Advanced¶

Use Advanced to understand Datoviz architecture, change runtime or backend code, contribute to the repository, or prepare a release. You do not need this section to create an ordinary visualization; use the How-To guides for tasks and Reference for exact contracts.

Status and stability

The scene API is the primary user surface. DRP2 and lower runtime layers are advanced/unstable; WebGPU/WASM and compute-to-render paths are experimental.

Understand the engine Learn the object model, architecture, frame lifecycle, and retained-resource model. Work on runtime and backends Follow scene output through DRP2 to native Vulkan or browser WebGPU execution. Contribute Find subsystem owners, source-of-truth specifications, and validation workflows. Prepare a release Use the maintainer process, flight checklist, artifact checks, and release evidence.

From scene to output¶

Retained scene state becomes a bounded frame plan, an immutable frame artifact, and a DRP2 command stream. The selected runtime executes that stream through native Vulkan or browser WebGPU and produces presentation, capture, or readback output.

Retained scene Semantic objects

FramePlan Bounded work

Frame artifact Immutable snapshot

DRP2 Command stream

Backend Vulkan or WebGPU

Output Present, capture, readback

Concepts¶

Scene planning¶

Runtime and portability¶

Runtime internals
DRP2 command streams — advanced/unstable
WebGPU subset — experimental
WebGPU example matrix
Compute and graphics — experimental
Deploy to the web
Embed in Qt
Record and replay

Contributors¶

Read the repository AGENTS.md before editing. Durable behavior belongs in spec/, public guidance in docs/, and current execution status in agents/.