Layer

Additional functionality from Datalogics

22 components201 items
168 Functions 1 Definitions 11 Structures 21 Enums

CosStream

1 items

Functions(1)

CosStreamSetData

void CosStreamSetData(CosObj stream, ASStm sourceP, ASInt32 sourceStart, ASBool encodeTheSourceData, CosObj attributes, CosObj encodeParms, ASInt32 sourceLength)
DLExtrasProcs.h:156

Essentially identical to CosNewStream, except that the result is a modification of an existing stream.

Parameters
stream: CosObj

Stream to be modified

sourceP: ASStm

source stream to be added.

sourceStart: ASInt32

The byte offset to the starting point of the stream to be added.

encodeTheSourceData: ASBool

Flag indicating whether the source data is to encoded via filters specified in the attributes.

attributes: CosObj

dictionary containing string data attributes, including its length and encoding parameters.

encodeParms: CosObj

Parameters to be used for encoding (if any).

sourceLength: ASInt32

length of data to be read from the source, or -1 to read to EOF.

Returns
void
See Also
CosStreamNew

General

87 items

Functions(70)

ACGetOption

AC_Error ACGetOption(AC_OptionCode code, ASUns32 *value)
DLExtrasProcs.h:129

Returns the current value for the given AC_OptionCode. This call controls the behavior of colorspace conversions and manipulations carried out via AC-layer calls; it does not impact other Adobe PDF Library color behaviors.

Parameters
code: AC_OptionCode

AC_Option_BlackPointCompensation indicates whether the Acrobat Color Engine will carry out black point compensation when converting between colorspaces with different black points.

value: ASUns32 *

AC_Option_BlackPointCompensation flag value to be retrieved (Filled by the method)

Returns
AC_Error

Indicates if an error occurred.

See Also
ACSetOption

ACSetOption

AC_Error ACSetOption(AC_OptionCode code, ASUns32 value)
DLExtrasProcs.h:140

Sets the current value for the option specified by the supplied AC_OptionCode. This call controls the behavior of colorspace conversions and manipulations carried out via AC-layer calls; it does not impact other Adobe PDF Library color behaviors.

Parameters
code: AC_OptionCode
value: ASUns32

The flag value to be set.

Returns
AC_Error

Indicates if an error occurred.

See Also
ACGetOption

DLPDEImageRotate

void DLPDEImageRotate(PDEImage image, ASDouble theta)
DLExtrasProcs.h:1157

Rotates an image by theta degrees. A rotation is produced by [cos(theta), sin(theta), -sin(theta), cos(theta), 0, 0], which has the effect of rotating the coordinate system axes by an angle theta (degrees) counterclockwise.

Parameters
image: PDEImage
theta: ASDouble
Returns
void

DLPDEImageScale

void DLPDEImageScale(PDEImage image, ASDouble sx, ASDouble sy)
DLExtrasProcs.h:1148

Scales an image by sx units. A scaling is obtained by [sx 0 0 sy 0 0]. This scales the coordinates so that 1 unit in the horizontal and vertical dimension of the new coordinate system is the same size as sx and sy units, respectively, as in the previous coordinate system.

Parameters
image: PDEImage
sx: ASDouble
sy: ASDouble
Returns
void

PDFLAddFontDirectories

ASBool PDFLAddFontDirectories(ASInt32 pathCount, ASPathName *paths)
DLExtrasProcs.h:453

This call allows Adobe PDF Library to rescan for fonts without re-initializing. This will allow an operating Library process to detect and update new font directories and resources after startup, without requiring a restart and re-initialization. This will add one or more directories, and the fonts within them, to the set of all directories containing fonts (those specified in the DirList string arrays of resource locations). This call should be followed by a call to PDFLRescanFontDirectories after all new font directories have been loaded.

Parameters
pathCount: ASInt32

Number of new paths to be added.

paths: ASPathName *

Paths to new resource locations to be added.

Returns
ASBool

Indicates if fonts directories were changed.

See Also
PDFLRescanFontDirectories

PDFLReinit

ASInt32 PDFLReinit(void)
PDFLProcs.h:688

Warm reinitialization of the Adobe PDF Library. Call this method if you closed all documents and other PD/PDE/Cos objects. Releases memory used for cached data.

Parameters
: void
Returns
ASInt32
See Also
PDFLInit

PDFLRescanFontDirectories

ASBool PDFLRescanFontDirectories(FontRescanFlags flags)
DLExtrasProcs.h:439

This call allows Adobe PDF Library to rescan for fonts without re-initializing. This will allow an operating Library process to detect and update new font directories and resources after startup, without requiring a restart and re-initialization. This call can, depending on flag settings, force a rescan of font resource areas defined in your dirList array, a rescan of those residing in the System folder, or both. To add new font resources to your dirList array, use the PDFLAddFontDirectories call. This call, as well as the PDFLAddFontDirectories call, will act upon all PDSysFont structures referenced by the font cache that have a reference count of zero. Any pointers to such structures will become invalid after a rescan call has occurred. By default, all referenced PDSysFont structures will be affected, as their reference counts are always zero. To preserve a PDSysFont reference across a rescan call, use PDEAcquire and PDERelease calls to increment and decrement usage counts of a PDSysFont object as like other PDE Object.

Parameters
flags: FontRescanFlags

Flags controlling rescan process.

Returns
ASBool

Indicates if fonts directories were changed.

See Also
PDFLAddFontDirectories

PDSignDocSaveInitParams

PDSignDocSaveParams PDSignDocSaveInitParams(void)
DLExtrasProcs.h:1763

Creates a set of parameters used for saving the document to which a digital signature has been added. The parameters are set to default values and can be examined using "get" methods, and modified via "set" methods. When these parameters are no longer needed (after the call to PDSignDocWithParams, although they can be re-used any number of times), they must be freed by calling PDSignDocSaveReleaseParams().

Parameters
: void
Returns
PDSignDocSaveParams

Initialized document signature parameters that can be further modified.

See Also
PDSignDocSaveReleaseParams

PDSignDocSetCancelProc

void PDSignDocSetCancelProc(PDSignDocSaveParams params, ASCancelProc cancelProc, void *cancelProcClientData)
DLExtrasProcs.h:1808

Sets the cancel process callback and client data for the callback.

Parameters
params: PDSignDocSaveParams

IN Object to be modified.

cancelProc: ASCancelProc

IN A callback to test whether an operation should be cancelled. A CancelProc is typically passed to some method that takes a long time to complete. At frequent intervals, the method calls the CancelProc. If it returns true, then the method cancels its operation; if false, it continues.

cancelProcClientData: void *

IN Pointer to user-supplied data to pass to cancelProc each time it is called. It must be NULL if cancelProc is NULL.

Returns
void

PDSignDocSetNonPfxPassphrase

void PDSignDocSetNonPfxPassphrase(PDSignDocSignParams params, void *passphrase, ASSize_t passphraseSize, CredentialStorageFmt storageFmt)
DLExtrasProcs.h:1672

Sets the passphrase used to decrypt NonPFX credentials. The passphrase provided must use the exact same character encoding used to encrypt the private key. The application makes no effort whatsoever to re-encode the same.

Parameters
params: PDSignDocSignParams

IN Object to be modified.

passphrase: void *

IN Passphrase used to encrypt NonPFX private key. Should be set to NULL if unencrypted.

passphraseSize: ASSize_t

IN Passphrase size in bytes. Shall be set to 0 if private key is unencrypted or passphrase is stored on disk.

storageFmt: CredentialStorageFmt

IN Storage format for passphrase.

Returns
void

PDSignDocSetNonPfxPrivateKey

void PDSignDocSetNonPfxPrivateKey(PDSignDocSignParams params, void *privateKey, ASSize_t keySize, CredentialStorageFmt storageFmt)
DLExtrasProcs.h:1662

