ra8-firmware/ra8__widget__progress__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_progress_bar {

  const ra8_widget_paint_t* paint;

  uint32_t                  track;

  uint32_t                  fill;

  uint16_t                  value;

  uint16_t                  total;

} ra8_widget_progress_bar_t;


const ra8_widget_vtable_t* ra8_widget_progress_bar_vtable(void);


[[nodiscard]] ra8_err_t ra8_widget_progress_bar_init(ra8_widget_t*              w,

                                                     ra8_widget_progress_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_progress_bar_init
ra8_err_t ra8_widget_progress_bar_init(ra8_widget_t *w, ra8_widget_progress_bar_t *bar)
Bind a widget instance to a progress bar.
Definition ra8_widget_progress_bar.c:87

ra8_widget_progress_bar_vtable
const ra8_widget_vtable_t * ra8_widget_progress_bar_vtable(void)
Return the shared vtable backing every progress-bar widget.
Definition ra8_widget_progress_bar.c:82

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

ra8_widget_progress_bar_t
A proportional progress bar: a track plus a value / total fill.

ra8_widget_progress_bar
Definition ra8_widget_progress_bar.h:64

ra8_widget_progress_bar::fill
uint32_t fill
Filled-portion colour, 0xRRGGBB.
Definition ra8_widget_progress_bar.h:67

ra8_widget_progress_bar::value
uint16_t value
Current progress value (clamped to total).
Definition ra8_widget_progress_bar.h:68

ra8_widget_progress_bar::total
uint16_t total
Full-scale value; 0 -> empty (no fill).
Definition ra8_widget_progress_bar.h:69

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

ra8_widget_progress_bar::track
uint32_t track
Track (unfilled) fill colour, 0xRRGGBB.
Definition ra8_widget_progress_bar.h:66

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