DynaPDF Manual - Page 270

Previous Page 269   Index   Next Page 271

Function Reference
Page 270 of 777
SI32 pdfCreateSeparationCS(
const PPDF* IPDF)
// Instance pointer
const char* Colorant,
// Colorant name -> required
TExtColorSpace Alternate, // Alternate color space
SI32 Handle,
// Alternate color space handle or -1
UI32 Color)
// Color value defined in the alt. color space
The function creates a Separation color space.
Color output devices produce full color by combining primary or process colorants in varying
amounts. On an additive color device such as a display, the primary colorants consist of red, green,
and blue phosphors; on a subtractive device such as a printer, they typically consist of cyan,
magenta, yellow, and sometimes black inks. In addition, some devices can apply special colorants,
often called spot colorants, to produce effects that cannot be achieved with the standard process
colorants alone. Examples include metallic and fluorescent colors and special textures.
When printing a page, most devices produce a single composite page on which all process colorants
(and spot colorants, if any) are combined. However, some devices, such as imagesetters, produce a
separate, monochromatic rendition of the page, called a separation, for each colorant. When the
separations are later combined—on a printing press, for example—and the proper inks or other
colorants are applied to them, the result is a full-color page.
A Separation color space (PDF 1.2) provides a means for specifying the use of additional colorants or
for isolating the control of individual color components of a device color space for a subtractive
device. When such a space is the current color space, the current color is a single-component value,
called a tint, that controls the application of the given colorant or color components only.
The parameter Colorant specifies the colorant name which this Separation color space is intended to
represent. The special colorant name All refers collectively to all colorants available on an output
device, including those for the standard process colorants. When a Separation space with this
colorant name is the current color space, painting operators apply tint values to all available
colorants at once. This is useful for purposes such as painting registration targets in the same place
on every separation.
Such marks are typically painted as the last step in composing a page to ensure that they are not
overwritten by subsequent painting operations.
The special colorant name None never produces any visible output. Painting operations in a
Separation space with this colorant name have no effect on the current page.
The parameter Alternate specifies the alternate color space in which the color should be rendered if
the device does not support the specified colorant. The alternate color space can be any Device or
CIE based color space but not in turn a special color space like Separation, Indexed, or DeviceN.
The parameter Handle specifies the handle of the alternate color space if a CIE based color space
should be used. If the alternate color space is a device color space the parameter Handle is ignored.

Previous topic: CreateResetAction

Next topic: Encoding of Colorant Names, CreateSetOCGStateAction