Functions
void	Title_UpdateIntroSprites (void)
	A VBlank task of the title intro, scheduled by Title_ShowIntro: places the rising sprites along the slope of the scrolling background, alternating two sets every other frame so twice as many show, hides the rest and copies the list to OAM.
void	Title_LoadIntroBackgrounds (void)
	Loads the title intro's two scrolling backgrounds and its sprite tiles, builds their maps and sets the blending and windows.
s32	Title_ShowIntro (s32 prompt)
	Plays the title intro: the backgrounds scroll down and the sprites rise until frame 278 (A or Start skips ahead), then the screen flashes white into the title picture.
void	Title_NoOpPalette (void)
	Unused palette entry retained in the far-call table.
s32	Title_ShowSplashScreen (s32 mode)
	Shows the Nintendo logo with its jingle.
s32	Title_ShowAnimatedSplash (void)
	Shows the Camelot logo for two seconds, cycling its four frames of tiles.
void	Graphics_NoOpColor (void)
	Unused color entry retained in the far-call table.
void	PaletteFade_ComputeSteps (s16 sourceComponents, s16 targetComponents, s16 *componentSteps, s32 frames)
	Computes each of the 1536 colour components' change per frame from the current components to the target (nothing when frames is not positive).
void	PaletteFade_Update (void)
	A task scheduled by PaletteFade_Init: steps the palette fade each frame, adding the step to every colour component until the fade is done, packs the components into the spare RGB555 copy of the palettes and queues both halves for VBlank.
void	Palette_Transform (u32 mode, u16 source, u16 destination, s32 paletteHalf)
	Transforms 512 source colours into destination components (three per colour, each in the high bits of a halfword).
void	PaletteFade_Init (void)
	Allocates the palette fade, saves both hardware palettes in it as the starting colours and schedules PaletteFade_Update.
void	PaletteFade_Release (void)
	Unschedules the palette fade and frees its buffers.
void	PaletteFade_SetTarget (s32 mode, s32 paletteHalf)
	Sets the fade target by transforming the saved background and/or sprite palettes through the requested mode.
void	PaletteFade_SetBackdrop (s32 color)
	Replaces the first saved colour, the backdrop. Nothing in ☀️ calls it.
void	PaletteFade_Start (s32 frames)
	Starts fading the shown colours to the target over the requested frames.
s32	Graphics_ClampRgb555Channel (s32 value)
	Clamps a five-bit colour channel to 0..31. Called by Palette_Transform.
s32	Graphics_ClampRgb555Component (s32 value)
	Caps a colour component at 0x7c00, the largest a five-bit channel shifted into the high bits reaches.

Variables
const u8	gTitle_IntroSpriteColumns []
	The x of each of the six columns of intro sprites.
const u8	gTitle_PromptBlendLevels [60]
	The prompt's blend level over its 60-frame pulse.

Function Documentation

◆ Title_UpdateIntroSprites()

void Title_UpdateIntroSprites ( void )

A VBlank task of the title intro, scheduled by Title_ShowIntro: places the rising sprites along the slope of the scrolling background, alternating two sets every other frame so twice as many show, hides the rest and copies the list to OAM.

Definition at line 112 of file intro.c.

Referenced by Title_ShowIntro(), and Title_UpdateIntroSprites().

◆ Title_LoadIntroBackgrounds()

void Title_LoadIntroBackgrounds ( void )

Loads the title intro's two scrolling backgrounds and its sprite tiles, builds their maps and sets the blending and windows.

Called by Title_ShowIntro.

Definition at line 177 of file intro.c.

Referenced by Title_LoadIntroBackgrounds(), and Title_ShowIntro().

◆ Title_ShowIntro()

s32 Title_ShowIntro ( s32 prompt )

Plays the title intro: the backgrounds scroll down and the sprites rise until frame 278 (A or Start skips ahead), then the screen flashes white into the title picture.

With prompt set the "Press Start" prompt pulses for up to a minute, otherwise the picture stays five seconds. Reached through the palette far-call table from the title screen. Returns 1 when A or Start was pressed on the title picture.

Definition at line 295 of file intro.c.

Referenced by Title_ShowIntro().

◆ Title_NoOpPalette()

void Title_NoOpPalette ( void )

Unused palette entry retained in the far-call table.

Definition at line 511 of file intro.c.

Referenced by Title_NoOpPalette().

◆ Title_ShowSplashScreen()

s32 Title_ShowSplashScreen ( s32 mode )

Shows the Nintendo logo with its jingle.

With mode 0 it fades in and holds two seconds; otherwise it waits a second, fades in, holds three seconds and fades out, faster once skipped. Called by Title_Run. Returns -1 when A or Start skipped it.

Definition at line 517 of file intro.c.

Referenced by Title_Run(), and Title_ShowSplashScreen().

