Expand description
Pure, deterministic timeline evaluation.
Structs§
- Active
Audio Clip - One audio clip overlapping an evaluated timeline span.
- Active
Caption - The cue one caption track shows at a timestamp.
- Active
Clip - A visible or audible clip mapped to its source timestamp.
- Active
Composition - A clip’s composition at one timeline timestamp.
- Active
Effect - One effect invocation at one timestamp (timeline time for transitions, composition time for composition steps).
- Active
Index - A precomputed interval index for a validated project snapshot.
- Active
Transition - A transition evaluated at one timeline timestamp.
- Audio
Span - The clips of one span, read from an
AudioSpanScratchwithout copying. - Audio
Span Desc - Audio activity over one half-open timeline span.
- Audio
Span Scratch - Reusable working memory for
evaluate_audio_in. - Composition
Plan - A composition’s output, drawn by steps in dependency order.
- Effect
Param Value - One effect parameter’s value at a timeline timestamp.
- Evaluated
Layout - A layout tree with every value sampled.
- Evaluated
Node - One box with its values sampled. Lengths are fractions of the picture’s shorter side.
- Evaluated
Text - A text node’s sampled text and the style it inherits.
- Evaluated
Visual - Visual properties evaluated at one timeline timestamp.
- Frame
Desc - A timestamp-specific composition description with no GPU handles.
- Frame
Need - A source-frame request emitted for host prefetch and decode scheduling.
- Layout
Plan - A layout tree, evaluated once when it does not animate.
- Node
Layout - A box’s sampled box-model, flex and grid values. Lengths are fractions or percents.
- Node
Paint - What a box draws under its content.
- Node
Visual - How a box and its subtree are drawn after layout.
- Sampled
Animator - An animator’s selector and properties at one time.
- Shapes
Plan - A content tree with its static parts evaluated once.
- Sides
- A length on each side of a box, as a fraction of the picture’s shorter side.
- Source
Read - One reader of a source over an export range (
ActiveIndex::source_reads). - Step
- One node of a composition, with its inputs resolved to earlier steps.
- Step
Layer - One layer of a
StepOp::Merge.
Enums§
- Eval
Error - An evaluator failure.
- Generator
Plan - A shapes or layout generator’s tree, planned once. Other generators need none.
- Node
Content - A box’s content.
- Plan
Error - Why a composition’s output cannot be drawn.
- Sampled
Selector - A selector at one time.
- StepOp
- The operation of a
Step. Inputs are indices of earlier steps.
Constants§
- MAX_
PLAN_ BYTES - Most bytes all compiled composition plans of one project may hold together, estimated per
Step(node path plus settings heap). Past this none draws (PlanError::TooLarge).
Functions§
- evaluate
- Evaluates visual and audio clip descriptions at one timeline timestamp.
- evaluate_
audio - Evaluates every audible clip overlapping a half-open timeline span.
- evaluate_
audio_ in - Evaluates the same clips as
evaluate_audiointo reusable memory. - evaluate_
geometry - A geometry at
time: a mask’s outline, or a content tree’s. - evaluate_
item - One item at
time. Opacities, trims and roundness clamp to0..=1and lengths to>= 0, since an overshooting curve can carry them past. - evaluate_
items - A whole content tree at
time, without a plan. - frame_
needs - Describes all source frames needed at a timestamp.
- hash_
sampled_ animators - Feeds every value of
animatorstohash. - picture_
source_ time - The source instant a clip’s picture shows at timeline
time, mirroring by project frames atframe_rateexactly as evaluation draws it. - plan_
composition - Compiles
composition’s output into steps as a clip’s composition, where clip nodes draw the clip’s picture.compositionsresolves group nodes andsourcesresolves media nodes. - plan_
source_ composition - Compiles
compositionas a composition source. Likeplan_composition, but clip nodes and group inputs are errors because nothing feeds them. - sample_
effect_ param - Samples one effect parameter with the project’s keyframe semantics.
- sample_
hold - Samples a non-interpolating value: the last keyframe at or before
time, else the first. - sample_
insets - Samples per-side lengths like
sample_size. - sample_
length - Samples a layout length. Mismatched keyframe kinds keep the left kind.
- sample_
paint - Samples an animated paint. Colors interpolate premultiplied; gradient geometry and stop
offsets interpolate numerically, then offsets are kept ordered in
0..=1and radii positive. Mismatched keyframes hold the left paint. - sample_
path - Samples an animated path, interpolating points and tangents linearly in
f64. Mismatched keyframe structures hold the left path. - sample_
point - Samples a position that may move along spatial curves.
- sample_
rgba - Samples an animated color, interpolated premultiplied.
- sample_
scalar - Samples one animated scalar with the project’s keyframe semantics.
- sample_
text_ animators animatorssampled attime, in order.- sample_
vec2 - Samples an animated 2D value like
sample_scalar. Usesample_pointfor positions that may follow spatial curves. - sample_
visual - Evaluates visual properties at a timestamp.
aspectis the canvas width over height, used to measure motion along spatial curves.