DL Logo

PDPref Enumerations

PDPrefAASmoothOptions

Header: PDFLExpT.h:1492

Description

Bit flags that set the default smooth text and smooth images global flags for subsequent rendering methods. These flags are passed to the PDPrefSetAntialiasLevel, and are similar to PDPageDrawSmoothFlags.

Related Methods

Enum Constants

kPDPrefAASmoothText=0x00000001
Draw smooth text.
kPDPrefAASmoothLineArt=0x00000002
Draw smooth line art.
kPDPrefAASmoothImage=0x00000010
Draw smooth image.

PDPrefAASmoothOptions

Header: PDFLExpT.h:1506

Enum Constants

PDPrefAASmoothText=1
PDPrefAASmoothLineArt=2
PDPrefAASmoothImage=0x00000010

RefXObjOptions

Header: PDFLExpT.h:1363

Description

Modes used to control the display of reference XObjects.

Value options for PDRefXObjMode.

Enum Constants

kRefXObjNever=0
Never display reference XObjects. If a file contains reference XObjects, their content will not be displayed, and only the proxy will be displayed if this mode is selected.
kRefXObjAlways=1
Always display reference XObjects. All files containing reference XObjects will display content from the XObjects.
kRefXObjPDFX5=2
All files that are PDFX5 compliant and that contain reference XObjects will display their content.
kRefXObjAlwaysAssured=3
Always display reference XObjects, but do not display the proxy. The PDF parsing fails if the target is not found.
kRefXObjPDFX5Assured=4
Always display reference XObjects, but do not display the proxy. The PDF parsing fails if the target PDF/X-5 document is not found.

PDPref Typedefs

PDRefXObjMode

Header: PDFLExpT.h:1390

Description

Modes used to control the display of reference XObjects.

For value options see RefXObjOptions.

Syntax

typedef ASInt32 PDRefXObjMode;

Returned From

Used By

PDPref Functions

PDPrefGetAntialiasLevel

Header: PDFLProcs.h:359

Description

Returns the antialias level, in pixels.

Related Methods

Syntax

ASUns32 PDPrefGetAntialiasLevel(void);

Returns

The antialias level set by PDPrefSetAntialiasLevel().

PDPrefGetBlackPointCompensation

Header: PDFLProcs.h:381

Description

Returns the black-point compensation flag.

Syntax

ASBool PDPrefGetBlackPointCompensation(void);

Returns

true if black-point compensation is done.

PDPrefGetEnableThinLineHeuristics

Header: PDFLProcs.h:896

Description

Determines whether thin lines will be fattened non-linearly or the stroke adjust will be applied to thin rectangles.

Syntax

ASBool PDPrefGetEnableThinLineHeuristics(void);

Returns

true if thin line heuristics are applied, false otherwise.

PDPrefGetGreekLevel

Header: PDFLProcs.h:351

Description

Returns the greek level.

Related Methods

Syntax

ASInt16 PDPrefGetGreekLevel(void);

Returns

The greek level set by PDPrefSetGreekLevel().

PDPrefGetRefXObj

Header: PDFLProcs.h:884

Description

Gets reference XObject parameters.

Syntax

PDRefXObjMode PDPrefGetRefXObj(ASFileSys *fileSys, ASPathName *pathName);

Parameters

fileSys
Used with pathname to specify where the target files should be found.
pathname
Used with fileSys to specify the location of the target files.

PDPrefGetSuppressICCSpaces

Header: PDFLProcs.h:570

Description

Returns the value of the suppress flag for ICC-based spaces with the specified number of components.

Syntax

ASBool PDPrefGetSuppressICCSpaces(ASUns32 nComponents);

Parameters

nComponents
The number of ICC-based space components that are suppressed or not, according to the flag value.

Returns

The suppress flag value.

PDPrefGetUseOutputIntents

Header: PDFLProcs.h:548

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.

PDPrefSetAntialiasLevel

Header: PDFLProcs.h:344

Description

Sets the default smooth text and smooth images global flags for subsequent rendering methods.

If the function PDPageDrawContentsToMemory() is used for drawing, the smoothFlags value passed to that function supersedes the preference value for the duration of the call.

Related Methods

Syntax

void PDPrefSetAntialiasLevel(ASUns32 antialiasPixelLevel);

Parameters

antialiasPixelLevel

PDPrefSetBlackPointCompensation

Header: PDFLProcs.h:374

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.

Returns

None.

PDPrefSetEnableThinLineHeuristics

Header: PDFLProcs.h:890

Description

Sets whether thin lines will be fattened non-linearly or the stroke adjust will be applied to thin rectangles.

Syntax

void PDPrefSetEnableThinLineHeuristics(ASBool doThinLineTricks);

Parameters

doThinLineTricks
true if thin line heuristics are applied, false otherwise.

PDPrefSetGreekLevel

Header: PDFLProcs.h:324

Description

Sets the greek level. The greek level is a text height below which text characters are not rendered. Instead, text-like glyphs that have no meaning but look good at very small size are used. This is known as greeking.

Related Methods

Syntax

void PDPrefSetGreekLevel(ASInt16 greekPixelLevel);

Parameters

greekPixelLevel
The greek level, in pixels.

PDPrefSetRefXObj

Header: PDFLProcs.h:877

Description

Sets reference XObject parameters.

Syntax

void PDPrefSetRefXObj(PDRefXObjMode refXObjMode, ASFileSys fileSys, ASPathName pathName);

Parameters

refXObjMode
The mode to view or print reference XObjects. Its value can be one of the following:
Reference XObject mode
Description
Does nothing. The function returns false.
Find a substitution with minimal checking.
Restrict substitutions to PDF/X-5 conforming ones.
Fail the parser if the target is not found. Do not display the proxy.
Fail the parser if the target PDF/X-5 document not found. Do not display the proxy.
fileSys
Used with pathname to specify where the target files should be found.
pathname
Used with fileSys to specify the location of the target files.

PDPrefSetSuppressICCSpaces

Header: PDFLProcs.h:560

Description

Specifies use of a default color space rather than an ICC-based color space.

Syntax

void PDPrefSetSuppressICCSpaces(ASUns32 nComponents, ASBool value);

Parameters

nComponents
The number of ICC color space components.
value
When true, use a DefaultCMYK, DefaultRGB, or DefaultGray color space instead of an ICC-based color space with the same number of components.

PDPrefSetUseLocalFonts

Header: PDFLProcs.h:388

Description

Enables or disables use of local fonts.

Syntax

void PDPrefSetUseLocalFonts(ASBool useLocalFonts);

Parameters

useLocalFonts
When true, use local fonts. When false, use global fonts.

PDPrefSetUseOutputIntents

Header: PDFLProcs.h:539

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: PDFLProcs.h:641

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: PDFLProcs.h:655

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: PDFLProcs.h:629

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.