DL Logo

PDPref Structures

_t_PDChromaticity

Header: PDExpT.h:3928

Description

A data structure containing a monitor's chromaticity, for use in displaying device-independent color.

x and y are the two values needed to specify the chromaticity.

Syntax

struct _t_PDChromaticity {
The x-axis component of the monitor's chromaticity. It must be in [0,1). x + y must be less than or equal to 1.
The y-axis component of the monitor's chromaticity. It must be in (0,1]. x + y must be less than or equal 1.
} PDChromaticity;

Used In

_t_PDColorCal

Header: PDExpT.h:3942

Description

A data structure used to represent the characteristics of an output device; it is needed for device-independent color.

Syntax

struct _t_PDColorCal {
PDChromaticity whiteChrom;
PDChromaticity redChrom;
PDChromaticity greenChrom;
PDChromaticity blueChrom;
ASFixed redGamma;
ASFixed greenGamma;
ASFixed blueGamma;
} PDColorCal, *PDColorCalP;

Used By

PDPref Functions

PDPrefGetBlackPointCompensation

Header: PDProcs.h:11932

Description

Returns the black-point compensation flag.

Syntax

ASBool PDPrefGetBlackPointCompensation(void);

Returns

true if black-point compensation is done.

PDPrefGetColorCal

Header: PDProcs.h:5402

Description

Gets the values to use for displaying the calibrated color and grayscale. These values are the chromaticity and gammas of the phosphors in the monitor.

These values are used for rendering if calibrated color is enabled by the preferences file item avpDoCalibratedColor (see AVAppGetPreference()).

Related Methods

Syntax

ASBool PDPrefGetColorCal(PDColorCalP colorCal);

Parameters

colorCal
IN/OUT (Filled by the method) A pointer to a structure that contains the color calibration information. For RGB devices, the red, green, and blue chromaticity and gammas are used; for grayscale, whiteChrom and greenGamma are used. You must allocate storage for the colorCal data structure and pass a pointer to the memory you allocated.

Returns

Always returns true.

PDPrefGetDefaultBlendingColorSpace

Header: PDProcs.h:12851

Description

Get the default blending color space Index

Syntax

ASInt32 PDPrefGetDefaultBlendingColorSpace(void);

Returns

value equal to 0 means default blending colorspace is Working CMYK, value equal to 1 means default blending colorspace is Working RGB.

PDPrefGetInstallPatternParentGState

Header: PDProcs.h:12882

Description

Get the preference whether to install the graphics state that was in effect at the beginning of the pattern's parent content stream

Syntax

ASBool PDPrefGetInstallPatternParentGState(void);

Returns

value equal to 0 means apply current GState, value equal to 1 means install GState was in effect at the beginning of the pattern's parent content stream.

PDPrefGetUseOutputIntents

Header: PDProcs.h:11911

Description

Returns the value of the Output Intent flag. When this flag is true, the system overrides the working space with the Output Intent, if it is present.

Related Methods

Syntax

ASBool PDPrefGetUseOutputIntents(void);

Returns

The Output Intent flag value.

PDPrefSetBlackPointCompensation

Header: PDProcs.h:11925

Description

Sets the black-point compensation flag, which controls whether to adjust for differences in black points when converting colors between color spaces. When enabled, the full dynamic range of the source space is mapped into the full dynamic range of the destination space. When disabled, the dynamic range of the source space is simulated in the destination space (which can result in blocked or gray shadows).

Syntax

void PDPrefSetBlackPointCompensation(ASBool kbpc);

Parameters

kbpc
true to enable black-point compensation, false otherwise.

PDPrefSetColorCal

Header: PDProcs.h:5379

Description

Sets the values to use for displaying the calibrated color and grayscale. These values are the chromaticities and gammas of the phosphors in the monitor.

These values do not necessarily correspond to the monitor being used; it is the responsibility of the client that sets these values to provide the correct values.

These values are used for rendering if calibrated color is enabled by the preferences file item avpDoCalibratedColor (see AVAppSetPreference()).

Related Methods

Syntax

ASBool PDPrefSetColorCal(PDColorCalP colorCal);

Parameters

colorCal
A pointer to a structure that contains the color calibration information. For RGB devices, the red, green, and blue chromaticities and gammas are used; for grayscale, whiteChrom and greenGamma are used.

Returns

true if the values were successfully set and installed for the currently active display device, false otherwise.

PDPrefSetDefaultBlendingColorSpace

Header: PDProcs.h:12845

Description

Sets the default blending color space to working CMYK or working RGB

Syntax

void PDPrefSetDefaultBlendingColorSpace(ASInt32 dBCSIndex);

Parameters

dBCSIndex
An index to set blending color space. Pass 1 to set bcs as working RGB. Pass 0 or other value to set bcs as working CMYK.

PDPrefSetInstallPatternParentGState

Header: PDProcs.h:12876

Description

Sets the preference to install the graphics state that was in effect at the beginning of the pattern's parent content stream

Syntax

void PDPrefSetInstallPatternParentGState(ASBool bInstallPatternParentGStateFlag);

Parameters

bInstallPatternParentGStateFlag
Pass 1 to install GState was in effect at the beginning of the pattern's parent content stream

PDPrefSetUseOutputIntents

Header: PDProcs.h:11902

Description

Sets the Output Intent flag.

Related Methods

Syntax

void PDPrefSetUseOutputIntents(ASBool flag);

Parameters

flag
When true, use Output Intent to override a working space if it is present.

PDPrefSetWorkingCMYK

Header: PDProcs.h:11956

Description

Sets the current CMYK working space to a given ICC profile. A CMYK working space in PDF is defined as a profile to substitute for a corresponding /DeviceCMYK space.

Syntax

void PDPrefSetWorkingCMYK(void *profile, ASUns32 profileLength);

Parameters

profile
A pointer to a buffer containing the ICC color profile.
profileLength
The length in bytes of the profile.

PDPrefSetWorkingGray

Header: PDProcs.h:11970

Description

Sets the current gray working space to a given ICC profile. A Gray working space in PDF is defined as a profile to substitute for a corresponding /DeviceGray space. When rendering with overprint preview, the gray substitution is suppressed, to avoid converting grayscale to rich black.

Syntax

void PDPrefSetWorkingGray(void *profile, ASUns32 profileLength);

Parameters

profile
A pointer to a buffer containing the ICC color profile.
profileLength
The length in bytes of the profile.

PDPrefSetWorkingRGB

Header: PDProcs.h:11944

Description

Set the current RGB working space to a given ICC profile. An RGB working space in PDF is defined as a profile to substitute for a corresponding /DeviceRGB space.

Syntax

void PDPrefSetWorkingRGB(void *profile, ASUns32 profileLength);

Parameters

profile
A pointer to a buffer containing the ICC color profile.
profileLength
The length in bytes of the profile.