Mapping Fonts

A font mapper is a VECTORFONTMAPPERCALLBACK callback function, defined by the user, which is used to set the font characteristics for any text added to the vector handle after calling L_VecSetFontMapper. If the font mapper callback function returns an error, then the changes to the LogFont will be ignored.

For example, consider the situation in which the user is loading a CGM file that contains text of font Arial. If a font mapper callback function has not been added using L_VecSetFontMapper, the user has no control over the font of the text, and it will be added to the vector drawing as Arial. If a font mapper callback function is added using the L_VecSetFontMapper function, before the CGM file is loaded, the user can catch the font of the text and change it to something such as Courier New. When the text that is part of the CGM file is added to the vector drawing, the text will appear as Courier New instead of Arial.

To get the current font mapper assigned to a vector handle, call L_VecGetFontMapper.