IG_vect_drwng_detect_font
The function looks for the font with the specified typeface, weight, and vector flag.
Declaration:
|
Copy Code
|
AT_ERRCOUNT ACCUAPI IG_vect_drwng_detect_font(
HIG_VECT_DRWNG hDrwng,
LPCHAR* lpTypeface,
long nWeight,
VECT_BOOL bVector,
HIG_VECT_FONT* lpFont
);
|
Arguments:
Name |
Type |
Description |
hDrwng |
HIG_VECT_DRWNG |
Handle to the Drawing. |
lpTypeface |
LPCHAR* |
Type face of the font. |
nWeight |
long |
Font weight. |
bVector |
VECT_BOOL |
Flag that tells whether Vector or TrueType font is created. |
lpFont |
HIG_VECT_FONT* |
Buffer for the font handle. |
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 the font has been found, its handle is returned in lpFont. Otherwise the return value is NULL.
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.