#define MAX_PWCHARS 255 #define _BASIC_EXP_T_ 1 #define kPDEmitEasternTileMarks 0x0002 #define kPDEmitNoMarks 0 #define kPDEmitSlug 0x0004 #define kPDEmitWesternTileMarks 0x0001 kHSEmitFontNoFonts | Embed no fonts.
|
kHSEmitFontEmbeddedFonts | Emit all embedded fonts.
|
kHSEmitFontAllFonts | Emit all fonts.
|
kNormal | |
kTransparent | |
kOpaqueInk | |
kOpaqueIgnore |
Value options for PDCharSet.
PDUnknownCharSet=0 | The font does not use Adobe standard encoding.
|
PDStandardRomanCharSet=1 | The font uses Adobe standard encoding. This is determined by the
"Uses Adobe Standard Encoding" bit in the font descriptor. |
PDAdobeExpertCharSet=2 | Currently unused.
|
PDLastCharSet |
Value options for PDColorSpace.
PDDeviceGray | Grayscale. It requires one value entry to specify the color.
|
PDDeviceRGB | Red-Green-Blue color specification. It requires three value entries to specify the color.
|
PDDeviceCMYK | Cyan-Magenta-Yellow-Black color specification. It requires four value entries to specify the color.
|
kAnnotAll=0x0001 | Copy all annotations; do not consult annotation type list
|
kDoNotMergeFonts=0x0004 | Do not merge duplicate fonts on merge: may result in larger files when saved, but can show performance benefits when inserting a page that uses a large number of fonts.
|
PDEndStyle. kPDEndMiter | |
kPDEndOverlap |
Value options for PDFindFlags.
PDFindWholeWords=0x0001 | Find whole words only.
|
PDFindCaseSens=0x0002 | Perform a case-sensitive search.
|
PDFindReverse=0x0004 | Perform a reverse order search.
|
PDFindAllOnPage=0x0008 | Return a PDTextSelect with all found words on the page.
|
PDFindIgnoreFH=0x0100 | Do not perform a match of full-width/half-width Kana characters.
|
PDFindIgnoreDiacritics=0x0200 | Ignore diacritics.
|
PDFindReset=0x0800 | Reset to the beginning of the document.
|
PDHorizAlign. kPDHorizLeft=0 | |
kPDHorizCenter | |
kPDHorizRight |
PDInsertBookmarks=0x0001 | Insert bookmarks as well as pages.
|
PDInsertAll=0x1000 | Insert all Catalog and Info dictionary values as well as pages.
|
PDInsertThreads=0x0002 | Insert articles as well.
|
PDDoNotInsertOutputIntent=0x0004 | Do not merge output Intents
|
PDInsertDoNotMergeFonts=0x0008 | Do not merge duplicate fonts when merging documents. This may result in larger files when saved, but can show performance benefits when inserting a page that uses a large number of fonts.
|
PDInsertDoNotResolveInvalidStructureParentReferences=0x0010 | This is not necessary in most cases but it can show performance benefits for a document with a complicated Structure Tree.
|
PDInsertDoNotRemovePageInheritance=0x0020 | This can slow down the performance when document has a very large page tree
|
PDInsertNamedDestinations=0x0040 |
PDJoinStyle. kPDJoinMiter | |
kPDJoinRound | |
kPDJoinBevel |
Value options for PDPathPaintOp.
pdPathNoPaint=0 | The path is not painted.
|
pdPathOpClose=1 | The path contains a closepath operator.
|
pdPathStroke=2 | The path contains a stroke operator.
|
pdPathFill=4 | The path contains a fill operator.
|
pdPathEOFill=8 | The path contains an eofill operator.
|
pdPathClip=16 | The path contains a clip operator.
|
pdPathEOClip=32 | The path contains an eoclip operator.
|
Value options for PDPathSegmentOp.
pdSegMoveTo | |
pdSegLineTo | |
pdSegCurveTo | |
pdSegVCurveTo | |
pdSegYCurveTo | |
pdSegRect | |
pdSegClosePath |
PDPlacementTypes. kPDPlacementCenter | |
kPDPlacementChoke | |
kPDPlacementNeutralDensity | |
kPDPlacementSpread |
kEmitPlate | |
kDontEmitPlate | |
kConvertToProcess | Represents an ink used on a page.
|
kConvertToAltSpace | Can be used while doing color convert only. This is a matching flag for kColorConvToAltSpace flag in PDColorConvertActionType kConvertToProcess matches kColorConvConvert in PDColorConvertActionType kEmitPlate & kDontEmitPlate matches kColorConvPreserve in PDColorConvertActionType
|
kPDDefaultMarkType=0 | No flags means InDesign style printer marks.
|
kPDInDesignJ1MarkType | |
kPDInDesignJ2MarkType | |
kPDIllustratorMarkType | |
kPDIllustratorJ | |
kPDQuarkXPress |
typedef ASUns16 PDCharOffset; For value options see PDColorSpaces.
typedef ASEnum8 PDColorSpace; typedef const struct _t_PDColorValueRec *PDConstColorValue; struct. typedef struct _t_PDContent *PDContent; typedef ASInt32 PDCount; PDEndStyles. typedef ASEnum8 PDEndStyle; typedef struct _t_PDFind *PDFind; For value options see PDFindFlagTypes.
typedef ASEnum8 PDFindFlags; typedef struct _t_PDGraphicEnumMonitor *PDGraphicEnumMonitor; PDHorizAlignments. typedef ASEnum8 PDHorizAlign; typedef ASInt32 PDImageScalar; PDJoinStyles. typedef ASEnum8 PDJoinStyle; Did notifications have corresponding Will notifications.
For value options see PDOperations.
typedef ASEnum8 PDOperation; typedef struct _t_PDPathEnumMonitor *PDPathEnumMonitor; For value options see PDPathPaintOps.
typedef ASEnum8 PDPathPaintOp; For value options see PDPathSegmentOps.
typedef ASEnum8 PDPathSegmentOp; PDPlacementOptions. typedef ASEnum8 PDPlacementTypes; Note: PDPageEnumResources is provided only for backwards compatibility. You should use the PDFEdit API to enumerate page resources.
typedef struct _t_PDResourceEnumMonitor *PDResourceEnumMonitor; typedef struct _t_PDXObject *PDXObject; typedef struct _t_PDGraphic *PDGraphic, /* as well as the following subtypes of PDGraphic */ *PDText, *PDPath, *PDInlineImage; ASBool PDFindTranslateStringProc(char *string, ASInt32 stringLength, PDWord pdWord, void *clientData); ASBool PDGetDataProc(char *data, ASUns32 lenData, void *clientData); data | IN/OUT A buffer containing the XObject's data.
|
lenData | IN/OUT The amount of data in data in bytes.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDXObjectGetData().
|
setcachedevice) operator. ASBool PDGraphicEnumCacheDeviceProc(ASFixed *parms, void *clientData); parms | IN/OUT An array of numbers containing the 6 parameters passed to the d1 operator.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPageEnumContents().
|
setcharwidth) operator. ASBool PDGraphicEnumCharWidthProc(ASFixedPoint width, void *clientData); width | IN/OUT Array of numbers containing the two parameters passed to the d0 operator.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPageEnumContents().
|
ASBool PDGraphicEnumImageProc(PDInlineImage obj, void *clientData); obj | IN/OUT Image data.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPageEnumContents().
|
ASBool PDGraphicEnumPathProc(PDPath obj, void *clientData); obj | IN/OUT The path data.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPageEnumContents().
|
ASBool PDGraphicEnumRestoreProc(void *clientData); clientData | IN/OUT User-supplied data that was passed in the call to PDPageEnumContents().
|
ASBool PDGraphicEnumSaveProc(void *clientData); clientData | IN/OUT User-supplied data that was passed in the call to PDPageEnumContents().
|
ASBool PDGraphicEnumTextProc(PDText obj, void *clientData); obj | IN/OUT The text object.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPageEnumContents().
|
ASBool PDGraphicEnumXObjectRefMatrixProc(ASFixedMatrix *matrix, void *clientData); matrix | IN/OUT (Filled by the callback) The current transformation matrix for the subsequent XObject whose name is obtained by PDGraphicEnumXObjectRefProc().
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPageEnumContents().
|
ASBool PDGraphicEnumXObjectRefProc(char *name, ASFixedRect *bbox, void *clientData); name | IN/OUT The XObject's name.
|
bbox | IN/OUT The XObject's bounding box, describing the bounding box of the XObject in user space. This is only the case for top-level XObjects. If a Form XObject refers to another XObject, the second XObject's bounding box is the 'infinity' bounding box.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPageEnumContents().
|
void PDImplicitMetadataProc(PDDoc pdDoc, void *data); pdDoc | The document containing the metadata.
|
data | User-supplied data.
|
ASBool PDPathClosePathProc(void *clientData); clientData | IN/OUT User-supplied data that was passed in the call to PDPathEnum().
|
ASBool PDPathCurveToProc(ASFixedPoint *p1, ASFixedPoint *p2, ASFixedPoint *p3, void *clientData); p1 | The first point needed to specify the curve.
|
p2 | The second point needed to specify the curve.
|
p3 | The third point needed to specify the curve.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPathEnum().
|
ASBool PDPathLineToProc(ASFixedPoint *p1, void *clientData); p1 | IN/OUT The one point needed to specify the line's ending point.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPathEnum().
|
ASBool PDPathMoveToProc(ASFixedPoint *p1, void *clientData); p1 | IN/OUT The one point needed to specify the location to move to.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPathEnum().
|
ASBool PDPathRectProc(ASFixedPoint *p1, ASFixedPoint *p2, void *clientData); p1 | The first of two points needed to specify the rectangle.
|
p2 | The second of two points needed to specify the rectangle.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPathEnum().
|
ASBool PDPathVCurveToProc(ASFixedPoint *p1, ASFixedPoint *p2, void *clientData); p1 | The first of two points needed to specify the curve.
|
p2 | The second of two points needed to specify the curve.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDPathEnum().
|
ASBool PDPathYCurveToProc(ASFixedPoint *p1, ASFixedPoint *p2, void *clientData); p1 | The first of two points needed to specify the curve.
|
p2 | The second of two points needed to specify the curve.
|
clientData | IN/OUT User-supplied data passed in the call to PDPathEnum().
|
ASBool PDResourceEnumColorSpaceProc(char *name, CosObj colorSpace, void *clientData); name | IN/OUT The color space name.
|
colorSpace | IN/OUT The name of the color space as it appears in the Resources dictionary.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDFormEnumResources().
|
ASBool PDResourceEnumFontProc(PDFont font, char *name, void *clientData); font | IN/OUT The font.
|
name | IN/OUT The name of the font as it appears in the Resources dictionary.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDFormEnumResources().
|
ASBool PDResourceEnumProcSetProc(char *name, void *clientData); name | IN/OUT The name of the ProcSet as it appears in the Resources dictionary.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDFormEnumResources().
|
ASBool PDResourceEnumXObjectProc(PDXObject xObject, char *name, void *clientData); xObject | IN/OUT The XObject.
|
name | IN/OUT The name of the XObject as it appears in the Resources dictionary.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDFormEnumResources().
|
ASBool PDStringEnumProc(PDFont font, char *string, ASInt32 stringLen, ASFixed delta, void *clientData); font | IN/OUT The font used for
string. |
string | IN/OUT The string. It may be converted using PDFontXlateToHost() or PDFontXlateToUCS().
|
stringLen | IN/OUT The number of bytes in
string. |
delta | IN/OUT The difference, in thousandths of an EM, from the end of the previous string to the beginning of the current string. An EM is a typographic unit of measurement equal to the size of a font. For example, in a 12-point font, an EM is 12 points. See the description of the TJ operator in the section on Text-Showing Operators in ISO 32000-1:2008, Document Management-Portable Document Format-Part 1: PDF 1.7, section 9.4.3, page 250. You can find this document on the web store of the International Standards Organization (ISO). |
clientData | IN/OUT User-supplied data that was passed in the call to PDTextEnum().
|
ASBool PDXObjectFilterEnumProc(char *filter, CosObj decodeParms, void *clientData); filter | IN/OUT The filter's name.
|
decodeParms | IN/OUT The dictionary Cos object containing the filter's decode parameters.
|
clientData | IN/OUT User-supplied data that was passed in the call to PDXObjectEnumFilters().
|
| |
float trapWidth; | |
float blackWidth; | |
float imageTrapWidth; | |
float blackDensityLimit; | |
|
| |
|
| |
The size of the data structure.
| |
void *window; | A pointer to a platform-dependent window object (
HWND on Windows WindowPtr). On Windows, to draw into an offscreen DC, pass NULL for window. |
void *displayContext; | A platform-dependent display context structure (
HDC on Windows). |
A pointer to the matrix to concatenate onto the default page matrix. It is useful for converting from page to window coordinates and for scaling.
| |
See above. The only value you should use is
0. | |
A rectangle represented by the coordinates of its four sides.
| |
A procedure called periodically to check for the user's cancelling of the drawing operation. The default cancel procedure can be obtained using AVAppGetCancelProc(). It may be
NULL, in which case no cancel procedure is used. | |
void *cancelProcClientData; | |
An optional-content context that determines what contents are visible. This context is copied and the copy is used in drawing. This allows a client to change its copy of the context without raising an exception. | |
A pointer to a callback function for monitoring progress.
| |
void *progressProcClientData; | |
|
NULL for a callback to not enumerate that type of object. Each array element must be either NULL or a valid callback. Enumeration of the page contents halts if the callback returns false. Note: PDPageEnumContents is provided only for backwards compatibility. You should use the PDFEdit API to enumerate page contents.
| |
The size of the data structure. It must be set to
sizeof(PDGraphicEnumMonitorRec). | |
If non-
NULL, EnumXObjectRefMatrix is called immediately before EnumXObjectRef. It returns the current matrix for the subsequent XObject ref. | |
|
| |
An optional-content context that determines what contents are visible.
NULL uses the document's optional-content context, as returned by PDDocGetOCContext(pddoc), which is equivalent to calling the version of the method without optional-content parameters. This context is copied and the copy is used in drawing. This allows a client to change its copy of the context without raising an exception. | |
Filled by the method with the context that will be used during enumeration. This is a copy of the context specified by
clientOCContext. | |
The graphic enumeration monitor.
| |
void *monObj; | A pointer to user-supplied data to pass to the monitor.
|
|
| |
Current transformation matrix.
| |
Fill color.
| |
Stroke color.
| |
Fill color space.
| |
Stroke color space.
| |
Flatness tolerance.
| |
Line cap style.
| |
Dash phase.
| |
Length of dash array.
| |
Fixed to 10. The viewer has been extended to support dashes of any length.
| |
Line join style.
| |
Line width.
| |
Miter limit.
| |
|
A data structure containing information about the attributes of an image. See the description of Images in ISO 32000-1:2008, Document Management-Portable Document Format-Part 1: PDF 1.7, section 8.9, page 203.
You can find this document on the web store of the International Standards Organization (ISO).
| |
(Required) The width of the source image in samples.
| |
(Required) The height of the source image in samples.
| |
(Required) The number of bits used to represent each color component.
| |
(Optional) An array of numbers specifying the mapping from sample values in the image to values appropriate for the current color space.
| |
An ASAtom representing the color space name.
| |
(Optional) This is used if
isIndexed is true. Colors are specified by integers in the range 0 to hival. | |
(Required for images, not allowed for image masks) A Cos object of the color space used for the image samples.
| |
The length of the sample data in bytes.
| |
The number of components in
colorSpace. For instance, comps is 3 for an RGB color space. | |
|
| |
The size of the data structure. It must be set to
sizeof(PDPathEnumMonitorRec). | |
|
Note: PDPageEnumResources() is provided only for backwards compatibility. You should use the PDFEdit API to enumerate page resources.
| |
The size of the data structure. It must be set to
sizeof(PDResourceEnumMonitorRec). | |
|
| |
Text font.
| |
Character spacing.
| |
Word spacing.
| |
Horizontal scaling.
| |
Leading.
| |
Text rise.
| |
Text font size.
| |
Text rendering mode.
| |
Text matrix.
| |
|
Deprecated: use PDApplyFunctionEx instead
void PDApplyFunction(CosObj funcDict, const float inVals [], float outVals []); funcDict | The CosObj representing a function.
|
inVals | Input values.
|
outVals | Output values.
|
is raised if the CosObj is not a function dictionary.
|
void PDApplyFunctionEx(CosObj funcDict, const float inVals [], const ASArraySize nInput, float outVals [], const ASArraySize nOutput); funcDict | The CosObj representing a function.
|
inVals | Input values.
|
nInput | Number of input values.
|
outVals | Output values.
|
nOutput | Number of output values.
|
is raised if the CosObj is not a function dictionary or the number of i/o do not match with that of the function.
|
Draws the specified stream of PDF marking operators into the specified window. This method is used for platform-independent drawing of graphics and text.
This method changes the Current Transformation Matrix (CTM) and zoom factor for the current page. This leaves the file "dirty," or stale. The version of the file on the disk no longer matches the more current version in system memory.
void PDDrawCosObjToWindow(CosObj cosObj, void *window, void *displayContext, ASBool isDPS, ASFixedMatrix *matrix, ASFixedRect *updateRect, CancelProc cancelProc, void *cancelProcClientData); cosObj | The stream Cos object to draw into the window. This stream can be created using CosNewStream(). The stream's dictionary must contain a Resources key whose value is a dictionary specifying all the resources needed to draw the Cos object (including a ProcSet entry). Its structure and contents are the same as for the Resources dictionary for a Page object. See the description of Resource Dictionaries in ISO 32000-1:2008, Document Management-Portable Document Format-Part 1: PDF 1.7, section 7.8.3, on page 82.
You can find this document on the web store of the International Standards Organization (ISO).
See the description of the Content Stream Operators in Annex A of the ISO 32000-1:2008, Document Management-Portable Document Format-Part 1: PDF 1.7, Annex A.2, on page 643.
You can find this document on the web store of the International Standards Organization (ISO).
A pseudocode example of the stream object is:
|
window | A pointer to a platform-dependent window object (
HWND on Windows, WindowPtr). On Windows, to draw into an offscreen DC, pass NULL for window. |
displayContext | A pointer to a platform-dependent display context structure (
hDC on Windows). |
isDPS | Currently unused. Always set it to
false. |
matrix | A pointer to a matrix to concatenate onto the default page matrix. It is useful for scaling and for converting from page to window coordinates.
|
updateRect | A pointer to a rectangle, specified in user space coordinates. Any objects outside of
updateRect will not be drawn. All objects are drawn if updateRect is NULL. |
cancelProc | A procedure called periodically to check for the user's cancelling of the drawing operation. The default cancel proc can be obtained using AVAppGetCancelProc(). It may be
NULL, in which case no cancel proc is used. |
cancelProcClientData |
void PDDrawCosObjWithParams(CosObj cosObj, PDDrawParams params); cosObj | The object to draw.
|
params | The parameters with which to draw the object, including the optional-content context to use for content visibility.
|
void PDFormEnumPaintProcWithParams(PDXObject obj, PDGraphicEnumParams params); obj | The form whose drawing operations are enumerated.
|
params | The parameters, including the optional-content context to use for content visibility.
|
This method is obsolete and is provided only for backwards compatibility.
The method allows an image selector client to change the region of the page occupied by an image. It must only be used by image selector clients that return data for only the visible part of an image, to set the region of the page that the sub-image occupies. It must not be used otherwise.
This method only has an effect while displaying on the screen. It does nothing when printing.
The matrix set by this call remains in effect only for the current image. The Acrobat viewer automatically replaces it after the image has been drawn.
void PDImageSelAdjustMatrix(void *callData, ASFixedMatrix newUserMatrix); callData | The value passed to the image selector as a parameter to PDImageSelectAlternate().
|
newUserMatrix | The matrix that will replace the
imageToUserMatri (see PDImageSelGetGeoAttr()). The imageToDevMatrix is automatically calculated from newUserMatrix. |
This method is obsolete and provided only for backwards compatibility.
The method gets device-related attributes for a particular image XObject. It must only be used from within an image selector client, since it returns information that is only valid in that context. This method can be used by an image selector client to obtain additional information to help the selector determine which alternate image to choose.
If an image is displayed on two devices simultaneously (for example, if the window containing the image is split across two monitors in a multi-monitor system), the values returned for colorSpaceP and bitsPerPixelP are each the maximum for the devices on which the image is currently displayed. For example, if the image is currently split across the following devices:
colorSpaceP would be DeviceRGB, because that is the highest color space on which the image is currently displayed.
bitsPerPixelP would be 8, because that is the highest bit depth on which the image is currently displayed.
void PDImageSelGetDeviceAttr(void *callData, PDColorSpace *colorSpaceP, ASUns32 *bitsPerPixelP, ASAtom *deviceTypeP); callData | (Filled by the method) The value passed to the image selector as a parameter to PDImageSelectAlternate().
| ||||||||
colorSpaceP | (Filled by the method) The destination device's color space. It will be one of the following:
If the device has some other color space or its color space cannot be determined, PDDeviceRGB is returned. | ||||||||
bitsPerPixelP | (Filled by the method) The number of bits used for each pixel. For example, a device with 8 bits red, 8 bits green, and 8 bits blue would have a
bitsPerPixel of 24. If bitsPerPixelP has a value of 0 (instead of the more standard 1, 8, or 24), the number of bits per pixel on the output device could not be determined. | ||||||||
deviceTypeP | (Filled by the method) The output device type. It will be one of the following:
|
This method is obsolete and provided only for backwards compatibility.
The method requests geometry-related attributes of an image XObject. This method can be used by an image selector client to obtain additional information to help the selector determine which alternate image to choose.
void PDImageSelGetGeoAttr(void *callData, ASFixedRect *updateBBoxP, ASFixedMatrix *imageToDefaultMatrixP, ASFixedMatrix *imageToDevMatrixP); callData | (Filled by the method) The value passed to the image selector as a parameter to PDImageSelectAlternate().
|
updateBBoxP | (Filled by the method) The rectangle bounding the region of the page to update. This is the intersection of the visible portion of the page, any update regions, and any clipping paths that have been explicitly set in the PDF file. Its coordinates are specified in default user space.
|
imageToDefaultMatrixP |
In other words, this matrix provides the image's height, width, and position on the page, all in units of points (compare to |
imageToDevMatrixP | (Filled by the method) A matrix specifying the transformation from image space (the space in which all images are 1x1 unit) to device space (the space in which one unit is one pixel). This matrix provides the image's height, width, and position on the page, all in pixels (compare to
imageToDefaultMatrixP). |
void PDSetHostEncoding(ASHostEncoding encoding, char *parseTable);