damascene-core 0.4.0

Damascene — backend-agnostic UI library core
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

//! Backend-neutral data for the `Scene3D` draw-op: small, polished,
//! hardware-accelerated 3D graphs and models.
//!
//! Scope and rationale live in `docs/SCENE3D_PLAN.md`. The short version:
//! a closed-scope 3D scene (point scatter, small lit meshes, lines) is
//! threaded through the backend-neutral draw-op stream rather than bolted
//! on as a host-composed `surface()`, so it renders zero-glue on every
//! backend. This module owns the *data* the op carries — geometry,
//! handles, and (as the feature lands) camera, lighting, and style. The
//! pipelines that render it live in the backend crates, never here:
//! `damascene-core` stays backend-neutral and is "not a game engine".
//!
//! ## Math vocabulary
//!
//! The scene API speaks [`glam`] — the de-facto standard apps already
//! reach for — so callers pass their own `Vec3`/`Mat4` directly. glam is
//! **re-exported here** ([`scene::glam`](glam)); reference it through this
//! path so downstream code pins the same (pre-1.0) version and avoids the
//! two-incompatible-`Vec3` footgun. The one type glam lacks, an
//! axis-aligned [`Aabb`], lives in [`bounds`].
//!
//! Built so far (the geometry foundation):
//!
//! - [`bounds`]: [`Aabb`] over `glam::Vec3`.
//! - [`geometry`]: logical vertex types and the app-owned, versioned
//!   [`GeometryHandle`] that carries geometry into a scene without the app
//!   ever touching a device.

pub mod axes;
pub mod bounds;
pub mod camera;
pub mod colormap;
pub mod data;
pub mod depth;
pub mod geometry;
pub mod gpu;
pub mod labels;
pub mod spec;
pub mod style;

/// Re-exported so downstream code can pin damascene's exact glam version.
pub use glam;

pub use axes::{Axes, AxisKind, AxisLabel, AxisRange, AxisSpec, TickFormat, TickPolicy};
pub use bounds::Aabb;
pub use camera::{CameraControls, CameraState, Focus, Framing, ResolvedCamera};
pub use colormap::{Colormap, colormap};
pub use data::{LineDraw, MeshDraw, PointDraw, Scene3DData};
pub use depth::SceneDepthMap;
pub use geometry::{
    GeometryData, GeometryHandle, GeometryId, LineData, LineSegment, LinesHandle, MeshData,
    MeshHandle, MeshVertex, PointData, PointsHandle, ScenePoint, next_geometry_id,
};
pub use labels::{LabelDisplay, LabelPlacement, PointLabels, ScenePointPick};
pub use spec::SceneSpec;
pub use style::{
    AxisBounds, GridPlanes, GridSettings, LightRig, LinePattern, LineStyle, Material, PointShape,
    PointStyle, SceneStyle, SizeMode,
};