nilorea-library/n__gui_8h_source.html

/*

 * Nilorea Library

 * Copyright (C) 2005-2026 Castagnier Mickael

 *

 * This program is free software: you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation, either version 3 of the License, or

 * (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program.  If not, see <https://www.gnu.org/licenses/>.

 */


#ifndef __NILOREA_GUI__

#define __NILOREA_GUI__


#ifdef __cplusplus

extern "C" {

#endif


#include <stdio.h>

#include <stdlib.h>

#include <string.h>

#include <ctype.h>

#include <stdbool.h>


#include <nilorea/n_allegro5.h>

#include <nilorea/n_common.h>

#include <nilorea/n_str.h>

#include <nilorea/n_log.h>

#include <nilorea/n_list.h>

#include <nilorea/n_hash.h>


#define N_GUI_ID_MAX 128

#define N_GUI_TEXT_MAX 4096


/* ---- widget type enum ---- */

#define N_GUI_TYPE_BUTTON 1

#define N_GUI_TYPE_SLIDER 2

#define N_GUI_TYPE_TEXTAREA 3

#define N_GUI_TYPE_CHECKBOX 4

#define N_GUI_TYPE_SCROLLBAR 5

#define N_GUI_TYPE_LISTBOX 6

#define N_GUI_TYPE_RADIOLIST 7

#define N_GUI_TYPE_COMBOBOX 8

#define N_GUI_TYPE_IMAGE 9

#define N_GUI_TYPE_LABEL 10

#define N_GUI_TYPE_DROPMENU 11


/* ---- shape flags ---- */

#define N_GUI_SHAPE_RECT 0

#define N_GUI_SHAPE_ROUNDED 1

#define N_GUI_SHAPE_BITMAP 2


/* ---- slider mode ---- */

#define N_GUI_SLIDER_VALUE 0

#define N_GUI_SLIDER_PERCENT 1


/* ---- slider orientation ---- */

#define N_GUI_SLIDER_H 0

#define N_GUI_SLIDER_V 1


/* ---- scrollbar orientation ---- */

#define N_GUI_SCROLLBAR_H 0

#define N_GUI_SCROLLBAR_V 1


/* ---- list selection modes ---- */

#define N_GUI_SELECT_NONE 0

#define N_GUI_SELECT_SINGLE 1

#define N_GUI_SELECT_MULTIPLE 2


/* ---- image scale modes ---- */

#define N_GUI_IMAGE_FIT 0

#define N_GUI_IMAGE_STRETCH 1

#define N_GUI_IMAGE_CENTER 2


/* ---- text alignment ---- */

#define N_GUI_ALIGN_LEFT 0

#define N_GUI_ALIGN_CENTER 1

#define N_GUI_ALIGN_RIGHT 2

#define N_GUI_ALIGN_JUSTIFIED 3


/* ---- widget state flags ---- */

#define N_GUI_STATE_IDLE 0

#define N_GUI_STATE_HOVER 1

#define N_GUI_STATE_ACTIVE 2

#define N_GUI_STATE_FOCUSED 4

#define N_GUI_STATE_SCROLLBAR_DRAG 8


/* ---- window state flags ---- */

#define N_GUI_WIN_OPEN 1

#define N_GUI_WIN_MINIMISED 2

#define N_GUI_WIN_DRAGGING 4

#define N_GUI_WIN_RESIZING 8

#define N_GUI_WIN_VSCROLL_DRAG 16

#define N_GUI_WIN_HSCROLL_DRAG 32


/* ---- window feature flags (set via n_gui_window_set_flags) ---- */

#define N_GUI_WIN_AUTO_SCROLLBAR 16

#define N_GUI_WIN_RESIZABLE 32

#define N_GUI_WIN_FIXED_POSITION 64

#define N_GUI_WIN_FRAMELESS 128


/* ---- context-level resize modes (set via n_gui_set_resize_mode) ---- */

#define N_GUI_RESIZE_VIRTUAL 0

#define N_GUI_RESIZE_ADAPTIVE 1


/* ---- per-window resize policies (used in ADAPTIVE mode) ---- */

#define N_GUI_WIN_RESIZE_NONE 0

#define N_GUI_WIN_RESIZE_MOVE 1

#define N_GUI_WIN_RESIZE_SCALE 2


/* ---- dialog auto-adjust flags (set via n_gui_window_set_autofit) ---- */

#define N_GUI_AUTOFIT_W 1

#define N_GUI_AUTOFIT_H 2

#define N_GUI_AUTOFIT_WH 3

#define N_GUI_AUTOFIT_EXPAND_LEFT 4

#define N_GUI_AUTOFIT_EXPAND_UP 8

#define N_GUI_AUTOFIT_CENTER 16


/* ---- window z-order modes ---- */

#define N_GUI_ZORDER_NORMAL 0

#define N_GUI_ZORDER_ALWAYS_ON_TOP 1

#define N_GUI_ZORDER_ALWAYS_BEHIND 2

#define N_GUI_ZORDER_FIXED 3


/* ---- text dimension bounding box ---- */


typedef struct N_GUI_TEXT_DIMS {

    int x;

    int y;

    int w;

    int h;

} N_GUI_TEXT_DIMS;


/* ---- color theme ---- */


typedef struct N_GUI_THEME {

    ALLEGRO_COLOR bg_normal;

    ALLEGRO_COLOR bg_hover;

    ALLEGRO_COLOR bg_active;

    ALLEGRO_COLOR border_normal;

    ALLEGRO_COLOR border_hover;

    ALLEGRO_COLOR border_active;

    ALLEGRO_COLOR text_normal;

    ALLEGRO_COLOR text_hover;

    ALLEGRO_COLOR text_active;

    float border_thickness;

    float corner_rx;

    float corner_ry;

    ALLEGRO_COLOR selection_color;

} N_GUI_THEME;


/* ---- button key modifier flags (use with n_gui_button_set_keycode) ---- */

#define N_GUI_KEY_MOD_MASK (ALLEGRO_KEYMOD_SHIFT | ALLEGRO_KEYMOD_CTRL | ALLEGRO_KEYMOD_ALT | ALLEGRO_KEYMOD_ALTGR)


#define N_GUI_KEY_SOURCES_MAX 8


/* ---- per-widget data ---- */


typedef struct N_GUI_BUTTON_DATA {

    char label[N_GUI_ID_MAX];

    ALLEGRO_BITMAP* bitmap;

    ALLEGRO_BITMAP* bitmap_hover;

    ALLEGRO_BITMAP* bitmap_active;

    int shape;

    int toggle_mode;

    int toggled;

    int keycode;

    int key_modifiers;

    int key_focus_only;

    int key_sources[N_GUI_KEY_SOURCES_MAX];

    void (*on_click)(int widget_id, void* user_data);

    void* user_data;

} N_GUI_BUTTON_DATA;


typedef struct N_GUI_SLIDER_DATA {

    double min_val;

    double max_val;

    double value;

    double step;

    int mode;

    int orientation;

    ALLEGRO_BITMAP* track_bitmap;

    ALLEGRO_BITMAP* fill_bitmap;

    ALLEGRO_BITMAP* handle_bitmap;

    ALLEGRO_BITMAP* handle_hover_bitmap;

    ALLEGRO_BITMAP* handle_active_bitmap;

    void (*on_change)(int widget_id, double value, void* user_data);

    void* user_data;

} N_GUI_SLIDER_DATA;


typedef struct N_GUI_TEXTAREA_DATA {

    char* text;

    size_t text_len;

    size_t text_alloc;

    size_t char_limit;

    int multiline;

    size_t cursor_pos;

    size_t sel_start;

    size_t sel_end;

    int scroll_y;

    float scroll_x;

    int scroll_from_wheel;

    double cursor_time;

    ALLEGRO_BITMAP* bg_bitmap;

    char mask_char;

    void (*on_change)(int widget_id, const char* text, void* user_data);

    void* user_data;

} N_GUI_TEXTAREA_DATA;


typedef struct N_GUI_CHECKBOX_DATA {

    char label[N_GUI_ID_MAX];

    int checked;

    ALLEGRO_BITMAP* box_bitmap;

    ALLEGRO_BITMAP* box_checked_bitmap;

    ALLEGRO_BITMAP* box_hover_bitmap;

    void (*on_toggle)(int widget_id, int checked, void* user_data);

    void* user_data;

} N_GUI_CHECKBOX_DATA;


typedef struct N_GUI_SCROLLBAR_DATA {

    int orientation;

    double content_size;

    double viewport_size;

    double scroll_pos;

    int shape;

    ALLEGRO_BITMAP* track_bitmap;

    ALLEGRO_BITMAP* thumb_bitmap;

    ALLEGRO_BITMAP* thumb_hover_bitmap;

    ALLEGRO_BITMAP* thumb_active_bitmap;

    void (*on_scroll)(int widget_id, double scroll_pos, void* user_data);

    void* user_data;

} N_GUI_SCROLLBAR_DATA;


typedef struct N_GUI_LISTITEM {

    char text[N_GUI_ID_MAX];

    int selected;

} N_GUI_LISTITEM;


typedef struct N_GUI_LISTBOX_DATA {

    N_GUI_LISTITEM* items;

    size_t nb_items;

    size_t items_capacity;

    int selection_mode;

    int scroll_offset;

    float item_height;

    ALLEGRO_BITMAP* bg_bitmap;

    ALLEGRO_BITMAP* item_bg_bitmap;

    ALLEGRO_BITMAP* item_selected_bitmap;

    void (*on_select)(int widget_id, int index, int selected, void* user_data);

    void* user_data;

} N_GUI_LISTBOX_DATA;


typedef struct N_GUI_RADIOLIST_DATA {

    N_GUI_LISTITEM* items;

    size_t nb_items;

    size_t items_capacity;

    int selected_index;

    int scroll_offset;

    float item_height;

    ALLEGRO_BITMAP* bg_bitmap;

    ALLEGRO_BITMAP* item_bg_bitmap;

    ALLEGRO_BITMAP* item_selected_bitmap;

    void (*on_select)(int widget_id, int index, void* user_data);

    void* user_data;

} N_GUI_RADIOLIST_DATA;


/* ---- combobox feature flags ---- */

#define N_GUI_COMBOBOX_AUTO_WIDTH 1


typedef struct N_GUI_COMBOBOX_DATA {

    N_GUI_LISTITEM* items;

    size_t nb_items;

    size_t items_capacity;

    int selected_index;

    int is_open;

    int scroll_offset;

    float item_height;

    int max_visible;

    ALLEGRO_BITMAP* bg_bitmap;

    ALLEGRO_BITMAP* item_bg_bitmap;

    ALLEGRO_BITMAP* item_selected_bitmap;

    void (*on_select)(int widget_id, int index, void* user_data);

    void* user_data;

    int flags;

} N_GUI_COMBOBOX_DATA;


typedef struct N_GUI_IMAGE_DATA {

    ALLEGRO_BITMAP* bitmap;

    int scale_mode;

} N_GUI_IMAGE_DATA;


typedef struct N_GUI_LABEL_DATA {

    char text[N_GUI_TEXT_MAX];

    char link[N_GUI_TEXT_MAX];

    int align;

    float scroll_y;

    int sel_start;

    int sel_end;

    int sel_dragging;

    ALLEGRO_BITMAP* bg_bitmap;

    void (*on_link_click)(int widget_id, const char* link, void* user_data);

    void* user_data;

} N_GUI_LABEL_DATA;


typedef struct N_GUI_DROPMENU_ENTRY {

    char text[N_GUI_ID_MAX];

    int is_dynamic;

    int tag;

    void (*on_click)(int widget_id, int entry_index, int tag, void* user_data);

    void* user_data;

} N_GUI_DROPMENU_ENTRY;


typedef struct N_GUI_DROPMENU_DATA {

    char label[N_GUI_ID_MAX];

    N_GUI_DROPMENU_ENTRY* entries;

    size_t nb_entries;

    size_t entries_capacity;

    int is_open;

    int scroll_offset;

    int max_visible;

    float item_height;

    ALLEGRO_BITMAP* panel_bitmap;

    ALLEGRO_BITMAP* item_hover_bitmap;

    void (*on_open)(int widget_id, void* user_data);

    void* on_open_user_data;

} N_GUI_DROPMENU_DATA;


/* ---- widget ---- */


typedef struct N_GUI_WIDGET {

    int id;

    int type;

    float x;

    float y;

    float w;

    float h;

    int state;

    int visible;

    int enabled;

    N_GUI_THEME theme;

    ALLEGRO_FONT* font;

    void* data;

    float norm_x;

    float norm_y;

    float norm_w;

    float norm_h;

} N_GUI_WIDGET;


/* ---- pseudo window ---- */


typedef struct N_GUI_WINDOW {

    int id;

    char title[N_GUI_ID_MAX];

    float x;

    float y;

    float w;

    float h;

    float titlebar_h;

    int state;

    int flags;

    LIST* widgets;

    N_GUI_THEME theme;

    ALLEGRO_FONT* font;

    float drag_ox;

    float drag_oy;

    float min_w;

    float min_h;

    float scroll_y;

    float scroll_x;

    float content_h;

    float content_w;

    int z_order;

    int z_value;

    ALLEGRO_BITMAP* bg_bitmap;

    ALLEGRO_BITMAP* titlebar_bitmap;

    int bg_scale_mode;

    int autofit_flags;

    float autofit_border;

    float autofit_origin_x;

    float autofit_origin_y;

    int resize_policy;

    float norm_x;

    float norm_y;

    float norm_w;

    float norm_h;

} N_GUI_WINDOW;


/* ---- global style (all configurable sizes, colors, paddings) ---- */


typedef struct N_GUI_STYLE {

    /* window chrome */

    float titlebar_h;

    float min_win_w;

    float min_win_h;

    float title_padding;

    float title_max_w_reserve;


    /* window auto-scrollbar */

    float scrollbar_size;

    float scrollbar_thumb_min;

    float scrollbar_thumb_padding;

    float scrollbar_thumb_corner_r;

    ALLEGRO_COLOR scrollbar_track_color;

    ALLEGRO_COLOR scrollbar_thumb_color;


    /* global display scrollbar */

    float global_scrollbar_size;

    float global_scrollbar_thumb_min;

    float global_scrollbar_thumb_padding;

    float global_scrollbar_thumb_corner_r;

    float global_scrollbar_border_thickness;

    ALLEGRO_COLOR global_scrollbar_track_color;

    ALLEGRO_COLOR global_scrollbar_thumb_color;

    ALLEGRO_COLOR global_scrollbar_thumb_border_color;


    /* resize grip */

    float grip_size;

    float grip_line_thickness;

    ALLEGRO_COLOR grip_color;


    /* slider */

    float slider_track_size;

    float slider_track_corner_r;

    float slider_track_border_thickness;

    float slider_handle_min_r;

    float slider_handle_edge_offset;

    float slider_handle_border_thickness;

    float slider_value_label_offset;


    /* text area */

    float textarea_padding;

    float textarea_cursor_width;

    float textarea_cursor_blink_period;


    /* checkbox */

    float checkbox_max_size;

    float checkbox_mark_margin;

    float checkbox_mark_thickness;

    float checkbox_label_gap;

    float checkbox_label_offset;


    /* radio list */

    float radio_circle_min_r;

    float radio_circle_border_thickness;

    float radio_inner_offset;

    float radio_label_gap;


    /* list items (shared by listbox, radiolist, combobox, dropmenu) */

    float listbox_default_item_height;

    float radiolist_default_item_height;

    int combobox_max_visible;

    int dropmenu_max_visible;

    float item_text_padding;

    float item_selection_inset;

    float item_height_pad;


    /* dropdown arrow (combobox & dropmenu) */

    float dropdown_arrow_reserve;

    float dropdown_arrow_thickness;

    float dropdown_arrow_half_h;

    float dropdown_arrow_half_w;

    float dropdown_border_thickness;


    /* label */

    float label_padding;

    float link_underline_thickness;

    ALLEGRO_COLOR link_color_normal;

    ALLEGRO_COLOR link_color_hover;


    /* scroll step */

    float scroll_step;

    float global_scroll_step;


    /* combobox auto-width cap */

    float combobox_max_dropdown_width;

} N_GUI_STYLE;


/* ---- gui context ---- */


typedef struct N_GUI_CTX {

    LIST* windows;

    HASH_TABLE* widgets_by_id;

    int next_widget_id;

    int next_window_id;

    ALLEGRO_FONT* default_font;

    N_GUI_THEME default_theme;

    int focused_widget_id;

    int mouse_x;

    int mouse_y;

    int mouse_b1;

    int mouse_b1_prev;

    int open_combobox_id;

    int scrollbar_drag_widget_id;

    int open_dropmenu_id;

    float display_w;

    float display_h;

    float global_scroll_x;

    float global_scroll_y;

    float gui_bounds_w;

    float gui_bounds_h;

    float dpi_scale;

    float virtual_w;

    float virtual_h;

    float gui_scale;

    float gui_offset_x;

    float gui_offset_y;

    int global_vscroll_drag;

    int global_hscroll_drag;

    N_GUI_STYLE style;

    ALLEGRO_DISPLAY* display;

    int selected_label_id;

    int resize_mode;

    float ref_display_w;

    float ref_display_h;

} N_GUI_CTX;


/* =============== API =============== */


/* ---- style helpers ---- */


N_GUI_STYLE n_gui_default_style(void);


/* ---- theme helpers ---- */


N_GUI_THEME n_gui_default_theme(void);

N_GUI_THEME n_gui_make_theme(

    ALLEGRO_COLOR bg,

    ALLEGRO_COLOR bg_hover,

    ALLEGRO_COLOR bg_active,

    ALLEGRO_COLOR border,

    ALLEGRO_COLOR border_hover,

    ALLEGRO_COLOR border_active,

    ALLEGRO_COLOR text,

    ALLEGRO_COLOR text_hover,

    ALLEGRO_COLOR text_active,

    float border_thickness,

    float corner_rx,

    float corner_ry);


/* ---- text measurement ---- */


N_GUI_TEXT_DIMS n_gui_get_text_dims(ALLEGRO_FONT* font, const char* text);


/* ---- context ---- */


N_GUI_CTX* n_gui_new_ctx(ALLEGRO_FONT* default_font);

void n_gui_destroy_ctx(N_GUI_CTX** ctx);


/* ---- window management ---- */


int n_gui_add_window(N_GUI_CTX* ctx, const char* title, float x, float y, float w, float h);

int n_gui_add_window_auto(N_GUI_CTX* ctx, const char* title, float x, float y);

N_GUI_WINDOW* n_gui_get_window(N_GUI_CTX* ctx, int window_id);

void n_gui_close_window(N_GUI_CTX* ctx, int window_id);

void n_gui_open_window(N_GUI_CTX* ctx, int window_id);

void n_gui_toggle_window(N_GUI_CTX* ctx, int window_id);

int n_gui_window_is_open(N_GUI_CTX* ctx, int window_id);

void n_gui_minimize_window(N_GUI_CTX* ctx, int window_id);

void n_gui_raise_window(N_GUI_CTX* ctx, int window_id);

void n_gui_lower_window(N_GUI_CTX* ctx, int window_id);

void n_gui_window_set_zorder(N_GUI_CTX* ctx, int window_id, int z_mode, int z_value);

int n_gui_window_get_zorder(N_GUI_CTX* ctx, int window_id);

int n_gui_window_get_zvalue(N_GUI_CTX* ctx, int window_id);

void n_gui_window_set_flags(N_GUI_CTX* ctx, int window_id, int flags);

int n_gui_window_get_flags(N_GUI_CTX* ctx, int window_id);

void n_gui_window_autosize(N_GUI_CTX* ctx, int window_id);

void n_gui_window_set_autofit(N_GUI_CTX* ctx, int window_id, int autofit_flags, float border);

void n_gui_window_apply_autofit(N_GUI_CTX* ctx, int window_id);


/* ---- resize mode ---- */


void n_gui_set_resize_mode(N_GUI_CTX* ctx, int mode);


int n_gui_get_resize_mode(N_GUI_CTX* ctx);


void n_gui_window_set_resize_policy(N_GUI_CTX* ctx, int window_id, int policy);


int n_gui_window_get_resize_policy(N_GUI_CTX* ctx, int window_id);


void n_gui_window_update_normalized(N_GUI_CTX* ctx, int window_id);


void n_gui_apply_adaptive_resize(N_GUI_CTX* ctx, float new_w, float new_h);


/* ---- widget creation (returns widget id) ---- */


int n_gui_add_button(N_GUI_CTX* ctx, int window_id, const char* label, float x, float y, float w, float h, int shape, void (*on_click)(int, void*), void* user_data);


int n_gui_add_button_bitmap(N_GUI_CTX* ctx, int window_id, const char* label, float x, float y, float w, float h, ALLEGRO_BITMAP* normal, ALLEGRO_BITMAP* hover, ALLEGRO_BITMAP* active, void (*on_click)(int, void*), void* user_data);


int n_gui_add_toggle_button(N_GUI_CTX* ctx, int window_id, const char* label, float x, float y, float w, float h, int shape, int initial_state, void (*on_click)(int, void*), void* user_data);


int n_gui_button_is_toggled(N_GUI_CTX* ctx, int widget_id);

void n_gui_button_set_toggled(N_GUI_CTX* ctx, int widget_id, int toggled);

void n_gui_button_set_toggle_mode(N_GUI_CTX* ctx, int widget_id, int toggle_mode);


/* button keyboard binding */

void n_gui_button_set_keycode(N_GUI_CTX* ctx, int widget_id, int keycode, int modifiers);


void n_gui_button_set_keycode_focused(N_GUI_CTX* ctx, int widget_id, int keycode, int modifiers, const int* sources, int source_count);


int n_gui_add_slider(N_GUI_CTX* ctx, int window_id, float x, float y, float w, float h, double min_val, double max_val, double initial, int mode, void (*on_change)(int, double, void*), void* user_data);


int n_gui_add_vslider(N_GUI_CTX* ctx, int window_id, float x, float y, float w, float h, double min_val, double max_val, double initial, int mode, void (*on_change)(int, double, void*), void* user_data);


int n_gui_add_textarea(N_GUI_CTX* ctx, int window_id, float x, float y, float w, float h, int multiline, size_t char_limit, void (*on_change)(int, const char*, void*), void* user_data);


int n_gui_add_checkbox(N_GUI_CTX* ctx, int window_id, const char* label, float x, float y, float w, float h, int initial_checked, void (*on_toggle)(int, int, void*), void* user_data);


int n_gui_add_scrollbar(N_GUI_CTX* ctx, int window_id, float x, float y, float w, float h, int orientation, int shape, double content_size, double viewport_size, void (*on_scroll)(int, double, void*), void* user_data);


/* ---- widget access ---- */


N_GUI_WIDGET* n_gui_get_widget(N_GUI_CTX* ctx, int widget_id);

void n_gui_set_widget_theme(N_GUI_CTX* ctx, int widget_id, N_GUI_THEME theme);

void n_gui_set_widget_visible(N_GUI_CTX* ctx, int widget_id, int visible);

void n_gui_set_widget_enabled(N_GUI_CTX* ctx, int widget_id, int enabled);

int n_gui_is_widget_enabled(N_GUI_CTX* ctx, int widget_id);

void n_gui_set_focus(N_GUI_CTX* ctx, int widget_id);


/* slider helpers */

double n_gui_slider_get_value(N_GUI_CTX* ctx, int widget_id);

void n_gui_slider_set_value(N_GUI_CTX* ctx, int widget_id, double value);

void n_gui_slider_set_range(N_GUI_CTX* ctx, int widget_id, double min_val, double max_val);

void n_gui_slider_set_step(N_GUI_CTX* ctx, int widget_id, double step);


/* textarea helpers */

const char* n_gui_textarea_get_text(N_GUI_CTX* ctx, int widget_id);

void n_gui_textarea_set_text(N_GUI_CTX* ctx, int widget_id, const char* text);

void n_gui_textarea_scroll_to_bottom(N_GUI_CTX* ctx, int widget_id);

void n_gui_textarea_set_selection(N_GUI_CTX* ctx, int widget_id, size_t start, size_t end);

void n_gui_textarea_scroll_to_offset(N_GUI_CTX* ctx, int widget_id, size_t byte_offset);

size_t n_gui_textarea_get_text_length(N_GUI_CTX* ctx, int widget_id);


/* checkbox helpers */

int n_gui_checkbox_is_checked(N_GUI_CTX* ctx, int widget_id);

void n_gui_checkbox_set_checked(N_GUI_CTX* ctx, int widget_id, int checked);


/* scrollbar helpers */

double n_gui_scrollbar_get_pos(N_GUI_CTX* ctx, int widget_id);

void n_gui_scrollbar_set_pos(N_GUI_CTX* ctx, int widget_id, double pos);

void n_gui_scrollbar_set_sizes(N_GUI_CTX* ctx, int widget_id, double content_size, double viewport_size);


/* ---- listbox ---- */


int n_gui_add_listbox(N_GUI_CTX* ctx, int window_id, float x, float y, float w, float h, int selection_mode, void (*on_select)(int, int, int, void*), void* user_data);

int n_gui_listbox_add_item(N_GUI_CTX* ctx, int widget_id, const char* text);

int n_gui_listbox_remove_item(N_GUI_CTX* ctx, int widget_id, int index);

void n_gui_listbox_clear(N_GUI_CTX* ctx, int widget_id);

int n_gui_listbox_get_count(N_GUI_CTX* ctx, int widget_id);

const char* n_gui_listbox_get_item_text(N_GUI_CTX* ctx, int widget_id, int index);

int n_gui_listbox_get_selected(N_GUI_CTX* ctx, int widget_id);

int n_gui_listbox_is_selected(N_GUI_CTX* ctx, int widget_id, int index);

void n_gui_listbox_set_selected(N_GUI_CTX* ctx, int widget_id, int index, int selected);

int n_gui_listbox_get_scroll_offset(N_GUI_CTX* ctx, int widget_id);

void n_gui_listbox_set_scroll_offset(N_GUI_CTX* ctx, int widget_id, int offset);


/* ---- radiolist ---- */


int n_gui_add_radiolist(N_GUI_CTX* ctx, int window_id, float x, float y, float w, float h, void (*on_select)(int, int, void*), void* user_data);

int n_gui_radiolist_add_item(N_GUI_CTX* ctx, int widget_id, const char* text);

void n_gui_radiolist_clear(N_GUI_CTX* ctx, int widget_id);

int n_gui_radiolist_get_selected(N_GUI_CTX* ctx, int widget_id);

void n_gui_radiolist_set_selected(N_GUI_CTX* ctx, int widget_id, int index);


/* ---- combobox ---- */


int n_gui_add_combobox(N_GUI_CTX* ctx, int window_id, float x, float y, float w, float h, void (*on_select)(int, int, void*), void* user_data);

int n_gui_combobox_add_item(N_GUI_CTX* ctx, int widget_id, const char* text);

void n_gui_combobox_clear(N_GUI_CTX* ctx, int widget_id);

int n_gui_combobox_get_selected(N_GUI_CTX* ctx, int widget_id);

void n_gui_combobox_set_selected(N_GUI_CTX* ctx, int widget_id, int index);


void n_gui_combobox_set_flags(N_GUI_CTX* ctx, int widget_id, int flags);


/* ---- image ---- */


int n_gui_add_image(N_GUI_CTX* ctx, int window_id, float x, float y, float w, float h, ALLEGRO_BITMAP* bitmap, int scale_mode);

void n_gui_image_set_bitmap(N_GUI_CTX* ctx, int widget_id, ALLEGRO_BITMAP* bitmap);


/* ---- label (static text, optional hyperlink) ---- */


int n_gui_add_label(N_GUI_CTX* ctx, int window_id, const char* text, float x, float y, float w, float h, int align);

int n_gui_add_label_link(N_GUI_CTX* ctx, int window_id, const char* text, const char* link, float x, float y, float w, float h, int align, void (*on_link_click)(int, const char*, void*), void* user_data);

void n_gui_label_set_text(N_GUI_CTX* ctx, int widget_id, const char* text);

void n_gui_label_set_link(N_GUI_CTX* ctx, int widget_id, const char* link);


/* ---- dropdown menu ---- */


int n_gui_add_dropmenu(N_GUI_CTX* ctx, int window_id, const char* label, float x, float y, float w, float h, void (*on_open)(int, void*), void* on_open_user_data);

int n_gui_dropmenu_add_entry(N_GUI_CTX* ctx, int widget_id, const char* text, int tag, void (*on_click)(int, int, int, void*), void* user_data);

int n_gui_dropmenu_add_dynamic_entry(N_GUI_CTX* ctx, int widget_id, const char* text, int tag, void (*on_click)(int, int, int, void*), void* user_data);

void n_gui_dropmenu_clear_dynamic(N_GUI_CTX* ctx, int widget_id);

void n_gui_dropmenu_clear(N_GUI_CTX* ctx, int widget_id);

void n_gui_dropmenu_set_entry_text(N_GUI_CTX* ctx, int widget_id, int index, const char* text);

int n_gui_dropmenu_get_count(N_GUI_CTX* ctx, int widget_id);


/* ---- bitmap skinning ---- */


void n_gui_window_set_bitmaps(N_GUI_CTX* ctx, int window_id, ALLEGRO_BITMAP* bg, ALLEGRO_BITMAP* titlebar, int bg_scale_mode);


void n_gui_slider_set_bitmaps(N_GUI_CTX* ctx, int widget_id, ALLEGRO_BITMAP* track, ALLEGRO_BITMAP* fill, ALLEGRO_BITMAP* handle, ALLEGRO_BITMAP* handle_hover, ALLEGRO_BITMAP* handle_active);


void n_gui_scrollbar_set_bitmaps(N_GUI_CTX* ctx, int widget_id, ALLEGRO_BITMAP* track, ALLEGRO_BITMAP* thumb, ALLEGRO_BITMAP* thumb_hover, ALLEGRO_BITMAP* thumb_active);


void n_gui_checkbox_set_bitmaps(N_GUI_CTX* ctx, int widget_id, ALLEGRO_BITMAP* box, ALLEGRO_BITMAP* box_checked, ALLEGRO_BITMAP* box_hover);


void n_gui_textarea_set_bitmap(N_GUI_CTX* ctx, int widget_id, ALLEGRO_BITMAP* bg);


void n_gui_textarea_set_mask_char(N_GUI_CTX* ctx, int widget_id, char mask);


void n_gui_listbox_set_bitmaps(N_GUI_CTX* ctx, int widget_id, ALLEGRO_BITMAP* bg, ALLEGRO_BITMAP* item_bg, ALLEGRO_BITMAP* item_selected);


void n_gui_radiolist_set_bitmaps(N_GUI_CTX* ctx, int widget_id, ALLEGRO_BITMAP* bg, ALLEGRO_BITMAP* item_bg, ALLEGRO_BITMAP* item_selected);


void n_gui_combobox_set_bitmaps(N_GUI_CTX* ctx, int widget_id, ALLEGRO_BITMAP* bg, ALLEGRO_BITMAP* item_bg, ALLEGRO_BITMAP* item_selected);


void n_gui_dropmenu_set_bitmaps(N_GUI_CTX* ctx, int widget_id, ALLEGRO_BITMAP* panel, ALLEGRO_BITMAP* item_hover);


void n_gui_label_set_bitmap(N_GUI_CTX* ctx, int widget_id, ALLEGRO_BITMAP* bg);


/* ---- JSON theme I/O ---- */


int n_gui_save_theme_json(N_GUI_CTX* ctx, const char* filepath);


int n_gui_load_theme_json(N_GUI_CTX* ctx, const char* filepath);


/* ---- virtual canvas / display / DPI ---- */


void n_gui_set_virtual_size(N_GUI_CTX* ctx, float w, float h);


void n_gui_update_transform(N_GUI_CTX* ctx);


void n_gui_screen_to_virtual(const N_GUI_CTX* ctx, float sx, float sy, float* vx, float* vy);


void n_gui_set_display_size(N_GUI_CTX* ctx, float w, float h);

void n_gui_set_display(N_GUI_CTX* ctx, ALLEGRO_DISPLAY* display);


void n_gui_set_dpi_scale(N_GUI_CTX* ctx, float scale);


float n_gui_get_dpi_scale(const N_GUI_CTX* ctx);


float n_gui_detect_dpi_scale(N_GUI_CTX* ctx, ALLEGRO_DISPLAY* display);


/* ---- event processing & drawing ---- */


int n_gui_process_event(N_GUI_CTX* ctx, ALLEGRO_EVENT event);

void n_gui_draw(N_GUI_CTX* ctx);

int n_gui_wants_mouse(N_GUI_CTX* ctx);


#define N_GUI_TAB_MAX 16


typedef struct N_GUI_TAB_PANEL {

    N_GUI_CTX* ctx;

    int parent_window_id;

    int button_ids[N_GUI_TAB_MAX];

    int content_window_ids[N_GUI_TAB_MAX];

    int nb_tabs;

    int active_tab;

    float x;

    float y;

    float button_w;

    float button_h;

    void (*on_tab_change)(int, void*);

    void* user_data;

} N_GUI_TAB_PANEL;


N_GUI_TAB_PANEL* n_gui_tab_create(N_GUI_CTX* ctx, int window_id, float x, float y, float button_w, float button_h, void (*on_tab_change)(int, void*), void* user_data);

int n_gui_tab_add(N_GUI_TAB_PANEL* panel, const char* label);

void n_gui_tab_set_content_window(N_GUI_TAB_PANEL* panel, int tab_index, int window_id);

void n_gui_tab_set_active(N_GUI_TAB_PANEL* panel, int index);

int n_gui_tab_get_active(N_GUI_TAB_PANEL* panel);

void n_gui_tab_free(N_GUI_TAB_PANEL** panel);


#define N_GUI_TREE_MAX 512


typedef struct N_GUI_TREE_NODE {

    char label[128];

    int parent_index;

    int expanded;

    int depth;

    int has_children;

    void* user_data;

} N_GUI_TREE_NODE;


typedef struct N_GUI_TREE {

    N_GUI_CTX* ctx;

    int listbox_id;

    N_GUI_TREE_NODE nodes[N_GUI_TREE_MAX];

    int nb_nodes;

    int visible_map[N_GUI_TREE_MAX];

    int nb_visible;

    void (*on_select)(int, void*);

    void* user_data;

} N_GUI_TREE;


N_GUI_TREE* n_gui_tree_create(N_GUI_CTX* ctx, int window_id, float x, float y, float w, float h, void (*on_select)(int, void*), void* user_data);

int n_gui_tree_add_node(N_GUI_TREE* tree, const char* label, int parent_index, void* user_data);

void n_gui_tree_toggle_expand(N_GUI_TREE* tree, int node_index);

void n_gui_tree_rebuild(N_GUI_TREE* tree);

void n_gui_tree_free(N_GUI_TREE** tree);


#define N_GUI_KV_MAX 128


typedef struct N_GUI_KV_ROW {

    int key_id;

    int value_id;

    int desc_id;

    int enabled_id;

    int remove_id;

    int active;

} N_GUI_KV_ROW;


typedef struct N_GUI_KVTABLE {

    N_GUI_CTX* ctx;

    int window_id;

    N_GUI_KV_ROW rows[N_GUI_KV_MAX];

    int nb_rows;

    int nb_active;

    float row_height;

    float padding;

    float header_height;

    int lbl_key;

    int lbl_value;

    int lbl_desc;

    int lbl_enabled;

    int btn_add;

    void (*on_remove)(int, void*);

    void* user_data;

} N_GUI_KVTABLE;


N_GUI_KVTABLE* n_gui_kvtable_create(N_GUI_CTX* ctx, int window_id, float row_height, float padding, void (*on_remove)(int, void*), void* user_data);

int n_gui_kvtable_add_row(N_GUI_KVTABLE* table,

                          const char* key,

                          const char* value,

                          const char* description,

                          int enabled);

void n_gui_kvtable_remove_row(N_GUI_KVTABLE* table, int row_index);

int n_gui_kvtable_get_count(N_GUI_KVTABLE* table);

void n_gui_kvtable_free(N_GUI_KVTABLE** table);


#ifdef __cplusplus

}

