GUI Functions

Below you'll find all the API functions that provide a GUI for user interaction, whether it be simply showing the user a message or getting input from the user.

void gui_warn(char* warning);

gui_warn is for showing users a simple message

• only allows the user to exit with A.
• newlines (\n) are allowed but testing of looks should be done if using more than one.

"Warn" is somewhat of a misnomer -- it was originally made to warn users that something wrong or unexpected happened, but can be used to show any simple information to the user

int gui_choice(char* message);

gui_choice is for providing the user with a simple binary choice

• returns 1 if the user exits with A or it returns 0 if the user exits with B
• newlines (\n) are allowed but testing of looks should be done if using more than one.

int gui_splash(char* message);

gui_splash is like gui_warn and gui_choice but doesn't wait for user input before allowing the screen to change. It's really only useful for providing feedback to the user that the previous screen accepted whatever input was given and the script is doing some long-running work.

• newlines (\n) are allowed but testing of looks should be done if using more than one.

int gui_menu_6x5(char* question, int options, char** labels, struct pkx* pokemon, enum Generation generation);

gui_menu_6x5 brings up a grid of Pokémon sprites for the user to choose from.

• char* question: Text shown on the bottom screen. Newlines (\n) are allowed
• int options: Total number of options to be displayed to the user. If this exceeds the number of cells in the menu, the GUI will span multiple pages. Pages can be traversed using the d-pad or the R/L buttons.
• char** labels: Array of strings to use as text labels for the options
• enum Generation generation: Which generation of species info and sprites should be used in the display (some species have different forms in different generations, like Pikachu)
• struct pkx* pokemon: Array of pkx structs

struct pkx {
    int species;
    int form;
};

• int species is the National Dex number of the Pokémon you want to display. 0 results in an egg
• int form is always necessary, even if all the species you're working with do not have alternate forms. If you're not trying to display a certain alternate form, set form to 0.

int gui_menu_20x2(char* question, int options, char** labels);

• char* question: Text shown on the bottom screen. Newlines (\n) are allowed
• int options: Total number of options to be displayed to the user. If this exceeds the number of cells in the menu, the GUI will span multiple pages. Pages can be traversed using the d-pad or the R/L buttons.
• char** labels: Array of strings to use as text labels for the options

void gui_numpad(unsigned int* out, char* hint, int maxDigits);

Brings up the numpad to allow user input.

• unsigned int* out: pointer to an existing unsigned int variable to hold the user's input
• char* hint: string to be shown if the user clicks on the What? button in the bottom left. Newlines (\n) are allowed but testing of looks should be done if using more than one.
• int maxDigits: max length of the number provided by user

void gui_keyboard(char* out, char* hint, int maxChars);

Brings up the keyboard to allow user input.

• char* out: pointer to an existing string variable that should be large enough to hold whatever you're prompting the user for, including the NULL terminator
• char* hint: string shown in input box when it's empty. Newlines (\n) are allowed, but only the first and last lines will be visible to the user.
• int maxChars: The number of UTF-16 codepoints allowed to be input, including the null terminator. The data written to out is UTF-8 encoded

int gui_boxes(int* fromStorage, int* box, int* slot, int doCrypt);

• All arguments except doCrypt should be pointers to existing variables
• fromStorage: whether or not the user's selection is in PKSM's storage (1) or save's PC (0)
• box, slot: Box and slot numbers of user's selection
• doCrypt: whether this should (1) or should not (0) it should decrypt and encrypt the boxes itself
  • If you use gui_boxes after sav_box_decrypt, make sure this is 0
• Returns 0 if a selection was successfully made

void bank_select();

Brings up the same bank selection screen as seen when changing banks in Storage.