◆ Title_ShowAnimatedSplash()

s32 Title_ShowAnimatedSplash ( void )

Shows the Camelot logo for two seconds, cycling its four frames of tiles.

A or Start ends it early. Reached through the palette far-call table from the title sequence. Returns 0.

Definition at line 609 of file intro.c.

Referenced by Title_ShowAnimatedSplash().

◆ Graphics_NoOpColor()

void Graphics_NoOpColor ( void )

Unused color entry retained in the far-call table.

Definition at line 665 of file intro.c.

Referenced by Graphics_NoOpColor().

◆ PaletteFade_ComputeSteps()

void PaletteFade_ComputeSteps	(	s16 *	sourceComponents,
		s16 *	targetComponents,
		s16 *	componentSteps,
		s32	frames )

Computes each of the 1536 colour components' change per frame from the current components to the target (nothing when frames is not positive).

Called by PaletteFade_Start.

Definition at line 673 of file intro.c.

Referenced by PaletteFade_ComputeSteps(), and PaletteFade_Start().

◆ PaletteFade_Update()

void PaletteFade_Update ( void )

A task scheduled by PaletteFade_Init: steps the palette fade each frame, adding the step to every colour component until the fade is done, packs the components into the spare RGB555 copy of the palettes and queues both halves for VBlank.

Definition at line 697 of file intro.c.

Referenced by PaletteFade_Init(), PaletteFade_Release(), and PaletteFade_Update().

◆ Palette_Transform()

void Palette_Transform	(	u32	mode,
		u16 *	source,
		u16 *	destination,
		s32	paletteHalf )

Transforms 512 source colours into destination components (three per colour, each in the high bits of a halfword).

mode picks the transform: a colour below 0x8000 fills every colour with it; 0x8000 takes that colour from source[0]; 0x10000 to 0x10007 are the whole-palette filters (plain, grey, sepia and the others); the TINT, BLEND and SPLIT flags carry a colour in their low bits; anything else is the address of components to copy. paletteHalf 1 does only the background palettes, 2 only the sprites'. Called by PaletteFade_Init and the palette fade's setters.

Definition at line 748 of file intro.c.

Referenced by Palette_Transform(), PaletteFade_Init(), PaletteFade_SetCurrent(), and PaletteFade_SetTarget().

◆ PaletteFade_Init()

void PaletteFade_Init ( void )

Allocates the palette fade, saves both hardware palettes in it as the starting colours and schedules PaletteFade_Update.

Called by Title_ShowIntro.

Definition at line 1005 of file intro.c.

Referenced by PaletteFade_Init(), and Title_ShowIntro().

◆ PaletteFade_Release()

void PaletteFade_Release ( void )

Unschedules the palette fade and frees its buffers.

Nothing in ☀️ calls it.

Definition at line 1022 of file intro.c.

Referenced by PaletteFade_Release().

◆ PaletteFade_SetTarget()

void PaletteFade_SetTarget	(	s32	mode,
		s32	paletteHalf )

Sets the fade target by transforming the saved background and/or sprite palettes through the requested mode.

Nothing in ☀️ calls it.

Definition at line 1029 of file intro.c.

Referenced by PaletteFade_SetTarget().

◆ PaletteFade_SetBackdrop()

void PaletteFade_SetBackdrop ( s32 color )

Replaces the first saved colour, the backdrop. Nothing in ☀️ calls it.

Definition at line 1046 of file intro.c.

Referenced by PaletteFade_SetBackdrop().

◆ PaletteFade_Start()

void PaletteFade_Start ( s32 frames )

Starts fading the shown colours to the target over the requested frames.

Called by Title_ShowIntro for the opening fade from black.

Definition at line 1055 of file intro.c.

Referenced by PaletteFade_Start(), and Title_ShowIntro().

◆ Graphics_ClampRgb555Channel()

s32 Graphics_ClampRgb555Channel ( s32 value )

Clamps a five-bit colour channel to 0..31. Called by Palette_Transform.

Definition at line 1067 of file intro.c.

Referenced by Graphics_ClampRgb555Channel(), and Palette_Transform().

◆ Graphics_ClampRgb555Component()

s32 Graphics_ClampRgb555Component ( s32 value )

Caps a colour component at 0x7c00, the largest a five-bit channel shifted into the high bits reaches.

There is no lower bound. Called by Palette_Transform.

Definition at line 1078 of file intro.c.

Referenced by Graphics_ClampRgb555Component(), and Palette_Transform().

Variable Documentation

◆ gTitle_IntroSpriteColumns

const u8 gTitle_IntroSpriteColumns[]

extern

The x of each of the six columns of intro sprites.

Definition at line 64 of file intro.c.

◆ gTitle_PromptBlendLevels

const u8 gTitle_PromptBlendLevels[60]