Skip to content
GitHub · 2.7.0

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_window vs get_display, channels-first convention.
  • Pipeline - extract / train / predict decorators, 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.zip archive layout.
  • File names - <ID>_<YYYYMMDD-HHMM>_<what>.mg.zip, gesture codes, model names.
  • Widgets - the construct-once .ui() contract, ImGui immediate mode, Grid layout.
  • 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.