Initializes the Gooey system with the selected backend. Currently, only the GLPS (OpenGL) backend is supported.

int Gooey_Init();

Animates a widget's horizontal position Creates a smooth translation animation along the X-axis from start to end position. The animation speed controls the duration and easing of the movement.

@param[in,out] widget Pointer to the widget to animate @param[in] start Starting X position in pixels @param[in] end Target X position in pixels @param[in] speed Animation speed (pixels per second or normalized 0.0-1.0)

void GooeyAnimation_TranslateX(GooeyWidget * widget, int start, int end, float speed);

Animates a widget's vertical position Creates a smooth translation animation along the Y-axis from start to end position. The animation speed controls the duration and easing of the movement.

@param[in,out] widget Pointer to the widget to animate @param[in] start Starting Y position in pixels @param[in] end Target Y position in pixels @param[in] speed Animation speed (pixels per second or normalized 0.0-1.0)

void GooeyAnimation_TranslateY(GooeyWidget * widget, int start, int end, float speed);

General event structure.

struct GooeyEvent
{
    GooeyEventType type;

    union
    {
        GooeyMouseData click;
        GooeyMouseData mouse_move;
        GooeyMouseData mouse_scroll;
        GooeyKeyPressData key_press;
        GooeyDropData drop_data;
    };
};

Enumeration of event types.

typedef enum
{
    GOOEY_EVENT_CLICK_PRESS,
    GOOEY_EVENT_CLICK_RELEASE,
    GOOEY_EVENT_MOUSE_MOVE,
    GOOEY_EVENT_MOUSE_SCROLL,
    GOOEY_EVENT_KEY_PRESS,
    GOOEY_EVENT_KEY_RELEASE,
    GOOEY_EVENT_WINDOW_CLOSE,
    GOOEY_EVENT_EXPOSE,
    GOOEY_EVENT_RESIZE,
    GOOEY_EVENT_REDRAWREQ,
    GOOEY_EVENT_DROP,
    GOOEY_EVENT_VK_ENTER,
    GOOEY_EVENT_RESET
} GooeyEventType;

Internal definitions for the Gooey GUI library.

typedef struct GooeyWindow GooeyWindow;

Keyboard key press event data.

typedef struct
{
    unsigned int state;
    char value[20];
    unsigned long keycode;
} GooeyKeyPressData;

File drop event data.

typedef struct
{
    unsigned int state;
    char mime[20];
    char file_path[1024];
    int drop_x;
    int drop_y;
} GooeyDropData;

Mouse event data.

typedef struct
{
    int x;
    int y;
} GooeyMouseData;

Structure representing a theme for the Gooey UI. The colors in the theme are stored as unsigned long values representing the color codes (typically in hexadecimal format).

typedef struct
{
    unsigned long base;        /**< Base window background color */
    unsigned long neutral;     /**< Neutral color for text */
    unsigned long widget_base; /**< Base widget color */
    unsigned long primary;     /**< Primary color */
    unsigned long danger;      /**< Danger color */
    unsigned long info;        /**< Info color */
    unsigned long success;     /**< Success color */
} GooeyTheme;

Structure representing a theme for the Gooey UI. The colors in the theme are stored as unsigned long values representing the color codes (typically in hexadecimal format).

GooeyTheme parser_load_theme_from_file(const char * filePath, bool * is_theme_loaded);

Highlights or unhighlights a button. This function visually indicates whether a button is highlighted, which can be used to show focus or selection.

void GooeyButton_SetHighlight(GooeyButton * button, bool is_highlighted);

Sets the text of the button. This function updates the label text displayed on the button.

void GooeyButton_SetText(GooeyButton * button, const char * text);

Creates a meter widget. Initializes a new GooeyMeter widget at the specified position and size, with an initial value, a label, and an optional icon.

GooeyMeter *GooeyMeter_Create(int x, int y, int width, int height, long initial_value, const char * label, const char * icon_path);

Updates the value displayed by the meter.

void GooeyMeter_Update(GooeyMeter * meter, long new_value);

Creates a plot widget. Adds a plot widget of the specified type to the given position and size, using the provided plot data.

GooeyPlot *GooeyPlot_Create(GOOEY_PLOT_TYPE plot_type, GooeyPlotData * data, int x, int y, int width, int height);

Updates an existing plot with new data. Updates the content of the given plot widget while maintaining its configuration and type.

void GooeyPlot_Update(GooeyPlot * plot, GooeyPlotData * new_data);

Header file for the GooeyLabel module. Provides functions for creating, modifying, and rendering text labels within a GooeyWindow.

GooeyLabel *GooeyLabel_Create(const char * text, float font_size, int x, int y);

