mndiagram.h File Reference

#include <placeholder.h>
#include "mn/types.h"
#include <baselib/forward.h>

Go to the source code of this file.

Functions
u8	mnDiagram_GetFighterByIndex (int idx)
	Gets the fighter ID at the given sorted index.
u8	mnDiagram_GetNameByIndex (int idx)
	Gets the name ID at the given sorted index.
bool	mnDiagram_IsDistanceOverflow (u32 distance)
	Checks if a distance stat exceeds 1 mile (display cap).
u32	mnDiagram_ConvertDistanceForDisplay (u32 distance)
	Converts internal distance units to display units.
s32	mnDiagram_GetHitPercentage (int is_name_mode, u8 player_index)
s32	mnDiagram_GetPlayPercentage (int is_name_mode, u8 player_index)
s32	mnDiagram_GetAveragePlayerCount (int is_name_mode, u8 player_index)
int	mnDiagram_GetNameTotalKOs (u8 field_index)
	Gets total KOs scored by a name against all other names.
int	mnDiagram_GetNameTotalFalls (u8 field_index)
int	mnDiagram_GetFighterTotalKOs (u8 field_index)
	Gets total KOs scored by a fighter against all other fighters.
int	mnDiagram_GetFighterTotalFalls (u8 field_index)
void	mnDiagram_FormatDecimalNumber (char *buf, u32 val, int mode)
	Formats a number with optional decimal places.
void	mnDiagram_FormatTime (char *buf, s32 seconds)
	Formats seconds as MM:SS string.
void	mnDiagram_IntToStr (char *buf, u32 val)
	Converts a number to a null-terminated string.
u8	mnDiagram_GetPrevNameIndex (s32 idx)
	Gets the previous valid name index.
u8	mnDiagram_GetNextNameIndex (s32 idx)
u8	mnDiagram_GetPrevFighterIndex (s32 idx)
	Gets the previous valid fighter index.
u8	mnDiagram_GetNextFighterIndex (s32 idx)
u32	mnDiagram_GetNamePlayTimeByFighter (int name_idx, SelectableCharacterKind fighter_idx)
	Gets play time for a specific fighter under a name tag.
int	mnDiagram_GetRankedFighterForName (int rank, int name_idx, u32(*func)(int, int))
u8	mnDiagram_GetLeastPlayedFighter (u8 name_idx)
void	mnDiagram_SortFightersByKOs (void)
void	mnDiagram_SortNamesByKOs (void)
int	mnDiagram_CountUnlockedFighters (void)
	Counts the number of unlocked fighters.
void	mnDiagram_PopupInputProc (HSD_GObj *)
void	mnDiagram_InputProc (HSD_GObj *)
	Per-frame input handler for the VS Records "diagram" grid screen.
void	mnDiagram_PopupCleanup (void *arg0)
void	mnDiagram_PopupAnimProc (void *arg0)
void	mnDiagram_CreatePopupTexts (void *arg0, s32 arg1, s32 arg2, s32 arg3)
void	mnDiagram_CreatePopup (s32 arg0, s32 arg1, s32 arg2)
void	mnDiagram_ClearGrid (void *arg0)
void	mnDiagram_RefreshGrid (HSD_GObj *arg0, int arg1, int arg2)
void	mnDiagram_UpdateScrollArrows (HSD_GObj *gobj)
	Updates scroll arrow visibility based on cursor position and available entries beyond the visible range.
void	mnDiagram_ExitAnimProc (HSD_GObj *gobj)
void	mnDiagram_UpdateScrollArrowVisibility (void *gobj, int count)
	Updates scroll arrow visibility based on entry count.
void	mnDiagram_OnFrame (HSD_GObj *gobj)
void	mnDiagram_DrawCellValue (void *arg0, u8 arg1, u8 arg2, int arg3)
void	mnDiagram_DrawGridValues (void *arg0, s32 arg1, s32 arg2, u8 arg3)
void	mnDiagram_DrawNameHeaders (void *arg0, s32 arg1, s32 arg2)
HSD_JObj *	mnDiagram_CreateFighterIcon (int idx, int arg1)
void	mnDiagram_DrawFighterHeaders (void *arg0, int arg1, int arg2)
void	mnDiagram_CursorProc (HSD_GObj *gobj)
void	mnDiagram_CreateCursor (void)
void	mnDiagram_CreateScreen (u8 arg0)
void	mnDiagram_Init (u8 arg0, u8 arg1)
	Initialize VS Records diagram screen.

Function Documentation

mnDiagram_GetFighterByIndex()

u8 mnDiagram_GetFighterByIndex

(

int

idx

)

Gets the fighter ID at the given sorted index.

Parameters

idx	Index into the sorted fighter list

Returns

Fighter ID

mnDiagram_GetNameByIndex()

u8 mnDiagram_GetNameByIndex

(

int

idx

)

Gets the name ID at the given sorted index.

Parameters

