oxideav-scene 0.1.3

Pure-Rust time-based scene / composition model for oxideav — PDF pages, RTMP streaming compositor, NLE timelines on one data model
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

//! A time-based composition model for oxideav.
//!
//! The type surface (scene, objects, animations, time-base) is in
//! place. The full [`SceneRenderer`] driver is still a stub
//! ([`StubRenderer`] returns `Error::Unsupported`); concrete
//! per-object rendering lands here piecemeal. The first real piece
//! is [`text::TextRenderer`] — it composites a [`TextRun`] onto a
//! straight-alpha RGBA framebuffer via [`oxideav_scribe`] (TrueType
//! shaping + scanline rasterisation). The caller supplies the
//! [`oxideav_scribe::Face`]; scene-level font discovery is out of
//! scope.
//!
//! See [`README.md`](../README.md) for the full design + the three
//! target use cases (PDF pages, RTMP streaming compositor, NLE
//! timeline).
//!
//! # Quick tour
//!
//! ```no_run
//! use oxideav_scene::{Scene, Canvas, SceneDuration, SceneObject};
//! use oxideav_core::TimeBase;
//!
//! let scene = Scene {
//!     canvas: Canvas::raster(1920, 1080),
//!     duration: SceneDuration::Finite(30_000),
//!     time_base: TimeBase::new(1, 1_000),
//!     sample_rate: 48_000,
//!     ..Scene::default()
//! };
//! assert_eq!(scene.canvas.raster_size(), Some((1920, 1080)));
//! ```
//!
//! The hierarchy:
//!
//! - [`Scene`] — root container. Has a [`Canvas`], a [`SceneDuration`],
//!   and a vector of [`SceneObject`]s.
//! - [`SceneObject`] — one element on the scene. Carries a
//!   [`Transform`], a [`Lifetime`], a list of [`Animation`]s, a blend
//!   mode + effects chain, and an [`ObjectKind`] payload.
//! - [`Animation`] — a per-property keyframe track. Each
//!   [`Keyframe`] pins a value at a point in time; consecutive
//!   keyframes interpolate via [`Easing`].
//! - [`AudioCue`] — timeline-triggered audio with an animated volume
//!   envelope.
//! - [`SceneRenderer`] / [`SceneSampler`] — traits the renderer
//!   implements. Current default ([`StubRenderer`]) always returns
//!   `Error::Unsupported`.

pub mod adapt;
pub mod animation;
pub mod audio;
pub mod duration;
pub mod id;
pub mod object;
pub mod ops;
pub mod page;
// `raster` was previously gated behind the `raster` cargo feature; with
// the round-2 text-pipeline migration `oxideav-raster` is a hard
// dependency (text rendering goes through it), so the gate is dropped
// here too. The `raster` cargo feature is preserved as a no-op for
// back-compat.
pub mod raster;
pub mod render;
pub mod scene;
pub mod source;
pub mod text;

pub use adapt::{adapt_frame_to, adapt_frame_to_canvas, AdaptedSource};
pub use animation::{AnimatedProperty, Animation, Easing, Keyframe, KeyframeValue, Repeat};
pub use audio::{AudioCue, AudioSource, DuckBus};
pub use duration::{Lifetime, SceneDuration, TimeStamp};
pub use id::ObjectId;
pub use object::{
    BlendMode, Canvas, ClipRect, Effect, ImageSource, LengthUnit, LiveStreamHandle, ObjectKind,
    SceneObject, Shape, TextRun, Transform, VideoSource,
};
pub use ops::{ExportOp, Operation};
pub use page::Page;
pub use raster::rasterize_vector;
pub use render::{RenderedFrame, SceneRenderer, SceneSampler, StubRenderer};
pub use scene::{Background, Metadata, Scene};
pub use source::{drive, FnSink, NullSink, RenderedSource, SceneSink, SceneSource, SourceFormat};
pub use text::TextRenderer;