ImageGear for C and C++ on Windows v19.6 - Updated
IG_PDE_font_create_from_sysfont
API Reference Guide > PDF Component API Reference > PDF Component Objects Reference > Page Editing Objects and Elements > HIG_PDE_FONT > IG_PDE_font_create_from_sysfont

Creates a PDE Font corresponding to a font in the system.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_PDE_font_create_from_sysfont(
        HIG_PDF_SYSFONT hSysFont,
        LONG nCreateFlags,
        HIG_PDF_ATOM hSnapshotName,
        LPAT_PDF_FIXED mmDesignVec,
        LPHIG_PDE_FONT lphFont 
);

Arguments:

Name Type Description
hSysFont HIG_PDF_SYSFONT PDF system font object referencing a system font.
nCreateFlags LONG Indicates whether to embed the font and whether to subset the font. Must be one of enumIGPDEFontCreateFlags. If you want to subset a font, set both the IG_PDE_FONT_CREATE_EMBEDDED and IG_PDE_FONT_WILL_SUBSET flags.
hSnapshotName HIG_PDF_ATOM Name to be associated with this particular instantiation of the PDE Font.
mmDesignVec LPAT_PDF_FIXED Multiple master font design vector.
lphFont LPHIG_PDE_FONT The PDE Font corresponding to hSysFont.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

If the font is a multiple master font, mmDesignVec points to the design vector, whose length must equal the number of design axes of the font.

The enumIGPDEFontCreateFlags flags IG_PDE_FONT_CREATE_EMBEDDED and IG_PDE_FONT_WILL_SUBSET must both be set in order to subset a font.

If you create a PDE Font that is a subset, call IG_PDE_font_subset_now on this font afterwards.

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