idx	Index into the sorted name list

Returns

Name ID

mnDiagram_IsDistanceOverflow()

bool mnDiagram_IsDistanceOverflow

(

u32

distance

)

Checks if a distance stat exceeds 1 mile (display cap).

Distance stats are stored in internal game units and converted for display by dividing by ~30.5 to get feet. When the distance exceeds these thresholds (~1 mile), the display caps at "1 mi." instead of showing larger values.

Parameters

distance

The distance value in internal game units.

Returns

true if distance >= 1 mile, false otherwise.

160,934 internal units / 30.5 = ~5,276 ft = 1 mile

100,000 internal units / 30.5 = ~3,278 meters

mnDiagram_ConvertDistanceForDisplay()

u32 mnDiagram_ConvertDistanceForDisplay

(

u32

distance

)

Converts internal distance units to display units.

For US locale: Returns feet (or miles if >= 1 mile). For other locales: Returns centimeters (or km if >= 1km).

Parameters

distance

Distance in internal game units.

Returns

Distance in display units (feet/cm or miles/km).

mnDiagram_GetHitPercentage()

s32 mnDiagram_GetHitPercentage	(	int	is_name_mode,
		u8	player_index )

mnDiagram_GetPlayPercentage()

s32 mnDiagram_GetPlayPercentage	(	int	is_name_mode,
		u8	player_index )

mnDiagram_GetAveragePlayerCount()

s32 mnDiagram_GetAveragePlayerCount	(	int	is_name_mode,
		u8	player_index )

mnDiagram_GetNameTotalKOs()

int mnDiagram_GetNameTotalKOs

(

u8

field_index

)

Gets total KOs scored by a name against all other names.

Parameters

field_index

Index of the name tag to query.

Returns

Sum of KOs scored by this name against all existing names.

mnDiagram_GetNameTotalFalls()

int mnDiagram_GetNameTotalFalls

(

u8

field_index

)

mnDiagram_GetFighterTotalKOs()

int mnDiagram_GetFighterTotalKOs

(

u8

field_index

)

Gets total KOs scored by a fighter against all other fighters.

Iterates through all unlocked fighters and sums how many times the target fighter KO'd each one. Fighter data uses a similar matrix layout to name data.

Parameters

field_index

Index of the fighter to query (0-24).

Returns

Sum of KOs scored by this fighter against all unlocked fighters.

mnDiagram_GetFighterTotalFalls()

int mnDiagram_GetFighterTotalFalls

(

u8

field_index

)

mnDiagram_FormatDecimalNumber()

void mnDiagram_FormatDecimalNumber	(	char *	buf,
		u32	val,
		int	decimal_places )

Formats a number with optional decimal places.

Parameters

buf	Output buffer for the string.
val	The value to format (treat last decimal_places digits as decimal).
decimal_places	Number of decimal places (0 = integer only).

mnDiagram_FormatTime()

void mnDiagram_FormatTime	(	char *	buf,
		s32	seconds )

Formats seconds as MM:SS string.

Parameters

buf	Output buffer for the string.
seconds	Time in seconds.

mnDiagram_IntToStr()

void mnDiagram_IntToStr	(	char *	buf,
		u32	val )

Converts a number to a null-terminated string.

Parameters

buf	Output buffer for the string.
val	The number to convert.

mnDiagram_GetPrevNameIndex()

u8 mnDiagram_GetPrevNameIndex

(

s32

idx

)

Gets the previous valid name index.

Parameters

idx	Current name index.

Returns

Previous name index with a valid name, or original if none found.

mnDiagram_GetNextNameIndex()

u8 mnDiagram_GetNextNameIndex

(

s32

idx

)

mnDiagram_GetPrevFighterIndex()

u8 mnDiagram_GetPrevFighterIndex

(

s32

idx

)

Gets the previous valid fighter index.

Parameters

idx	Current fighter index.

Returns

Previous fighter index that's unlocked, or original if none found.

mnDiagram_GetNextFighterIndex()

u8 mnDiagram_GetNextFighterIndex

(

s32

idx

)

mnDiagram_GetNamePlayTimeByFighter()

u32 mnDiagram_GetNamePlayTimeByFighter	(	int	name_idx,
		SelectableCharacterKind	selkind )

Gets play time for a specific fighter under a name tag.

Parameters

name_idx	Name tag index.
fighter_idx	Fighter index (0-24).

Returns

Play time in seconds for this fighter under this name.

mnDiagram_GetRankedFighterForName()

int mnDiagram_GetRankedFighterForName	(	int	rank,
		int	name_idx,
		u32(*	func )(int, int) )

mnDiagram_GetLeastPlayedFighter()

u8 mnDiagram_GetLeastPlayedFighter

(

u8

name_idx

)

mnDiagram_SortFightersByKOs()

void mnDiagram_SortFightersByKOs

(

void

)

mnDiagram_SortNamesByKOs()

