DynaPDF Manual - Page 154

Previous Page 153   Index   Next Page 155

Function Reference
Page 154 of 839
FirstPage should normally be set to the same value as StartPage to achieve a continous page
numbering. Although it is possible to number each range separately, this can be very confusing for
users since the logical and physical page order is then different.
A document can contain multiple page label objects. Each of them represents a labelling range
which is a series of consecutive pages using the same numbering system.
Pages within a range are numbered sequentially in ascending order. A page’s label consists of a
numeric portion based on its position within its labelling range, optionally preceded by a label
prefix denoting the range itself. For example, the pages in an appendix might be labelled with
decimal numeric portions prefixed with the string A; the resulting page labels would be A-1, A-2,
and so on.
Remarks:
This function is implemented in an Ansi and Unicode compatible version.
Return values:
If the function succeeds the return value is the page label handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
AddRasImage (Rendering Engine)
Syntax:
LBOOL pdfAddRasImage(
const PPDF* IPDF,
// PDF Instance pointer
IRAS* RasPtr,
// Instance pointer of the rasterizer
TCompressionFilter Filter) // Compression filter for TIFF output
typedef enum TCompressionFilter
{
cfFlate
= 0x00000000, // TIFF output
cfJPEG
= 0x00000001, // JPEG, or TIFF output
cfCCITT3
= 0x00000002, // B&W CCITT Fax G3 compression
cfCCITT4
= 0x00000003, // B&W CCITT Fax G4 compression -> higher compression ratio
cfLZW
= 0x00000004, // Very fast but less compression ratios than flate
cfLZWBW
= 0x00000005, // TIFF -> Floyd Steinberg dithering
cfFlateBW
= 0x00000006, // TIFF, PNG, or BMP output -> Floyd Steinberg dithering
cfJP2K
= 0x00000007, // JPEG2000 output
// These flags can be combined with the filters cfFlate, cfCCITT3, cfCCITT4, and LZW.
cfDitherFloydSteinberg
= 0x00001000, // See 1 bit image output below
cfConvGrayToOtsu
= 0x00002000, // See 1 bit image output below
cfOrderedDithering
= 0x00004000, // See 1 bit image output below
cfIgnoreICCProfile
= 0x00008000
// Meaningful only if color management is enabled. If set,
// the device ICC profile is not embedded in the image.
}TCompressionFilter;
The function adds an image of the rasterizer to the current open image file. The output image must
be opened with CreateImage() beforehand.
The function performs a color conversion if the output image format requires another component
order. For example, if the pixel format of the rasterizer is RGB and if the output image format is
BMP then the component order must be changed to BGR because Windows Bitmaps require the
 

Previous topic: AddOutputIntentEx, AddPageLabel

Next topic: 1 bit image output, Compression filters