DynaPDF Manual - Page 132

Previous Page 131   Index   Next Page 133

Function Reference
Page 132 of 777
pdfAddOCGToAppEvent( pdf,
TOCAppEvent(aeExport | aePrint),
TOCGUsageCategory(oucExport | oucPrint)
In the above example only the category oucExport will be added to the Export event, and oucPrint to
the Print event. The category oucPrint is not meaningful for exporting and oucExport is not
meaningful for printing. The invalid categories are automatically removed so that the above function
call is allowed and valid.
Note that application events are not supported in all viewer applications. If a watermark should
appear when printing, for example, then it is usually best to set the state of such a layer to visible,
and to make it invisible in the View event. A viewer that supports application events will hide the
layer at viewing time but still print it. A viewer that does not support application events will always
display the layer.
If the initial state of the layer would be invisible, then it would also stay invisible at printing time if
the viewer does not support application events but layers.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
SI32 pdfAddOutputIntent(
const PPDF* IPDF,
// Instance pointer
const char* ICCFile) // File path of the ICC profile
An Output Intent represents the destination color space for which a PDF file was created. Different
profiles for DeviceGray, DeviceRGB and DeviceCMYK can be attached but this is not recommendet.
Certain PDF standards like PDF/A or PDF/X prohibit the usage of multiple profiles since only one
destination color space can exist. So, although PDF supports multiple profiles, please attach only
one profile.
Depending on the application for which a PDF file was created the attached ICC profile is mostly a
RGB or CMYK profile. RGB refers mainly to PDF files created for the web and CMYK profiles for
BTW - You find a very detailed description about color management in PDF on our website...
ICC profiles are available for different input color spaces and for different output devices classes.
PDF viewer applications support the device classes mntr, prtr, scnr, and spac.
The input color space can be DeviceGray, DeviceRGB, DeviceCMYK, or Lab. Other input color
spaces are not supported. An ICC color profile is always required to create PDF/X compatible PDF

Previous topic: AddOCGToAppEvent

Next topic: AddOutputIntentEx