DL Logo

PDPref Functions

PDPrefGetAllowOpeningXFA

Header: DLExtrasProcs.h:295

Description

Routine to get the current allow-XFA setting.

Related Methods

Syntax

ASBool PDPrefGetAllowOpeningXFA(void);

Returns

true if opening XFA PDFs is allowed.

PDPrefGetAllowRelaxedSyntax

Header: DLExtrasProcs.h:497

Description

Returns the current value of the AllowRelaxedSyntax flag setting.

Related Methods

Syntax

ASBool PDPrefGetAllowRelaxedSyntax(void);

Returns

if True, the Library will attempt to resolve or ignore certain minor PDF syntax errors.

PDPrefGetAllowStringRetrievalFailingDecryption

Header: DLExtrasProcs.h:891

Description

Returns the current value of the AllowStringRetrievalFailingDecryption flag setting.

Related Methods

Syntax

ASBool PDPrefGetAllowStringRetrievalFailingDecryption(void);

Returns

if True, the Library will attempt to retrieve String object values, even if Decryption of those strings fails.

PDPrefGetDefaultIntentToProfile

Header: DLExtrasProcs.h:480

Description

This function returns the current status of the default source intent used in a color profile.

Related Methods

Syntax

ASBool PDPrefGetDefaultIntentToProfile(void);

Returns

If true, the intent to be used shall be the intent specified in the profile; otherwise AC_RelColorimetric will be assumed.

PDPrefGetNeverUseOutputIntent

Header: DLExtrasProcs.h:590

Description

This function returns whether that the output intent should be completely ignored when rendering a document.

Note: This setting defaults to false.

Related Methods

Syntax

ASBool PDPrefGetNeverUseOutputIntent(void);

Returns

If true, the OutputIntent will not be used when rendering even for PDF/A, PDF/E, or PDF/X documents.

PDPrefGetPrintUsingWorkingSpaces

Header: DLExtrasProcs.h:538

Description

This function returns whether the device spaces are treated as calibrated when rendering.

Note: This setting is only effective when the document is being rendered to memory, or a window, and kPDPageIsPrinting is true.

Related Methods

Syntax

ASBool PDPrefGetPrintUsingWorkingSpaces(void);

Returns

if true, treats device spaces as calibrated to the associated working space profile. Otherwise, treats device spaces as uncalibrated

PDPrefGetStrictFormEmission

Header: DLExtrasProcs.h:1045

Description

Returns the current value of the PDPrefGetStrictFormEmission flag setting.

Related Methods

Syntax

ASBool PDPrefGetStrictFormEmission(void);

Returns

if True, the Library will bypass the strict enforcement to emit form content to container.

PDPrefSetAllowOpeningXFA

Header: DLExtrasProcs.h:287

Description

Routine to allow APDFL to open XFA PDF documents, which as of 9.1P2f is disallowed.

Related Methods

Syntax

void PDPrefSetAllowOpeningXFA(ASBool flag);

Parameters

flag
True will allow APDFL to open XFA PDF documents.

PDPrefSetAllowRelaxedSyntax

Header: DLExtrasProcs.h:491

Description

This call, with a True flag value, allows callers to ask Adobe PDF Library to attempt to ignore minor PDF syntax errors. For example, the Library may correct FontDescriptor entries with missing values by adding defaults, add a missing Supplement for Adobe Identity, or add a missing /FirstChar or /LastChar entry if the other of the pair is present, along with a valid Widths table).

Related Methods

Syntax

void PDPrefSetAllowRelaxedSyntax(ASBool flag);

Parameters

flag
When true, this will tell the PDF Library to ignore certain minor PDF document errors.

PDPrefSetAllowStringRetrievalFailingDecryption

Header: DLExtrasProcs.h:882

Description

This call is used to retrive the value of String objects using an Encryption that's not supported by the Library in order to still retrieve the String's value. This is useful to Advanced Users who know how to interpret the String data when advanced Encryption is in use.

Related Methods

Syntax

void PDPrefSetAllowStringRetrievalFailingDecryption(ASBool allowStringRetrievalFailingDecryption);

Parameters

flag
When true, this will tell the Library to retrieve String object values, even if Decryption of those strings fails.

PDPrefSetDefaultIntentToProfile

Header: DLExtrasProcs.h:472

Description

When this preference is set to true, the intent used (when no other intent is explicitly specified) will be the intent specified in the profile. Otherwise AC_RelColorimetric will be assumed by default.

Related Methods

Syntax

void PDPrefSetDefaultIntentToProfile(ASBool flag);

Parameters

flag
If true, use intent specified in the profile.

PDPrefSetNeverUseOutputIntent

Header: DLExtrasProcs.h:600

Description

This function sets a flag to specify that the output intent should not be considered when rendering a document. This overrides the default behavior of the preference set with PDPrefSetUseProfileIntent. The PDPrefSetUseProfileIntent may still use the OutputIntent in spite of being set to false, if the document purports to be PDF/A, PDF/E, or PDF/X.

Note: This setting defaults to false.

Related Methods

Syntax

void PDPrefSetNeverUseOutputIntent(ASBool value);

Parameters

flag
if true, the OutputIntent will not be used when rendering even for PDF/A, PDF/E, or PDF/X documents.

PDPrefSetPrintUsingWorkingSpaces

Header: DLExtrasProcs.h:529

Description

This function sets a flag to treat the device spaces as calibrated when rendering.

Note: This setting is only effective when the document is being rendered to memory, or a window, and kPDPageIsPrinting is true.

Related Methods

Syntax

void PDPrefSetPrintUsingWorkingSpaces(ASBool flag);

Parameters

flag
if true, treats device spaces as calibrated to the associated working space profile. Otherwise, treats device spaces as uncalibrated

PDPrefSetStrictFormEmission

Header: DLExtrasProcs.h:1036

Description

This call is used to allow user to set strictFormEmission.

Related Methods

Syntax

void PDPrefSetStrictFormEmission(ASBool strictFormEmission);

Parameters

flag
When true, this will tell Libary to bypass the strict enforcement to emit form content to container.

PDPrefSuppressDefaultCMYKCalibration

Header: DLExtrasProcs.h:266

Description

Routine to suppress the Adobe-defined default color profile used for DeviceCMYK specified object. If a default color space is defined in the document resources, or via PDEContentSetDefault, it will still be used.

Related Methods

PDPrefSuppressDefaultGrayCalibration PDPrefSuppressDefaultRGBCalibration

Syntax

void PDPrefSuppressDefaultCMYKCalibration(ASBool flag);

Parameters

flag
True will suppress the Adobe-defined default color profile.

PDPrefSuppressDefaultGrayCalibration

Header: DLExtrasProcs.h:278

Description

Routine to suppress the Adobe-defined default color profile used for DeviceGray specified object. If a default color space is defined in the document resources, or via PDEContentSetDefault, it will still be used.

Related Methods

PDPrefSuppressDefaultCMYKCalibration PDPrefSuppressDefaultRGBCalibration

Syntax

void PDPrefSuppressDefaultGrayCalibration(ASBool flag);

Parameters

flag
True will suppress the Adobe-defined default color profile.

PDPrefSuppressDefaultRGBCalibration

Header: DLExtrasProcs.h:254

Description

Routine to suppress the Adobe-defined default color profile used for DeviceRGB specified object. If a default color space is defined in the document resources, or via PDEContentSetDefault, it will still be used.

Related Methods

Syntax

void PDPrefSuppressDefaultRGBCalibration(ASBool flag);

Parameters

flag
True will suppress the Adobe Defined Default Color Profile.