highScores.c File Reference

Macros
#define	NVS_KEY_USER_HIGH_SCORE   "user_high_score"
#define	NVS_KEY_HIGH_SCORES   "high_scores"
#define	HIGH_SCORE_COUNT(hs)

Functions
void	initHighScores (highScores_t *hs, const char *nvsNamespace)
	Load high score data from NVS.
bool	updateHighScores (highScores_t *hs, const char *nvsNamespace, score_t newScores[], uint8_t numNewScores)
	Update the high score table and user high score with new scores from the player or SwadgePass and persist to NVS. This function handles sorting and limiting the number of scores, so no preprocessing is necessary.
void	saveHighScoresFromSwadgePass (highScores_t *hs, const char *nvsNamespace, list_t swadgePasses, int32_t(*fnGetSwadgePassHighScore)(const swadgePassPacket_t *packet))
	Extract high score data received from SwadgePass and save to the high score table. This should be called from your mode's fnEnterMode function after calling initHighScores().
void	addHighScoreToSwadgePassPacket (const char *nvsNamespace, swadgePassPacket_t *packet, void(*fnSetSwadgePassHighScore)(swadgePassPacket_t *packet, int32_t highScore))
	Write high score data to SwadgePass packet for sending to other swadges. This should be called from your mode's fnAddToSwadgePassPacket function.
void	initHighScoreSonas (highScores_t *hs, swadgesona_t sonas[])
	Load the usernames and Swadgesona images for the high score table into memory. When you are finished with the Swadgesona images, call freeHighScoreSonas() to free the memory. It is safe to call this function multiple times before calling freeHighScoreSonas().
void	freeHighScoreSonas (highScores_t *hs, swadgesona_t sonas[])
	Free memory used for Swadgesona images.

Macro Definition Documentation

NVS_KEY_USER_HIGH_SCORE

#define NVS_KEY_USER_HIGH_SCORE   "user_high_score"

NVS_KEY_HIGH_SCORES

#define NVS_KEY_HIGH_SCORES   "high_scores"

HIGH_SCORE_COUNT

#define HIGH_SCORE_COUNT

(

hs

)

Value:

    (hs->highScoreCount == 0 ? MAX_HIGH_SCORE_COUNT : MIN(hs->highScoreCount, MAX_HIGH_SCORE_COUNT))

Function Documentation

initHighScores()

void initHighScores	(	highScores_t *	hs,
		const char *	nvsNamespace )

Load high score data from NVS.

Parameters

hs	The struct that contains the high scores. highScores_t.highScoreCount should be set; other fields will be overwritten
nvsNamespace	The NVS namespace to read saved high score data from

updateHighScores()

bool updateHighScores	(	highScores_t *	hs,
		const char *	nvsNamespace,
		score_t	newScores[],
		uint8_t	numNewScores )

Update the high score table and user high score with new scores from the player or SwadgePass and persist to NVS. This function handles sorting and limiting the number of scores, so no preprocessing is necessary.

Parameters

hs	The struct that contains the high scores
nvsNamespace	The NVS namespace to write data to
newScores	Array of scores to add to the table
numNewScores	Count of scores in the array

Returns

true if the high score table changed, false if it didn't

saveHighScoresFromSwadgePass()

void saveHighScoresFromSwadgePass	(	highScores_t *	hs,
		const char *	nvsNamespace,
		list_t	swadgePasses,
		int32_t(*	fnGetSwadgePassHighScore )(const swadgePassPacket_t *packet) )

Extract high score data received from SwadgePass and save to the high score table. This should be called from your mode's fnEnterMode function after calling initHighScores().

Parameters

hs	The highScores_t struct that contains the high scores
nvsNamespace	The NVS namespace to write data to
swadgePasses	A list_t of SwadgePasses from getSwadgePasses()
fnGetSwadgePassHighScore	Pointer to a function that returns your mode's high score from a SwadgePass packet

addHighScoreToSwadgePassPacket()

void addHighScoreToSwadgePassPacket	(	const char *	nvsNamespace,
		swadgePassPacket_t *	packet,
		void(*	fnSetSwadgePassHighScore )(swadgePassPacket_t *packet, int32_t highScore) )

Write high score data to SwadgePass packet for sending to other swadges. This should be called from your mode's fnAddToSwadgePassPacket function.

Parameters

nvsNamespace	The NVS namespace to read data from
packet	The SwadgePass packet to modify
fnSetSwadgePassHighScore	Pointer to a function that sets your mode's high score field in a SwadgePass packet

initHighScoreSonas()

void initHighScoreSonas	(	highScores_t *	hs,
		swadgesona_t	sonas[] )

Load the usernames and Swadgesona images for the high score table into memory. When you are finished with the Swadgesona images, call freeHighScoreSonas() to free the memory. It is safe to call this function multiple times before calling freeHighScoreSonas().

Parameters

hs	The highScores_t struct that contains the high scores
sonas	Array of swadgesona structs. nameData_t.nameBuffer in swadgesona_t.name and swadgesona_t.image will be populated. This array must be the same length as highScores_t.highScoreCount.

freeHighScoreSonas()

void freeHighScoreSonas	(	highScores_t *	hs,
		swadgesona_t	sonas[] )

Free memory used for Swadgesona images.

Parameters

hs	The highScores_t struct that contains the high scores
sonas	Array of swadgesona structs. This array must be the same length as highScores_t.highScoreCount.