DynaPDF Manual - Page 246

Previous Page 245   Index   Next Page 247

Function Reference
Page 246 of 839
The check box character can be changed with the property Get/SetCheckBoxChar(). If the check box
character is ccCircle, the border appears circular if the check box is a sub control of a radio button
field. If the check box is used stand alone, the border appears always rectangular.
Specific flags supported by check boxes only:
ffRadioIsUnion: If set, a group of radio buttons within a radio button field that use the
same export value for the on state will turn on and off in unison; that is if one is checked,
they are all checked. This flag requires Acrobat 6 or higher.
Interactive form fields can be structured into several groups by passing a handle of a group field to
the parameter Parent. See CreateGroupField() for further information.
Return values:
If the function succeeds the return value is the field handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
SI32 pdfCreateCIEColorSpace(
const PPDF* IPDF,
// Instance pointer
TExtColorSpace CS, // Allowed values: esCalGray, esCalRGB, esLab
float* WhitePoint, // White point -> required
float* BlackPoint, // Optional black point
float* Gamma,
// Optional gamma per component or Range in Lab
float* Matrix)
// Optional transformation matrix -> CalRGB only
The function creates a CIE-based color space. Three CIE-based color spaces are supported: CalGray,
CalRGB, and Lab.
The semantics of CIE-based color spaces are defined in terms of the relationship between the space’s
components and the tristimulus values X, Y, and Z of the CIE 1931 XYZ space. The CalRGB and Lab
color spaces (PDF 1.1) are special cases of three-component CIE-based color spaces, known as CIE-
based ABC color spaces. These spaces are defined in terms of a two-stage, nonlinear transformation
of the CIE 1931 XYZ space. See PDF Reference for further information.
A CalGray color space (PDF 1.1) is a special case of a single-component CIEbased color space,
known as CIE-based A color space. This type of space is the one-dimensional (and usually
achromatic) analog of CIE-based ABC spaces. Color values in a CIE-based A space have a single
component, arbitrarily named A.
The white point is an array of three numbers [XW YW ZW] specifying the tristimulus value, in the
CIE 1931 XYZ space, of the diffuse white point. The numbers XW and ZW must be positive, and YW
must be equal to 1.0. The parameter WhitePoint is always required.

Previous topic: CreateCheckBox

Next topic: How to define CalGray colors?, How to define CalcRGB colors?, How to define Lab colors?