# LoadFont

## Description

Loads a font file into AGK, typically in the TrueType format, but anything supported by FreeType should work. The szFontFile parameter can either be a font file located in your media folder or the name of a system font, this command will check your media folder first before checking for system fonts. If loading a system font then the file extension is optional, for example "Arial.ttf" and "Arial" would both load the system font "Arial" if it exists. When loading a system font the filename must not have any folder paths in the filename, i.e. no forward or backward slashes.
To improve performance you should only load a font once. For example if you wanted to use the "Arial" font in multiple places then you should load it into an ID then use that ID for all uses, rather than loading multiple copies of the Arial font file into separate IDs.

## Definition

LoadFont( iFontID, szFontFile )

void agk::LoadFont( UINT iFontID, const char *szFontFile )

integer LoadFont( szFontFile )

UINT agk::LoadFont( const char *szFontFile )

## Parameters

- iFontID - The ID to use to reference this font in future
- szFontFile - The filename of the font to load