#endif


#endif /* __NILOREA_GUI__ */

display
ALLEGRO_DISPLAY * display
Definition ex_fluid.c:53

on_link_click
void on_link_click(int widget_id, const char *link, void *user_data)
Definition ex_gui.c:140

on_scroll
void on_scroll(int widget_id, double pos, void *user_data)
Definition ex_gui.c:103

mode
static int mode
Definition ex_gui_network.c:65

key
char * key
Definition ex_network_ssl.c:38

N_GUI_WINDOW::title
char title[128]
window title
Definition n_gui.h:659

N_GUI_SCROLLBAR_DATA::thumb_bitmap
ALLEGRO_BITMAP * thumb_bitmap
optional bitmap for the thumb/handle, normal state (NULL = color theme)
Definition n_gui.h:431

N_GUI_WIDGET::h
float h
height
Definition n_gui.h:629

N_GUI_LABEL_DATA::scroll_y
float scroll_y
vertical scroll offset for overflowing text (pixels)
Definition n_gui.h:555

N_GUI_WINDOW::scroll_y
float scroll_y
vertical scroll offset for auto-scrollbar (pixels)
Definition n_gui.h:689

N_GUI_WIDGET::visible
int visible
visibility flag
Definition n_gui.h:633

N_GUI_DROPMENU_DATA::panel_bitmap
ALLEGRO_BITMAP * panel_bitmap
optional bitmap for the dropdown panel background (NULL = color theme)
Definition n_gui.h:603

