# SetTextDefaultExtendedFontImage

## Description

Sets the default extended font to use for text objects. The extended font is for non standard characters above ascii value 127 and can be set separately to the standard characters so you can have multiple images for the extended set and a base image for the normal font characters.
The AGK has a built in extended font for characters 128 to 255 that it uses for text objects, this allows you to override it. If you do choose to override it you must do so before creating any text objects. You can set the font on a per text basis using SetTextExtendedFontImage. The image should contain all white characters surrounded by a transparent alpha channel. Fully transparent pixels should also contain white in their RGB components.
The extended font image may either be fixed width or variable width. For fixed width the font image must be laid out in a grid of 16 characters across and 8 characters down, starting with the ascii character 128 in the top left and proceeding left to right, top to bottom, ending with ascii character 255 in the bottom right. The image width must be divisible by 16 and the image height must be divisible by 8. For variable width the image must be an atlas texture accompanied by a subimages.txt file that states the location of each character on the image. The AGK will look for images "128" up to and including "255" in the subimages file and any not found will default to the space character (32).

## Definition

SetTextDefaultExtendedFontImage( iImageID )

void agk::SetTextDefaultExtendedFontImage( UINT iImageID )

## Parameters

- iImageID - The image containing the new font.