Sets the private key for NonPFX credentials.

Parameters
params: PDSignDocSignParams

IN Object to be modified.

privateKey: void *

IN Private key corresponding to the public key in the signer certificate.

keySize: ASSize_t

IN Size of private key in bytes. Shall be set to 0 if key is stored on disk.

storageFmt: CredentialStorageFmt

IN Storage format for private key.

Returns
void

PDSignDocSetNonPfxSignerCert

void PDSignDocSetNonPfxSignerCert(PDSignDocSignParams params, void *signerCert, ASSize_t certSize, CredentialStorageFmt storageFmt)
DLExtrasProcs.h:1653

Sets the signer certificate for NonPFX credentials.

Parameters
params: PDSignDocSignParams

IN Object to be modified.

signerCert: void *

IN Signer certificate.

certSize: ASSize_t

IN Size of signer certificate in bytes. Shall be set to 0 if certificate is stored on disk.

storageFmt: CredentialStorageFmt

IN Storage format for the signer certificate.

Returns
void

PDSignDocSetPfxPassphrase

void PDSignDocSetPfxPassphrase(PDSignDocSignParams params, void *passphrase, ASSize_t passphraseSize, CredentialStorageFmt storageFmt)
DLExtrasProcs.h:1689

Sets the passphrase used to decrypt PFX/PKCS#12 credentials. The passphrase provided must use the exact same character encoding used to encrypt the PFX credentials. The application makes no effort whatsoever to re-encode the same.

Parameters
params: PDSignDocSignParams

IN Object to be modified.

passphrase: void *

IN Passphrase used to encrypt PFX/PKCS#12 credentials. Shall be set to NULL if credentials are unencrypted.

passphraseSize: ASSize_t

IN Passphrase size in bytes. Shall be set to 0 if PFX credentials are unencrypted or passphrase is stored on disk.

storageFmt: CredentialStorageFmt

IN Storage format for PFX/PKCS#12 credentials.

Returns
void

PDSignDocSetProgressMon

void PDSignDocSetProgressMon(PDSignDocSaveParams params, ASProgressMonitor progMon, void *progMonClientData)
DLExtrasProcs.h:1798

Sets the progress monitor and client data for the monitor.

Parameters
params: PDSignDocSaveParams

IN Object to be modified.

progMon: ASProgressMonitor

IN Progress monitor. Use AVAppGetDocProgressMonitor() to obtain the default. It may be NULL.

progMonClientData: void *

IN A pointer to user-supplied data to pass to mon each time it is called. It must be NULL if mon is NULL.

Returns
void

PDSignDocSetSigPolicy

ASInt32 PDSignDocSetSigPolicy(PDSignDocSignParams params, ASConstText oid)
DLExtrasProcs.h:1727

Adds a signature policy as a signed attribute to the PAdES signature used to sign the document. Signature policies may be applied to PAdES signatures, only. It is required that signature type be defined prior to adding a signature policy.

Parameters
params: PDSignDocSignParams

IN Object to be modified.

oid: ASConstText

IN Object Identifier (OID) that uniquely identifies a specific version of the signature policy to be added.

Returns
ASInt32

Number of signature policies contained within the PAdES signature.

PDSignDocSetSigPolicyQualifierUserNotice

void PDSignDocSetSigPolicyQualifierUserNotice(PDSignDocSignParams params, ASConstText displayText, ASConstText org, ASInt64 *noticeNos, ASSize_t numNoticeNos)
DLExtrasProcs.h:1750

Adds an element of type SPUserNotice containing information that is intended for being displayed whenever the PAdES signature is validated. The displayText and org attributes can be defined independent of each other. However, a valid org attribute must be defined in order to qualify a PAdES signature policy with the noticeNos attribute.

Parameters
params: PDSignDocSignParams

IN Object to be modified.

displayText: ASConstText

IN Text of the notice to be displayed.

org: ASConstText

IN Organization name that to be specified as part of the NoticeRef field.

noticeNos: ASInt64 *

IN Array of integers that identify a group of textual statements prepared by the organization to allow for retrieval of notices.

numNoticeNos: ASSize_t

IN Size of the array containing notice numbers.

Returns
void

PDSignDocSetSignerInfo

void PDSignDocSetSignerInfo(PDSignDocSignParams params, PDEImage logo, ASFixed opacity, ASConstText name, ASConstText location, ASConstText reason, ASConstText contactInfo, ASInt32 displayTraits)
DLExtrasProcs.h:1702

Sets signer info attributes that define corresponding signature dictionary entries and signature appearance traits.

Parameters
params: PDSignDocSignParams

IN Object to be modified.

logo: PDEImage

IN Image to display as part of signature appearance.

opacity: ASFixed

IN Opacity of image to display as part of signature appearance.

name: ASConstText

IN Name of the person or authority signing the document.

location: ASConstText

IN CPU host name or physical location of the signing.

reason: ASConstText

IN Reason for signing the document.

contactInfo: ASConstText

IN Information provided by the signer to enable recipients to contact signer for signature verification.

displayTraits: ASInt32

IN DisplayTraits fields to display as part of signature appearance.

Returns
void

PDSignDocWithParams

void PDSignDocWithParams(PDDoc doc, PDSignDocSaveParams saveParams, PDSignDocSignParams signParams)
DLExtrasProcs.h:1525

Adds a digital signature to a document. It is expected that the PDSignDocSaveParams and PDSignDocSignParams structure definitions have been set by the user prior to signing a document. If the document has not been previously signed, signs and saves the entire document. If the document has been previously signed, signs and saves only the portions of the document that have changed. If the document has been previously signed and the path to which the file is saved is NULL or the same as the path specified by the parameter, doc, signs and copies the document, saving only the portions of the document that have changed.

Parameters
doc: PDDoc

IN/OUT The PDF document object.

saveParams: PDSignDocSaveParams

IN A PDSignDocSaveParams structure specifying how the document should be saved.

signParams: PDSignDocSignParams

IN A PDSignDocSignParams structure specifying how the document should be signed.

Returns
void

Structures(5)

PDSignDocSaveParams

typedef struct _t_PDSignDocSaveParams* PDSignDocSaveParams
DLExtrasExpT.h:690

Type that specifies the parameters required for saving the document to which a digital signature is added.

QREncodeParams

typedef struct _t_QREncodeParamsRec* QREncodeParams
DLExtrasExpT.h:742

An opaque type collecting together QREncodeParams parameters.

Enums(11)

AC_OptionCode

DLExtrasExpT.h:22

Datalogics-specific flags for the Acro Color Layer.

Values
AC_Option_BlackPointCompensation
—

Controls whether to adjust for differences in black points when converting colors between color spaces. If enabled the full dynamic range of the source space is mapped into the full dynamic range of the destination space. If disabled, the dynamic range of the source space is simulated in the destination space (which can result in blocked or gray shadows) This option is ignored if the rendering intent for the transformation is AC_AbsColorimetric. Default is 0 (zero).

AC_Option_Dither8
—

Dither transformations to 8 bit color spaces. This may be ignored by optimized transforms. This option is used by AC_ApplyTransform. Default is 0 (zero).

AC_OptionCode_MaxEnum
—

CredentialDataFmt

DLExtrasExpT.h:628

Enumeration to specify user-credential format.

Values
NonPFX
—

Base64-encoded or Binary DER (ASN.1 Distinguished Encoding Rules) format.

PFX
—

PKCS#12 format.

CredentialStorageFmt

DLExtrasExpT.h:636

Enumeration to specify whether user-credentials reside on-disk or are cached in memory.

Values
OnDisk
—

Credential resides on-disk.

InMemory
—

Credential is cached in memory.

DLImageCompression

