ra8_box.h

Go to the documentation of this file.

 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
 
#include "ra8_err.h"
#include "ra8_ui.h"
 
/* ===========================================================================
 * Sentinels
 * ===========================================================================
 */

typedef enum : int32_t {
  k_ra8_box_none      = -1,         
  k_ra8_box_no_colour = (int32_t)0, 
} ra8_box_const_t;

typedef enum : uint8_t {
  k_ra8_box_stack_v = 0U, 
  k_ra8_box_stack_h = 1U, 
  k_ra8_box_grid    = 2U, 
  k_ra8_box_leaf    = 3U, 
} ra8_box_kind_t;
 
/* ===========================================================================
 * Node + tree
 * ===========================================================================
 */

typedef struct {
  uint8_t       kind;        
  uint8_t       grid_cols;   
  int16_t       fixed;       
  uint16_t      flex;        
  int16_t       pad;         
  int16_t       gap;         
  uint32_t      fill;        
  uint32_t      border;      
  int16_t       border_w;    
  int16_t       tag;         
  int32_t       first_child; 
  int32_t       next;        
  ra8_ui_rect_t rect;        
} ra8_box_t;

typedef struct {
  ra8_box_t* nodes; 
  uint16_t   cap;   
  uint16_t   count; 
} ra8_box_tree_t;
 
/* ===========================================================================
 * API
 * ===========================================================================
 */

[[nodiscard]] ra8_err_t ra8_box_tree_init(ra8_box_tree_t* tree, ra8_box_t* storage, uint16_t cap);

[[nodiscard]] int16_t ra8_box_add(ra8_box_tree_t* tree, int16_t parent, const ra8_box_t* node);

[[nodiscard]] ra8_err_t
ra8_box_layout(ra8_box_tree_t* tree, int16_t root, const ra8_ui_rect_t* frame);
 
#ifdef __cplusplus
}
#endif