DynaPDF Manual - Page 296

Previous Page 295   Index   Next Page 297

Function Reference
Page 296 of 839
SI32 pdfCreateResetAction(
const PPDF* IPDF) // Instance pointer
A reset form action resets all or specific fields of an interactive form to their default values. If only a
few specific fields should be reset then add these fields with AddFieldToFormAction() to the action.
It is possible to exclude or include only specific fields when resetting the form. However, if no
specific fields are added to the action, all fields are reset to their default values, this is the normal
Actions must be added to a PDF object with AddActionToObj().
Return values:
If the function succeeds the return value is the action handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
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
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

Previous topic: CreateRectilinearMeasure

Next topic: Encoding of Colorant Names