Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

DynaPDF.InitColorManagementEx

Initializes color management.

Component Version macOS Windows Linux Server iOS SDK
DynaPDF 6.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "DynaPDF.InitColorManagementEx"; PDF { ; DestSpace; Flags; DefInGray; DefInRGB; DefInCMYK; DeviceProfile; SoftProof } )   More

Parameters

Parameter Description Example Flags
PDF The PDF reference returned from DynaPDF.New. $pdf
DestSpace Destination color space. Can be DeviceRGB, DeviceCMYK or DeviceGray. Default is DeviceRGB. "DeviceRGB" Optional
Flags Flags for color management initialization. Can be Default or a combination of BPCompensation (1), CheckBlackPoint (2) or both (3). "BPCompensation" Optional
DefInGray The gray profile as Container.
You can pass empty text/value if you have no gray profile.
MyTable::gDefInGray Optional
DefInRGB The RGB profile as container.
You can pass empty text/value if you have no RGB profile.
MyTable::gDefInRGB Optional
DefInCMYK The CMYK profile as container.
You can pass empty text/value if you have no CMYK profile.
MyTable::gDefInCMYK Optional
DeviceProfile The Device profile as container, must be compatible with the output color space. Default is sRGB.
You can pass empty text/value if you have no device profile.
MyTable::gDeviceProfile Optional
SoftProof The output profile as conainer for emulating output device.
You can pass empty text/value if you have no soft proof profile.
MyTable::gSoftProof Optional

Result

Returns OK or error.

Description

Initializes color management.
Enables color management the functions DynaPDF.RenderPage, DynaPDF.RenderPDFFile exactly like DynaPDF.InitColorManagement but accepts ICC profile as containers instead of file paths. See DynaPDF.InitColorManagement for further information.

Initializing the color management requires a considerable amount of processing time. It is strongly recommended to use one PDF instance as long as possible so that it must not be initialized again when another PDF file will be rendered.
The color management can be initialized right after the PDF instance was created.

See also InitColorManagementEx function in DynaPDF manual.

Examples

Initialize with profiles in containers:

Set Variable [ $r ; Value: MBS("DynaPDF.InitColorManagementEx"; $pdf; "DeviceRGB"; "BPCompensation"; Settings::Gray ICC Profile; Settings::RGB ICC Profile; Settings::CMYK ICC Profile) ]

See also

Example Databases

This function checks for a license.

Created 27th January 2016, last changed 27th May 2021


DynaPDF.InitColorManagement - DynaPDF.Initialize