DLExtrasExpT.h:462

Compression values for exporting TIF images.

Values
Compression_Default
—

Use the default for the output image type.

Compression_NONE
—

Use no image compression. Valid for BMP, PNG and TIFF outputs only.

Compression_FLATE
—

Deflate algorithm (PNG only). An open source standard widely used for creating zip files and with PDF.

Compression_LZW
—

Lempel-Ziv-Welch, valid for TIFF output. A lossless algorithm, resulting files are larger but retain original quality.

Compression_G3
—

CCITT Group3 compression. Valid for TIFF, requires colorModel gray. A lossless algorithm for black and white images that efficiently compresses whitespace.

Compression_G4
—

CCITT Group4 compression. Valid for TIFF, requires colorModel gray. A lossless algorithm for black and white images based on G3.

Compression_DCT
—

Discrete Cosine Transform. Lossy algorithm, valid for JPEG. Best when used with continuous tone (such as photographs).

DLImageExportType

DLExtrasExpT.h:446

Export Image Types.

Values
ExportType_Invalid
—

Used for error handling

ExportType_TIF
—

Tagged Image File Format

ExportType_JPEG
—

Joint Photographic Experts Group

ExportType_BMP
—

Microsoft Windows Bitmap

ExportType_PNG
—

Portable Network Graphic

ExportType_GIF
—

Graphics Interchange Format

DLTIFFByteOrder

DLExtrasExpT.h:479
Values
Order_BigEndian
—
Order_LittleEndian
—
HostEndian
—

DigestCategory

DLExtrasExpT.h:644

Enumeration to specify cryptographic hash functions that generate variable-length message digests required for digital signature creation.

Values
sha1
—

SHA-1 message digest comprised of a 160-bit hash value.

sha224
—

SHA-2 message digest comprised of a 224-bit hash value.

sha256
—

SHA-2 message digest comprised of a 256-bit hash value.

sha384
—

SHA-2 message digest comprised of a 384-bit hash value.

sha512
—

SHA-2 message digest comprised of a 512-bit hash value.

DisplayTraits

DLExtrasExpT.h:658

Enumeration to specify fields to display as part of signature appearance.

Values
kDisplayNone
—

Do not display text labels or logo image. Note that specifying this option results in an empty signature appearance.

kDisplayAll
—

Display all available text labels and logo image. Note that the application expects valid data to be supplied for each available label that will be displayed as a result of this option being selected.

kDisplayName
—

Display the Name label.

kDisplayReason
—

Display the Reason label.

kDisplayLocation
—

Display the Location label.

kDisplayDate
—

Display the Date label.

kDisplayContactInfo
—

Display the ContactInfo label.

kDisplayDN
—

Display the Signer Certificate's Distinguished Name label.

kDisplayLogo
—

Display logo image.

FontRescanFlags

DLExtrasExpT.h:73

flags for rescanning font directories for additional fonts after Library initialization.

Values
FontRescan_Files
—

This will rescan just the fields defined in dirList, plus those added with PDFLAddFontDirectories.

FontRescan_System
—

This will rescan the system directories.

FontRescan_All
—

This, or an "or" of the previous two, will rescan both.

SignatureFieldID

DLExtrasExpT.h:594

Enumeration to specify identifying information of the form field expected to contain the digital signature.

Values
SearchForFirstUnsignedField
—

Search for the first available signature field, i.e., a field that does not contain a signature. No new signature field is created if none found. Exception raised if not found.

FieldCosObject
—

Cos object of an existing signature field that does not contain a signature. No new signature field is created if not found. Exception raised if not found.

FullyQualifiedFieldName
—

Fully qualified field name of a valid T entry in an existing field dictionary that is expected to contain the digital signature. Refer PDF specification ISO 32000-2:2020, Section 12.7.4.2 for additional information. No new signature field is created if not found. Exception raised if not found.

CreateFieldWithQualifiedName
—

Creates a new signature field to be signed using the T-entry fully qualified field name provided. The signature field created will contain neither parent nor child entries, i.e., the partial field name is the same as the fully qualified field name, per PDF specification ISO 32000-2:2020 Section 12.7.4.2.

Field name provided shall not be separated by a period (.) character. Appearance of the generated signature field is determined by widget annotation attributes specified by signatureBoxInfo. If signatureBoxInfo is undefined, the annotation is not drawn, resulting in the creation of an invisible signature field on the first page.

SignatureType

DLExtrasExpT.h:693

Enumeration to specify the type of signature to be added to the document.

Values
CMS
—

Digital signature based on the Cryptographic Message Syntax (CMS) standard. CMS-based digital signatures contain embedded timestamps, per the RFC3161 specification.

RFC3161
—

Trusted timestamp based on the Time-Stamp Protocol (RFC3161). Timestamp signatures are not available on 32-bit Linux and 64-bit AIX systems.

PADES
—

PAdES B-T baseline and policy-based digital signatures per the ETSI EN 319 142 European Standard. PAdES signatures are not available on 32-bit Linux and 64-bit AIX systems.

Definitions(1)

JPXColorSpace

1 items

Functions(1)

Metadata

1 items

Functions(1)

PDDocGetXAPMetadataCompactOptional

ASText PDDocGetXAPMetadataCompactOptional(IN PDDoc pdDoc, IN ASBool enableCompactRDF)
PDMetadataProcs.h:573

Allow customer to get XML/RDF metadata in a full (non-compact) form Gets the XMP metadata associated with a document. It returns an ASText whose text is the XML text of the XMP metadata associated with the document pdDoc . The ASText becomes the property of the client, which is free to alter or destroy it. The XMP metadata returned always represents all the properties in the pdDoc object's Info dictionary, and can also contain properties not present in the Info dictionary. This call is preferred to PDDocGetInfo(), which only returns properties that are in the Info dictionary (although the older function is supported for compatibility). The term XAP refers to an early internal code name for Adobe's Extensible Metadata Platform (XMP). For more information on this protocol, see the Adobe XMP specification.

Parameters
pdDoc: IN PDDoc

The document containing the metadata.

enableCompactRDF: IN ASBool

True if the XML/RDF output is in compact form.

Returns
ASText

An ASText object containing the XMP metadata associated with the document pdDoc.

See Also
PDDocGetXAPMetadataPropertyPDDocSetXAPMetadataPDDocSetXAPMetadataProperty

PDDoc

47 items

Functions(35)

PDDocDeletePagesEx

void PDDocDeletePagesEx(IN PDDoc doc, ASInt32 firstPage, ASInt32 lastPage, ProgressMonitor progMon, void *progMonClientData, PDPageDeleteFlags flags)
DLExtrasProcs.h:899

Deletes the specified pages.

Parameters
doc: IN PDDoc

The document from which pages are deleted.

firstPage: ASInt32

The page number of the first page to delete. The first page is 0 .

lastPage: ASInt32

The page number of the last page to delete.

progMon: ProgressMonitor

A progress monitor. Use AVAppGetDocProgressMonitor() to obtain the default progress monitor. NULL may be passed, in which case no progress monitor is used.

progMonClientData: void *

A pointer to user-supplied datapassed to progMon each time it is called. It should be NULL if progMon is NULL .

flags: PDPageDeleteFlags

Page Deletion flags that can be used to modify the how the deletion process works.

Returns
void

PDDocEmbedFonts

void PDDocEmbedFonts(PDDoc doc, ASUns32 flags, ASStatusMonitorProcs statusMon)
DLExtrasProcs.h:197

Routine to embed unembedded fonts in a document. If the font has information indicating that it cannot be embedded for print and preview, the font will not be embedded in the document.

Parameters
doc: PDDoc

