Xojo Developer Conference
25/27th April 2018 in Denver.
MBS Xojo Conference
6/7th September 2018 in Munich, Germany.

DynaPDF Manual - Page 116

Previous Page 115   Index   Next Page 117

Function Reference
Page 116 of 750
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.
Remarks:
Process colorant names must be defined in the code page 1252 (WinAnsi).
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
AddDeviceNSeparations
Syntax:
LBOOL pdfAddDeviceNSeparations(
const PPDF* IPDF,
// Instance pointer
UI32 DeviceNCS,
// Handle of a DeviceN or NChannel color space
const char** Colorants, // Array of colorant names
UI32* SeparationCS,
// Array of Separation color space handles
UI32 NumColorants)
// Number of colorants and handles in the arrays
The function adds a dictionary to a DeviceN or NChannel color space that describes the spot
colorants which are used in the color space.
This dictionary provides information about the individual colorants that may be useful to some
applications. In particular, the alternate color space and tint transformation function of a Separation
color space describe the appearance of that colorant alone, whereas those of a DeviceN color space
describe only the appearance of its colorants in combination.
The array Colorants holds the spot colorant names and the array SeparationCS holds the
corresponding Separation color space handles. The colorant names in the array must match the
names in the corresponding Separation color spaces. In addition, the colorants must be included in
the DeviceN or NChannel color space.
 

Previous topic: AddDeviceNProcessColorants

Next topic: AddFieldToFormAction