ImageGear for C and C++ on Windows v21.0 - Updated
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
In This Topic
    IG_PDE_font_create_from_sysfont
    In This Topic

    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.