PDDoc to operate on. The fonts will be embedded in this document. To keep the changes the document must be saved. Fonts on the user's system that match the original font definition will be embedded. For the Times Roman and Helvetica and corresponding styles, if displayed with a font alias, then the font alias will be embedded in the file. If the font has information that indicates the font cannot be embedded for print and preview, the font will not be embedded in the document.

flags: ASUns32

One of the following:

kDocEmbedSubset

If set fonts will be subset when embedded. Otherwise the entire font will be embedded. Full fonts should only be embedded if the information in the fonts indicates it can be used for editible embedding. Fonts that have more than 2048 characters will be subset embedded regardless of the setting of this flag.

kDocEmbedSubsetOfEmbeddedFont

If set, fonts that have already been embedded but are not subset fonts, will be reembedded as a subset font.

statusMon: ASStatusMonitorProcs

Pointer to a record containing a Progress Monitor, Cancel procedure, and report procedure. The procedures in the progress monitor are called to indicate the progress of the routine. The cancel procedure is called periodically to allow the client to cancel the routine. If the cancel procedure returns false then the routine is canceled. The report procedure will be called to report errors or warnings while embedding the fonts. For each font that cannot be embedded, the report procedure will be called.

Returns
void
See Also
PDDocEmbedFontsFromFontArray

PDDocEmbedFontsFromFontArray

void PDDocEmbedFontsFromFontArray(PDDoc doc, const PDFont *fonts, ASUns32 nFonts, ASUns32 flags, ASStatusMonitorProcs statusMon)
DLExtrasProcs.h:240

Routine to embed fonts in a document. This will embed only the fonts listed in an array. The parameters to this routine are them same as described for PDDocEmbedFonts. With the exception of the additional fonts and nFonts parameters described below. If the font has information indicating that it cannot be embedded for print and preview, then the font will not be embedded in the document.

Parameters
doc: PDDoc

PDDoc to operate on. The fonts will be embedded in this document. To keep the changes the document must be saved. Fonts on the user's system that match the original font definition will be embedded. For the Times Roman and Helvetica and corresponding styles, if displayed with a font alias, then the font alias will be embedded in the file. If the font has information that indicates the font cannot be embedded for print and preview, then the font will not be embedded in the document.

fonts: const PDFont *

An array of PDFont containing fonts to be embedded.

nFonts: ASUns32

The number of fonts in the fonts array.

flags: ASUns32

One of the following:

kDocEmbedSubset

If set fonts will be subset when embedded. Otherwise the entire font will be embedded. Full fonts should only be embedded if the information in the fonts indicates it can be used for editible embedding. Fonts that have more than 2048 characters will be subset embedded regardless of the setting of this flag.

kDocEmbedSubsetOfEmbeddedFont

If set, fonts that have already been embedded but are not subset fonts, will be reembedded as a subset font.

statusMon: ASStatusMonitorProcs

Pointer to a record containing a Progress Monitor, Cancel procedure, and report procedure. The procedures in the progress monitor are called to indicate the progress of the routine. The cancel procedure is called periodically to allow the client to cancel the routine. If the cancel procedure returns false then the routine is canceled. The report procedure will be called to report errors or warnings while embedding the fonts. For each font that cannot be embedded, the report procedure will be called.

Returns
void
See Also
PDDocEmbedFonts

PDDocFlattenAcroFormFieldsAsIfPrinted

void PDDocFlattenAcroFormFieldsAsIfPrinted(PDDoc doc)
DLExtrasProcs.h:1489

Flatten a AcroForms Document as if printed. Flattening transforms the document into static PDF page content. All AcroForm fields are removed. The Flattened appearance will take into consideration how the document's appearance should look when printed.

Parameters
doc: PDDoc

IN/OUT The PDF document object.

Returns
void

PDDocOptimizeDefaultParams

PDFOptimizationParams PDDocOptimizeDefaultParams(void)
DLExtrasProcs.h:647

This will create a set of optimization parameters, set to the default values. These can be examined using "get" methods, and changed with the "set" methods When these parameters are no longer needed (after the call to PDDocumentOptimize, although they be re-used any number of times), they should be freed by the method PDDocOptimizeReleaseParams.

Parameters
: void
Returns
PDFOptimizationParams

initialized optimization parameters that can be further modified.

See Also
PDDocOptimizeReleaseParams

PDDocOptimizeGetImageRecompress

void PDDocOptimizeGetImageRecompress(PDFOptimizationParams Params, PDFOptimizerCompressImageType imageType, ASInt16 *recompressIfAbove, ASInt16 *recompressTo, PDFOptimizerCompressionType *compressType, PDFOptimizationCompressQuality *compressQuality)
DLExtrasProcs.h:729

This will return the values set for one of the three cases of Image Recompression and Downsampling. These values are used in deciding which Images from the set of all Images in the document will be modified by the Optimizer.

Parameters
Params: PDFOptimizationParams

IN a PDFOptimizationParams object to be checked

imageType: PDFOptimizerCompressImageType

OUT The class of Images these parameters are to refer to.

recompressIfAbove: ASInt16 *

OUT The lower limit of resolution (In DPI) of an Image to be Resampled.

recompressTo: ASInt16 *

OUT The target DPI for Resampling. Images which are Resampled will be changed to this resolution.

compressType: PDFOptimizerCompressionType *

OUT a member of the enumeration PDFOptimizerCompressionType.

compressQuality: PDFOptimizationCompressQuality *

OUT a member of the enumeration PDFOptimizationCompressQuality

Returns
void
See Also
PDDocOptimizeSetImageRecompress

PDDocOptimizeSetImageRecompress

void PDDocOptimizeSetImageRecompress(PDFOptimizationParams Params, PDFOptimizerCompressImageType imageType, ASInt16 recompressIfAbove, ASInt16 recompressTo, PDFOptimizerCompressionType compressType, PDFOptimizationCompressQuality compressQuality)
DLExtrasProcs.h:712

This will set the value for one of the cases of Image Recompression and Downsampling. These values are used in deciding which Images from the set of all Images in the document will be modified by the Optimizer.

Parameters
Params: PDFOptimizationParams

IN a PDFOptimizationParams object to be modified

imageType: PDFOptimizerCompressImageType

IN The class of Images these parameters are to refer to. This is a member of the Enumeration PDFOptimizerCompressImageType and is one of the set of values "Color", "Gray", or "Monochrome" (B/W).

recompressIfAbove: ASInt16

IN The lower limit of resolution (In DPI) of an Image to be Resampled. Only Images above this limitation will be considered for Resampling.

recompressTo: ASInt16

IN The target DPI for Resampling. Images which are Resampled will be changed to this resolution.

compressType: PDFOptimizerCompressionType

IN a member of the enumeration PDFOptimizerCompressionType. Images which are either Resampled or Recompressed will be written in this compression type. If the value of this enumeration is either the specifier for "Same", or for "None", then we will not Recompress images which do not require Downsampling.

compressQuality: PDFOptimizationCompressQuality

IN a member of the enumeration PDFOptimizationCompressQuality. NOTE that this enumeration is only meaningful for lossy compression techniques. Note also that it is an error to specify "Lossless" for techniques that cannot support lossless compression.

Returns
void
See Also
PDDocOptimizeGetImageRecompress

PDDocOptimizeSetOption

void PDDocOptimizeSetOption(PDFOptimizationParams Params, PDFOptimizerOption option, ASBool OnOff)
DLExtrasProcs.h:741

This will set one the optimzation option either ON or OFF.

Parameters
Params: PDFOptimizationParams

IN. A PDFOptimizationParams object to be modified

option: PDFOptimizerOption

IN. A member of the enumeration PDFOptimizerOption, selecting which option to effect.

OnOff: ASBool

IN. If true, set the associated option as ON. If false, set it as OFF.

Returns
void
See Also
PDDocOptimizeGetOption