N_GUI_SLIDER_DATA::handle_hover_bitmap
ALLEGRO_BITMAP * handle_hover_bitmap
optional bitmap for the handle on hover (NULL = fallback to handle_bitmap)
Definition n_gui.h:352

N_GUI_TAB_PANEL::button_h
float button_h
height of each tab button
Definition n_gui.h:1434

N_GUI_COMBOBOX_DATA::is_open
int is_open
is dropdown currently open
Definition n_gui.h:517

N_GUI_TAB_PANEL::content_window_ids
int content_window_ids[16]
content window IDs (-1 = none)
Definition n_gui.h:1428

N_GUI_TEXT_DIMS::w
int w
bounding box width in pixels
Definition n_gui.h:249

N_GUI_CTX::open_combobox_id
int open_combobox_id
id of the combobox whose dropdown is currently open, or -1
Definition n_gui.h:906

N_GUI_STYLE::scrollbar_track_color
ALLEGRO_COLOR scrollbar_track_color
scrollbar track colour
Definition n_gui.h:754

N_GUI_COMBOBOX_DATA::max_visible
int max_visible
max visible items in dropdown
Definition n_gui.h:523

N_GUI_COMBOBOX_DATA::selected_index
int selected_index
currently selected index (-1 = none)
Definition n_gui.h:515

N_GUI_KVTABLE::on_remove
void(* on_remove)(int, void *)
callback on row removal
Definition n_gui.h:1516

N_GUI_LISTBOX_DATA::items_capacity
size_t items_capacity
allocated capacity
Definition n_gui.h:457

N_GUI_STYLE::grip_color
ALLEGRO_COLOR grip_color
grip line colour
Definition n_gui.h:782

N_GUI_STYLE::dropdown_border_thickness
float dropdown_border_thickness
dropdown panel border thickness
Definition n_gui.h:856

N_GUI_TEXTAREA_DATA::text
char * text
text content (dynamically allocated, text_alloc bytes)
Definition n_gui.h:364

N_GUI_KVTABLE::nb_rows
int nb_rows
total rows (including removed)
Definition n_gui.h:1506

N_GUI_STYLE::slider_handle_edge_offset
float slider_handle_edge_offset
handle circle offset from edge
Definition n_gui.h:794

N_GUI_TREE_NODE::parent_index
int parent_index
parent node index, or -1 for root
Definition n_gui.h:1458

N_GUI_SCROLLBAR_DATA::shape
int shape
shape type: N_GUI_SHAPE_RECT or N_GUI_SHAPE_ROUNDED
Definition n_gui.h:427

N_GUI_WINDOW::content_h
float content_h
total content height computed from widgets (internal)
Definition n_gui.h:693

N_GUI_STYLE::global_scrollbar_thumb_padding
float global_scrollbar_thumb_padding
global thumb inset from track edge
Definition n_gui.h:764

N_GUI_DROPMENU_DATA::label
char label[128]
menu label (shown on the button)
Definition n_gui.h:587

N_GUI_COMBOBOX_DATA::items_capacity
size_t items_capacity
allocated capacity
Definition n_gui.h:513

N_GUI_WINDOW::x
float x
position x on screen
Definition n_gui.h:661

N_GUI_STYLE::scrollbar_size
float scrollbar_size
scrollbar track width/height
Definition n_gui.h:746

N_GUI_WINDOW::norm_y
float norm_y
normalized position y (0.0–1.0 fraction of reference display height)
Definition n_gui.h:719

N_GUI_RADIOLIST_DATA::on_select
void(* on_select)(int widget_id, int index, void *user_data)
callback on selection change (widget_id, selected_index, user_data)
Definition n_gui.h:497

N_GUI_STYLE::scrollbar_thumb_corner_r
float scrollbar_thumb_corner_r
thumb corner radius
Definition n_gui.h:752

N_GUI_DROPMENU_ENTRY::is_dynamic
int is_dynamic
is this entry dynamic (rebuilt via callback each time menu opens)
Definition n_gui.h:575

N_GUI_STYLE::title_padding
float title_padding
padding left of title text
Definition n_gui.h:740

N_GUI_STYLE::min_win_h
float min_win_h
minimum window height (for resize)
Definition n_gui.h:738

N_GUI_STYLE::dropdown_arrow_half_w
float dropdown_arrow_half_w
horizontal half-extent of the arrow chevron
Definition n_gui.h:854

N_GUI_BUTTON_DATA::toggled
int toggled
toggle state: 0 = off/unclicked, 1 = on/clicked (only used when toggle_mode=1)
Definition n_gui.h:309

N_GUI_KVTABLE::lbl_enabled
int lbl_enabled
label widget ID for "On" header
Definition n_gui.h:1514

N_GUI_LISTBOX_DATA::item_bg_bitmap
ALLEGRO_BITMAP * item_bg_bitmap
optional bitmap for per-item background, normal state (NULL = color theme)
Definition n_gui.h:467

N_GUI_RADIOLIST_DATA::scroll_offset
int scroll_offset
scroll offset in items
Definition n_gui.h:487

N_GUI_CTX::ref_display_h
float ref_display_h
reference display height at the time normalized values were last captured
Definition n_gui.h:950

N_GUI_STYLE::slider_track_corner_r
float slider_track_corner_r
track corner radius
Definition n_gui.h:788

N_GUI_TEXT_DIMS::y
int y
bounding box y offset from draw origin
Definition n_gui.h:248

N_GUI_WINDOW::titlebar_h
float titlebar_h
title bar height
Definition n_gui.h:669

N_GUI_SLIDER_DATA::handle_active_bitmap
ALLEGRO_BITMAP * handle_active_bitmap
optional bitmap for the handle while dragging (NULL = fallback to handle_bitmap)
Definition n_gui.h:354

N_GUI_TAB_PANEL::on_tab_change
void(* on_tab_change)(int, void *)
callback on tab switch (may be NULL)
Definition n_gui.h:1435

N_GUI_WIDGET::norm_y
float norm_y
normalized position y (fraction of parent window h, used for SCALE resize)
Definition n_gui.h:645

N_GUI_STYLE::dropmenu_max_visible
int dropmenu_max_visible
default max visible items for dropmenu panel
Definition n_gui.h:838

N_GUI_WINDOW::norm_x
float norm_x
normalized position x (0.0–1.0 fraction of reference display width)
Definition n_gui.h:717

N_GUI_STYLE::textarea_padding
float textarea_padding
inner padding
Definition n_gui.h:802

