esoc-scene 0.1.0

Arena scene graph with typed visual marks — shared IR between chart logic and rendering backends
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

# esoc-scene

Arena-allocated scene graph with typed visual marks. This is the intermediate representation that sits between chart logic (which decides *what* to draw) and rendering backends (which decide *how*). Producers build a `SceneGraph`; backends like `esoc-gfx` walk it.

## Install

```toml
[dependencies]
esoc-scene = "0.1"
```

## Marks

Nine primitive mark types cover the data-visualization vocabulary:

`LineMark`, `RectMark`, `PointMark`, `AreaMark`, `TextMark`, `ArcMark`, `RuleMark`, `PathMark`, `ImageMark`.

A `Mark` enum wraps any one of them; `MarkBatch` holds a homogeneous run for instanced rendering. Each batch attribute can be a single value or per-instance — the backend decides whether to expand or instance.

## Nodes and the arena

`SceneGraph` is a generational-index arena. `NodeId` carries an index plus generation counter, so freed slots can't be confused with reused ones (ABA safety). Nodes have a parent, children, local `Affine2D` transform, opacity, z-order, optional clip rect, and either `Container`, `Mark`, or `Batch` content.

Optional `MarkKey` per node identifies marks across scene diffs — useful when an animation layer needs enter/update/exit sets between frames.

## Why an arena?

Tree-of-`Box`/`Rc` scene graphs fragment memory and make traversal cache-unfriendly. An arena keeps nodes contiguous, lets `NodeId` be `Copy`, and gives O(1) insert/remove without unsafe code or refcounting.

## Example

```rust
use esoc_scene::{SceneGraph, Node, NodeContent, Mark};
use esoc_scene::mark::{PointMark, MarkerShape};

let mut sg = SceneGraph::with_root();
let root = sg.root().unwrap();

let dot = sg.insert(Node {
    parent: Some(root),
    children: vec![],
    transform: Default::default(),
    clip: false,
    z_order: 0,
    opacity: 1.0,
    content: NodeContent::Mark(Mark::Point(PointMark {
        center: [100.0, 50.0],
        size: 6.0,
        shape: MarkerShape::Circle,
        fill: Default::default(),
        stroke: Default::default(),
    })),
    key: None,
});
sg.add_child(root, dot);
```

## License

MIT OR Apache-2.0