PDDocQREncodeParamsDefault

QREncodeParams PDDocQREncodeParamsDefault(void)
DLExtrasProcs.h:1871

This will create a set of Encode Parameters, set to the default values. These can be examined using "get" methods, and changed with the "set" methods When these parameters are no longer needed, they should be freed by the method PDDocQREncodeParamsRelease.

Parameters
: void
Returns
QREncodeParams

initialized parameters that can be further modified. NOTE: Typical usage is to specify where the code should be located, what size it should be, what should be encoded etc. The default values are prepopulated to be a small visible barcode on a typical page size.

See Also
PDDocQREncodeParamsRelease

PDDocRemoveAttachment

void PDDocRemoveAttachment(PDDoc doc, char *attachmentNameToRemove)
DLExtrasProcs.h:1497

Removes a PDF attachment that matches the specified name.

Parameters
doc: PDDoc

IN The PDF document object.

attachmentNameToRemove: char *

IN The attachment name to remove, this should be a null terminated string.

Returns
void

PDDocReplaceUnembeddedSimpleFonts

void PDDocReplaceUnembeddedSimpleFonts(PDDoc doc, ASAtom *currentFontNames, ASAtom *newFontNames, ASUns32 fontNamesLength)
DLExtrasProcs.h:853

NOTE: This method should only be used by advanced users. It is useful for applications that need to define precise font substitutions for unembedded fonts rather than relying on the PDF Viewer to find a suitable font on the local system. If you choose a new font replacement that is not similar to the font being replaced, in terms of encoding, metrics, and glyphs, your result may appear distorted or incorrect in a variety of ways. The user must take care when selecting a replacement font. This method replaces Simple (not Type 0 or Composite), Unembedded, non-subset Fonts with a different font. NOTE: Fonts that lack required dictionary entries (e.g. /FontDescriptor) will have default ones created.

Parameters
doc: PDDoc
currentFontNames: ASAtom *
newFontNames: ASAtom *
fontNamesLength: ASUns32
Returns
void

PDDocumentOptimize

ASBool PDDocumentOptimize(PDDoc InputDoc, ASPathName OutputPath, ASFileSys fileSys, PDFOptimizationParams params, ProgressMonitor progMon, void *progMonClientData, ASCancelProc cancelProc, void *cancelProcClientData)
DLExtrasProcs.h:633

This function is used to create an optimized document. The types of Optimization performed depend on the optimization parameters. The result of optimization is a new document, saved to a file.

Parameters
InputDoc: PDDoc
OutputPath: ASPathName
fileSys: ASFileSys
params: PDFOptimizationParams
progMon: ProgressMonitor
progMonClientData: void *
cancelProc: ASCancelProc
cancelProcClientData: void *
Returns
ASBool

PDDocumentOptimizeWithReport

ASBool PDDocumentOptimizeWithReport(PDDoc InputDoc, ASPathName OutputPath, ASFileSys fileSys, PDFOptimizationParams params, ProgressMonitor progMon, void *progMonClientData, ASCancelProc cancelProc, void *cancelProcClientData, PDFOptimizerReport report)
DLExtrasProcs.h:834

This facility is used to create an optimized copy of the original document. Optimization can be in many specific forms, controlled by control records input to the optimizer. The result of optimization is always a new document, saved to a file. This is because some of the optimizations are done at Document save time.

Parameters
InputDoc: PDDoc
OutputPath: ASPathName
fileSys: ASFileSys
params: PDFOptimizationParams
progMon: ProgressMonitor
progMonClientData: void *
cancelProc: ASCancelProc
cancelProcClientData: void *
report: PDFOptimizerReport
Returns
ASBool

Structures(5)

PDDocTextFinder

typedef struct _t_PDDocTextFinder* PDDocTextFinder
DLExtrasExpT.h:395

Extracts words or phrases that match a regular expression (regex) on a given page range or on all of the pages in a document.

Enums(7)

PDDocEmbedFontFlags

DLExtrasExpT.h:50

Flags for PDDocEmbedFonts.

Values
kDocEmbedSubset
—

Fonts will be subset when embedded. Otherwise the entire font will be embedded. Full fonts should only be embedded if the information in the fonts indicates it can be used for editible embedding. Fonts that have more than 2048 characters will be subset embedded regardless of the setting of this flag.

This flag implies a scan of the document text to ensure that all required characters are in the subset.

kDocEmbedSubsetOfEmbeddedFont
—

If set, fonts that have already been embedded but are not subset fonts, will be reembedded as a subset font.

If clear, already embedded fonts will not be re-scanned for embedding at all, subset or no.

PDFOptimizationCompressQuality

DLExtrasExpT.h:106

Compression quality options

Values
PDFOptimizerCompressQualityUnset
—
PDFOptimizerCompressMinimum
—
PDFOptimizerCompressLowQuality
—
PDFOptimizerCompressMediumQuality
—
PDFOptimizerCompressHighQuality
—
PDFOptimizerCompressMaximumQuality
—
PDFOptimizerCompressLossless
—

PDFOptimizerCompressImageType

DLExtrasExpT.h:117

Image types for PDFOptimizer compression

Values
PDFOptimizerColor
—

Compress colored images

PDFOptimizerGray
—

Compress Gray scale Images

PDFOptimizerMonochrome
—

Compress B/W images

PDFOptimizerCompressionType

DLExtrasExpT.h:84

types of compression for PDFOptimizer

Values
PDFOptimizerRecompressNone
—

Used only when original image is not compressed

PDFOptimizerRecompressSame
—

Compress using the same compression

PDFOptimizerRecompressFlate
—

Compress image using Flate

PDFOptimizerRecompressJpeg
—

Compress image using Jpeg

PDFOptimizerRecompressJP2k
—

Compress image using JPEG2000

PDFOptimizerRecompressJBig
—

Compress image using JBig2

PDFOptimizerRecompressCCITTG4
—

Compress image using CCITTG4

PDFOptimizerRecompressCCITTG3
—

Compress image using CCITTG3

PDFOptimizerRecompressFlateJpeg
—

Compress using Flate and Jpeg

PDFOptimizerObjectCompressionType

DLExtrasExpT.h:127

Object Compression types for PDFOptimizer

Values
PDFOptimizerObjectCompressionAll
—

Compress all objects.

PDFOptimizerObjectCompressionNone
—

No object compression is used.

PDFOptimizerObjectCompressionStructure
—

Compress objects related to Logical Structure of a document.

PDFOptimizerObjectCompressionLeaveUnchanged
—

Leave object compression unchanged.

PDFOptimizerOption

DLExtrasExpT.h:143

PDFOptimizer Options

Values
PDFOptimizerDownsampleColor
—

Defaults to ON

PDFOptimizerRecompressColor
—

Defaults to ON

PDFOptimizerDownsampleGray
—

Defaults to ON

PDFOptimizerRecompressGray
—

Defaults to ON

PDFOptimizerDownsampleBW
—

Defaults to ON

PDFOptimizerRecompressBW
—

Defaults to ON

PDFOptimizerDownsampleRecompressOnlyIfSmaller
—

Defaults to ON

PDFOptimizerDiscardAlternateImages
—

Defaults to ON

PDFOptimizerSubsetAllEmbeddedFonts
—

Defaults to ON

PDFOptimizerRemoveAllEmbeddedFonts
—

Defaults to OFF

PDFOptimizerRemoveAllBase14Fonts
—

Defaults to ON

PDFOptimizerMergeDuplicateFonts
—

Defaults to ON

PDFOptimizerDiscardBookmarks
—

Defaults to OFF

PDFOptimizerDiscardAcroforms
—

Defaults to OFF

PDFOptimizerDiscardOutputIntent
—

Defaults to ON

PDFOptimizerDiscardThumbnails
—

