ParseFont

Parses a font and prepare it for use.

Synopsis

FontDescriptor * ParseFont (void *fontImage)

Description

Parses an in-memory image of a font file, creating a FontDescriptor for it and preparing it for use. Use this function when you've loaded a font file yourself (using data streaming or some other custom I/O method) and you want to prepare the font for use by the font and text API routines.

Use UnloadFont() to release resources acquired by ParseFont(). You must release the font image memory yourself; UnloadFont() only releases resources acquired internally by ParseFont().

Arguments

fontImage: Pointer to a font file image that you have loaded into memory.

Return Value

Pointer to a FontDescriptor structure that describes the font; NULL if the image is not a valid font file, or there is not enough memory to create a FontDescriptor structure.

Associated Files