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 a timeline transition, composition time for a composition step.
- 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, as
evaluate_audioreports them, held in anAudioSpanScratchand read back without 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
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.
- 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.
- Plan
Error - Why a composition’s output cannot be drawn.
- StepOp
- The operation of a
Step. Inputs are indices of earlier steps.
Constants§
- MAX_
PLAN_ BYTES - Most bytes the compiled composition plans of one project hold together,
as
Steps estimate them: each step, its node path, and the heap its settings use (keyframes, parameter and resource names, masks, layers, gradient stops). A project’s plans are those of every composition a clip or composition source shows; past this, none of them is drawn (PlanError::TooLarge). The steps are what validation counts, at mostMAX_INLINED_NODES; this bounds how large each may be, which inlining multiplies.
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. - frame_
needs - Describes all source frames needed at a timestamp.
- picture_
source_ time - The source instant a clip’s picture shows at timeline
time: its time map read with the reverse and ping-pong mirror of one project frame atframe_rate, exactly as evaluation draws it. - plan_
composition - Compiles
composition’s output into steps, as a clip’s composition: its clip nodes draw the clip’s picture.compositionsresolves group nodes andsourcesmedia nodes, which may name generated or composition sources. - plan_
source_ composition - Compiles
compositionas a composition source draws it: likeplan_composition, but a clip node or group input is an error, since no clip or group node feeds it. - sample_
effect_ param - Samples one effect parameter with the project’s keyframe semantics.
- sample_
scalar - Samples one animated scalar with the project’s keyframe semantics.
- sample_
vec2 - Samples one animated two-dimensional value with the project’s keyframe
semantics; see
sample_scalar. - sample_
visual - Evaluates visual properties at a timestamp: a clip’s at timeline time, a transform node’s at composition time.