Struct TimecodeValue 

pub struct TimecodeValue {
    pub hh: u8,
    pub mm: u8,
    pub ss: u8,
    pub ff: u8,
    pub fps: f32,
    pub drop_frame: bool,
}

A timecode value with arithmetic support.

Fields

hh: u8

Hours component (0-23)

mm: u8

Minutes component (0-59)

ss: u8

Seconds component (0-59)

ff: u8

Frames component (0 to fps-1)

fps: f32

Frames per second (e.g. 25.0, 29.97, 30.0)

drop_frame: bool

Whether this timecode uses drop-frame notation

Implementations

impl TimecodeValue

pub fn new(hh: u8, mm: u8, ss: u8, ff: u8, fps: f32, drop_frame: bool) -> Self

Create a new timecode value.

pub fn to_frame_count(&self) -> u64

Convert to total frame count since 00:00:00:00.

For drop-frame timecode, applies the standard SMPTE drop-frame adjustment.

pub fn from_frame_count(frames: u64, fps: f32, drop_frame: bool) -> Self

Create a timecode value from a frame count.

pub fn add_frames(&self, frames: i64) -> Self

Add a number of frames (positive or negative), wrapping at 24 hours.

pub fn subtract(&self, other: &Self) -> i64

Compute the signed frame difference between self and another timecode.

Returns a positive value if self is later than other.

pub fn to_string_formatted(&self) -> String

Convert to a formatted timecode string.

Uses colons for non-drop-frame and semicolons for drop-frame.

pub fn parse(s: &str, fps: f32) -> Option<Self>

Parse a timecode string.

Detects drop-frame from the presence of a semicolon before the frame count. Format: HH:MM:SS:FF (NDF) or HH:MM:SS;FF (DF).

Trait Implementations

impl Clone for TimecodeValue

fn clone(&self) -> TimecodeValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TimecodeValue

impl Debug for TimecodeValue

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

Formats the value using the given formatter.

impl Display for TimecodeValue

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

Formats the value using the given formatter.

impl PartialEq for TimecodeValue

fn eq(&self, other: &TimecodeValue) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for TimecodeValue