Defaults to ON

PDFOptimizerDiscardPageLabels
—

Defaults to ON

PDFOptimizerDiscardNameTrees
—

Defaults to ON

PDFOptimizerDiscardStructureTrees
—

Defaults to ON

PDFOptimizerDiscardFileAttachments
—

Defaults to ON

PDFOptimizerDiscardXMPPadding
—

Defaults to ON Remove padding from XMP Metadata

PDFOptimizerDiscardUnusedForms
—

Defaults to ON

PDFOptimizerDiscardPieceData
—

Defaults to ON

PDFOptimizerCompressStreams
—

Defaults to ON, indicates if Uncompressed Streams will be compressed when possible.

PDFOptimizerReplaceLZW
—

Defaults to ON When set to false, the related option PDFOptimizerOptimizeContentStreams must also be disabled or Page /Contents that are LZW-compressed won't be affected.

PDFOptimizerDiscardMetadata
—

Defaults to ON

PDFOptimizerDiscardDocumentInfo
—

Defaults to ON

PDFOptimizerOptimizeContentStreams
—

Defaults to ON, indicates if Page /Contents will be compressed when possible by removing redundancies and utilizing Flate compression.

PDFOptimizerLinearize
—

Defaults to OFF

PDFOptimizerDiscardDuplicateForms
—

Defaults to OFF

PDFOptimizerDiscardDuplicateObjects
—

Defaults to ON

PDFOptimizerDiscardASCIIFilters
—

Defaults to ON

PDFOptimizerDiscardComments
—

Defaults to OFF, discards Markup Annotations

PDFOptimizerDiscardAnnotations
—

Defaults to OFF, discards any Annotation besides Widgets

PDFOptimizerDiscardJavaScriptActions
—

Defaults to OFF

PDFOptimizerFlattenOptionalContent
—

Defaults to OFF

PDFOptimizerResubsetSubsetFonts
—

Defaults to ON.

The related option PDFOptimizerSubsetAllEmbeddedFonts must be Enabled for this option to have an effect. Fonts which are already Embedded Subset will be Re-subset. If the document being optimized represents an extraction of pages from a larger document, or if the document has been edited to remove Content, this can result in savings. NOTE: This can ONLY remove glyphs from an already subset font. It doesn't add missing glyphs.

PDFOptimizerDownConvert16To8BpcImages
—

Defaults to ON

PDFOptimizerDiscardUnusedImages
—

Defaults to ON

PDFOptimizerDiscardUnusedFonts
—

Defaults to ON

PDFOptimizerIncludeIndexedImages
—

Defaults to ON. Controls if Indexed images are eligible for compression and downsampling or not. When true, if possible, Indexed images are recompressed and/or downsampled. When false, Indexed images aren't recompressed or downsampled.

PDFOptimizerDoNotPersistFileAttributes
—

Defaults to OFF

PDFOptimizerDoNotConvertDeviceNImages
—

Defaults to OFF

PDFOptimizerLastOption
—
See Also
PDDocOptimizeDefaultParamsPDDocumentOptimize

QRErrorCorrectionLevel

DLExtrasExpT.h:713

The Error Correction Level of the QR Code

Values
Low
—

Can tolerate 7% of bad codewords.

Medium
—

Can tolerate 15% of bad codewords.

Quartile
—

Can tolerate 25% of bad codewords.

High
—

Can tolerate 30% of bad codewords.

PDDocTextFinder

5 items

Functions(5)

PDDocTextFinderAcquireMatchList

PDDocTextFinderMatchList PDDocTextFinderAcquireMatchList(PDDocTextFinder mObj, PDDoc pdDoc, ASInt32 beginPageNumber, ASInt32 endPageNumber, const char *regexstr)
DLExtrasProcs.h:987

Finds all regular expression (regex) matches for the given page range. Only words within or partially within the page's crop box (see PDPageGetCropBox()) are included. Words outside the crop box are skipped. There can be only one match list in existence at a time; clients must release the previous match list, using PDDocTextFinderReleaseMatchList(), before creating a new one. Available only on Windows, Mac, and Linux platforms

Parameters
mObj: PDDocTextFinder
pdDoc: PDDoc
beginPageNumber: ASInt32
endPageNumber: ASInt32
regexstr: const char *
Returns
PDDocTextFinderMatchList

PDDocTextFinderCreate

PDDocTextFinder PDDocTextFinderCreate(PDWordFinderConfig wfConfig)
DLExtrasProcs.h:919

Creates a document text finder that is used to extract words or phrases that match regular expressions from a PDF file based on words extracted using a given word finder configuration. Available only on Windows, Mac, and Linux platforms

Parameters
wfConfig: PDWordFinderConfig
Returns
PDDocTextFinder

PDEContent

2 items

Functions(2)

PDEContentGetAttrsEx

void PDEContentGetAttrsEx(IN PDEContent pdeContent, OUT PDEContentAttrsExP attrsP, IN ASUns32 attrsSize)
PERProcs.h:3426

Obtains PDEContentAttrsEx , which gives matrix and bounding box in ASDouble Gets the attributes of a content.

Parameters
pdeContent: IN PDEContent

IN/OUT A content object.

attrsP: OUT PDEContentAttrsExP

IN/OUT (Filled by the method) A pointer to a PDEContentAttrsEx structure containing the attributes of the content.

attrsSize: IN ASUns32

IN/OUT The size of the attrsP buffer in bytes.

Returns
void

PDEContentToCosObjEx

void PDEContentToCosObjEx(IN PDEContent pdeContent, IN ASUns32 flags, IN PDEContentAttrsExP attrs, IN ASUns32 attrsSize, IN CosDoc cosDoc, IN PDEFilterArrayP filtersP, OUT CosObj *contentsP, OUT CosObj *resourcesP)
PEWProcs.h:108

This is the same as PDEContentToCosObj, above, except that the Content Attributes are passed as PDEContentAttrsEx , so as to allow for ASDouble Matrices and Bounding Boxes

Parameters
pdeContent: IN PDEContent
flags: IN ASUns32
attrs: IN PDEContentAttrsExP
attrsSize: IN ASUns32
cosDoc: IN CosDoc
filtersP: IN PDEFilterArrayP
contentsP: OUT CosObj *
resourcesP: OUT CosObj *
Returns
void

PDEFont

1 items

Functions(1)

PDEFontCheckASTextIsRepresentable

ASBool PDEFontCheckASTextIsRepresentable(const PDEFont font, const ASText text, ASUns32 *index)
DLExtrasProcs.h:338

Routine to check that the entire contents of an ASText are representable in the font. If the index parameter is not NULL and this function returns FALSE, the index will indicate the first character not representable in the font. An exception will be raised if the supplied font is incompatible with the API. Such may happen, for example, if font is a Type 1 font or if the font is retrieved from an existing PDF document.

Parameters
font: const PDEFont

The PDEFont to check against. Its type must be 'Type0' or 'TrueType'.

text: const ASText

An ASText containing the text to check

index: ASUns32 *

The index of the first character in the Unicode representation of the string that could not be represented in the font. May be NULL if the user wants to ignore this information.

Returns
ASBool

Whether the ASText is representable or not using the font.

PDEForm

7 items

Functions(7)

PDEFormCalcBBox

void PDEFormCalcBBox(PDEForm form)
DLExtrasProcs.h:616

This function allows the BBox stored in a form's XObject to be recalculated after its contents have been modified. The bounding box of a form is set in the COS form, and is usually not changed by any event in the conversions between PDE and COS content. This is done so that the user may set the bounding box of a form so as to specifically clip its contents to a given path (the bounding box). Sometimes the content of a form is changed, and then the user may want to reset the form's bounding box to the size of the current content.

Parameters
form: PDEForm