N_GUI_LABEL_DATA::bg_bitmap
ALLEGRO_BITMAP * bg_bitmap
optional bitmap for the label background (NULL = no background)
Definition n_gui.h:563

N_GUI_DROPMENU_DATA::item_height
float item_height
item height
Definition n_gui.h:601

N_GUI_WIDGET::theme
N_GUI_THEME theme
color theme for this widget
Definition n_gui.h:637

N_GUI_STYLE::title_max_w_reserve
float title_max_w_reserve
pixels reserved right of title for truncation
Definition n_gui.h:742

N_GUI_LISTITEM::text
char text[128]
item display text
Definition n_gui.h:445

N_GUI_TAB_PANEL::nb_tabs
int nb_tabs
number of tabs
Definition n_gui.h:1429

N_GUI_BUTTON_DATA::key_sources
int key_sources[8]
widget IDs that can trigger this focused key binding.
Definition n_gui.h:324

N_GUI_STYLE::checkbox_label_gap
float checkbox_label_gap
gap between box and label text
Definition n_gui.h:816

N_GUI_CTX::open_dropmenu_id
int open_dropmenu_id
id of the dropdown menu whose panel is currently open, or -1
Definition n_gui.h:910

N_GUI_STYLE::global_scrollbar_thumb_corner_r
float global_scrollbar_thumb_corner_r
global thumb corner radius
Definition n_gui.h:766

N_GUI_CTX::default_theme
N_GUI_THEME default_theme
default theme (applied to new widgets/windows)
Definition n_gui.h:894

N_GUI_CTX::dpi_scale
float dpi_scale
DPI scale factor (1.0 = normal, 1.25 = 125%, 2.0 = HiDPI, etc.)
Definition n_gui.h:924

N_GUI_LABEL_DATA::user_data
void * user_data
user data for callback
Definition n_gui.h:567

N_GUI_TEXTAREA_DATA::scroll_from_wheel
int scroll_from_wheel
set to 1 when scroll was changed by mouse wheel, cleared on key input
Definition n_gui.h:385

N_GUI_KVTABLE::btn_add
int btn_add
button widget ID for "+" add row
Definition n_gui.h:1515

N_GUI_WINDOW::bg_bitmap
ALLEGRO_BITMAP * bg_bitmap
optional bitmap for the window body background (NULL = color fill)
Definition n_gui.h:701

N_GUI_STYLE::scrollbar_thumb_padding
float scrollbar_thumb_padding
thumb inset from track edge
Definition n_gui.h:750

N_GUI_WIDGET::w
float w
width
Definition n_gui.h:627

N_GUI_TREE::visible_map
int visible_map[512]
visible row to node index
Definition n_gui.h:1471

N_GUI_THEME::text_normal
ALLEGRO_COLOR text_normal
text normal
Definition n_gui.h:270

N_GUI_KV_ROW::remove_id
int remove_id
button widget ID for the remove action
Definition n_gui.h:1497

N_GUI_WINDOW::w
float w
window width
Definition n_gui.h:665

N_GUI_STYLE::combobox_max_visible
int combobox_max_visible
default max visible items for combobox dropdown
Definition n_gui.h:836

N_GUI_COMBOBOX_DATA::item_bg_bitmap
ALLEGRO_BITMAP * item_bg_bitmap
optional bitmap for per-item background, normal state (NULL = color theme)
Definition n_gui.h:527

N_GUI_WIDGET::norm_h
float norm_h
normalized height (fraction of parent window h)
Definition n_gui.h:649

N_GUI_TREE::user_data
void * user_data
user data for callback
Definition n_gui.h:1474

N_GUI_DROPMENU_DATA::on_open
void(* on_open)(int widget_id, void *user_data)
callback to rebuild dynamic entries each time the menu is opened.
Definition n_gui.h:609

N_GUI_CTX::mouse_b1_prev
int mouse_b1_prev
previous mouse button 1 state
Definition n_gui.h:904

N_GUI_TREE::listbox_id
int listbox_id
listbox widget ID
Definition n_gui.h:1468

N_GUI_THEME::corner_rx
float corner_rx
corner radius for rounded shapes
Definition n_gui.h:278

N_GUI_THEME::selection_color
ALLEGRO_COLOR selection_color
text selection highlight colour (semi-transparent recommended)
Definition n_gui.h:282

N_GUI_BUTTON_DATA::bitmap
ALLEGRO_BITMAP * bitmap
optional bitmap for the button (NULL = color theme)
Definition n_gui.h:299

N_GUI_COMBOBOX_DATA::flags
int flags
bitmask of N_GUI_COMBOBOX_* flags
Definition n_gui.h:535

N_GUI_CTX::gui_offset_x
float gui_offset_x
horizontal letterbox offset for virtual canvas
Definition n_gui.h:932

N_GUI_BUTTON_DATA::key_focus_only
int key_focus_only
if 1, keycode fires only when the button itself or a source widget has focus.
Definition n_gui.h:321

N_GUI_KVTABLE::rows
N_GUI_KV_ROW rows[128]
row storage
Definition n_gui.h:1505

N_GUI_WIDGET::type
int type
widget type (N_GUI_TYPE_*)
Definition n_gui.h:621

N_GUI_WIDGET::state
int state
current state flags (N_GUI_STATE_*)
Definition n_gui.h:631

N_GUI_STYLE::scroll_step
float scroll_step
pixels per mouse wheel notch for window auto-scroll
Definition n_gui.h:870

N_GUI_TEXTAREA_DATA::multiline
int multiline
0 = single line, 1 = multiline
Definition n_gui.h:372

N_GUI_KV_ROW::key_id
int key_id
textarea widget ID for the key
Definition n_gui.h:1493

N_GUI_BUTTON_DATA::bitmap_hover
ALLEGRO_BITMAP * bitmap_hover
optional bitmap for hover state
Definition n_gui.h:301

N_GUI_TAB_PANEL::button_ids
int button_ids[16]
toggle button widget IDs
Definition n_gui.h:1427

N_GUI_DROPMENU_DATA::max_visible
int max_visible
max visible items
Definition n_gui.h:599

N_GUI_CTX::gui_bounds_w
float gui_bounds_w
total bounding box width of all windows (computed internally)
Definition n_gui.h:920

N_GUI_WIDGET::x
float x
position x relative to parent window
Definition n_gui.h:623

N_GUI_STYLE::global_scrollbar_size
float global_scrollbar_size
global scrollbar track width/height
Definition n_gui.h:760

N_GUI_STYLE::textarea_cursor_width
float textarea_cursor_width
cursor width in pixels
Definition n_gui.h:804

N_GUI_LABEL_DATA::text
char text[4096]
text to display
Definition n_gui.h:549

N_GUI_TAB_PANEL::user_data
void * user_data
user data for callback
Definition n_gui.h:1436

N_GUI_WINDOW::norm_h
float norm_h
normalized height (fraction of reference display height, used in SCALE mode)
Definition n_gui.h:723

N_GUI_STYLE::min_win_w
float min_win_w
minimum window width (for resize)
Definition n_gui.h:736

N_GUI_COMBOBOX_DATA::bg_bitmap
ALLEGRO_BITMAP * bg_bitmap
optional bitmap for the combobox background (NULL = color theme)
Definition n_gui.h:525

N_GUI_SLIDER_DATA::on_change
void(* on_change)(int widget_id, double value, void *user_data)
callback on value change
Definition n_gui.h:356

N_GUI_RADIOLIST_DATA::item_height
float item_height
item height in pixels
Definition n_gui.h:489

N_GUI_WINDOW::drag_ox
float drag_ox
drag offset x (internal)
Definition n_gui.h:681

N_GUI_BUTTON_DATA::on_click
void(* on_click)(int widget_id, void *user_data)
callback on click (widget_id passed)
Definition n_gui.h:326

N_GUI_KVTABLE::row_height
float row_height
height of each row in pixels
Definition n_gui.h:1508

N_GUI_TREE_NODE::expanded
int expanded
1 if expanded
Definition n_gui.h:1459

N_GUI_COMBOBOX_DATA::items
N_GUI_LISTITEM * items
dynamic array of items
Definition n_gui.h:509

N_GUI_TREE_NODE::label
char label[128]
display text
Definition n_gui.h:1457

N_GUI_WINDOW::theme
N_GUI_THEME theme
color theme for this window chrome
Definition n_gui.h:677

N_GUI_WIDGET::id
int id
unique widget id
Definition n_gui.h:619

N_GUI_KV_ROW::desc_id
int desc_id
textarea widget ID for the description
Definition n_gui.h:1495

N_GUI_CTX::next_window_id
int next_window_id
next window id to assign
Definition n_gui.h:890

N_GUI_STYLE::item_selection_inset
float item_selection_inset
item highlight inset from left/right edges
Definition n_gui.h:842

N_GUI_THEME::border_normal
ALLEGRO_COLOR border_normal
border normal
Definition n_gui.h:264

N_GUI_DROPMENU_ENTRY::on_click
void(* on_click)(int widget_id, int entry_index, int tag, void *user_data)
callback when this entry is clicked (widget_id, entry_index, tag, user_data)
Definition n_gui.h:579

N_GUI_TREE_NODE::has_children
int has_children
1 if node has children
Definition n_gui.h:1461

N_GUI_DROPMENU_ENTRY::user_data
void * user_data
user data for callback
Definition n_gui.h:581

N_GUI_DROPMENU_DATA::scroll_offset
int scroll_offset
scroll offset
Definition n_gui.h:597

N_GUI_THEME::text_hover
ALLEGRO_COLOR text_hover
text hover
Definition n_gui.h:272

N_GUI_STYLE::dropdown_arrow_half_h
float dropdown_arrow_half_h
vertical half-extent of the arrow chevron
Definition n_gui.h:852

N_GUI_WINDOW::z_value
int z_value
z-value for N_GUI_ZORDER_FIXED mode (lower = behind, higher = on top)
Definition n_gui.h:699

N_GUI_RADIOLIST_DATA::item_bg_bitmap
ALLEGRO_BITMAP * item_bg_bitmap
optional bitmap for per-item background, normal state (NULL = color theme)
Definition n_gui.h:493

N_GUI_TEXTAREA_DATA::cursor_time
double cursor_time
timestamp of last cursor activity (for blink reset)
Definition n_gui.h:387

N_GUI_DROPMENU_DATA::entries_capacity
size_t entries_capacity
allocated capacity
Definition n_gui.h:593

N_GUI_CTX::mouse_y
int mouse_y
mouse state tracking
Definition n_gui.h:900

N_GUI_STYLE::grip_line_thickness
float grip_line_thickness
grip line thickness
Definition n_gui.h:780

N_GUI_KVTABLE::lbl_key
int lbl_key
label widget ID for "Key" header
Definition n_gui.h:1511

N_GUI_TEXTAREA_DATA::sel_end
size_t sel_end
selection end position (tracks cursor during selection)
Definition n_gui.h:379

N_GUI_WINDOW::resize_policy
int resize_policy
per-window resize policy: N_GUI_WIN_RESIZE_NONE, _MOVE, or _SCALE
Definition n_gui.h:715

N_GUI_RADIOLIST_DATA::nb_items
size_t nb_items
number of items
Definition n_gui.h:481

N_GUI_COMBOBOX_DATA::user_data
void * user_data
user data for callback
Definition n_gui.h:533

N_GUI_KVTABLE::padding
float padding
horizontal padding
Definition n_gui.h:1509

N_GUI_TREE::on_select
void(* on_select)(int, void *)
selection callback
Definition n_gui.h:1473

N_GUI_BUTTON_DATA::shape
int shape
shape type: N_GUI_SHAPE_RECT, N_GUI_SHAPE_ROUNDED, N_GUI_SHAPE_BITMAP
Definition n_gui.h:305

N_GUI_WINDOW::z_order
int z_order
z-order mode (N_GUI_ZORDER_NORMAL, _ALWAYS_ON_TOP, _ALWAYS_BEHIND, _FIXED)
Definition n_gui.h:697

