====== 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 ====

lib3do.lib, fontlib.h

==== See Also ====

''%%LoadFont%%'', [[:documentation:development:opera:pf25:ppgfldr:smmfldr:ldofldr:01ldo204#xref40483|UnloadFont]]