The function creates a font by typeface and weight.

Declaration:

AT_ERRCOUNT ACCUAPI IG_vect_drwng_create_font(
        HIG_VECT_DRWNG hDrwng,
        LPCHAR* lpTypeface,
        long nWeight,
        VECT_BOOL bItalic
        VECT_BOOL bVector, 
        HIG_VECT_FONT* lpFont
);

Arguments:

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

None

Remarks:

If bVector is VECT_TRUE then an empty vector font is created. The user is responsible for creating every glyph of such font. Otherwise, a complete TrueType font is created.

This function does not support the creation of User Fonts. ImageGear only allows the loading of User Fonts embedded within vector images.

Drawing can use two font types:

• TrueType font - is created and controlled completely by the Drawing, based on the typeface name and weight. The user does not have access to individual glyphs of a TrueType font.

  If an empty typeface name is specified (either in the source file or via the API) then the typeface name specified in the VECTOR.DEFAULT_FONT_FAMILY global control parameter will be used. If the value of this parameter is an empty string, then the font is selected by the system according to other font parameters.

• Vector font - is empty just after it has been created by the Drawing. The user must set the size (number of glyphs) of the vector font and fill the Vertex Container of every glyph. The sample is the CAD font described in the .shx files. The CAD filter creates vector fonts contained in the .shx files. The user has complete control and responsibility for such fonts.