the PDEForm whose BBox should be recalculated.

Returns
void

PDEGraphicFont

1 items

Functions(1)

PDEImage

2 items

Functions(2)

PDEImageGetColorValue

void PDEImageGetColorValue(IN PDEImage image, IN PDEColorValueP color)
PERProcs.h:3364

Gets an image's Color Value. This call is valid only for a PDEImage which is an Image Mask

Parameters
image: IN PDEImage

IN/OUT The image whose data is obtained.

color: IN PDEColorValueP
Returns
void

PDEImageRemoveIndexedColor

PDEImage PDEImageRemoveIndexedColor(PDEImage image)
DLExtrasProcs.h:786

If the image input uses an indexed color space, a new image will be created from it. The new image will use the base color space. If the image is not using an indexed color model, the original image will be incremented and returned. The image returned must be released when no longer needed.

Parameters
image: PDEImage

The Indexed image inP .

Returns
PDEImage

The new image or the original image.

PDEImageJPX

1 items

Functions(1)

PDEImageJPXGetSMask

PDEImage PDEImageJPXGetSMask(PDEImageJPX pdeImageJPX)
DLExtrasProcs.h:1507

Retrieves the SoftMask image contained within the JPX-encoded data.

Parameters
pdeImageJPX: PDEImageJPX

IN The JP2K encoded image object. NOTE: The returned PDEImage must be released using PDERelease() when done using it.

Returns
PDEImage

The PDEImage representing the Soft Mask image of the JPX-encoded data if one is present, otherwise NULL.

PDEPS

1 items

Functions(1)

PDEPSGetCosObj

void PDEPSGetCosObj(IN PDEPS ps, OUT CosObj *cosObjP)
DLExtrasProcs.h:421

Get the CosObj for a Postscript Passthrough.

Parameters
ps: IN PDEPS

IN The PostScript XObject whose Cos object is obtained.

cosObjP: OUT CosObj *

OUT The Cos object of the PostScript XObject.

Returns
void

PDEPath

4 items

Functions(4)

PDEPathGetDataFloat

ASUns32 PDEPathGetDataFloat(IN PDEPath path, OUT ASFloat *data, IN ASUns32 dataSize)
PERProcs.h:3407

Superseded by PDEPathGetDataEx(). Get path using float-point values for coordinate values. This effectively removes the PDEPathGetData implementation limit that path coordinate values need to be no larger than +/-32767.0.

Parameters
path: IN PDEPath
data: OUT ASFloat *
dataSize: IN ASUns32
Returns
ASUns32

PDEText

2 items

Functions(2)

PDETextAddASText

void PDETextAddASText(PDEText pdeText, ASUns32 flags, ASInt32 index, ASText text, PDEFont font, PDEGraphicStateP gstateP, ASUns32 gstateLen, PDETextStateP tstateP, ASUns32 tstateLen, ASFixedMatrixP textMatrixP)
DLExtrasProcs.h:363

Adds a character or a text run to a PDEText object, taking them from the ASText; thus Unicode characters can be placed in the PDEText. This function will accept characters that are not representable in the given font; such characters will be replaced with the .notdef glyph. An exception will be raised if the supplied font is incompatible with the API. Such may happen, for example, if font is a Type 1 font or if the font is retrieved from an existing PDF document.

Parameters
pdeText: PDEText

The text object to which a character or text run is added.

flags: ASUns32

A PDETextFlags that specifies what kind of text to add.

index: ASInt32

The index after which to add the character or text run.

text: ASText

An ASText containing the text to add

font: PDEFont

The PDEFont for the element. Its type must be 'Type0' or 'TrueType'.

gstateP: PDEGraphicStateP

A pointer to a PDEGraphicStateP structure with the graphics state for the element.

gstateLen: ASUns32

The length of the graphics state for the element.

tstateP: PDETextStateP

A pointer to a PDETextState structure with the text state for the element.

tstateLen: ASUns32

The length of the text state for the element.

textMatrixP: ASFixedMatrixP

A pointer to an ASFixedMatrix that holds the matrix for the element.

Returns
void
See Also
PDEFontCheckASTextIsRepresentablePDETextGetASText

PDETextGetASText

void PDETextGetASText(PDEText pdeText, ASUns32 flags, ASInt32 index, ASText text)
DLExtrasProcs.h:412

Gets the text for a text run or character. The PDEFont associated with the PDEText must contain a ToUnicode table unless the descendant CIDFont uses the Adobe-GB1, Adobe-CNS1, Adobe-Japan1, or Adobe-Korea1 character collection.

Parameters
pdeText: PDEText

A text object containing a character or text run whose text is found

flags: ASUns32

A PDETextFlags that specifies whether index refers to a character or a text run.

index: ASInt32

The index of the character or text run in pdeText

text: ASText

An ASText that is filled with the text from the text item

Returns
void
See Also
PDETextAddASText

PDETextItem

2 items

Functions(2)

PDETextItemCreateASText

PDETextItem PDETextItemCreateASText(ASText text, PDEFont font, PDEGraphicStateP gStateP, ASUns32 gStateLen, PDETextStateP textStateP, ASUns32 textStateLen, ASFixedMatrixP textMatrixP)
DLExtrasProcs.h:385

Creates a text element containing a character or text run which can be added to a PDEText object. This function will accept characters that are not representable in the given font; such characters will be replaced with the .notdef glyph. An exception will be raised if the supplied font is incompatible with the API. Such may happen, for example, if font is a Type 1 font or if the font is retrieved from an existing PDF document.

Parameters
text: ASText

An ASText containing the text to add. Note that passing an ASText containing an empty string will throw a genErrBadParm.

font: PDEFont

The PDEFont for the element. Its type must be 'Type0' or 'TrueType'.

gStateP: PDEGraphicStateP

A pointer to a PDEGraphicStateP structure with the graphics state for the element.

gStateLen: ASUns32

The length of the graphics state for the element.

textStateP: PDETextStateP

A pointer to a PDETextState structure with the text state for the element. Note that PDFEdit ignores the wasSetFlags flag of the PDETextState structure, so you must initialize the PDETextState fields.

textStateLen: ASUns32

The length of the text state for the element.

textMatrixP: ASFixedMatrixP

A pointer to an ASFixedMatrix that holds the matrix for the element.

Returns
PDETextItem
See Also
PDETextItemCopyASText

PDFileAttachment

3 items

Functions(2)

Enums(1)

AFRelationship

DLExtrasExpT.h:745

Represents the relationship between the component of the PDF document that refers to this attachment and the file denoted by the attachment

Values
Source
—

Original source material.

Data
—

Information used to derive a visual presentation, e.g. table or graph.

Alternative
—

Alternative representation of content, e.g. audio.

Supplement
—

Supplemental representation of the original source or data that may be more easily consumable.

EncryptedPayload
—

Encrypted payload document that should be displayed if the Processor has the cryptographic filter needed to decrypt it.

FormData
—

Data associated with the AcroForm.

Schema
—

Schema definition for the associated object.

UnspecifiedOrUnknown
—

Relationship is not known or can't be described using of the other values.

PDFont

1 items

Functions(1)

PDFontXlateToUCSCanRaise

ASInt32 PDFontXlateToUCSCanRaise(PDFont fontP, ASUns8 *inP, ASInt32 inLen, ASUns8 *outP, ASInt32 outLen)
DLExtrasProcs.h:773

Translates a string from whatever encoding the PDFont uses to Unicode encoding. This may raise an error.

Parameters
fontP: PDFont

The font of the input string inP .

inP: ASUns8 *

A pointer to the string to translate.

inLen: ASInt32

The length of the inP buffer in bytes.

outP: ASUns8 *

(Filled by the method) A pointer to the translated string. If it is NULL , the method returns the size of the translated string.

