truce-gui-types 0.49.8

Lightweight GUI types for truce - layout, render trait, widget regions. No rasterization, no windowing.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# truce-gui-types

Lightweight GUI types for the truce audio plugin framework.

## Overview

`truce-gui-types` carries the trait + data surface that GUI
backends build on - `GridLayout`, `RenderBackend` (the trait -
not its impl), `WidgetType`, `WidgetRegion`, `InteractionState`,
`Theme` / `Color`, `ParamSnapshot`, the `grid!` and `layout!`
macros. Crates that only need to *describe* layouts and react
to platform-translated input events depend on this crate; the
heavy machinery (tiny-skia rasterisation, baseview windowing,
truce-font / fontdue) stays in the renderer crates (`truce-cpu`,
`truce-gpu`) and `truce-gui`.

## Crate split

```
truce-core          ← AudioBuffer, Editor trait, EventList, ...
   ↓
truce-gui-types     ← this crate - light data + traits
   ↓
truce-plugin        ← PluginLogic / PluginLogic64 / PluginLogicCore
   ↓                ↘
truce-gui           truce-egui / truce-iced / truce-slint  ← alt GUI backends
(BuiltinEditor,     each depends on truce-gui-types but not truce-gui
 baseview)
   ↓        ↘
truce-cpu  truce-gpu  ← RenderBackend impls, pulled by truce-gui's
(tiny-skia, (wgpu)       cpu (default) / gpu features
 fontdue)
```

A slint-only plugin's dep tree contains `truce-plugin →
truce-gui-types → truce-core` - `tiny-skia`, `baseview`,
`fontdue`, `truce-font` don't appear unless the plugin also
depends on `truce-gui`.

## Key types

- **`GridLayout` / `PluginLayout`** - declarative widget layouts
- **`RenderBackend`** - trait the renderer backends implement (the
  `CpuBackend` in `truce-cpu` is one impl; `truce_gpu::WgpuBackend`
  is another)
- **`WidgetType` / `WidgetKind` / `WidgetRegion`** - widget
  enumeration + hit-test regions
- **`InteractionState` / `InputEvent`** - input dispatch primitives
  (the `BaseviewTranslator` that maps baseview events into these
  lives in `truce-gui`)
- **`Theme` / `Color`** - visual theme (tiny-skia conversions live
  on `ColorExt` in `truce-cpu`)
- **`ParamSnapshot`** - per-frame view of params for widget code

## Macros

- **`layout!`** - declarative DSL for `PluginLayout`
- **`grid!`** - declarative DSL for `GridLayout`

Part of [truce](https://github.com/truce-audio/truce). [Docs](https://truce.audio/docs/).