Monkeybread Software - DynaPDF Manual

DynaPDF Manual - Page 275

Function Reference

Page 275 of 839

• prtr -> Printers

ICC profiles are available in different versions. Which profile versions are allowed to use depends

on the output PDF version:

PDF Version

ICC Specification Version

ICC Profile Version Number

PDF 1.3

3.3 or earlier

2.10

PDF 1.4

ICC.1:1998-09 and its addendum

2.20

ICC.1A:1999-04

PDF 1.5

ICC.1:2001-12

4.00

PDF 1.6

ICC.1:2003-09

4.10

PDF 1.7

ICC.1:2004-10

4.20

Please note that neither PDF/A-1 nor PDF/X-1 and PDF/X-3 support ICC profile major versions

higher than 2. The functions CreateICCBasedColorSpace() and AddRenderingIntent() check the

profile version only if the output version was set to a PDF/A or PDF/X compatible version (see

SetPDFVersion()).

ICC profiles are available for different input color spaces such as DeviceGray, DeviceRGB,

DeviceCMYK, or Lab. Color values must be defined in the very same as for the corresponding

device color spaces.

Notice:

Non-device color spaces cannot be used for interactive objects such as annotations or form fields.

The active color space must always be changed to a device color space before creating interactive

objects; see SetColorSpace(). Note also that annotations support DeviceRGB only. Form fields

support DeviceGray, DeviceRGB, and DeviceCMYK.

Remarks:

Use the function SetExtColorSpace() to activate the color space in the graphics state. To set a color of

an ICC-based color space convert the color value to a 32 bit integer in the very same way as for

DeviceGray, DeviceRGB, or DeviceCMYK depending on the base color space and pass the resulting

color value to SetFillColor(), SetStrokeColor(), or SetColors().

Return values:

If the function succeeds the return value is the color space handle, a value greater or equal zero. If

the function fails the return value is a negative error code.