ui_layout.c File Reference

Backend-agnostic layout helpers. More...

#include "ui_layout.h"
#include "ui_backend.h"
#include <string.h>

Include dependency graph for ui_layout.c:

Go to the source code of this file.

Functions
void	ui_framed_surface_destroy (UiFramedSurface *fs)
	Destroy a framed surface and release its resources.
UiFramedSurface	ui_framed_surface_new (UiSurface *parent, UiRect rect)
	Create a framed surface (outer border + inner content area).

Detailed Description

Backend-agnostic layout helpers.

Implements utility functions that build higher-level layout concepts (framed surfaces, etc.) entirely through the portable UALUI API so they work with any compiled-in backend.

Definition in file ui_layout.c.

Function Documentation

ui_framed_surface_destroy()

void ui_framed_surface_destroy

(

UiFramedSurface *

fs

)

Destroy a framed surface and release its resources.

Destroys a framed surface and releases its resources.

Parameters

fs	Pointer to the UiFramedSurface to destroy.

Definition at line 54 of file ui_layout.c.

                                                    {
    if (!fs)
        return;
    /* Destroy inner before outer (child before parent). */
    if (fs->inner)
        ui_surface_destroy(fs->inner);
    if (fs->outer)
        ui_surface_destroy(fs->outer);
    fs->inner = NULL;
    fs->outer = NULL;
}

References UiFramedSurface::inner, UiFramedSurface::outer, and ui_surface_destroy().

Here is the call graph for this function:

ui_framed_surface_new()

UiFramedSurface ui_framed_surface_new	(	UiSurface *	parent,
		UiRect	rect )

Create a framed surface (outer border + inner content area).

Creates a new framed surface with the specified parent and rectangle.

The returned UiFramedSurface.outer is the frame panel; .inner is one row and one column smaller on each side (the drawable content area). The caller is responsible for destroying the framed surface with ui_framed_surface_destroy() when it is no longer needed.

Parameters

ui	The UiRuntime context.
parent	Parent surface, or NULL to make the frame a top-level panel.
rect	Position and size of the outer frame (including the border).

Returns

A UiFramedSurface; both fields are NULL on failure.

Definition at line 26 of file ui_layout.c.

                                                                      {
    int w = 0;
    UiFramedSurface fs = {NULL, NULL};
 
    if (!ui || rect.lines < 3 || rect.cols < 3)
        return fs;
 
    // char title[64] = {0};
    fs.outer = ui_surface_new(w, parent, 0, rect.lines, rect.cols, rect.y, rect.x);
    if (!fs.outer)
        return fs;
 
    rect.y = 1,
    rect.x = 1,
    rect.lines = rect.lines - 2,
    rect.cols = rect.cols - 2,
    fs.inner = ui_surface_new(w, fs.outer, 0, rect.lines, rect.cols, rect.y, rect.x);
    if (!fs.inner) {
        ui_surface_destroy(fs.outer);
        fs.outer = NULL;
    }
 
    return fs;
}

References UiRect::cols, UiFramedSurface::inner, UiRect::lines, UiFramedSurface::outer, ui, ui_surface_destroy(), ui_surface_new(), UiRect::x, and UiRect::y.

Here is the call graph for this function: