DLI Implementation and Reference Guide - Datalogics

11.6 DLI Implementation and Reference Guide
dlpdfimagecreatefrombmp
This method creates a DLPDFIMAGE from a bitmap and user-supplied information.
Concepts and Facilities: Guide to the DL Pager Composition System
• Its first parameter is the document of which the image is to be a part.
• Its second parameter is a name to be used to identify this image.
• Its third and fourth parameters are pointers to an array of bytes containing the
bitmap and the length of that bitmap.
• Its fifth parameter is the length of a line in samples.
• Its sixth parameter is the number of lines.
• Its seventh parameter is the size of a sample.
• The eighth parameter is a COS Object which describes the color model used for the
image.
• The last parameter is a flag. When TRUE, this object will be embedded in the
document each time it is used. When FALSE, it will be embedded only once.
NOTE: DLI will merge inline all bitmapped images under 500 bytes. However, if
the image is equal to one bitmap, then DLI will automatically set the image as an
imagemask. Please see “Creating Transparent Graphics” on page 11.12
This method assumes that the bitmap is ordered into samples within lines, that the
first line presented is the top of the image, and that the first sample presented is the
left edge of the image.
Order of Values within Color Models
The type of color model will determine whether the image contains one value per
sample (/DeviceGray or /Indexed color models), three values per sample
(/DeviceRGB), or four values per sample (/DeviceCMYK).
Each value is assumed to have the number of bits specified in the sample size. For
/DeviceRGB they are assumed to be ordered Red/Green/Blue; for /DeviceCMYK
they are assumed to be ordered Cyan/Magenta/Yellow/Black.