main_menu.h File Reference

Exposes functions for the main menu. More...

#include "menu.h"

Go to the source code of this file.

Functions
int	init_main_menu (void)
	Initializes resources for the main menu, including memory allocation and observer registration for localized menu strings.
menu_result_t	show_main_menu (bool game_in_progress)
	Display and handle the main menu.
void	shutdown_main_menu (void)
	Shuts down the main menu and frees associated data.

Detailed Description

Exposes functions for the main menu.

Definition in file main_menu.h.

Function Documentation

init_main_menu()

int init_main_menu

(

void

)

Initializes resources for the main menu, including memory allocation and observer registration for localized menu strings.

Returns

0 if the main menu initializes successfully, non-zero value otherwise in case of failure.

Definition at line 28 of file main_menu.c.

                     {
    main_menu_strings = (char**) malloc(sizeof(char*) * MAX_MAIN_MENU_STRINGS);
    RETURN_WHEN_NULL(main_menu_strings, 1, "Main Menu", "Failed to allocate memory for main menu strings.");
 
    for (int i = 0; i < MAX_MAIN_MENU_STRINGS; i++) {
        main_menu_strings[i] = NULL;
    }
 
    // update local once, so the strings are initialized
    update_main_menu_local();
    // add update local function to the observer list
    observe_local(update_main_menu_local);
    return 0;
}

show_main_menu()

menu_result_t show_main_menu

(

bool

game_in_progress

)

Display and handle the main menu.

Parameters

game_in_progress

indicates whether there's an active game that can be continued

Returns

MENU_START_GAME to start a new game, MENU_CONTINUE to continue the current game, MENU_SAVE_GAME to save the game, MENU_LOAD_GAME to load a game, MENU_EXIT to exit the game

Definition at line 43 of file main_menu.c.

                                                          {
    const char* menu_options[6];
    int menu_count;
 
    // Always include New Game
    menu_options[0] = main_menu_strings[NEW_GAME_STR];
 
    if (game_in_progress) {
        // If game is in progress, show all options
        menu_options[1] = main_menu_strings[CONTINUE_STR];
        menu_options[2] = main_menu_strings[SAVE_GAME_STR];
        menu_options[3] = main_menu_strings[LOAD_GAME_STR];
        menu_options[4] = main_menu_strings[CHANGE_LANGUAGE_STR];
        menu_options[5] = main_menu_strings[EXIT_STR];
        menu_count = 6;
    } else {
        // If no game in progress, only show New Game, Load Game and Exit
        menu_options[1] = main_menu_strings[LOAD_GAME_STR];
        menu_options[2] = main_menu_strings[CHANGE_LANGUAGE_STR];
        menu_options[3] = main_menu_strings[EXIT_STR];
        menu_count = 4;
    }
 
    int selected_index = 0;
    active_menu_state = MENU_CONTINUE;
    menu_active = true;
 
    while (menu_active) {
        draw_menu(menu_options, menu_count, selected_index);
 
        input_event_t input_event;
        if (!get_input_blocking(&input_event)) {
            continue;
        }
 
        // Using our input type to navigate the menu
        switch (input_event.type) {
            case INPUT_UP:
                selected_index = (selected_index - 1 + menu_count) % menu_count;
                break;
            case INPUT_DOWN:
                selected_index = (selected_index + 1) % menu_count;
                break;
            case INPUT_CONFIRM: {
                // Get the selected menu option
                select_menu_option(selected_index, game_in_progress);
                break;
            }
            case INPUT_QUIT:
                active_menu_state = MENU_EXIT;
                menu_active = false;
                break;
            case INPUT_CANCEL:
            case INPUT_MENU:
                active_menu_state = MENU_CONTINUE;
                menu_active = false;
                break;
            default:
                // do nothing for other keys
                break;
        }
    }
 
    return active_menu_state;
}

shutdown_main_menu()

void shutdown_main_menu

(

void

)

Shuts down the main menu and frees associated data.

Definition at line 160 of file main_menu.c.

                              {
    if (main_menu_strings != NULL) {
        for (int i = 0; i < MAX_MAIN_MENU_STRINGS; i++) {
            if (main_menu_strings[i] != NULL) {
                free(main_menu_strings[i]);
            }
        }
        free(main_menu_strings);
    }
}