Concepts
Concepts
Read Anatomy of an app first. It walks through a complete app in the order you write it and introduces the runtime model these pages assume. These pages explain its components. Use the guides for tasks and the API reference for symbols.
- Architecture - the runtime: sources → streams → context → render / predict / output threads.
- Streams - the ring buffer,
get_windowvsget_display, channels-first convention. - Pipeline -
extract/train/predictdecorators,TrainingData, the predict thread. - Controls - the control map, the
[-1, 1]standard, in-process vs. remote targets, deferred binding. - Recording - sessions, label tracks, the
.mg.ziparchive layout. - File names -
<ID>_<YYYYMMDD-HHMM>_<what>.mg.zip, gesture codes, model names. - Widgets - the construct-once
.ui()contract, ImGui immediate mode,Gridlayout. - Threading - daemon threads, GIL release, the GPU contention rule.
- Design principles - the eight rules the codebase keeps to.
- Visual language - the type, colour, panel and state-cue tokens every widget uses.