Struct NestedSequence 

pub struct NestedSequence {
    pub id: SequenceId,
    pub name: String,
    pub frame_rate: Rational,
    pub duration: i64,
    pub resolution: (u32, u32),
    pub track_count: u32,
    pub nested_refs: Vec<NestedSequenceRef>,
}

A sequence (timeline) that can be nested inside other sequences.

Fields

id: SequenceId

Unique identifier.

name: String

Human-readable name.

frame_rate: Rational

Frame rate of this sequence, expressed as a Rational (e.g. Rational::new(24, 1)).

duration: i64

Total duration in timebase units.

resolution: (u32, u32)

Resolution in pixels: (width, height). Defaults to (1920, 1080).

track_count: u32

Number of tracks in this sequence.

nested_refs: Vec<NestedSequenceRef>

Nested references within this sequence (sub-sub-sequences).

Implementations

impl NestedSequence

pub fn new( id: SequenceId, name: impl Into<String>, frame_rate: Rational, ) -> Self

Create a new sequence with default 1920×1080 resolution.

pub fn with_duration(self, duration: i64) -> Self

Builder: set duration.

pub fn with_resolution(self, width: u32, height: u32) -> Self

Builder: set resolution.

pub fn with_track_count(self, count: u32) -> Self

Builder: set track count.

pub fn add_ref(&mut self, r: NestedSequenceRef)

Add a nested reference.

pub fn remove_ref(&mut self, child_id: SequenceId) -> usize

Remove a nested reference by child sequence ID.

pub fn references(&self, child_id: SequenceId) -> bool

Returns true if this sequence contains a reference to child_id.

pub fn duration_in_outer_timebase(&self, outer_rate: Rational) -> i64

Compute the duration of this sequence in an outer (parent) timebase.

Uses integer rounding (nearest-frame) to convert from this sequence’s own frame_rate into outer_rate. All three ConformMethod variants produce the same duration accounting; FrameBlend and OpticalFlow differ only in render quality, not timeline length.

Returns

The number of outer_rate units required to represent this sequence’s full duration. Returns 0 if either rate has a zero component.

Example

use oximedia_core::Rational;
use oximedia_edit::nested_sequence::{NestedSequence, SequenceId};

// 24 inner frames at 24 fps = 1 second = 60 frames at 60 fps
let seq = NestedSequence::new(SequenceId(1), "Clip", Rational::new(24, 1))
    .with_duration(24);
let outer = seq.duration_in_outer_timebase(Rational::new(60, 1));
assert_eq!(outer, 60);

Trait Implementations

impl Clone for NestedSequence

fn clone(&self) -> NestedSequence

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NestedSequence

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.