orca/src/ui.h

349 lines
7.7 KiB
C
Raw Normal View History

2022-08-14 16:19:40 +00:00
/************************************************************//**
*
* @file: ui.h
* @author: Martin Fouilleul
* @date: 08/08/2022
* @revision:
*
*****************************************************************/
#ifndef __UI_H_
#define __UI_H_
#include"typedefs.h"
#include"lists.h"
#include"graphics.h"
#ifdef __cplusplus
extern "C" {
#endif
typedef enum
{
UI_FLAG_CLICKABLE = (1<<0),
UI_FLAG_SCROLLABLE = (1<<1),
UI_FLAG_BLOCK_MOUSE = (1<<2),
UI_FLAG_HOT_ANIMATION = (1<<3),
UI_FLAG_ACTIVE_ANIMATION = (1<<4),
UI_FLAG_CLIP = (1<<5),
UI_FLAG_DRAW_BACKGROUND = (1<<6),
UI_FLAG_DRAW_FOREGROUND = (1<<7),
UI_FLAG_DRAW_BORDER = (1<<8),
UI_FLAG_DRAW_TEXT = (1<<9),
UI_FLAG_DRAW_RENDER_PROC = (1<<10),
2022-08-14 16:19:40 +00:00
} ui_flags;
typedef struct ui_key
{
u64 hash;
} ui_key;
typedef enum
{
UI_AXIS_X,
UI_AXIS_Y,
UI_AXIS_COUNT
} ui_axis;
typedef enum
{
UI_ALIGN_START,
UI_ALIGN_END,
UI_ALIGN_CENTER,
} ui_align;
typedef struct ui_layout
{
ui_axis axis;
ui_align align[UI_AXIS_COUNT];
} ui_layout;
typedef enum
{
UI_SIZE_TEXT,
UI_SIZE_PIXELS,
UI_SIZE_CHILDREN,
UI_SIZE_PARENT_RATIO,
} ui_size_kind;
typedef struct ui_size
{
ui_size_kind kind;
f32 value;
f32 strictness;
} ui_size;
typedef enum { UI_STYLE_ANIMATE_SIZE_X = 1<<1,
UI_STYLE_ANIMATE_SIZE_Y = 1<<2,
UI_STYLE_ANIMATE_COLOR = 1<<3,
UI_STYLE_ANIMATE_BG_COLOR = 1<<4,
UI_STYLE_ANIMATE_BORDER_COLOR = 1<<5,
UI_STYLE_ANIMATE_BORDER_SIZE = 1<<6,
UI_STYLE_ANIMATE_FONT_SIZE = 1<<7,
UI_STYLE_ANIMATE_ROUNDNESS = 1<<8,
UI_STYLE_ANIMATE_POS = 1<<9,
2022-08-15 22:01:07 +00:00
} ui_style_animation_flags;
2022-08-14 16:19:40 +00:00
typedef struct ui_style
{
2022-08-15 08:20:29 +00:00
ui_size size[UI_AXIS_COUNT];
ui_layout layout;
bool floating[UI_AXIS_COUNT];
vec2 floatTarget;
mg_color color;
2022-08-15 08:20:29 +00:00
mg_color bgColor;
2022-08-14 16:19:40 +00:00
mg_color borderColor;
mg_font font;
f32 fontSize;
f32 borderSize;
f32 roundness;
f32 animationTime;
2022-08-15 22:01:07 +00:00
ui_style_animation_flags animationFlags;
2022-08-14 16:19:40 +00:00
} ui_style;
typedef u64 ui_style_mask;
enum
{
UI_STYLE_NONE = 0,
UI_STYLE_SIZE_X = 1<<1,
UI_STYLE_SIZE_Y = 1<<2,
UI_STYLE_COLOR = 1<<3,
UI_STYLE_BG_COLOR = 1<<4,
UI_STYLE_BORDER_COLOR = 1<<6,
UI_STYLE_BORDER_SIZE = 1<<7,
UI_STYLE_ROUNDNESS = 1<<8,
UI_STYLE_FONT = 1<<9,
UI_STYLE_FONT_SIZE = 1<<10,
UI_STYLE_ANIMATION_TIME = 1<<11,
UI_STYLE_ANIMATION_FLAGS = 1<<12,
//...
UI_STYLE_MASK_INHERITED = UI_STYLE_COLOR
| UI_STYLE_FONT
| UI_STYLE_FONT_SIZE
| UI_STYLE_ANIMATION_TIME
| UI_STYLE_ANIMATION_FLAGS,
};
typedef struct ui_tag { u64 hash; } ui_tag;
typedef enum
{
UI_SEL_TEXT,
UI_SEL_TAG,
UI_SEL_HOVER,
UI_SEL_ACTIVE,
UI_SEL_DRAGGING,
UI_SEL_KEY,
//...
} ui_selector_kind;
typedef struct ui_selector
{
list_elt listElt;
ui_selector_kind kind;
union
{
str8 text;
ui_key key;
ui_tag tag;
//...
};
} ui_selector;
typedef struct ui_pattern { list_info l; } ui_pattern;
typedef struct ui_style_rule
{
list_elt boxElt;
list_elt buildElt;
list_elt tmpElt;
ui_pattern pattern;
ui_style_mask mask;
ui_style* style;
} ui_style_rule;
2022-08-14 16:19:40 +00:00
typedef struct ui_box ui_box;
typedef struct ui_sig
{
ui_box* box;
vec2 mouse;
vec2 delta;
vec2 wheel;
bool pressed;
bool released;
bool clicked;
bool doubleClicked;
bool rightPressed;
2022-08-14 16:19:40 +00:00
bool dragging;
bool hovering;
} ui_sig;
2023-03-03 16:13:03 +00:00
typedef void(*ui_box_render_proc)(ui_box* box, void* data);
2022-08-14 16:19:40 +00:00
struct ui_box
{
// hierarchy
list_elt listElt;
list_info children;
ui_box* parent;
// keying and caching
list_elt bucketElt;
ui_key key;
u64 frameCounter;
// builder-provided info
ui_flags flags;
str8 string;
list_info tags;
2022-08-14 16:19:40 +00:00
ui_box_render_proc renderProc;
void* renderData;
// styling
list_info beforeRules;
list_info afterRules;
//ui_style_tag tag;
2022-08-15 08:20:29 +00:00
ui_style* targetStyle;
ui_style style;
2022-08-14 16:19:40 +00:00
u32 z;
2022-08-15 22:01:07 +00:00
vec2 floatPos;
2022-08-14 16:19:40 +00:00
f32 childrenSum[2];
2022-08-15 08:20:29 +00:00
mp_rect rect;
2022-08-14 16:19:40 +00:00
// signals
ui_sig* sig;
// stateful behaviour
bool fresh;
2022-08-14 16:19:40 +00:00
bool closed;
bool parentClosed;
bool dragging;
2022-08-15 08:20:29 +00:00
bool hot;
2022-08-14 16:19:40 +00:00
bool active;
vec2 scroll;
// animation data
f32 hotTransition;
f32 activeTransition;
};
2022-08-15 21:11:00 +00:00
typedef struct ui_context ui_context;
void ui_init(void);
ui_context* ui_get_context(void);
2022-08-15 21:11:00 +00:00
void ui_set_context(ui_context* context);
2022-08-14 16:19:40 +00:00
void ui_begin_frame(u32 width, u32 height, ui_style defaultStyle);
void ui_end_frame(void);
#define ui_frame(width, height, defaultStyle) defer_loop(ui_begin_frame(width, height, defaultStyle), ui_end_frame())
2023-03-03 16:13:03 +00:00
void ui_draw(void);
2022-08-14 16:19:40 +00:00
ui_box* ui_box_lookup(const char* string);
ui_box* ui_box_lookup_str8(str8 string);
2022-08-14 16:19:40 +00:00
ui_box* ui_box_make(const char* string, ui_flags flags);
ui_box* ui_box_begin(const char* string, ui_flags flags);
ui_box* ui_box_make_str8(str8 string, ui_flags flags);
ui_box* ui_box_begin_str8(str8 string, ui_flags flags);
ui_box* ui_box_end(void);
2022-08-14 16:19:40 +00:00
#define ui_container(name, flags) defer_loop(ui_box_begin(name, flags), ui_box_end())
void ui_box_push(ui_box* box);
void ui_box_pop(void);
ui_box* ui_box_top(void);
ui_tag ui_tag_make(str8 string);
void ui_tag_box(ui_box* box, str8 string);
void ui_tag_next(str8 string);
bool ui_box_closed(ui_box* box);
void ui_box_set_closed(ui_box* box, bool closed);
bool ui_box_active(ui_box* box);
void ui_box_activate(ui_box* box);
void ui_box_deactivate(ui_box* box);
bool ui_box_hot(ui_box* box);
void ui_box_set_hot(ui_box* box, bool hot);
void ui_box_set_render_proc(ui_box* box, ui_box_render_proc proc, void* data);
/*
2022-08-14 16:19:40 +00:00
void ui_box_set_layout(ui_box* box, ui_axis axis, ui_align alignX, ui_align alignY);
void ui_box_set_size(ui_box* box, ui_axis axis, ui_size_kind kind, f32 value, f32 strictness);
void ui_box_set_floating(ui_box* box, ui_axis axis, f32 pos);
void ui_box_set_style_selector(ui_box* box, ui_style_selector selector);
*/
2022-08-14 16:19:40 +00:00
ui_sig ui_box_sig(ui_box* box);
//NOTE: styling API
//WARN: You can use a pattern in multiple rules, but be aware that a pattern is references an underlying list of selectors,
// hence pushing to a pattern also modifies rules in which the pattern was previously used!
void ui_pattern_push(mem_arena* arena, ui_pattern* pattern, ui_selector selector);
void ui_style_next(ui_pattern pattern, ui_style* style, ui_style_mask mask);
void ui_style_prev(ui_pattern pattern, ui_style* style, ui_style_mask mask);
2022-08-14 16:19:40 +00:00
2023-03-03 16:13:03 +00:00
//-------------------------------------------------------------------------
// Basic widget helpers
//-------------------------------------------------------------------------
2022-08-15 08:20:29 +00:00
enum {
UI_STYLE_TAG_USER_MAX = 1<<16,
UI_STYLE_TAG_LABEL,
UI_STYLE_TAG_BUTTON,
UI_STYLE_TAG_SCROLLBAR,
UI_STYLE_TAG_PANEL,
UI_STYLE_TAG_TOOLTIP,
UI_STYLE_TAG_MENU
};
ui_sig ui_label(const char* label);
ui_sig ui_label_str8(str8 label);
2022-08-14 16:19:40 +00:00
ui_sig ui_button(const char* label);
ui_sig ui_button_str8(str8 label);
2022-08-14 16:19:40 +00:00
ui_box* ui_scrollbar(const char* label, f32 thumbRatio, f32* scrollValue);
ui_box* ui_panel_begin(const char* name);
void ui_panel_end(void);
2022-08-14 16:19:40 +00:00
#define ui_panel(name) defer_loop(ui_panel_begin(name), ui_panel_end())
ui_sig ui_tooltip_begin(const char* name);
void ui_tooltip_end(void);
2022-08-14 16:19:40 +00:00
#define ui_tooltip(name) defer_loop(ui_tooltip_begin(name), ui_tooltip_end())
void ui_menu_bar_begin(const char* label);
void ui_menu_bar_end(void);
2022-08-14 16:19:40 +00:00
#define ui_menu_bar(name) defer_loop(ui_menu_bar_begin(name), ui_menu_bar_end())
void ui_menu_begin(const char* label);
void ui_menu_end(void);
2022-08-14 16:19:40 +00:00
#define ui_menu(name) defer_loop(ui_menu_begin(name), ui_menu_end())
2022-08-15 08:20:29 +00:00
typedef struct ui_text_box_result
{
bool changed;
bool accepted;
str8 text;
}ui_text_box_result;
ui_text_box_result ui_text_box(const char* name, mem_arena* arena, str8 text);
2022-08-14 16:19:40 +00:00
#ifdef __cplusplus
} // extern "C"
#endif
#endif //__UI_H_