| Layer | PD_Layer |
| Object | PDCharProc |
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 | ||
|---|---|---|
| PDCharProc | ||
| Callback | ||
|---|---|---|
| PDCharProcEnumProc
A callback for PDFontEnumCharProcs(). It is called once for each character in a Type 3 font.
|
||
| Method | ||
|---|---|---|
|
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.
|
||
|
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.
|
||
| PDCharProc |
| Product availability: PDFL |
| Platform availability: Macintosh, Windows, UNIX |
typedef struct _t_PDCharProc* PDCharProc;
| File: PDExpT.h |
| Line: 2424 |
| PDCharProcEnumProc |
| Product availability: PDFL |
| Platform availability: Macintosh, Windows, UNIX |
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: 3022 |
| PDCharProcEnum | () |
| Product availability: PDFL |
| Platform availability: Macintosh, Windows, UNIX |
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 |
|
clientData — | A pointer to user-supplied data to pass to each monitor routine that is called. |
See Also
Since
| File: PDProcs.h |
| Line: 3953 |
| PDCharProcEnumWithParams | () |
| Product availability: PDFL |
| Platform availability: Macintosh, Windows, UNIX |
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
Since
| File: PDProcs.h |
| Line: 10436 |
| PDCharProcGetCosObj | () |
| Product availability: PDFL |
| Platform availability: Macintosh, Windows, UNIX |
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. |
The character procedure's stream Cos object. |
See Also
Since
| File: PDProcs.h |
| Line: 3967 |