openmohaa/code/gamespy/common/nitro/menu.h

#ifndef _MENU_H_
#define _MENU_H_

// various length defines
#define MAX_CHOICE_STRING_LEN      32
#define MAX_TOP_SCREEN_TEXT        32
#define MAX_CHOICES                10
#define MAX_LIST_STRINGS           16
#define MAX_LIST_STRING_LEN        32
#define MAX_KEYBOARD_TEXT_LEN      32
#define MAX_EXTRA_TEXT_STRINGS     10
#define MAX_EXTRA_TEXT_STRING_LEN  32

// options for screens
#define SCREEN_OPTION_ANIMATED         0x1
#define SCREEN_OPTION_KEYBOARD         0x2
#define SCREEN_OPTION_LIST             0x4
#define SCREEN_OPTION_EXTRAS_CENTERED  0x8

// options for screen choices
#define CHOICE_OPTION_NEEDS_LIST_SELECTION   0x1
#define CHOICE_OPTION_DISABLED               0x2

// a single choice on a screen
typedef struct MenuScreenChoice
{
	const char * text;
	int options;
} MenuScreenChoice;

// an instance of a screen
typedef struct MenuScreen
{
	struct MenuScreenConfiguration * configuration;
	char extraText[MAX_EXTRA_TEXT_STRINGS][MAX_EXTRA_TEXT_STRING_LEN + 1];
	char list[MAX_LIST_STRINGS][MAX_LIST_STRING_LEN + 1];
	int listSelection;  // default -1, no selection
	char keyboardText[MAX_KEYBOARD_TEXT_LEN + 1];
	int numChoices;
} MenuScreen;

// the static configuration for a screen
typedef struct MenuScreenConfiguration
{
	const char * topScreenText;
	MenuScreenChoice choices[MAX_CHOICES];
	void (* initFunc)(void);
	void (* choseFunc)(const char * choice);
	void (* thinkFunc)(void);
	int options;
} MenuScreenConfiguration;

// call this to start showing a menu, pass in the initial screen to show
void StartMenuScreen(MenuScreenConfiguration * configuration);

// call this from any of the configuration callback funcs to set the next screen to show
void SetNextMenuScreen(MenuScreenConfiguration * configuration);

// call this to exit the menu
void ExitMenu(void);

// gets the current menu screen
MenuScreen * GetMenuScreen(void);

#endif