DarkBASIC Professional Help File

DX11 GET FONT CHARACTER

Retrieves an individual character from a bitmap font as a pixel map.
Note that the returned pixel map is a system resource.
You cannot delete it yourself and it is volatile in the sense that it will be automatically
destroyed when the font is deleted. For that reason you should only use these pixel maps
in situations where you can guarantee that you will not delete the font until you are done with the pixel map(s).
A usage example is the built-in font printing function which uses SET PIXELMAP RECT to paste the
characters corresponding to a string onto a source pixel map of the required dimensions to hold it.
Also note that accessing a character that is not present in the font will return a null pointer.
You should check to ensure that is not the case before attempting to use the returned pixel map.

Syntax

    Return Dword pixelmap  = DX11 GET FONT CHARACTER(font, character)

Parameters

    font

> Dword
> The font from which to extract the character map.

    character

> Byte
> The ASCII code for the character to retrieve.

Returns

A pixel map containing the pixels that make up the specified character for the given font, or 0 if there is no such character in the font.

See also

FONT Functions Menu
DX11 Function Categories