DLI Implementation and Reference Guide - Datalogics

Color and its Use 12.3
Colors in Images
Color spaces may also be used separately with images if those images are bitmaps. A
color model must be specified as a CosStructure when using
dlpdfimagecreatefrombmp. The CosObj form of a color is obtained from the
PDE form by the call PDEColorSpaceGetCosObj. Creating the PDE form is
explained below.
When images are created with any of the other dlpdfimagecreate-type calls, color
spaces will be constructed as needed.
Creating and Destroying Color Spaces
For the basic colors, the color spaces used in your document will be in the form of a
PDEColorSpace. This is not a document object, and therefore can be shared
between documents. A COS form of that space will be created and inserted into each
document where that color space is used. These color models can be created when the
Adobe PDF Library is initialized, and should be destroyed before it is closed.
CAUTION: If color models are not freed, a close error will result.