N_GUI_DROPMENU_ENTRY::tag
int tag
user-defined tag for the entry (e.g.
Definition n_gui.h:577

N_GUI_CTX::mouse_b1
int mouse_b1
mouse button 1 state
Definition n_gui.h:902

N_GUI_TAB_PANEL::button_w
float button_w
width of each tab button
Definition n_gui.h:1433

N_GUI_CTX::display_w
float display_w
display/viewport width (set via n_gui_set_display_size)
Definition n_gui.h:912

N_GUI_RADIOLIST_DATA::items
N_GUI_LISTITEM * items
dynamic array of items
Definition n_gui.h:479

N_GUI_CHECKBOX_DATA::box_hover_bitmap
ALLEGRO_BITMAP * box_hover_bitmap
optional bitmap for the checkbox square on hover (NULL = fallback to box_bitmap/box_checked_bitmap)
Definition n_gui.h:409

N_GUI_TEXT_DIMS::h
int h
bounding box height in pixels
Definition n_gui.h:250

N_GUI_STYLE::grip_size
float grip_size
grip area size
Definition n_gui.h:778

N_GUI_STYLE::radio_label_gap
float radio_label_gap
gap between circle and label text
Definition n_gui.h:828

N_GUI_TREE::ctx
N_GUI_CTX * ctx
GUI context.
Definition n_gui.h:1467

N_GUI_CTX::display
ALLEGRO_DISPLAY * display
display pointer for clipboard operations (set via n_gui_set_display)
Definition n_gui.h:942

N_GUI_WINDOW::norm_w
float norm_w
normalized width (fraction of reference display width, used in SCALE mode)
Definition n_gui.h:721

N_GUI_WINDOW::content_w
float content_w
total content width computed from widgets (internal)
Definition n_gui.h:695

N_GUI_TREE_NODE::user_data
void * user_data
user data for this node
Definition n_gui.h:1462

N_GUI_WIDGET::norm_x
float norm_x
normalized position x (fraction of parent window w, used for SCALE resize)
Definition n_gui.h:643

N_GUI_STYLE::global_scrollbar_thumb_color
ALLEGRO_COLOR global_scrollbar_thumb_color
global scrollbar thumb colour
Definition n_gui.h:772

N_GUI_CTX::selected_label_id
int selected_label_id
id of the label widget with the most recent text selection, or -1
Definition n_gui.h:944

N_GUI_STYLE::radio_inner_offset
float radio_inner_offset
inner filled circle shrink from outer
Definition n_gui.h:826

N_GUI_WINDOW::min_w
float min_w
minimum width
Definition n_gui.h:685

N_GUI_RADIOLIST_DATA::selected_index
int selected_index
currently selected index (-1 = none)
Definition n_gui.h:485

N_GUI_SLIDER_DATA::track_bitmap
ALLEGRO_BITMAP * track_bitmap
optional bitmap for the track/rail background (NULL = color theme)
Definition n_gui.h:346

N_GUI_CTX::mouse_x
int mouse_x
mouse state tracking
Definition n_gui.h:898

N_GUI_STYLE::scrollbar_thumb_color
ALLEGRO_COLOR scrollbar_thumb_color
scrollbar thumb colour
Definition n_gui.h:756

N_GUI_TAB_PANEL::active_tab
int active_tab
currently active tab index
Definition n_gui.h:1430

N_GUI_STYLE::checkbox_max_size
float checkbox_max_size
maximum box size
Definition n_gui.h:810

N_GUI_DROPMENU_DATA::nb_entries
size_t nb_entries
number of entries
Definition n_gui.h:591

N_GUI_STYLE::checkbox_mark_thickness
float checkbox_mark_thickness
checkmark line thickness
Definition n_gui.h:814

N_GUI_LABEL_DATA::sel_start
int sel_start
selection start byte offset (-1 = no selection)
Definition n_gui.h:557

N_GUI_IMAGE_DATA::bitmap
ALLEGRO_BITMAP * bitmap
bitmap to display (not owned, not freed)
Definition n_gui.h:541

N_GUI_SLIDER_DATA::fill_bitmap
ALLEGRO_BITMAP * fill_bitmap
optional bitmap for the filled portion of the track (NULL = color theme)
Definition n_gui.h:348

N_GUI_KVTABLE::header_height
float header_height
height of the column header row
Definition n_gui.h:1510

N_GUI_STYLE::global_scroll_step
float global_scroll_step
pixels per mouse wheel notch for global scroll
Definition n_gui.h:872

N_GUI_WINDOW::h
float h
window height
Definition n_gui.h:667

N_GUI_COMBOBOX_DATA::item_height
float item_height
item height in dropdown
Definition n_gui.h:521

N_GUI_CHECKBOX_DATA::user_data
void * user_data
user data for callback
Definition n_gui.h:413

N_GUI_SCROLLBAR_DATA::scroll_pos
double scroll_pos
current scroll position
Definition n_gui.h:425

N_GUI_TEXTAREA_DATA::on_change
void(* on_change)(int widget_id, const char *text, void *user_data)
callback on text change
Definition n_gui.h:393

N_GUI_COMBOBOX_DATA::item_selected_bitmap
ALLEGRO_BITMAP * item_selected_bitmap
optional bitmap for per-item background, selected/highlighted (NULL = color theme)
Definition n_gui.h:529

N_GUI_SLIDER_DATA::user_data
void * user_data
user data for callback
Definition n_gui.h:358

N_GUI_WINDOW::autofit_origin_y
float autofit_origin_y
original insertion point y for N_GUI_AUTOFIT_CENTER (set by n_gui_window_set_autofit)
Definition n_gui.h:713

N_GUI_LISTBOX_DATA::scroll_offset
int scroll_offset
scroll offset in items
Definition n_gui.h:461

N_GUI_LISTITEM::selected
int selected
selection state (for listbox)
Definition n_gui.h:447

N_GUI_DROPMENU_DATA::item_hover_bitmap
ALLEGRO_BITMAP * item_hover_bitmap
optional bitmap for the hovered entry background (NULL = color theme)
Definition n_gui.h:605

N_GUI_CTX::virtual_h
float virtual_h
virtual canvas height (0 = disabled / identity transform)
Definition n_gui.h:928

N_GUI_KVTABLE::ctx
N_GUI_CTX * ctx
GUI context.
Definition n_gui.h:1503

N_GUI_CTX::global_scroll_x
float global_scroll_x
global horizontal scroll offset (when GUI exceeds display)
Definition n_gui.h:916

N_GUI_STYLE::checkbox_mark_margin
float checkbox_mark_margin
checkmark inset from box edge
Definition n_gui.h:812

N_GUI_SCROLLBAR_DATA::track_bitmap
ALLEGRO_BITMAP * track_bitmap
optional bitmap for the scrollbar track background (NULL = color theme)
Definition n_gui.h:429

N_GUI_STYLE::checkbox_label_offset
float checkbox_label_offset
horizontal offset from box edge to label text
Definition n_gui.h:818

N_GUI_WINDOW::titlebar_bitmap
ALLEGRO_BITMAP * titlebar_bitmap
optional bitmap for the titlebar background (NULL = color fill)
Definition n_gui.h:703

N_GUI_COMBOBOX_DATA::scroll_offset
int scroll_offset
scroll offset in dropdown
Definition n_gui.h:519

N_GUI_TAB_PANEL::ctx
N_GUI_CTX * ctx
GUI context.
Definition n_gui.h:1425

N_GUI_WIDGET::data
void * data
widget-specific data (union via void pointer)
Definition n_gui.h:641

N_GUI_SLIDER_DATA::value
double value
current value (always snapped to step)
Definition n_gui.h:338

N_GUI_DROPMENU_DATA::entries
N_GUI_DROPMENU_ENTRY * entries
dynamic array of entries
Definition n_gui.h:589

N_GUI_WINDOW::drag_oy
float drag_oy
drag offset y (internal)
Definition n_gui.h:683

N_GUI_STYLE::slider_track_border_thickness
float slider_track_border_thickness
track outline thickness
Definition n_gui.h:790

N_GUI_KVTABLE::nb_active
int nb_active
active row count
Definition n_gui.h:1507

N_GUI_STYLE::link_color_normal
ALLEGRO_COLOR link_color_normal
link colour (normal)
Definition n_gui.h:864

N_GUI_STYLE::slider_handle_min_r
float slider_handle_min_r
minimum handle circle radius
Definition n_gui.h:792

N_GUI_IMAGE_DATA::scale_mode
int scale_mode
scale mode: N_GUI_IMAGE_FIT, N_GUI_IMAGE_STRETCH, N_GUI_IMAGE_CENTER
Definition n_gui.h:543

N_GUI_RADIOLIST_DATA::item_selected_bitmap
ALLEGRO_BITMAP * item_selected_bitmap
optional bitmap for per-item background, selected/highlighted (NULL = color theme)
Definition n_gui.h:495

N_GUI_RADIOLIST_DATA::bg_bitmap
ALLEGRO_BITMAP * bg_bitmap
optional bitmap for the radiolist background (NULL = color theme)
Definition n_gui.h:491

N_GUI_TREE::nodes
N_GUI_TREE_NODE nodes[512]
node storage
Definition n_gui.h:1469

N_GUI_CHECKBOX_DATA::box_bitmap
ALLEGRO_BITMAP * box_bitmap
optional bitmap for the checkbox square, unchecked state (NULL = color theme)
Definition n_gui.h:405

N_GUI_DROPMENU_DATA::on_open_user_data
void * on_open_user_data
user data for on_open callback
Definition n_gui.h:611

N_GUI_TAB_PANEL::y
float y
y origin of tab button row
Definition n_gui.h:1432

N_GUI_STYLE::dropdown_arrow_reserve
float dropdown_arrow_reserve
horizontal space reserved for the arrow on the right
Definition n_gui.h:848

N_GUI_WIDGET::y
float y
position y relative to parent window
Definition n_gui.h:625

N_GUI_KVTABLE::lbl_desc
int lbl_desc
label widget ID for "Description" header
Definition n_gui.h:1513

N_GUI_SLIDER_DATA::orientation
int orientation
orientation: N_GUI_SLIDER_H or N_GUI_SLIDER_V
Definition n_gui.h:344

N_GUI_STYLE::global_scrollbar_border_thickness
float global_scrollbar_border_thickness
global thumb border thickness
Definition n_gui.h:768

N_GUI_WINDOW::state
int state
state flags (N_GUI_WIN_*)
Definition n_gui.h:671

N_GUI_WINDOW::flags
int flags
feature flags (N_GUI_WIN_AUTO_SCROLLBAR, N_GUI_WIN_RESIZABLE, etc.)
Definition n_gui.h:673

N_GUI_SCROLLBAR_DATA::user_data
void * user_data
user data for callback
Definition n_gui.h:439

N_GUI_KV_ROW::active
int active
1 if active, 0 if removed
Definition n_gui.h:1498

N_GUI_SLIDER_DATA::max_val
double max_val
maximum value
Definition n_gui.h:336

N_GUI_CTX::widgets_by_id
HASH_TABLE * widgets_by_id
hash table for fast widget lookup by id
Definition n_gui.h:886

N_GUI_THEME::border_thickness
float border_thickness
border thickness
Definition n_gui.h:276

N_GUI_STYLE::link_underline_thickness
float link_underline_thickness
link underline thickness
Definition n_gui.h:862

N_GUI_CHECKBOX_DATA::box_checked_bitmap
ALLEGRO_BITMAP * box_checked_bitmap
optional bitmap for the checkbox square, checked state (NULL = color theme)
Definition n_gui.h:407

N_GUI_WINDOW::autofit_flags
int autofit_flags
bitmask of N_GUI_AUTOFIT_* flags (0 = no auto-fitting)
Definition n_gui.h:707

N_GUI_CTX::style
N_GUI_STYLE style
configurable style (sizes, colours, paddings)
Definition n_gui.h:940

N_GUI_WINDOW::font
ALLEGRO_FONT * font
font for the title bar
Definition n_gui.h:679

N_GUI_TEXTAREA_DATA::user_data
void * user_data
user data for callback
Definition n_gui.h:395

N_GUI_THEME::text_active
ALLEGRO_COLOR text_active
text active
Definition n_gui.h:274

N_GUI_CTX::ref_display_w
float ref_display_w
reference display width at the time normalized values were last captured
Definition n_gui.h:948

N_GUI_TREE::nb_nodes
int nb_nodes
number of nodes
Definition n_gui.h:1470

N_GUI_RADIOLIST_DATA::items_capacity
size_t items_capacity
allocated capacity
Definition n_gui.h:483

N_GUI_TAB_PANEL::parent_window_id
int parent_window_id
parent window for tab buttons
Definition n_gui.h:1426

N_GUI_SCROLLBAR_DATA::content_size
double content_size
total content size
Definition n_gui.h:421

N_GUI_WINDOW::autofit_origin_x
float autofit_origin_x
original insertion point x for N_GUI_AUTOFIT_CENTER (set by n_gui_window_set_autofit)
Definition n_gui.h:711

N_GUI_LISTBOX_DATA::user_data
void * user_data
user data for callback
Definition n_gui.h:473

N_GUI_SLIDER_DATA::step
double step
step increment (0 is treated as 1).
Definition n_gui.h:340

N_GUI_CTX::global_scroll_y
float global_scroll_y
global vertical scroll offset (when GUI exceeds display)
Definition n_gui.h:918

N_GUI_CTX::scrollbar_drag_widget_id
int scrollbar_drag_widget_id
id of the widget whose scrollbar is being dragged, or -1
Definition n_gui.h:908

N_GUI_WINDOW::min_h
float min_h
minimum height
Definition n_gui.h:687

N_GUI_STYLE::listbox_default_item_height
float listbox_default_item_height
default item height for listbox
Definition n_gui.h:832

N_GUI_STYLE::global_scrollbar_thumb_border_color
ALLEGRO_COLOR global_scrollbar_thumb_border_color
global scrollbar thumb border colour
Definition n_gui.h:774

N_GUI_THEME::border_active
ALLEGRO_COLOR border_active
border active
Definition n_gui.h:268

N_GUI_TEXTAREA_DATA::scroll_x
float scroll_x
horizontal scroll offset for single-line text (pixels)
Definition n_gui.h:383

N_GUI_STYLE::label_padding
float label_padding
horizontal padding each side
Definition n_gui.h:860

N_GUI_STYLE::titlebar_h
float titlebar_h
title bar height
Definition n_gui.h:734

N_GUI_CTX::gui_offset_y
float gui_offset_y
vertical letterbox offset for virtual canvas
Definition n_gui.h:934

N_GUI_LISTBOX_DATA::item_selected_bitmap
ALLEGRO_BITMAP * item_selected_bitmap
optional bitmap for per-item background, selected/highlighted (NULL = color theme)
Definition n_gui.h:469

N_GUI_LISTBOX_DATA::on_select
void(* on_select)(int widget_id, int index, int selected, void *user_data)
callback on selection change (widget_id, item_index, selected, user_data)
Definition n_gui.h:471

N_GUI_LISTBOX_DATA::item_height
float item_height
item height in pixels
Definition n_gui.h:463

N_GUI_COMBOBOX_DATA::on_select
void(* on_select)(int widget_id, int index, void *user_data)
callback on selection change (widget_id, selected_index, user_data)
Definition n_gui.h:531

N_GUI_CTX::focused_widget_id
int focused_widget_id
id of the widget that currently has focus, or -1
Definition n_gui.h:896

N_GUI_WINDOW::id
int id
unique window id
Definition n_gui.h:657

N_GUI_CTX::global_vscroll_drag
int global_vscroll_drag
1 if global scrollbar vertical thumb is being dragged
Definition n_gui.h:936

N_GUI_LABEL_DATA::sel_dragging
int sel_dragging
1 if mouse is actively dragging to select text
Definition n_gui.h:561

N_GUI_TREE::nb_visible
int nb_visible
number of visible rows
Definition n_gui.h:1472

N_GUI_STYLE::global_scrollbar_track_color
ALLEGRO_COLOR global_scrollbar_track_color
global scrollbar track colour
Definition n_gui.h:770

N_GUI_STYLE::item_height_pad
float item_height_pad
min padding added to font height for item height
Definition n_gui.h:844

N_GUI_CTX::display_h
float display_h
display/viewport height
Definition n_gui.h:914

N_GUI_LISTBOX_DATA::items
N_GUI_LISTITEM * items
dynamic array of items
Definition n_gui.h:453

N_GUI_RADIOLIST_DATA::user_data
void * user_data
user data for callback
Definition n_gui.h:499

N_GUI_THEME::corner_ry
float corner_ry
corner radius Y for rounded shapes
Definition n_gui.h:280

N_GUI_CHECKBOX_DATA::checked
int checked
checked state
Definition n_gui.h:403

N_GUI_LABEL_DATA::sel_end
int sel_end
selection end byte offset (-1 = no selection)
Definition n_gui.h:559

N_GUI_WINDOW::bg_scale_mode
int bg_scale_mode
scale mode for bg_bitmap: N_GUI_IMAGE_FIT, N_GUI_IMAGE_STRETCH, or N_GUI_IMAGE_CENTER
Definition n_gui.h:705

N_GUI_TEXTAREA_DATA::text_alloc
size_t text_alloc
allocated buffer size (char_limit + 1)
Definition n_gui.h:368

N_GUI_THEME::bg_normal
ALLEGRO_COLOR bg_normal
background normal
Definition n_gui.h:258

N_GUI_SLIDER_DATA::handle_bitmap
ALLEGRO_BITMAP * handle_bitmap
optional bitmap for the draggable handle, normal state (NULL = color theme)
Definition n_gui.h:350

N_GUI_WIDGET::font
ALLEGRO_FONT * font
font used by this widget (NULL = context default)
Definition n_gui.h:639

N_GUI_WIDGET::norm_w
float norm_w
normalized width (fraction of parent window w)
Definition n_gui.h:647

N_GUI_CTX::resize_mode
int resize_mode
context resize mode: N_GUI_RESIZE_VIRTUAL or N_GUI_RESIZE_ADAPTIVE
Definition n_gui.h:946

N_GUI_CTX::virtual_w
float virtual_w
virtual canvas width (0 = disabled / identity transform)
Definition n_gui.h:926

N_GUI_STYLE::radiolist_default_item_height
float radiolist_default_item_height
default item height for radiolist
Definition n_gui.h:834

N_GUI_CHECKBOX_DATA::label
char label[128]
label displayed next to the checkbox
Definition n_gui.h:401

N_GUI_STYLE::slider_value_label_offset
float slider_value_label_offset
gap between slider end and value label
Definition n_gui.h:798

N_GUI_LISTBOX_DATA::nb_items
size_t nb_items
number of items
Definition n_gui.h:455

N_GUI_TREE_NODE::depth
int depth
depth in tree (0 = root)
Definition n_gui.h:1460

N_GUI_THEME::bg_active
ALLEGRO_COLOR bg_active
background active/pressed
Definition n_gui.h:262

N_GUI_TEXTAREA_DATA::mask_char
char mask_char
mask character for password fields (0 = no masking, e.g.
Definition n_gui.h:391

N_GUI_CTX::global_hscroll_drag
int global_hscroll_drag
1 if global scrollbar horizontal thumb is being dragged
Definition n_gui.h:938

N_GUI_CTX::windows
LIST * windows
ordered list of N_GUI_WINDOW* (back to front)
Definition n_gui.h:884

N_GUI_DROPMENU_ENTRY::text
char text[128]
display text
Definition n_gui.h:573

N_GUI_TEXTAREA_DATA::scroll_y
int scroll_y
scroll offset for long text
Definition n_gui.h:381

N_GUI_SCROLLBAR_DATA::on_scroll
void(* on_scroll)(int widget_id, double scroll_pos, void *user_data)
callback on scroll
Definition n_gui.h:437

N_GUI_TEXT_DIMS::x
int x
bounding box x offset from draw origin
Definition n_gui.h:247

N_GUI_CTX::gui_bounds_h
float gui_bounds_h
total bounding box height of all windows (computed internally)
Definition n_gui.h:922

N_GUI_SLIDER_DATA::min_val
double min_val
minimum value
Definition n_gui.h:334

N_GUI_STYLE::textarea_cursor_blink_period
float textarea_cursor_blink_period
cursor blink period in seconds (full cycle on+off)
Definition n_gui.h:806

N_GUI_KVTABLE::lbl_value
int lbl_value
label widget ID for "Value" header
Definition n_gui.h:1512

N_GUI_CHECKBOX_DATA::on_toggle
void(* on_toggle)(int widget_id, int checked, void *user_data)
callback on toggle
Definition n_gui.h:411

N_GUI_THEME::bg_hover
ALLEGRO_COLOR bg_hover
background hover
Definition n_gui.h:260

N_GUI_TEXTAREA_DATA::sel_start
size_t sel_start
selection anchor position (where shift-click/shift-arrow started).
Definition n_gui.h:377

N_GUI_KVTABLE::window_id
int window_id
parent window
Definition n_gui.h:1504

N_GUI_STYLE::dropdown_arrow_thickness
float dropdown_arrow_thickness
arrow stroke thickness
Definition n_gui.h:850

N_GUI_KVTABLE::user_data
void * user_data
user data for callback
Definition n_gui.h:1517

N_GUI_STYLE::link_color_hover
ALLEGRO_COLOR link_color_hover
link colour (hover)
Definition n_gui.h:866

N_GUI_STYLE::radio_circle_min_r
float radio_circle_min_r
minimum outer circle radius
Definition n_gui.h:822

N_GUI_LISTBOX_DATA::bg_bitmap
ALLEGRO_BITMAP * bg_bitmap
optional bitmap for the listbox background (NULL = color theme)
Definition n_gui.h:465

N_GUI_STYLE::item_text_padding
float item_text_padding
text padding inside list/combo/dropmenu items
Definition n_gui.h:840

N_GUI_CTX::next_widget_id
int next_widget_id
next widget id to assign
Definition n_gui.h:888

N_GUI_KV_ROW::enabled_id
int enabled_id
checkbox widget ID for the enabled toggle
Definition n_gui.h:1496

N_GUI_WINDOW::autofit_border
float autofit_border
padding/border around content for auto-fit (pixels, applied on each side)
Definition n_gui.h:709

N_GUI_CTX::gui_scale
float gui_scale
computed uniform scale factor for virtual canvas
Definition n_gui.h:930

N_GUI_TEXTAREA_DATA::cursor_pos
size_t cursor_pos
cursor position in text
Definition n_gui.h:374

N_GUI_BUTTON_DATA::user_data
void * user_data
user data for callback
Definition n_gui.h:328

N_GUI_SLIDER_DATA::mode
int mode
mode: N_GUI_SLIDER_VALUE or N_GUI_SLIDER_PERCENT
Definition n_gui.h:342

N_GUI_TEXTAREA_DATA::char_limit
size_t char_limit
maximum character limit (0 = N_GUI_TEXT_MAX)
Definition n_gui.h:370

N_GUI_BUTTON_DATA::toggle_mode
int toggle_mode
toggle mode: 0 = momentary (default), 1 = toggle (stays clicked/unclicked)
Definition n_gui.h:307

N_GUI_DROPMENU_DATA::is_open
int is_open
is the menu currently open
Definition n_gui.h:595

N_GUI_THEME::border_hover
ALLEGRO_COLOR border_hover
border hover
Definition n_gui.h:266

N_GUI_STYLE::scrollbar_thumb_min
float scrollbar_thumb_min
minimum thumb dimension
Definition n_gui.h:748

N_GUI_TAB_PANEL::x
float x
x origin of first tab button
Definition n_gui.h:1431

N_GUI_SCROLLBAR_DATA::thumb_hover_bitmap
ALLEGRO_BITMAP * thumb_hover_bitmap
optional bitmap for the thumb on hover (NULL = fallback to thumb_bitmap)
Definition n_gui.h:433

N_GUI_KV_ROW::value_id
int value_id
textarea widget ID for the value
Definition n_gui.h:1494

N_GUI_BUTTON_DATA::label
char label[128]
label displayed on the button
Definition n_gui.h:297

N_GUI_TEXTAREA_DATA::bg_bitmap
ALLEGRO_BITMAP * bg_bitmap
optional bitmap for the text area background (NULL = color theme)
Definition n_gui.h:389

N_GUI_LABEL_DATA::align
int align
text alignment: N_GUI_ALIGN_LEFT, N_GUI_ALIGN_CENTER, N_GUI_ALIGN_RIGHT
Definition n_gui.h:553

N_GUI_TEXTAREA_DATA::text_len
size_t text_len
current text length
Definition n_gui.h:366

N_GUI_LABEL_DATA::link
char link[4096]
optional hyperlink URL (empty string = no link)
Definition n_gui.h:551

N_GUI_SCROLLBAR_DATA::orientation
int orientation
orientation: N_GUI_SCROLLBAR_H or N_GUI_SCROLLBAR_V
Definition n_gui.h:419

N_GUI_STYLE::global_scrollbar_thumb_min
float global_scrollbar_thumb_min
global minimum thumb dimension
Definition n_gui.h:762

N_GUI_SCROLLBAR_DATA::viewport_size
double viewport_size
visible viewport size
Definition n_gui.h:423

N_GUI_LABEL_DATA::on_link_click
void(* on_link_click)(int widget_id, const char *link, void *user_data)
callback when link is clicked (widget_id, link_url, user_data)
Definition n_gui.h:565

N_GUI_CTX::default_font
ALLEGRO_FONT * default_font
default font (must be set before adding widgets)
Definition n_gui.h:892

N_GUI_STYLE::combobox_max_dropdown_width
float combobox_max_dropdown_width
maximum dropdown width for N_GUI_COMBOBOX_AUTO_WIDTH (0 = display width)
Definition n_gui.h:876

N_GUI_LISTBOX_DATA::selection_mode
int selection_mode
selection mode: N_GUI_SELECT_NONE, N_GUI_SELECT_SINGLE, N_GUI_SELECT_MULTIPLE
Definition n_gui.h:459

N_GUI_COMBOBOX_DATA::nb_items
size_t nb_items
number of items
Definition n_gui.h:511

N_GUI_BUTTON_DATA::key_modifiers
int key_modifiers
required modifier key flags for the keybind (0 = no modifier requirement, matches any modifier state ...
Definition n_gui.h:318

N_GUI_WINDOW::widgets
LIST * widgets
list of N_GUI_WIDGET* contained in this window
Definition n_gui.h:675

N_GUI_WINDOW::y
float y
position y on screen
Definition n_gui.h:663

N_GUI_BUTTON_DATA::bitmap_active
ALLEGRO_BITMAP * bitmap_active
optional bitmap for active/pressed state
Definition n_gui.h:303

N_GUI_WIDGET::enabled
int enabled
enabled flag (1 = enabled, 0 = disabled: drawn dimmed and ignores input)
Definition n_gui.h:635

N_GUI_STYLE::radio_circle_border_thickness
float radio_circle_border_thickness
outer circle border thickness
Definition n_gui.h:824

N_GUI_BUTTON_DATA::keycode
int keycode
bound keyboard keycode (0 = none).
Definition n_gui.h:312

N_GUI_SCROLLBAR_DATA::thumb_active_bitmap
ALLEGRO_BITMAP * thumb_active_bitmap
optional bitmap for the thumb while dragging (NULL = fallback to thumb_bitmap)
Definition n_gui.h:435

N_GUI_STYLE::slider_track_size
float slider_track_size
track width (vertical) or height (horizontal)
Definition n_gui.h:786

N_GUI_WINDOW::scroll_x
float scroll_x
horizontal scroll offset for auto-scrollbar (pixels)
Definition n_gui.h:691

N_GUI_STYLE::slider_handle_border_thickness
float slider_handle_border_thickness
handle border thickness
Definition n_gui.h:796

n_gui_set_display_size
void n_gui_set_display_size(N_GUI_CTX *ctx, float w, float h)
set the display (viewport) size so global scrollbars can be computed.
Definition n_gui.c:5176

n_gui_combobox_set_bitmaps
void n_gui_combobox_set_bitmaps(N_GUI_CTX *ctx, int widget_id, ALLEGRO_BITMAP *bg, ALLEGRO_BITMAP *item_bg, ALLEGRO_BITMAP *item_selected)
set optional bitmap overlays on a combobox widget.
Definition n_gui.c:2522

n_gui_load_theme_json
int n_gui_load_theme_json(N_GUI_CTX *ctx, const char *filepath)
Load a JSON theme file and apply it to the context.
Definition n_gui.c:7536

n_gui_listbox_get_scroll_offset
int n_gui_listbox_get_scroll_offset(N_GUI_CTX *ctx, int widget_id)
get the current scroll offset (in items)
Definition n_gui.c:2001

n_gui_dropmenu_clear
void n_gui_dropmenu_clear(N_GUI_CTX *ctx, int widget_id)
remove all entries
Definition n_gui.c:2355

n_gui_update_transform
void n_gui_update_transform(N_GUI_CTX *ctx)
recalculate scale and offset from virtual canvas to display.
Definition n_gui.c:4992

n_gui_button_is_toggled
int n_gui_button_is_toggled(N_GUI_CTX *ctx, int widget_id)
check if button is toggled
Definition n_gui.c:1086

n_gui_detect_dpi_scale
float n_gui_detect_dpi_scale(N_GUI_CTX *ctx, ALLEGRO_DISPLAY *display)
detect and apply DPI scale from the given allegro display.
Definition n_gui.c:5234

n_gui_toggle_window
void n_gui_toggle_window(N_GUI_CTX *ctx, int window_id)
toggle window visibility (show/hide)
Definition n_gui.c:825

N_GUI_TREE_MAX
#define N_GUI_TREE_MAX
maximum number of nodes in a tree view
Definition n_gui.h:1453

n_gui_raise_window
void n_gui_raise_window(N_GUI_CTX *ctx, int window_id)
raise a window to the top of the stack (respects z-order constraints)
Definition n_gui.c:745

n_gui_add_slider
int n_gui_add_slider(N_GUI_CTX *ctx, int window_id, float x, float y, float w, float h, double min_val, double max_val, double initial, int mode, void(*on_change)(int, double, void *), void *user_data)
add a horizontal slider widget
Definition n_gui.c:1160

n_gui_combobox_set_flags
void n_gui_combobox_set_flags(N_GUI_CTX *ctx, int widget_id, int flags)
set combobox feature flags (bitmask of N_GUI_COMBOBOX_* values)
Definition n_gui.c:1446

n_gui_window_apply_autofit
void n_gui_window_apply_autofit(N_GUI_CTX *ctx, int window_id)
trigger auto-fit recalculation for a window (call after adding/removing/resizing widgets)
Definition n_gui.c:910

n_gui_textarea_set_text
void n_gui_textarea_set_text(N_GUI_CTX *ctx, int widget_id, const char *text)
set text area content
Definition n_gui.c:1752

n_gui_scrollbar_get_pos
double n_gui_scrollbar_get_pos(N_GUI_CTX *ctx, int widget_id)
get scrollbar position
Definition n_gui.c:1808

n_gui_kvtable_create
N_GUI_KVTABLE * n_gui_kvtable_create(N_GUI_CTX *ctx, int window_id, float row_height, float padding, void(*on_remove)(int, void *), void *user_data)
create a KV table in an existing window
Definition n_gui.c:7928

n_gui_add_vslider
int n_gui_add_vslider(N_GUI_CTX *ctx, int window_id, float x, float y, float w, float h, double min_val, double max_val, double initial, int mode, void(*on_change)(int, double, void *), void *user_data)
add a vertical slider (same as n_gui_add_slider but oriented vertically)
Definition n_gui.c:1200

n_gui_set_display
void n_gui_set_display(N_GUI_CTX *ctx, ALLEGRO_DISPLAY *display)
set the display pointer for clipboard operations (copy/paste)
Definition n_gui.c:5192

n_gui_window_set_bitmaps
void n_gui_window_set_bitmaps(N_GUI_CTX *ctx, int window_id, ALLEGRO_BITMAP *bg, ALLEGRO_BITMAP *titlebar, int bg_scale_mode)
set optional bitmap overlays on a window's body and titlebar.
Definition n_gui.c:2397

n_gui_set_widget_theme
void n_gui_set_widget_theme(N_GUI_CTX *ctx, int widget_id, N_GUI_THEME theme)
set the theme on a widget
Definition n_gui.c:1575

n_gui_wants_mouse
int n_gui_wants_mouse(N_GUI_CTX *ctx)
check if the mouse is currently over any open GUI window (use to prevent click-through to the game wo...
Definition n_gui.c:7344

n_gui_dropmenu_get_count
int n_gui_dropmenu_get_count(N_GUI_CTX *ctx, int widget_id)
get number of entries
Definition n_gui.c:2380

n_gui_radiolist_add_item
int n_gui_radiolist_add_item(N_GUI_CTX *ctx, int widget_id, const char *text)
add an item to a radio list
Definition n_gui.c:2028

n_gui_lower_window
void n_gui_lower_window(N_GUI_CTX *ctx, int window_id)
lower a window to the bottom of the stack (respects z-order constraints)
Definition n_gui.c:763

n_gui_label_set_text
void n_gui_label_set_text(N_GUI_CTX *ctx, int widget_id, const char *text)
set label text content
Definition n_gui.c:2178

n_gui_add_listbox
int n_gui_add_listbox(N_GUI_CTX *ctx, int window_id, float x, float y, float w, float h, int selection_mode, void(*on_select)(int, int, int, void *), void *user_data)
add a listbox widget
Definition n_gui.c:1336

N_GUI_KV_MAX
#define N_GUI_KV_MAX
maximum number of rows in a KV table
Definition n_gui.h:1489

n_gui_process_event
int n_gui_process_event(N_GUI_CTX *ctx, ALLEGRO_EVENT event)
process an allegro event for the GUI
Definition n_gui.c:5767

n_gui_window_get_flags
int n_gui_window_get_flags(N_GUI_CTX *ctx, int window_id)
get feature flags of a window
Definition n_gui.c:852

n_gui_minimize_window
void n_gui_minimize_window(N_GUI_CTX *ctx, int window_id)
minimize a window (title bar only)
Definition n_gui.c:662

n_gui_add_label
int n_gui_add_label(N_GUI_CTX *ctx, int window_id, const char *text, float x, float y, float w, float h, int align)
add a text label widget
Definition n_gui.c:1497

n_gui_set_widget_enabled
void n_gui_set_widget_enabled(N_GUI_CTX *ctx, int widget_id, int enabled)
set widget enabled state (0 = disabled: drawn dimmed and ignores all input)
Definition n_gui.c:1592

n_gui_add_radiolist
int n_gui_add_radiolist(N_GUI_CTX *ctx, int window_id, float x, float y, float w, float h, void(*on_select)(int, int, void *), void *user_data)
add a radio list widget
Definition n_gui.c:1371

n_gui_tab_free
void n_gui_tab_free(N_GUI_TAB_PANEL **panel)
free a tab panel (does not destroy the N_GUI widgets)
Definition n_gui.c:7780

n_gui_close_window
void n_gui_close_window(N_GUI_CTX *ctx, int window_id)
close (hide) a window
Definition n_gui.c:646

n_gui_listbox_set_bitmaps
void n_gui_listbox_set_bitmaps(N_GUI_CTX *ctx, int widget_id, ALLEGRO_BITMAP *bg, ALLEGRO_BITMAP *item_bg, ALLEGRO_BITMAP *item_selected)
set optional bitmap overlays on a listbox widget.
Definition n_gui.c:2490

n_gui_label_set_link
void n_gui_label_set_link(N_GUI_CTX *ctx, int widget_id, const char *link)
set label hyperlink URL
Definition n_gui.c:2198

n_gui_kvtable_free
void n_gui_kvtable_free(N_GUI_KVTABLE **table)
free a KV table (does not destroy the N_GUI widgets)
Definition n_gui.c:8028

n_gui_window_set_resize_policy
void n_gui_window_set_resize_policy(N_GUI_CTX *ctx, int window_id, int policy)
set per-window resize policy (N_GUI_WIN_RESIZE_NONE / _MOVE / _SCALE).
Definition n_gui.c:5081

n_gui_button_set_keycode_focused
void n_gui_button_set_keycode_focused(N_GUI_CTX *ctx, int widget_id, int keycode, int modifiers, const int *sources, int source_count)
bind a keyboard key to a button that fires only when specific widgets have focus.
Definition n_gui.c:1139

n_gui_radiolist_clear
void n_gui_radiolist_clear(N_GUI_CTX *ctx, int widget_id)
remove all items from a radio list
Definition n_gui.c:2049

n_gui_listbox_set_selected
void n_gui_listbox_set_selected(N_GUI_CTX *ctx, int widget_id, int index, int selected)
set item selection state
Definition n_gui.c:1990

n_gui_add_window_auto
int n_gui_add_window_auto(N_GUI_CTX *ctx, const char *title, float x, float y)
add a window that sizes itself automatically to fit its widgets (call n_gui_window_autosize after add...
Definition n_gui.c:817

n_gui_slider_get_value
double n_gui_slider_get_value(N_GUI_CTX *ctx, int widget_id)
get slider current value
Definition n_gui.c:1667

n_gui_listbox_add_item
int n_gui_listbox_add_item(N_GUI_CTX *ctx, int widget_id, const char *text)
add an item to a listbox
Definition n_gui.c:1860

n_gui_set_virtual_size
void n_gui_set_virtual_size(N_GUI_CTX *ctx, float w, float h)
set the virtual canvas size for resolution-independent scaling.
Definition n_gui.c:4974

n_gui_get_dpi_scale
float n_gui_get_dpi_scale(const N_GUI_CTX *ctx)
get current DPI scale factor
Definition n_gui.c:5210

n_gui_default_theme
N_GUI_THEME n_gui_default_theme(void)
return the built-in default theme
Definition n_gui.c:294

n_gui_window_set_zorder
void n_gui_window_set_zorder(N_GUI_CTX *ctx, int window_id, int z_mode, int z_value)
set window z-order mode and value
Definition n_gui.c:779

n_gui_radiolist_get_selected
int n_gui_radiolist_get_selected(N_GUI_CTX *ctx, int widget_id)
get the selected item index
Definition n_gui.c:2065

n_gui_tab_set_content_window
void n_gui_tab_set_content_window(N_GUI_TAB_PANEL *panel, int tab_index, int window_id)
associate a content window with a tab
Definition n_gui.c:7757

n_gui_save_theme_json
int n_gui_save_theme_json(N_GUI_CTX *ctx, const char *filepath)
Save the full theme (default_theme + style) to a JSON file.
Definition n_gui.c:7413

n_gui_combobox_add_item
int n_gui_combobox_add_item(N_GUI_CTX *ctx, int widget_id, const char *text)
add an item to a combo box
Definition n_gui.c:2109

n_gui_window_autosize
void n_gui_window_autosize(N_GUI_CTX *ctx, int window_id)
recompute and apply minimum-fit size for a window based on its current widgets
Definition n_gui.c:862

n_gui_set_focus
void n_gui_set_focus(N_GUI_CTX *ctx, int widget_id)
set keyboard focus to a specific widget (-1 to clear focus)
Definition n_gui.c:1613

n_gui_tree_rebuild
void n_gui_tree_rebuild(N_GUI_TREE *tree)
rebuild the listbox to reflect current tree state
Definition n_gui.c:7855

n_gui_textarea_set_selection
void n_gui_textarea_set_selection(N_GUI_CTX *ctx, int widget_id, size_t start, size_t end)
set the text selection range (byte offsets into text content)
Definition n_gui.c:2832

n_gui_scrollbar_set_bitmaps
void n_gui_scrollbar_set_bitmaps(N_GUI_CTX *ctx, int widget_id, ALLEGRO_BITMAP *track, ALLEGRO_BITMAP *thumb, ALLEGRO_BITMAP *thumb_hover, ALLEGRO_BITMAP *thumb_active)
set optional bitmap overlays on a scrollbar widget.
Definition n_gui.c:2430

n_gui_add_combobox
int n_gui_add_combobox(N_GUI_CTX *ctx, int window_id, float x, float y, float w, float h, void(*on_select)(int, int, void *), void *user_data)
add a combo box widget
Definition n_gui.c:1406

n_gui_button_set_toggled
void n_gui_button_set_toggled(N_GUI_CTX *ctx, int widget_id, int toggled)
set button toggled state
Definition n_gui.c:1097

n_gui_tab_set_active
void n_gui_tab_set_active(N_GUI_TAB_PANEL *panel, int index)
set the active tab (toggles buttons, opens/closes content windows)
Definition n_gui.c:7762

n_gui_slider_set_step
void n_gui_slider_set_step(N_GUI_CTX *ctx, int widget_id, double step)
set slider step increment (0 is treated as 1).
Definition n_gui.c:1719

n_gui_add_toggle_button
int n_gui_add_toggle_button(N_GUI_CTX *ctx, int window_id, const char *label, float x, float y, float w, float h, int shape, int initial_state, void(*on_click)(int, void *), void *user_data)
toggle button creation (returns widget id)
Definition n_gui.c:1070

n_gui_kvtable_remove_row
void n_gui_kvtable_remove_row(N_GUI_KVTABLE *table, int row_index)
remove a row by index (hides widgets, marks inactive)
Definition n_gui.c:8010

n_gui_add_label_link
int n_gui_add_label_link(N_GUI_CTX *ctx, int window_id, const char *text, const char *link, float x, float y, float w, float h, int align, void(*on_link_click)(int, const char *, void *), void *user_data)
add a text label with hyperlink
Definition n_gui.c:1538

n_gui_textarea_set_mask_char
void n_gui_textarea_set_mask_char(N_GUI_CTX *ctx, int widget_id, char mask)
set a mask character for password-style input (e.g.
Definition n_gui.c:2477

n_gui_listbox_get_selected
int n_gui_listbox_get_selected(N_GUI_CTX *ctx, int widget_id)
get the first selected item index
Definition n_gui.c:1954

n_gui_add_image
int n_gui_add_image(N_GUI_CTX *ctx, int window_id, float x, float y, float w, float h, ALLEGRO_BITMAP *bitmap, int scale_mode)
add an image widget
Definition n_gui.c:1468

n_gui_label_set_bitmap
void n_gui_label_set_bitmap(N_GUI_CTX *ctx, int widget_id, ALLEGRO_BITMAP *bg)
set optional background bitmap on a label widget.
Definition n_gui.c:2553

n_gui_draw
void n_gui_draw(N_GUI_CTX *ctx)
draw all visible GUI windows and widgets
Definition n_gui.c:4800

n_gui_tab_add
int n_gui_tab_add(N_GUI_TAB_PANEL *panel, const char *label)
add a tab to the panel, returns tab index
Definition n_gui.c:7742

n_gui_slider_set_bitmaps
void n_gui_slider_set_bitmaps(N_GUI_CTX *ctx, int widget_id, ALLEGRO_BITMAP *track, ALLEGRO_BITMAP *fill, ALLEGRO_BITMAP *handle, ALLEGRO_BITMAP *handle_hover, ALLEGRO_BITMAP *handle_active)
set optional bitmap overlays on a slider widget.
Definition n_gui.c:2412

n_gui_window_get_zorder
int n_gui_window_get_zorder(N_GUI_CTX *ctx, int window_id)
get window z-order mode
Definition n_gui.c:796

n_gui_tree_free
void n_gui_tree_free(N_GUI_TREE **tree)
free a tree view (does not destroy the N_GUI listbox)
Definition n_gui.c:7878

n_gui_window_get_resize_policy
int n_gui_window_get_resize_policy(N_GUI_CTX *ctx, int window_id)
get per-window resize policy
Definition n_gui.c:5094

n_gui_checkbox_set_checked
void n_gui_checkbox_set_checked(N_GUI_CTX *ctx, int widget_id, int checked)
set checkbox checked state
Definition n_gui.c:1793

n_gui_dropmenu_add_dynamic_entry
int n_gui_dropmenu_add_dynamic_entry(N_GUI_CTX *ctx, int widget_id, const char *text, int tag, void(*on_click)(int, int, int, void *), void *user_data)
add a dynamic entry (rebuilt each time menu opens)
Definition n_gui.c:2301

n_gui_apply_adaptive_resize
void n_gui_apply_adaptive_resize(N_GUI_CTX *ctx, float new_w, float new_h)
apply adaptive resize: reposition/resize all windows according to their policies for the new display ...
Definition n_gui.c:5123

n_gui_is_widget_enabled
int n_gui_is_widget_enabled(N_GUI_CTX *ctx, int widget_id)
check if a widget is enabled
Definition n_gui.c:1601

n_gui_button_set_keycode
void n_gui_button_set_keycode(N_GUI_CTX *ctx, int widget_id, int keycode, int modifiers)
bind a keyboard key with optional modifier requirements to a button.
Definition n_gui.c:1129

n_gui_window_is_open
int n_gui_window_is_open(N_GUI_CTX *ctx, int window_id)
check if window is visible
Definition n_gui.c:834

n_gui_set_dpi_scale
void n_gui_set_dpi_scale(N_GUI_CTX *ctx, float scale)
set DPI scale factor manually (default is 1.0).
Definition n_gui.c:5200

n_gui_get_resize_mode
int n_gui_get_resize_mode(N_GUI_CTX *ctx)
get current resize mode
Definition n_gui.c:5071

n_gui_get_widget
N_GUI_WIDGET * n_gui_get_widget(N_GUI_CTX *ctx, int widget_id)
get a widget by id
Definition n_gui.c:1561

n_gui_dropmenu_add_entry
int n_gui_dropmenu_add_entry(N_GUI_CTX *ctx, int widget_id, const char *text, int tag, void(*on_click)(int, int, int, void *), void *user_data)
add a static entry to a dropdown menu
Definition n_gui.c:2278

n_gui_get_window
N_GUI_WINDOW * n_gui_get_window(N_GUI_CTX *ctx, int window_id)
get a window by id
Definition n_gui.c:637

n_gui_dropmenu_set_bitmaps
void n_gui_dropmenu_set_bitmaps(N_GUI_CTX *ctx, int widget_id, ALLEGRO_BITMAP *panel, ALLEGRO_BITMAP *item_hover)
set optional bitmap overlays on a dropmenu widget.
Definition n_gui.c:2538

n_gui_add_window
int n_gui_add_window(N_GUI_CTX *ctx, const char *title, float x, float y, float w, float h)
add a window to the GUI context
Definition n_gui.c:581

n_gui_new_ctx
N_GUI_CTX * n_gui_new_ctx(ALLEGRO_FONT *default_font)
create a new GUI context
Definition n_gui.c:466

n_gui_slider_set_range
void n_gui_slider_set_range(N_GUI_CTX *ctx, int widget_id, double min_val, double max_val)
set slider min/max range, clamping the current value if needed
Definition n_gui.c:1699

n_gui_listbox_get_item_text
const char * n_gui_listbox_get_item_text(N_GUI_CTX *ctx, int widget_id, int index)
get item text by index
Definition n_gui.c:1937

n_gui_radiolist_set_bitmaps
void n_gui_radiolist_set_bitmaps(N_GUI_CTX *ctx, int widget_id, ALLEGRO_BITMAP *bg, ALLEGRO_BITMAP *item_bg, ALLEGRO_BITMAP *item_selected)
set optional bitmap overlays on a radiolist widget.
Definition n_gui.c:2506

n_gui_tree_create
N_GUI_TREE * n_gui_tree_create(N_GUI_CTX *ctx, int window_id, float x, float y, float w, float h, void(*on_select)(int, void *), void *user_data)
create a tree view in an existing window
Definition n_gui.c:7799

n_gui_add_button_bitmap
int n_gui_add_button_bitmap(N_GUI_CTX *ctx, int window_id, const char *label, float x, float y, float w, float h, ALLEGRO_BITMAP *normal, ALLEGRO_BITMAP *hover, ALLEGRO_BITMAP *active, void(*on_click)(int, void *), void *user_data)
add a bitmap-based button widget
Definition n_gui.c:1042

n_gui_set_resize_mode
void n_gui_set_resize_mode(N_GUI_CTX *ctx, int mode)
set context-level resize mode: N_GUI_RESIZE_VIRTUAL (default) or N_GUI_RESIZE_ADAPTIVE
Definition n_gui.c:5042

n_gui_button_set_toggle_mode
void n_gui_button_set_toggle_mode(N_GUI_CTX *ctx, int widget_id, int toggle_mode)
set button toggle mode
Definition n_gui.c:1110

n_gui_tree_toggle_expand
void n_gui_tree_toggle_expand(N_GUI_TREE *tree, int node_index)
toggle expand/collapse of a node
Definition n_gui.c:7848

n_gui_textarea_scroll_to_offset
void n_gui_textarea_scroll_to_offset(N_GUI_CTX *ctx, int widget_id, size_t byte_offset)
scroll a multiline textarea so that the given byte offset is vertically centered
Definition n_gui.c:2849

n_gui_textarea_set_bitmap
void n_gui_textarea_set_bitmap(N_GUI_CTX *ctx, int widget_id, ALLEGRO_BITMAP *bg)
set optional background bitmap on a textarea widget.
Definition n_gui.c:2463

n_gui_listbox_clear
void n_gui_listbox_clear(N_GUI_CTX *ctx, int widget_id)
clear all items from a listbox
Definition n_gui.c:1907

n_gui_add_scrollbar
int n_gui_add_scrollbar(N_GUI_CTX *ctx, int window_id, float x, float y, float w, float h, int orientation, int shape, double content_size, double viewport_size, void(*on_scroll)(int, double, void *), void *user_data)
add a scrollbar widget
Definition n_gui.c:1293

n_gui_get_text_dims
N_GUI_TEXT_DIMS n_gui_get_text_dims(ALLEGRO_FONT *font, const char *text)
get the bounding box dimensions of text rendered with the given font.
Definition n_gui.c:58

n_gui_kvtable_get_count
int n_gui_kvtable_get_count(N_GUI_KVTABLE *table)
get the number of active rows
Definition n_gui.c:8024

n_gui_destroy_ctx
void n_gui_destroy_ctx(N_GUI_CTX **ctx)
destroy a GUI context and free all resources
Definition n_gui.c:523

n_gui_textarea_get_text
const char * n_gui_textarea_get_text(N_GUI_CTX *ctx, int widget_id)
get text area content
Definition n_gui.c:1738

n_gui_tab_get_active
int n_gui_tab_get_active(N_GUI_TAB_PANEL *panel)
get the active tab index
Definition n_gui.c:7776

n_gui_kvtable_add_row
int n_gui_kvtable_add_row(N_GUI_KVTABLE *table, const char *key, const char *value, const char *description, int enabled)
add a row to the KV table
Definition n_gui.c:7972

n_gui_checkbox_set_bitmaps
void n_gui_checkbox_set_bitmaps(N_GUI_CTX *ctx, int widget_id, ALLEGRO_BITMAP *box, ALLEGRO_BITMAP *box_checked, ALLEGRO_BITMAP *box_hover)
set optional bitmap overlays on a checkbox widget.
Definition n_gui.c:2447

n_gui_listbox_set_scroll_offset
void n_gui_listbox_set_scroll_offset(N_GUI_CTX *ctx, int widget_id, int offset)
set the scroll offset (in items) — clamps to valid range
Definition n_gui.c:2008

N_GUI_TEXT_MAX
#define N_GUI_TEXT_MAX
maximum length for textarea content
Definition n_gui.h:86

n_gui_textarea_scroll_to_bottom
void n_gui_textarea_scroll_to_bottom(N_GUI_CTX *ctx, int widget_id)
scroll a multiline textarea to the bottom
Definition n_gui.c:2810

n_gui_textarea_get_text_length
size_t n_gui_textarea_get_text_length(N_GUI_CTX *ctx, int widget_id)
return the current text length in bytes (0 if widget is invalid)
Definition n_gui.c:2910

n_gui_open_window
void n_gui_open_window(N_GUI_CTX *ctx, int window_id)
open (show) a window
Definition n_gui.c:654

n_gui_window_get_zvalue
int n_gui_window_get_zvalue(N_GUI_CTX *ctx, int window_id)
get window z-value (for N_GUI_ZORDER_FIXED mode)
Definition n_gui.c:806

n_gui_dropmenu_set_entry_text
void n_gui_dropmenu_set_entry_text(N_GUI_CTX *ctx, int widget_id, int index, const char *text)
update text of an existing entry by index
Definition n_gui.c:2366

n_gui_tree_add_node
int n_gui_tree_add_node(N_GUI_TREE *tree, const char *label, int parent_index, void *user_data)
add a node to the tree
Definition n_gui.c:7827

n_gui_listbox_get_count
int n_gui_listbox_get_count(N_GUI_CTX *ctx, int widget_id)
get number of items in a listbox
Definition n_gui.c:1922

n_gui_checkbox_is_checked
int n_gui_checkbox_is_checked(N_GUI_CTX *ctx, int widget_id)
check if checkbox is checked
Definition n_gui.c:1779

n_gui_combobox_get_selected
int n_gui_combobox_get_selected(N_GUI_CTX *ctx, int widget_id)
get the selected item index
Definition n_gui.c:2131

n_gui_image_set_bitmap
void n_gui_image_set_bitmap(N_GUI_CTX *ctx, int widget_id, ALLEGRO_BITMAP *bitmap)
set the bitmap on an image widget
Definition n_gui.c:2163

n_gui_slider_set_value
void n_gui_slider_set_value(N_GUI_CTX *ctx, int widget_id, double value)
set slider value
Definition n_gui.c:1681

n_gui_radiolist_set_selected
void n_gui_radiolist_set_selected(N_GUI_CTX *ctx, int widget_id, int index)
set the selected item index
Definition n_gui.c:2079

n_gui_window_set_flags
void n_gui_window_set_flags(N_GUI_CTX *ctx, int window_id, int flags)
set feature flags on a window (N_GUI_WIN_AUTO_SCROLLBAR, N_GUI_WIN_RESIZABLE, ...)
Definition n_gui.c:843

n_gui_set_widget_visible
void n_gui_set_widget_visible(N_GUI_CTX *ctx, int widget_id, int visible)
set widget visibility
Definition n_gui.c:1583

n_gui_tab_create
N_GUI_TAB_PANEL * n_gui_tab_create(N_GUI_CTX *ctx, int window_id, float x, float y, float button_w, float button_h, void(*on_tab_change)(int, void *), void *user_data)
create a tab panel in an existing window
Definition n_gui.c:7720

N_GUI_ID_MAX
#define N_GUI_ID_MAX
maximum length for widget id/name strings
Definition n_gui.h:84

n_gui_default_style
N_GUI_STYLE n_gui_default_style(void)
return the built-in default style
Definition n_gui.c:365

N_GUI_TAB_MAX
#define N_GUI_TAB_MAX
maximum number of tabs in a single tab panel
Definition n_gui.h:1421

n_gui_scrollbar_set_sizes
void n_gui_scrollbar_set_sizes(N_GUI_CTX *ctx, int widget_id, double content_size, double viewport_size)
set scrollbar content and viewport sizes
Definition n_gui.c:1839

n_gui_add_textarea
int n_gui_add_textarea(N_GUI_CTX *ctx, int window_id, float x, float y, float w, float h, int multiline, size_t char_limit, void(*on_change)(int, const char *, void *), void *user_data)
add a text area widget
Definition n_gui.c:1214

n_gui_listbox_is_selected
int n_gui_listbox_is_selected(N_GUI_CTX *ctx, int widget_id, int index)
check if an item is selected
Definition n_gui.c:1972

n_gui_window_update_normalized
void n_gui_window_update_normalized(N_GUI_CTX *ctx, int window_id)
recapture normalized coordinates for a window from its current absolute position/size.
Definition n_gui.c:5107

n_gui_add_checkbox
int n_gui_add_checkbox(N_GUI_CTX *ctx, int window_id, const char *label, float x, float y, float w, float h, int initial_checked, void(*on_toggle)(int, int, void *), void *user_data)
add a checkbox widget
Definition n_gui.c:1259

n_gui_combobox_clear
void n_gui_combobox_clear(N_GUI_CTX *ctx, int widget_id)
remove all items from a combobox
Definition n_gui.c:2096

n_gui_combobox_set_selected
void n_gui_combobox_set_selected(N_GUI_CTX *ctx, int widget_id, int index)
set the selected item index
Definition n_gui.c:2145

n_gui_listbox_remove_item
int n_gui_listbox_remove_item(N_GUI_CTX *ctx, int widget_id, int index)
remove an item from a listbox by index
Definition n_gui.c:1883

n_gui_make_theme
N_GUI_THEME n_gui_make_theme(ALLEGRO_COLOR bg, ALLEGRO_COLOR bg_hover, ALLEGRO_COLOR bg_active, ALLEGRO_COLOR border, ALLEGRO_COLOR border_hover, ALLEGRO_COLOR border_active, ALLEGRO_COLOR text, ALLEGRO_COLOR text_hover, ALLEGRO_COLOR text_active, float border_thickness, float corner_rx, float corner_ry)
create a custom theme from individual colors and properties
Definition n_gui.c:328

n_gui_add_dropmenu
int n_gui_add_dropmenu(N_GUI_CTX *ctx, int window_id, const char *label, float x, float y, float w, float h, void(*on_open)(int, void *), void *on_open_user_data)
add a dropdown menu widget (button that opens a menu panel with entries)
Definition n_gui.c:2237

n_gui_screen_to_virtual
void n_gui_screen_to_virtual(const N_GUI_CTX *ctx, float sx, float sy, float *vx, float *vy)
convert physical screen coordinates to virtual canvas coordinates.
Definition n_gui.c:5019

n_gui_add_button
int n_gui_add_button(N_GUI_CTX *ctx, int window_id, const char *label, float x, float y, float w, float h, int shape, void(*on_click)(int, void *), void *user_data)
add a button widget
Definition n_gui.c:1001

N_GUI_KEY_SOURCES_MAX
#define N_GUI_KEY_SOURCES_MAX
maximum number of source widgets for a focused key binding
Definition n_gui.h:290

n_gui_window_set_autofit
void n_gui_window_set_autofit(N_GUI_CTX *ctx, int window_id, int autofit_flags, float border)
configure auto-fit behavior for a dialog window
Definition n_gui.c:891

n_gui_scrollbar_set_pos
void n_gui_scrollbar_set_pos(N_GUI_CTX *ctx, int widget_id, double pos)
set scrollbar position
Definition n_gui.c:1822

n_gui_dropmenu_clear_dynamic
void n_gui_dropmenu_clear_dynamic(N_GUI_CTX *ctx, int widget_id)
remove all dynamic entries (call from on_open callback before re-adding)
Definition n_gui.c:2326

N_GUI_BUTTON_DATA
button specific data
Definition n_gui.h:295

N_GUI_CHECKBOX_DATA
checkbox specific data
Definition n_gui.h:399

N_GUI_COMBOBOX_DATA
combo box specific data
Definition n_gui.h:507

N_GUI_CTX
The top-level GUI context that holds all windows.
Definition n_gui.h:882

N_GUI_DROPMENU_DATA
dropdown menu specific data
Definition n_gui.h:585

N_GUI_DROPMENU_ENTRY
A single entry in a dropdown menu (static or dynamic)
Definition n_gui.h:571

N_GUI_IMAGE_DATA
image widget specific data
Definition n_gui.h:539

N_GUI_KV_ROW
a single row in the KV table
Definition n_gui.h:1492

N_GUI_KVTABLE
key-value table built from textareas, checkboxes, and buttons
Definition n_gui.h:1502

N_GUI_LABEL_DATA
static text label specific data
Definition n_gui.h:547

N_GUI_LISTBOX_DATA
listbox specific data
Definition n_gui.h:451

N_GUI_LISTITEM
a single item in a list/radio/combo widget
Definition n_gui.h:443

N_GUI_RADIOLIST_DATA
radio list specific data
Definition n_gui.h:477

N_GUI_SCROLLBAR_DATA
scrollbar specific data
Definition n_gui.h:417

N_GUI_SLIDER_DATA
slider specific data
Definition n_gui.h:332

N_GUI_STYLE
Global style holding every configurable layout constant.
Definition n_gui.h:731

N_GUI_TAB_PANEL
tab panel built from toggle buttons with content window management
Definition n_gui.h:1424

N_GUI_TEXT_DIMS
bounding box dimensions returned by n_gui_get_text_dims()
Definition n_gui.h:246

N_GUI_TEXTAREA_DATA
text area specific data
Definition n_gui.h:362

N_GUI_THEME
Color theme for a widget.
Definition n_gui.h:256

N_GUI_TREE
tree view built from an N_GUI listbox
Definition n_gui.h:1466

N_GUI_TREE_NODE
a single node in the tree view
Definition n_gui.h:1456

N_GUI_WIDGET
A single GUI widget.
Definition n_gui.h:617

N_GUI_WINDOW
A pseudo window that contains widgets.
Definition n_gui.h:655

HASH_TABLE
structure of a hash table
Definition n_hash.h:137

LIST
Structure of a generic LIST container.
Definition n_list.h:58

n_allegro5.h
Allegro5 helpers.

n_common.h
Common headers and low-level functions & define.

n_hash.h
Hash functions and table.

n_list.h
List structures and definitions.

n_log.h
Generic log system.

n_str.h
N_STR and string function declaration.