Aethera/render_3D/third_party/datoviz/spec/scene/api

Scene API Specs

This directory contains the public API profile and implementation bridge.

Use these files when drafting public headers, deciding handle/descriptor/result shapes, or mapping scene concepts into C and language bindings.

Files

1. API_DESIGN.md: preferred scene-facing API profile and rationale.
2. API_SURFACE.md: immediate public-header target for interaction, scales, colorbars, text, and annotations.
3. API_IMPLEMENTATION_READINESS.md: implementation-readiness checklist for the next public API pass.
4. IMPLEMENTATION_NOTES.md: C object mapping and binding architecture.
5. OBJECT_LIFECYCLE.md: missing destroy APIs and retained-object lifecycle policy.
6. WASM_PORTABILITY.md: public scene API constraints for future WASM/WebGPU builds and generated bindings.
7. REFERENCE_GRID.md: v0.4 reference-grid API direction, v0.3 comparison, extent/fade semantics, and implementation staging.

Related Directories

1. ../headers: implementation-facing draft header sketches.
2. ../slices: implementation-ready work packets for mature API areas.
3. ../proposals: active design addenda that feed future API drafts.
4. ../examples: API pressure sketches and worked examples.

Active Proposal Inputs

1. ../proposals/promoted/INTERACTION_API_DESIGN.md
2. ../proposals/promoted/ANNOTATION_TEXT_SCALE_API.md for unresolved rationale only; installed headers own landed text/colorbar/annotation names
3. ../proposals/promoted/MESH_API_DESIGN.md
4. ../proposals/active/MATERIAL_LIGHTING_API.md
5. ../proposals/promoted/SAMPLED_FIELD_API_DESIGN.md

Active Implementation Slice Inputs

1. ../slices/TEXT_RENDERING_SLICE.md
2. ../slices/ANNOTATION_LABEL_SLICE.md
3. ../slices/COLORBAR_RENDERING_SLICE.md
4. ../slices/LEGEND_SLICE.md