IG_PDE_font

Creates a new PDE Font from the specified parameters.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_PDE_font_create( LPAT_PDE_FONTATTRS lpAttrs, LONG nFirstCharIndex, LONG nLastCharIndex, LPSHORT lpWidths, LPSTR* lpEncoding, HIG_PDF_ATOM hEncodingBaseName, HIG_PDF_STREAM hFontStm, LONG nLen1, LONG nLen2, LONG nLen3, LPHIG_PDE_FONT lphFont );

Copy Code

AT_ERRCOUNT ACCUAPI IG_PDE_font_create(
        LPAT_PDE_FONTATTRS lpAttrs,
        LONG nFirstCharIndex,
        LONG nLastCharIndex,
        LPSHORT lpWidths,
        LPSTR* lpEncoding,
        HIG_PDF_ATOM hEncodingBaseName,
        HIG_PDF_STREAM hFontStm,
        LONG nLen1,
        LONG nLen2,
        LONG nLen3,
        LPHIG_PDE_FONT lphFont
);

Arguments:

Name	Type	Description
lpAttrs	LPAT_PDE_FONTATTRS	Pointer to AT_PDE_FONTATTRS for the font attributes.
nFirstCharIndex	LONG	First character index for the widths array, lpWidths.
nLastCharIndex	LONG	Last character index for the widths array, lpWidths.
lpWidths	LPSHORT	Widths array.
lpEncoding	LPSTR*	Array of 256 glyph names specifying the custom encoding. If any pointer is NULL, no encoding information is written for that entry.
hEncodingBaseName	HIG_PDF_ATOM	Encoding base name if the encoding is a custom encoding. If encoding is NULL, encodingBaseName is used as the value of the encoding, and must be one of WinAnsiEncoding, MacRomanEncoding, or MacExpertEncoding. If no encoding value is desired, use IG_PDF_ATOM_NULL.
hFontStm	HIG_PDF_STREAM	Stream with font information.
nLen1	LONG	Length in bytes of the ASCII portion of the Type 1 font file after it has been decoded. For other font formats, such as TrueType or CFF, only Len1 is used, and it is the size of the font.
nLen2	LONG	Length in bytes of the encrypted portion of the Type 1 font file after it has been decoded.
nLen3	LONG	Length in bytes of the portion of the Type 1 font file that contains the 512 zeros, plus the clear-to-mark operator, plus any following data.
lphFont	LPHIG_PDE_FONT	The specified PDE font.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The PDE Font may be represented as an embedded font (a FontFile entry in the font descriptor of the PDF file). To create a PDE Font that is stored as an embedded font, the FontFile stream may be passed in hFontStm, and the nLen1, nLen2, and nLen3 parameters contain the Length1, Length2, and Length3 values of the FontFile stream attributes dictionary. See Section 5.8 in the PDF Reference for more information about embedded fonts.

Call IG_PDE_font_release to dispose of the returned font object when finished with it.