Sets the text color of a label. Changes the text color of a label to the specified color.

void GooeyLabel_SetColor(GooeyLabel * label, unsigned long color);

Sets the text of an existing label. Updates the text displayed by a given GooeyLabel.

void GooeyLabel_SetText(GooeyLabel * label, const char * text);

Creates a progress bar widget. Initializes a new progress bar at the specified position and size, with an initial value.

GooeyProgressBar *GooeyProgressBar_Create(int x, int y, int width, int height, long initial_value);

Updates the value of an existing progress bar. Changes the displayed progress to the new value.

void GooeyProgressBar_Update(GooeyProgressBar * progressbar, long new_value);

Header file for the GooeyDropdown module. Provides functions to create, handle, and render dropdown menus within a GooeyWindow.

void GooeyDropdown_Update(GooeyDropdown * dropdown, const char ** new_options, int new_num_options);

Adds a widget to a specific container within the window.

void GooeyContainer_AddWidget(GooeyWindow* window, GooeyContainers* container, size_t container_id, void * widget);

Creates a new container with the given position and dimensions.

GooeyContainers* GooeyContainer_Create(int x, int y, int width, int height);

Inserts a sub-container into the given container.

void GooeyContainer_InsertContainer(GooeyContainers * container);

Sets which container is currently active/visible.

void GooeyContainer_SetActiveContainer(GooeyContainers * container, size_t container_id);

Gets the current text from the textbox.

const char *GooeyTextbox_GetText(GooeyTextbox * textbox);

Draws the textbox on the specified window. Renders the textbox UI, reflecting its current state and contents.

void GooeyTextbox_Draw(GooeyWindow * win);

Handles click events on the textbox. Detects clicks on the textbox area and activates the textbox for input if clicked.

bool GooeyTextbox_HandleClick(GooeyWindow * win, int x, int y);

Processes key press events for the textbox. Updates the textbox content based on keyboard input.

void GooeyTextbox_HandleKeyPress(GooeyWindow * win, void * event);

Sets the text content of the textbox.

void GooeyTextbox_SetText(GooeyTextbox * textbox, const char * text);

Displays the specified message box window. This function makes the message box visible on the screen. The message box must have been created using `GooeyMessageBox_Create`.

void GooeyMessageBox_Show(GooeyWindow * msgBoxWindow);

Adds an item to the specified list widget.

void GooeyList_AddItem(GooeyList * list, const char * title, const char * description);

Clears all items from the specified list widget. Removes all list items from the provided list widget.

void GooeyList_ClearItems(GooeyList * list);

Toggles the visibility of the separator in a list widget. Enables or disables the visual separator between list items.

void GooeyList_ShowSeparator(GooeyList * list, bool state);

Updates the title and description of a specific item in the list.

void GooeyList_UpdateItem(GooeyList * list, size_t item_index, const char * title, const char * description);

Draws a rectangle onto the user-defined canvas. The rectangle can be either filled with a solid color or outlined.

void GooeyCanvas_DrawLine(GooeyCanvas * canvas, int x1, int y1, int x2, int y2, unsigned long color_hex);

Draws an arc onto the user-defined canvas. The arc is drawn within the specified bounding box and between the given angles.

void GooeyCanvas_SetForeground(GooeyCanvas * canvas, unsigned long color_hex);

Retrieves the current value of the slider. Returns the current slider value, guaranteed to be within the configured range.

long GooeySlider_GetValue(GooeySlider * slider);

Sets the slider's value. Updates the slider's position and value to the specified value within its range.

void GooeySlider_SetValue(GooeySlider * slider, long value);

Creates a tab widget. Creates a GooeyTabs widget at the specified position with given dimensions. If `is_sidebar` is true, the tabs behave as a sidebar.

GooeyTabs *GooeyTabs_Create(int x, int y, int width, int height, bool is_sidebar);

Adds a widget to a specified tab. Associates a widget with a tab identified by tab_id.

void GooeyTabs_AddWidget(GooeyWindow * window, GooeyTabs * tabs, size_t tab_id, void * widget);

Inserts a new tab with the specified name. Adds a new tab to the tab widget.

void GooeyTabs_InsertTab(GooeyTabs * tab_widget, char * tab_name);

Sets the active tab. Switches the active tab to the one specified by tab_id.

void GooeyTabs_SetActiveTab(GooeyTabs * tabs, size_t tab_id);

Closes the sidebar tabs (if tabs are in sidebar mode).

void GooeyTabs_Sidebar_Close(GooeyTabs * tabs_widget);

Opens the sidebar tabs (if tabs are in sidebar mode).

