stipple-render 0.0.1

The Stipple rendering seam: builds an oxideav scene graph, rasterizes it on the CPU, and presents through a backend-agnostic Surface.
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

//! The Stipple rendering seam.
//!
//! `stipple-render` is the one crate that knows about `oxideav`. It turns a
//! [`Scene`] (a list of logical-pixel draw primitives) into an `oxideav-core`
//! scene graph, rasterizes it on the CPU with `oxideav-raster`, and hands the
//! result to a [`Surface`] for display.
//!
//! ```
//! use stipple_geometry::{Rect, ScaleFactor, Size};
//! use stipple_render::{Color, Scene, SoftwareRenderer};
//!
//! let mut scene = Scene::new(Size::new(64.0, 64.0));
//! scene.fill_round_rect(Rect::from_xywh(8.0, 8.0, 48.0, 48.0), 12.0, Color::rgb(80, 140, 255));
//!
//! let pixmap = SoftwareRenderer::new().render(scene, ScaleFactor::IDENTITY);
//! assert_eq!(pixmap.size().width, 64);
//! ```
//!
//! The [`Surface`] trait is the GPU-readiness boundary: today the
//! [`SoftwareRenderer`] produces a [`Pixmap`] that the platform layer blits;
//! a future raw-GPU backend (Metal / Vulkan / D3D12 / WebGPU) can implement
//! the same trait without changing any caller. See `ROADMAP.md` ยง2 / Phase 6.

#![forbid(unsafe_code)]

mod color;
mod convert;
mod scene;
mod software;
mod surface;
mod text;

pub use color::Color;
pub use scene::{DrawCmd, Scene};
pub use software::SoftwareRenderer;
pub use surface::{Pixmap, Surface};
pub use text::{Font, FontError};

/// Low-level conversions to `oxideav-core` coordinate types. Exposed for
/// crates that build scene-graph nodes directly (e.g. the future text-run
/// shaping bridge) and need to share Stipple's geometry conventions.
pub mod oxideav_bridge {
    pub use crate::convert::{to_ox_point, to_transform2d};
}