libtonc: Tilemap text

Tonclib

previous page next page

Tilemap text
[Tonc Text Engine]

Text for regular and affine tilemaps. More...

Regular tilemaps

void tte_init_se (int bgnr, u16 bgcnt, SCR_ENTRY se0, u32 clrs, u32 bupofs, const TFont *font, fnDrawg proc)
 Initialize text system for screen-entry fonts.
void se_erase (int left, int top, int right, int bottom)
 Erase part of the regular tilemap canvas.
void se_drawg_w8h8 (uint gid)
 Character-plot for reg BGs using an 8x8 font.
void se_drawg_w8h16 (uint gid)
 Character-plot for reg BGs using an 8x16 font.
void se_drawg (uint gid)
 Character-plot for reg BGs, any sized font.
void se_drawg_s (uint gid)
 Character-plot for reg BGs, any sized, vertically tiled font.

Affine tilemaps

void tte_init_ase (int bgnr, u16 bgcnt, u8 ase0, u32 clrs, u32 bupofs, const TFont *font, fnDrawg proc)
 Initialize text system for affine screen-entry fonts.
void ase_erase (int left, int top, int right, int bottom)
 Erase part of the affine tilemap canvas.
void ase_drawg_w8h8 (uint gid)
 Character-plot for affine BGs using an 8x8 font.
void ase_drawg_w8h16 (uint gid)
 Character-plot for affine BGs using an 8x16 font.
void ase_drawg (uint gid)
 Character-plot for affine Bgs, any size.
void ase_drawg_s (uint gid)
 Character-plot for affine BGs, any sized,vertically oriented font.

Detailed Description

Text for regular and affine tilemaps.

The tilemap sub-system loads the tiles into memory first, then writes to the map to show the letters. For this to work properly, the glyph sizes should be 8-pixel aligned.

Note:
At present, the regular tilemap text ignores screenblock boundaries, so 512px wide maps may not work properly.

Function Documentation

void tte_init_ase ( int  bgnr,
u16  bgcnt,
u8  ase0,
u32  clrs,
u32  bupofs,
const TFont *  font,
fnDrawg  proc 
)

Initialize text system for affine screen-entry fonts.

Parameters:
bgnr Number of background to be used for text.
bgcnt Background control flags.
ase0 Base screen entry. This allows a greater range in capabilities, like offset tile-starts.
clrs colors to use for the text. The palette entries used depends on ase0 and bupofs.
bupofs Flags for font bit-unpacking. Basically indicates pixel values (and hence palette use).
font Font to initialize with.
proc Character plotting procedure.

void tte_init_se ( int  bgnr,
u16  bgcnt,
SCR_ENTRY  se0,
u32  clrs,
u32  bupofs,
const TFont *  font,
fnDrawg  proc 
)

Initialize text system for screen-entry fonts.

Parameters:
bgnr Number of background to be used for text.
bgcnt Background control flags.
se0 Base screen entry. This allows a greater range in capabilities, like offset tile-starts and palettes.
clrs colors to use for the text. The palette entries used depends on se0 and bupofs.
bupofs Flags for font bit-unpacking. Basically indicates pixel values (and hence palette use).
font Font to initialize with.
proc Glyph renderer.

Generated on Mon Aug 25 17:03:57 2008 for libtonc by  doxygen 1.5.3

previous page start next page