void GooeyTabs_Sidebar_Open(GooeyTabs * tabs_widget);

Header file for the GooeyLayout module. Provides functionality for managing and arranging widgets within a structured layout inside a GooeyWindow.

void GooeyLayout_AddChild(GooeyWindow * window, GooeyLayout * layout, void * widget);

Finalizes and builds the layout. This function applies the layout rules and arranges all child widgets accordingly.

void GooeyLayout_Build(GooeyLayout * layout);

Adds a child menu item to the window's menu. Creates a submenu or a category inside the main menu.

GooeyMenuChild *GooeyMenu_AddChild(GooeyWindow * win, char * title, void* user_data);

Header file for the Gooey menu system. Provides functions to create and manage menus and menu items within a Gooey window.

GooeyMenu *GooeyMenu_Set(GooeyWindow * win);

Marks the image as needing redrawing (damaged).

void GooeyImage_Damage(GooeyImage * image);

Image handling functions for the Gooey GUI library. This file contains functions for adding and drawing images in a Gooey window.

void GooeyImage_SetImage(GooeyImage * image, const char * image_path);

Header file for the GooeyDropSurface module.

void GooeyDropSurface_Clear(GooeyDropSurface * drop_surface);

Creates a new radio button group. Allows grouping of multiple radio buttons, ensuring single selection.

GooeyRadioButtonGroup *GooeyRadioButtonGroup_Create();

Draws all radio buttons in the group on the window. Renders the visual state of each radio button, reflecting selection.

void GooeyRadioButtonGroup_Draw(GooeyWindow * win);

Handles click events for a group of radio buttons. Ensures that only one radio button in the group is selected at a time.

bool GooeyRadioButtonGroup_HandleClick(GooeyWindow * win, int x, int y);

Handles a click event on radio buttons within a window. Checks if a radio button was clicked and triggers the appropriate callback.

bool GooeyRadioButton_HandleClick(GooeyWindow * win, int x, int y);

Retrieves the current value of the slider. Returns the current slider value, guaranteed to be within the configured range.

bool GooeySwitch_GetState(GooeySwitch * gswitch);

Sets the slider's value. Updates the slider's position and value to the specified value within its range.

void GooeySwitch_Toggle(GooeySwitch * gswitch);

Sets the visibility state of a widget.

void GooeyWidget_MakeVisible(void* widget, bool state);

Moves the widget to a new position.

void GooeyWidget_MoveTo(void* widget, int x, int y);

Resizes the widget.

void GooeyWidget_Resize(void* widget, int w, int h);

Creates a new timer object.

GooeyTimer *GooeyTimer_Create();

Destroys the timer and frees its resources.

void GooeyTimer_Destroy(GooeyTimer * timer);

Stops the timer if it is running.

void GooeyTimer_Stop(GooeyTimer * timer);

Loads a theme from the specified file path. This function reads a theme file and returns a `GooeyTheme` object that can be applied to Gooey windows.

GooeyTheme *GooeyTheme_LoadFromFile(const char * theme_path);

Creates a new Gooey window with the specified title, width, and height. This function initializes and returns a new window. The window can be customized with various properties such as its visibility and theme.

GooeyWindow *GooeyWindow_Create(const char * title, int x, int y, int width, int height, bool visibility);

Cleans up the resources associated with Gooey windows. This function deallocates memory and resources for the specified windows and their associated widgets.

void GooeyWindow_Cleanup(int num_windows, GooeyWindow * first_win, ... );

Sets the resizable property of a window. This function determines whether the user can resize the window. If the window is made resizable, the user can adjust its size at runtime.

void GooeyWindow_MakeResizable(GooeyWindow * msgBoxWindow, bool is_resizable);

Sets the visibility of a Gooey window. This function controls whether the window is visible or hidden.

void GooeyWindow_MakeVisible(GooeyWindow * win, bool visibility);

Registers a widget with the specified window. This function adds a widget (such as a button, label, or slider) to a window, so it can be rendered and interact with user input.

void GooeyWindow_RegisterWidget(GooeyWindow * win, void * widget);

Requests a redraw of the window. This function triggers a redraw of the specified window, typically in response to changes that affect its appearance (e.g., updates to the window's content or layout).

void GooeyWindow_RequestRedraw(GooeyWindow * win);

Runs the Gooey window's event loop. This function starts the main event loop for the specified window, where user input and window events are processed until the window is closed.

void GooeyWindow_Run(int num_windows, GooeyWindow * first_win, ... );

Sets the theme for the specified Gooey window. This function applies the given theme to the window, updating its appearance.

void GooeyWindow_SetTheme(GooeyWindow * win, GooeyTheme * theme);