void mnDiagram_SortNamesByKOs

(

void

)

mnDiagram_CountUnlockedFighters()

int mnDiagram_CountUnlockedFighters

(

void

)

Counts the number of unlocked fighters.

Returns

Number of unlocked fighters.

mnDiagram_PopupInputProc()

void mnDiagram_PopupInputProc

(

HSD_GObj *

gobj

)

mnDiagram_InputProc()

void mnDiagram_InputProc

(

HSD_GObj *

gobj

)

Per-frame input handler for the VS Records "diagram" grid screen.

Dispatches the current frame's menu input:

• A (0x10): open the detail popup (mnDiagram_PopupInputProc) for the highlighted cell, mapping the display cursor (mn_804A04F0.hovered_selection = row<<8 | col) to the underlying name/fighter id via the col-th/row-th visible entry, then enter the detail page (mnDiagram_CreatePopup).
• B (0x20): save cursor state and back out (mn_80229894).
• Start/Z (0xC0): save cursor state and advance to page 2 (mnDiagram2_Init) or page 3 (mnDiagram3_Init).
• L/R (0xC00): toggle between name-tag and fighter axes, clamping the cursor to the valid entry count.
• D-pad (1/2/4/8): move the cursor within the grid, scrolling the data window by a page when moving past a visible edge.

The "visible entry" scans skip locked fighters / empty name slots, and are factored into the mnDiagram_GetVisible*From / mnDiagram_Get{Prev,Next}*Index helpers shared with mndiagram2.

mnDiagram_PopupCleanup()

void mnDiagram_PopupCleanup

(

void *

arg0

)

mnDiagram_PopupAnimProc()

void mnDiagram_PopupAnimProc

(

void *

arg0

)

mnDiagram_CreatePopupTexts()

void mnDiagram_CreatePopupTexts	(	void *	arg0,
		s32	arg1,
		s32	arg2,
		s32	arg3 )

mnDiagram_CreatePopup()

void mnDiagram_CreatePopup	(	s32	arg0,
		s32	arg1,
		s32	arg2 )

mnDiagram_ClearGrid()

void mnDiagram_ClearGrid

(

void *

arg0

)

mnDiagram_RefreshGrid()

void mnDiagram_RefreshGrid	(	HSD_GObj *	arg0,
		int	arg1,
		int	arg2 )

mnDiagram_UpdateScrollArrows()

void mnDiagram_UpdateScrollArrows

(

HSD_GObj *

gobj

)

Updates scroll arrow visibility based on cursor position and available entries beyond the visible range.

Parameters

[in]

gobj

The diagram GObj containing arrow JObjs in user_data.

Checks 4 arrows: right (10 more cols?), left (cursor > 0?), up (cursor row > 0?), down (7 more rows?). Hides arrows when there's nothing to scroll to, shows them when there is.

mnDiagram_ExitAnimProc()

void mnDiagram_ExitAnimProc

(

HSD_GObj *

gobj

)

mnDiagram_UpdateScrollArrowVisibility()

void mnDiagram_UpdateScrollArrowVisibility	(	void *	gobj,
		int	count )

Updates scroll arrow visibility based on entry count.

Hides vertical arrows if count <= 7 (fits in visible rows). Hides horizontal arrows if count <= 10 (fits in visible columns).

Parameters

gobj	The diagram GObj containing arrow JObjs in user_data.
count	Number of entries (fighters or names) to display.

mnDiagram_OnFrame()

void mnDiagram_OnFrame

(

HSD_GObj *

gobj

)

mnDiagram_DrawCellValue()

void mnDiagram_DrawCellValue	(	void *	arg0,
		u8	arg1,
		u8	arg2,
		int	arg3 )

mnDiagram_DrawGridValues()

void mnDiagram_DrawGridValues	(	void *	arg0,
		s32	arg1,
		s32	arg2,
		u8	arg3 )

mnDiagram_DrawNameHeaders()

void mnDiagram_DrawNameHeaders	(	void *	arg0,
		s32	arg1,
		s32	arg2 )

mnDiagram_CreateFighterIcon()

HSD_JObj * mnDiagram_CreateFighterIcon	(	int	idx,
		int	arg1 )

mnDiagram_DrawFighterHeaders()

void mnDiagram_DrawFighterHeaders	(	void *	arg0,
		int	arg1,
		int	arg2 )

mnDiagram_CursorProc()

void mnDiagram_CursorProc

(

HSD_GObj *

gobj

)

mnDiagram_CreateCursor()

void mnDiagram_CreateCursor

(

void

)

mnDiagram_CreateScreen()

void mnDiagram_CreateScreen

(

u8

arg0

)

mnDiagram_Init()

void mnDiagram_Init	(	u8	arg0,
		u8	arg1 )

Initialize VS Records diagram screen.

Parameters

arg0	If non-zero, load DAT archive symbols
arg1	Initial mode (passed to mnDiagram_CreateScreen)