# SetTextExtendedFontImage

## Description

Sets the extended font to use for this text object. 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. AGK has a built in extended font that it uses for text objects with characters 128 to 255, this command allows you to override it. If you are setting all your text objects to the same extended font you should use SetTextDefaultExtendedFontImage instead as this will save some processing time.
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 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 32 (space) in the top left and proceeding left to right, top to bottom, ending with ascii character 127 (DEL) in the bottom right. The image width must be divisible by 16 and the image height must be divisible by 6. 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 "32" up to and including "127" in the subimages file and any not found will default to the space character (32). Variable height characters are not supported and all characters must be the same height with any necessary padding included in the font image.
If this text object is using a TrueType font then this command has no affect, the TrueType font handles both normal and extended (unicode) characters.

## Definition

SetTextExtendedFontImage( iTextIndex, iImageID )

void agk::SetTextExtendedFontImage( UINT iTextIndex, UINT iImageID )

## Parameters

- iTextIndex - The ID of the text object to modify
- iImageID - The image containing the new font.