Alchemy
Loading...
Searching...
No Matches

credits.h File Reference

Go to the source code of this file.

Functions

void Graphics_ClearCharacterBlockAndPalette (s32 alternate)
 Fills 30 KB of 256-color tiles with color 1 and clears 128 palette colors.
void Graphics_LoadCharacterBlockAndPalette (u32 resourceId, s32 alternate)
 Loads a credits backdrop into one of the two tile/palette halves.
void DisplayScroll_BuildHblankWordTable (u32 *destination)
 Builds the 512 tilemap words surrounding a sliding credits backdrop: blank margins, 240 consecutive tile pairs, then a zero-filled tail.
void DisplayScroll_StepPositionEveryFourFrames (void)
 A VBlank task of the credits slideshow: drifts both backdrops together, keeping their horizontal offsets aligned throughout the crossfade.
s32 DisplayScroll_RunSlideshow (void)
 Crossfades the credits backdrop sequence through alternating tile banks while the staff names scroll over it, then restores the display for the following screen.
void DisplayScroll_UpdateObjects (void)
 A VBlank task scheduled by DisplayScroll_InitObjectTable: maps the visible sixteen rows onto the tile ring and uploads their sprites.
void DisplayScroll_RenderEnteringLine (void)
 A main-loop task scheduled by DisplayScroll_InitObjectTable: renders each entering line sixteen rows ahead of the visible top, into the hidden half of the tile ring.
void DisplayScroll_InitObjectTable (void)
 Allocates the credits sprites, builds the blank border and text rows, clears the tile ring and schedules scrolling and line rendering.
s32 DisplayScroll_DrawLine (const u8 *text, s32 firstTile, s32 alignment)
 Centers, right-aligns or left-aligns one credits line in a 192-pixel row.

Variables

const u32 gDisplayScroll_SlideResources []
 Battle backgrounds shown in the credits; 0 clears the display.
const void * gDisplayScroll_LineTable []
 Credits text, one row per line, terminated by 0.
const u8 gDisplayScroll_GlyphWidths [96]

Function Documentation

◆ Graphics_ClearCharacterBlockAndPalette()

void Graphics_ClearCharacterBlockAndPalette ( s32 alternate)

Fills 30 KB of 256-color tiles with color 1 and clears 128 palette colors.

Called by the credits slideshow before loading a backdrop into a half.

Parameters
alternate0 selects the first half (VRAM 0x06000000, palette 0-127). 1 selects the second half (VRAM 0x06008000, palette 128-255, fill 129).

Definition at line 57 of file credits.c.

Referenced by DisplayScroll_RunSlideshow(), Graphics_ClearCharacterBlockAndPalette(), and Graphics_LoadCharacterBlockAndPalette().

◆ Graphics_LoadCharacterBlockAndPalette()

void Graphics_LoadCharacterBlockAndPalette ( u32 resourceId,
s32 alternate )

Loads a credits backdrop into one of the two tile/palette halves.

A zero resource clears that half; the second half offsets its palette indices. Called by DisplayScroll_RunSlideshow for each picture.

Definition at line 122 of file credits.c.

Referenced by DisplayScroll_RunSlideshow(), and Graphics_LoadCharacterBlockAndPalette().

◆ DisplayScroll_BuildHblankWordTable()

void DisplayScroll_BuildHblankWordTable ( u32 * destination)

Builds the 512 tilemap words surrounding a sliding credits backdrop: blank margins, 240 consecutive tile pairs, then a zero-filled tail.

Called by DisplayScroll_RunSlideshow.

Definition at line 159 of file credits.c.

Referenced by DisplayScroll_BuildHblankWordTable(), and DisplayScroll_RunSlideshow().

◆ DisplayScroll_StepPositionEveryFourFrames()

void DisplayScroll_StepPositionEveryFourFrames ( void )

A VBlank task of the credits slideshow: drifts both backdrops together, keeping their horizontal offsets aligned throughout the crossfade.

Definition at line 191 of file credits.c.

Referenced by DisplayScroll_RunSlideshow(), and DisplayScroll_StepPositionEveryFourFrames().

◆ DisplayScroll_RunSlideshow()

s32 DisplayScroll_RunSlideshow ( void )

Crossfades the credits backdrop sequence through alternating tile banks while the staff names scroll over it, then restores the display for the following screen.

Reached through the scroll far-call table at the end of the game.

Definition at line 204 of file credits.c.

Referenced by DisplayScroll_RunSlideshow().

◆ DisplayScroll_UpdateObjects()

void DisplayScroll_UpdateObjects ( void )

A VBlank task scheduled by DisplayScroll_InitObjectTable: maps the visible sixteen rows onto the tile ring and uploads their sprites.

Advances one pixel every fourth frame until the end-of-text latch stops the scroll.

Definition at line 933 of file credits.c.

Referenced by DisplayScroll_InitObjectTable(), and DisplayScroll_UpdateObjects().

◆ DisplayScroll_RenderEnteringLine()

void DisplayScroll_RenderEnteringLine ( void )

A main-loop task scheduled by DisplayScroll_InitObjectTable: renders each entering line sixteen rows ahead of the visible top, into the hidden half of the tile ring.

A null table entry latches the end-of-text state.

Definition at line 961 of file credits.c.

Referenced by DisplayScroll_InitObjectTable(), and DisplayScroll_RenderEnteringLine().

◆ DisplayScroll_InitObjectTable()

void DisplayScroll_InitObjectTable ( void )

Allocates the credits sprites, builds the blank border and text rows, clears the tile ring and schedules scrolling and line rendering.

Called by DisplayScroll_RunSlideshow; the credits keep their state in borrowed flash-library cells (see the graphics README).

Definition at line 983 of file credits.c.

Referenced by DisplayScroll_InitObjectTable(), and DisplayScroll_RunSlideshow().

◆ DisplayScroll_DrawLine()

s32 DisplayScroll_DrawLine ( const u8 * text,
s32 firstTile,
s32 alignment )

Centers, right-aligns or left-aligns one credits line in a 192-pixel row.

Rasterizes its glyphs and shadow, packs 4-bit pixels and uploads 24 tiles beginning at firstTile. Called by the line-rendering task and, for the blank rows, by DisplayScroll_InitObjectTable. Returns -1 at the null end marker, otherwise zero.

Definition at line 1041 of file credits.c.

Referenced by DisplayScroll_DrawLine(), DisplayScroll_InitObjectTable(), and DisplayScroll_RenderEnteringLine().

Variable Documentation

◆ gDisplayScroll_SlideResources

const u32 gDisplayScroll_SlideResources[]
extern

Battle backgrounds shown in the credits; 0 clears the display.

Definition at line 82 of file credits.c.

Referenced by DisplayScroll_RunSlideshow().

◆ gDisplayScroll_LineTable

const void* gDisplayScroll_LineTable[]
extern

Credits text, one row per line, terminated by 0.

Definition at line 313 of file credits.c.

Referenced by DisplayScroll_InitObjectTable(), and DisplayScroll_RenderEnteringLine().

◆ gDisplayScroll_GlyphWidths

const u8 gDisplayScroll_GlyphWidths[96]
extern

Definition at line 7 of file glyph_widths.h.

Referenced by DisplayScroll_DrawLine().