ra8-firmware/ra8__widget__status__bar_8h_source.html

#pragma once


#ifdef __cplusplus

extern "C" {

#endif


#include <stdint.h>


#include "ra8_err.h"

#include "ra8_widget.h"


typedef struct ra8_widget_status_bar {

  const ra8_widget_paint_t* paint;

  const char*               left;

  const char*               right;

  uint32_t                  bg;

  uint32_t                  fg;

  uint32_t                  fg_right;

  uint32_t                  rule;

  int16_t                   pad;

  int16_t                   rule_h;

} ra8_widget_status_bar_t;


const ra8_widget_vtable_t* ra8_widget_status_bar_vtable(void);


[[nodiscard]] ra8_err_t ra8_widget_status_bar_init(ra8_widget_t* w, ra8_widget_status_bar_t* bar);


#ifdef __cplusplus

}

#endif

ra8_err.h
Error Code Definitions for ra8-firmware.

ra8_err_t
ra8_err_codes_t ra8_err_t
Canonical error-return type used by every ra8-firmware API.
Definition ra8_err.h:546

ra8_widget.h
Zero-heap composable widget layer (dwm-style) over ra8_box + ra8_ui.

ra8_widget_status_bar_init
ra8_err_t ra8_widget_status_bar_init(ra8_widget_t *w, ra8_widget_status_bar_t *bar)
Bind a widget instance to a status bar.
Definition ra8_widget_status_bar.c:140

ra8_widget_status_bar_vtable
const ra8_widget_vtable_t * ra8_widget_status_bar_vtable(void)
Return the shared vtable backing every status-bar widget.
Definition ra8_widget_status_bar.c:135

ra8_widget_paint_t
Drawing backend the concrete leaf widgets paint through (a DI seam).

ra8_widget_status_bar_t
A status band: a fill, a left + right label, and a bottom hairline.

ra8_widget_status_bar
Definition ra8_widget_status_bar.h:65

ra8_widget_status_bar::left
const char * left
Left-aligned text (NULL -> none).
Definition ra8_widget_status_bar.h:67

ra8_widget_status_bar::fg_right
uint32_t fg_right
Right text colour, 0xRRGGBB.
Definition ra8_widget_status_bar.h:71

ra8_widget_status_bar::paint
const ra8_widget_paint_t * paint
Draw backend (NULL -> draws nothing).
Definition ra8_widget_status_bar.h:66

ra8_widget_status_bar::bg
uint32_t bg
Background fill colour, 0xRRGGBB.
Definition ra8_widget_status_bar.h:69

ra8_widget_status_bar::rule_h
int16_t rule_h
Hairline thickness in px (<= 0 -> none).
Definition ra8_widget_status_bar.h:74

ra8_widget_status_bar::fg
uint32_t fg
Left text colour, 0xRRGGBB.
Definition ra8_widget_status_bar.h:70

ra8_widget_status_bar::pad
int16_t pad
Inner text inset, pixels.
Definition ra8_widget_status_bar.h:73

ra8_widget_status_bar::right
const char * right
Right-aligned text (NULL -> none).
Definition ra8_widget_status_bar.h:68

ra8_widget_status_bar::rule
uint32_t rule
Bottom hairline colour, 0xRRGGBB.
Definition ra8_widget_status_bar.h:72

ra8_widget_t
One widget instance (caller-owned, no allocation).

ra8_widget_vtable_t
Behaviour table shared by all widgets of one kind.
Definition ra8_widget.h:121