DynaPDF Manual - Page 128

Previous Page 127   Index   Next Page 129

Function Reference
Page 128 of 839
AddContinueText
Syntax:
SI32 pdfAddContinueText(
const PPDF* IPDF,
// Instance pointer
const char* AText) // Text to be printed
The function prints a single text line and moves the text cursor to the next line. Text lines created by
this function are handled as a separate block. Before calling the function the first time, the usage
must be prepared with BeginContinueText(). After all text lines are printed call EndContinueText()
to finish the text block.
The distance between two text lines can be adjusted with SetLeading().
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
AddDeviceNProcessColorants
Syntax:
LBOOL pdfAddDeviceNProcessColorants(
const PPDF* IPDF,
// Instance pointer
UI32 DeviceNCS,
// Handle of a DeviceN or NChannel color
space
const char** Colorants,
// Array of colorant names
UI32 NumColorants,
// Number of colorants in the array
TExtColorSpace ProcessCS, // Process color space
SI32 Handle)
// Color space handle or -1
The function adds a dictionary to a DeviceN or NChannel color space that describes the process
color space whose components are included in the DeviceN or NChannel color space.
The array Colorants holds the process colorant names which are included in the process color space.
The names must appear in the normal color space order, e.g. Red, Green, and Blue, for a RGB color
space and the number of colorant names must match the number of color components in the process
color space. However, the names in the Colorants array need not match the actual color space names.
For example, a Red component need not be named Red.
Definitions of process colorants must not appear in the definition of spot colorants (see
AddDeviceNSeparations()).
The reserved names Cyan, Magenta, Yellow, and Black are always considered to be process colors,
which do not necessarily correspond to the colorants of a specific device; they are not required to
have entries in the process dictionary.
If NumColorants is zero the functions deletes existing definitions of process colorants in the DeviceN
or NChannel color space. Otherwise, existing definitions will be overridden.
 

Previous topic: AddButtonImageEx, AddButtonImageEx2

Next topic: AddDeviceNSeparations, Encoding of Colorant Names