Struct Seq 

pub struct Seq {
    pub indices: Vec<i64>,
    pub missed: Vec<i64>,
    pub start: i64,
    pub end: i64,
    pub padding: usize,
    /* private fields */
}

Sequence of numbered files

Fields

indices: Vec<i64>

Frame numbers actually present

missed: Vec<i64>

Missing frame numbers

start: i64

First frame

end: i64

Last frame

padding: usize

Padding (0 = variable/unpadded, >0 = fixed width)

Implementations

impl Seq

pub fn len(&self) -> usize

Get sequence length (number of files)

pub fn is_empty(&self) -> bool

Check if sequence is empty (required by Clippy when len() exists)

pub fn pattern(&self) -> &str

Get pattern with @ or ####

pub fn get_file(&self, frame: i64) -> Option<String>

Get full file path for specific frame number. Returns None if frame doesn’t exist in sequence (not in indices).

Arguments

• frame - Frame number to look up

Returns

Some(path) if frame exists, None otherwise

Example

let seq = ...; // frames 1-100, pattern: "/renders/img_####.exr"
assert_eq!(seq.get_file(42), Some("/renders/img_0042.exr".to_string()));
assert_eq!(seq.get_file(999), None); // frame doesn't exist

pub fn is_complete(&self) -> bool

Check if sequence is complete (no missing frames). A complete sequence has no gaps between start and end.

Example

let seq1 = ...; // frames 1,2,3,4,5
assert!(seq1.is_complete());

let seq2 = ...; // frames 1,2,4,5 (missing 3)
assert!(!seq2.is_complete());

pub fn expand(&self) -> Result<Vec<String>, String>

Expand sequence to all frame paths in range (start..=end). Includes paths for ALL frames including missing ones.

Safety

Limited to 1M frames to prevent OOM. Returns error if range exceeds limit.

Example

let seq = ...; // frames 1-3, pattern: "/img_@.exr"
assert_eq!(seq.expand()?, vec!["/img_1.exr", "/img_2.exr", "/img_3.exr"]);

pub fn expand_existing(&self) -> Vec<String>

Expand sequence to only existing frame paths (indices only). Unlike expand(), this skips missing frames.

Example

let seq = ...; // frames 1,3 (missing 2), pattern: "/img_@.exr"
assert_eq!(seq.expand_existing(), vec!["/img_1.exr", "/img_3.exr"]);

pub fn first_file(&self) -> &str

Get first file path in sequence with original case. Use this for file operations (reading, globbing) since pattern() may have lowercase paths on Windows.

pub fn last_file(&self) -> String

Get last file path in sequence.

pub fn frame_count(&self) -> usize

Get frame count (number of existing frames, not range).

pub fn range_count(&self) -> i64

Get total range (end - start + 1), including missing frames.

pub fn to_map(&self) -> HashMap<&'static str, Value>

Convert sequence to HashMap for serialization/inspection. Useful for JSON export or debugging.

pub fn to_json(&self) -> String

Serialize sequence to JSON string.

pub fn to_json_pretty(&self) -> String

Serialize sequence to pretty JSON string.

pub fn group_seqs(flist: &mut Vec<File>) -> Vec<Seq>

Group files into sequences. Uses mask-based grouping to handle unpadded sequences correctly.

pub fn extract_seq(target: &File, files: &mut Vec<File>) -> Option<Seq>

Extract sequence containing target file from file list. Drains files with matching sig_hash, returns Seq containing target.

Trait Implementations

impl Clone for Seq

fn clone(&self) -> Seq

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Seq

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

Formats the value using the given formatter.

impl Display for Seq

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

Formats the value using the given formatter.

impl Serialize for Seq

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.