outLen: ASInt32

The length of the outP buffer in bytes. If it is 0 , the method returns the size of the translated string.

Returns
ASInt32

The number of bytes in the translated string in outP .

See Also
PDFontXlateToUCS

PDPage

10 items

Functions(8)

PDPageDrawContentsToMemoryWithParams

ASSize_t PDPageDrawContentsToMemoryWithParams(PDPage page, PDPageDrawMParams drawParams)
DLExtrasProcs.h:49

Renders a page to memory. For use in rasterizing pages for viewing or previewing. This call supports the same rasterization parameters as PDPageDrawContentsToMemory, and also allows users to specify these additional arguments: The destination rectangle (in ASFixed or ASReal notation) The update rectangle (in ASFixed notation) The transformation matrix (in ASFixed or ASReal notation) The colorspace to use, as a named colorspace or as a color profile The rendering intent to use for rendering A request to ignore restrictions on content copying & page extraction Default profile for uncalibrated RGB

Parameters
page: PDPage

The PDPage to be rendered.

drawParams: PDPageDrawMParams

Set of parameters describing how to rasterize the supplied PDPage, rasterizing the PDPage into a memory buffer supplied in the parameter set.

Returns
ASSize_t

the size of the buffer required to rasterize the PDPage if the buffer is not supplied and the length of the buffer is specified as 0 .

See Also
PDPageDrawContentsToMemoryPDPageDrawContentsToWindowWithParams

PDPageDrawContentsToWindowWithParams

void PDPageDrawContentsToWindowWithParams(PDPage page, PDPageDrawWParams drawParams)
DLExtrasProcs.h:68

Renders a page to a (platform-dependent) window. For use in rasterizing pages for viewing or previewing. This API accepts a structure of type PDPageDrawWParams, which includes a set of ASReal-based values in the same manner as PDPageDrawContentsToMemoryWithParams. It is intended to address overflow or underflow issues with the ASFixed-based drawing APIs when rendering a page to a window object. Platform: (!MAC_PLATFORM || (MAC_PLATFORM && !AS_ARCH_64BIT))

Parameters
page: PDPage

The PDPage to be rendered.

drawParams: PDPageDrawWParams

Set of parameters describing how to rasterize the supplied PDPage to a platform-dependent window object.

Returns
void
See Also
PDPageDrawContentsToMemoryWithParams

PDPageSetBlendingProfile

void PDPageSetBlendingProfile(PDPage page, AC_Profile profile)
DLExtrasProcs.h:508

This function sets the blending profile for a PD page for the duration of of the PDPage. Effectively, this creates an isolated page level, a non-knockout transparency group with the specified profile for the page. This apparent group will be used in rendering the page, but it is not preserved when the document is saved. In order to create a persistent transparency group, the user must add a "Group" entry to the page dictionary.

Parameters
page: PDPage

The PDPage to be rendered.

profile: AC_Profile

The color blending profile to be used when rendering.

Returns
void

Structures(1)

Enums(1)

PDPageDeleteFlags

DLExtrasExpT.h:436

Page Deletion Flags.

Values
PDDeleteNormal
—

Normal page deletion.

PDDeleteDoNotParseStructureTree
—

Do not parse Structure Tree. For documents with a complicated Structure Tree, parsing can be exhorbitantly slow, set this flag to bypass processing it.

PDPref

17 items

Functions(17)

PDPrefGetPrintUsingWorkingSpaces

ASBool PDPrefGetPrintUsingWorkingSpaces(void)
DLExtrasProcs.h:534

This function returns whether the device spaces are treated as calibrated when rendering. This setting is only effective when the document is being rendered to memory, or a window, and kPDPageIsPrinting is true.

Parameters
: void
Returns
ASBool

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

See Also
PDPrefSetPrintUsingWorkingSpaces

PDPrefSetAllowRelaxedSyntax

void PDPrefSetAllowRelaxedSyntax(ASBool flag)
DLExtrasProcs.h:487

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).

Parameters
flag: ASBool

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

Returns
void
See Also
PDPrefGetAllowRelaxedSyntax

PDPrefSetAllowStringRetrievalFailingDecryption

void PDPrefSetAllowStringRetrievalFailingDecryption(ASBool allowStringRetrievalFailingDecryption)
DLExtrasProcs.h:872

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.

Parameters
allowStringRetrievalFailingDecryption: ASBool
Returns
void
See Also
PDPrefGetAllowStringRetrievalFailingDecryption

PDPrefSetNeverUseOutputIntent

void PDPrefSetNeverUseOutputIntent(ASBool value)
DLExtrasProcs.h:596

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. This setting defaults to false.

Parameters
value: ASBool
Returns
void
See Also
PDPrefGetPrintUsingWorkingSpacesPDPrefSetUseProfileIntent

PDPrefSetPrintUsingWorkingSpaces

void PDPrefSetPrintUsingWorkingSpaces(ASBool flag)
DLExtrasProcs.h:525

This function sets a flag to treat the device spaces as calibrated when rendering. This setting is only effective when the document is being rendered to memory, or a window, and kPDPageIsPrinting is true.

Parameters
flag: ASBool

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

Returns
void
See Also
PDPrefGetPrintUsingWorkingSpaces

PDSysFont

2 items

Functions(1)

PDSysFontGetFullName

ASText PDSysFontGetFullName(PDSysFont sysFont)
DLExtrasProcs.h:861

This method retrieves the full font name of a system font. Note: This method only returns a meaningful result for TrueType-based technology fonts.

Parameters
sysFont: PDSysFont
Returns
ASText

Enums(1)

PDSysFontMatchFlagsEx

DLExtrasExpT.h:576

Font matching flags for PDFindSysFont().

Values
kPDSysFontMatchNameAndCharSetEx
—

Match the font name and character set.

kPDSysFontMatchFontTypeEx
—

Match the font type.

kPDSysFontMatchWritingModeEx
—

Match the writing mode (horizontal or vertical).

kPDSysFontDontUseNameAsPrefixEx
—

The Legacy behavior of System Font Matching is when all conventional attempts have failed to yield a match to treat the entire font name as a prefix to match with available fonts. This behavior worked well for names with illegal characters or Unicode where matching is difficult, the user could provide the well-known part of the font name. However this prefix matching behavior isn't always desirable, using this flag will disable it

PDWord

3 items

Functions(3)

PDWordGetCharPoint

ASBool PDWordGetCharPoint(PDWord word, ASInt16 byteIdx, ASFixedPoint *point)
DLExtrasProcs.h:106

Gets the placement point of the character at a given index position in the word. If the specified character is constructed with multiple bytes, only the first byte returns a valid quad. Otherwise, this method returns false. The placement point is specified in user space coordinates.

Parameters
word: PDWord

The word whose character placement point is obtained.

byteIdx: ASInt16

The byte index within the word of the character whose placement point is obtained. Valid values are 0 to PDWordGetLength(word)-1.

point: ASFixedPoint *

(Filled by the method) Pointer to the character's placement point, specified in user-space coordinates.

Returns
ASBool

Returns true if the word has an nth quad, false otherwise.

See Also
PDWordGetCharQuad

PDWordGetNthQuadPoint

ASBool PDWordGetNthQuadPoint(PDWord word, ASInt16 nTh, ASFixedPoint *point)
DLExtrasProcs.h:86

Gets the specified word's nth quad placement point, specified in user space coordinates.

Parameters
word: PDWord

The word whose nth quad is obtained.

nTh: ASInt16

The quad placement point to obtain. A word's first quad has an index of zero.

point: ASFixedPoint *

(Filled by the method) Pointer to the word's nth quad placement point, specified in user-space coordinates.

Returns
ASBool

Returns true if the word has an nth quad, false otherwise.

See Also
PDWordGetNumQuads