Main Page | Modules | Related Pages

Text Functions

Functions


Function Documentation

void hel_CustomTextClear TCustomTextInfo *  pTextInfo  ) 
 

Clear the entire custom text background.

The hel_CustomTextClear function clears the entire custom text background using the space character.

Parameters:
pTextInfo Pointer to TCustomTextInfo structure
Remarks:
If the TextInformation specified by pTextInfo has no space character set, it will probably display garbage.
See also:
hel_CustomTextClearRow()

void hel_CustomTextClearRow TCustomTextInfo *  pTextInfo,
u32  y
 

Clear a row.

The hel_CustomTextClearRow function clears the row specified by y with the space character.

Parameters:
pTextInfo Pointer to TCustomTextInfo structure
y The row to clear
Remarks:
If the TextInformation specified by pTextInfo has no space character set, it will probably display garbage.
See also:
hel_CustomTextClear

void hel_CustomTextInit TCustomTextInfo *  pTextInfo,
void *  pSrcTiles,
u16  SizeU16,
u8  ColMode,
u8  PalNo,
u8  MapSize,
u8  MapRot
 

Initialize a custom textdraw system.

Parameters:
pTextInfo Pointer to TCustomTextInfo structure
pSrcTiles Pointer to the tile source data
SizeU16 Size of the tiles to be copied into Tile RAM, in number of 16bit chunks
ColMode Color mode of the tile set: 0 = 16colors/16 palettes 1 = 256 colors / 1 palette
PalNo When ColMode is 0, this parameter specifies the palette-bank (0..15)
MapSize The size of the map (0-3). This depends on the MapRot parameter! See ham_InitMapEmptySet for more information
MapRot 0 for normal map, 1 for a rotation map
Note:
The Custom Text-System only works in tilemode!
See also:
hel_CustomTextPrint, hel_CustomTextType

void hel_CustomTextPrint TCustomTextInfo *  pTextInfo,
u32  x,
u32  y,
char *  pText
 

Output a string on a tiles mode GBA screen.

The hel_CustomTextPrint function outputs a string to the GBA display, it does not support formatting.

Parameters:
pTextInfo Pointer to TCustomTextInfo structure
x X character number the string should start on
y Y character number the string should start on
pText The string to output
Note:
This function is faster than hel_CustomTextPrintFmt
See also:
hel_CustomTextInit, hel_CustomTextPrintFmt, hel_CustomTextType

void hel_CustomTextPrintFmt TCustomTextInfo *  pTextInfo,
u32  x,
u32  y,
char *  pFmt,
  ...
 

Output a formatted string on a tiles mode GBA screen.

The hel_CustomTextPrintFmt function outputs a formatted string to the GBA display.

Parameters:
pTextInfo Pointer to TCustomTextInfo structure
x X character number the string should start on
y Y character number the string should start on
pFmt The Format string (see "printf" documentation in your local C tutorial)
Note:
This function is slower than hel_CustomTextPrint.
See also:
hel_CustomTextInit, hel_CustomTextPrintFmt, hel_CustomTextType

u8 hel_CustomTextType TCustomTextInfo *  pTextInfo,
u32  x,
u32  y,
u8  Delay,
u16  Wait,
char *  pText
 

Output a string on a tiles mode GBA screen letter by letter.

The hel_CustomTextType function outputs a string to the GBA display letter by letter, like a typing machine.

Parameters:
pTextInfo Pointer to TCustomTextInfo structure
x X character number the string should start on
y Y character number the string should start on
Delay The Delay of typing. When calling this function once per VBL, it's usually specified in frames.
Wait The "time" to Wait after the entire text has been drawn. When calling this function once per VBL, it's usually specified in frames.
pText The string to output
Note:
This function does not support formatting.
Returns:
Returns TRUE when the entire text has been typed and the specified Wait value has been reached, otherwise FALSE.
See also:
hel_CustomTextInit, hel_CustomTextPrintFmt, hel_CustomTextType


Generated on Sun Oct 9 20:21:00 2005 by DoxyGen 1.4.4