LayerPD_Layer
ObjectPDCharProc

A PDCharProc is a character procedure, which is a stream of graphic operators (see PDGraphic) that draw a particular glyph of a Type 3 PostScript font.

A glyph is the visual representation of a character, part of a character, or even multiple characters. For example, a glyph can be a picture of the letter A, it can be an accent mark, such as grave (`), or it can be a picture of multiple characters such as the ligature fl, which represents the letters f and l. Glyphs can also be used to represent arbitrary symbols, such as in the font ITC Zapf Dingbats. Every glyph has a name in a Type 1, Multiple Master Type 1, or Type 3 font. In most TrueType fonts, glyphs are assigned names. In some TrueType fonts, the glyph names are implicit.

For information on Type 3 fonts, see Section 5.5.4 in the PDF Reference.

To determine the sequence of graphics operations used to draw one or more glyphs in a Type 3 font, use PDFontEnumCharProcs() to enumerate the glyphs in the font. Then use PDCharProcEnum() to enumerate the graphic operators in each glyph of interest.



Typedef Summary
 Typedef
 PDCharProc
Callback Summary
 Callback
 PDCharProcEnumProc
A callback for PDFontEnumCharProcs(). It is called once for each character in a Type 3 font.
Method Summary
 Method
 
void PDCharProcEnum(PDCharProc obj, PDGraphicEnumMonitor mon, void* clientData)
Enumerates the graphic description of a single character procedure for a Type 3 font. To enumerate all the character procedures in a Type 3 font (but not their graphic descriptions), use PDFontEnumCharProcs().
 
Enumerates the graphic description of a single character procedure for a Type 3 font, for those contents that are visible in a given optional-content context. The parameters include both the monitor and data you would pass to PDCharProcEnum(), and an optional-content context that determines which contents are visible.
 
Get the stream Cos object associated with the PDCharProc. This method does not copy the object, but is instead the logical equivalent of a type cast.

Typedefs Detail
PDCharProc 
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

typedef struct _t_PDCharProc* PDCharProc;

File: PDExpT.h
Line: 2421


Callbacks Detail
PDCharProcEnumProc 
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

ASBool (*PDCharProcEnumProc)(char *name, PDCharProc obj, void *clientData)

A callback for PDFontEnumCharProcs(). It is called once for each character in a Type 3 font.

See Also


File: PDExpT.h
Line: 3019

Method Detail
PDCharProcEnum()
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

void PDCharProcEnum(PDCharProc obj, PDGraphicEnumMonitor mon, void* clientData)

Enumerates the graphic description of a single character procedure for a Type 3 font. To enumerate all the character procedures in a Type 3 font (but not their graphic descriptions), use PDFontEnumCharProcs().

Parameters

obj — 

The character procedure whose graphic description is enumerated.

 
mon — 

A pointer to a structure containing user-supplied callbacks that are called for each drawing operator on a page. Enumeration halts if any procedure returns false.

 
clientData — 

A pointer to user-supplied data to pass to each monitor routine that is called.

See Also

Since

PI_PDMODEL_VERSION >= 0x00020000

File: PDProcs.h
Line: 3952
PDCharProcEnumWithParams() 
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

void PDCharProcEnumWithParams(PDCharProc obj, PDGraphicEnumParams params)

Enumerates the graphic description of a single character procedure for a Type 3 font, for those contents that are visible in a given optional-content context. The parameters include both the monitor and data you would pass to PDCharProcEnum(), and an optional-content context that determines which contents are visible.

Parameters

obj — 

The character procedure whose graphic descriptions are enumerated.

 
params — 

The parameters, including the optional-content context to use for content visibility.

See Also

Exceptions

pdPErrUnableToCreateRasterPort

Since

PI_PDMODEL_VERSION >= 0x00060000

File: PDProcs.h
Line: 10435
PDCharProcGetCosObj() 
Product availability: PDFL
Platform availability: Macintosh, Windows, UNIX

Syntax

CosObj PDCharProcGetCosObj(PDCharProc obj)

Get the stream Cos object associated with the PDCharProc. This method does not copy the object, but is instead the logical equivalent of a type cast.

Parameters

obj — 

IN/OUT The character procedure whose Cos object is obtained.

Returns

The character procedure's stream Cos object.

See Also

Since

PI_PDMODEL_VERSION >= 0x00020000

File: PDProcs.h
Line: 3966