Struct Args

pub(crate) struct Args {
    pub(crate) file: PathBuf,
    pub(crate) use_seek: bool,
    pub(crate) multicore: bool,
}

Command line argument parser using clap derive macro Defines the CLI interface for the frame extraction application

Fields

• file - Input video file path (default: “video.mp4”)
• use_seek - Enable seek-based frame extraction method
• multicore - Enable parallel processing using multiple CPU cores

Fields

file: PathBuf

Path to the input video file to process

Specifies the video file from which frames will be extracted. The file must be in a format supported by the underlying video processing library.

Default

If not specified, defaults to “video.mp4” in the current directory.

Supported Formats

Common formats like MP4, AVI, MOV, MKV are typically supported, though actual support depends on the system’s codec installation.

use_seek: bool

Enable seek-based frame extraction method

When enabled, extracts exactly one frame per second by seeking to specific timestamps rather than processing sequentially. This method is more accurate for temporal sampling but significantly slower due to seek overhead.

Performance Impact

• Much slower than sequential processing due to seek operations
• More CPU intensive due to decoding from keyframes
• May skip frames in areas with sparse keyframes
• Incompatible with –multicore flag

multicore: bool

Enable multi-core parallel processing

When enabled, splits the input video into time-based segments and processes them in parallel using all available CPU cores. This can significantly reduce processing time for large videos on multi-core systems.

Requirements

• ffmpeg must be installed and available in system PATH
• Sufficient disk space for temporary segment files
• Incompatible with –use-seek flag

Trait Implementations

impl Args for Args

fn group_id() -> Option<Id>

Report the [ArgGroup::id][crate::ArgGroup::id] for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate Self via [FromArgMatches::from_arg_matches_mut]

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate self via [FromArgMatches::update_from_arg_matches_mut]

impl CommandFactory for Args

fn command<'b>() -> Command

Build a [Command] that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a [Command] that can update self.

impl Debug for Args

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

Formats the value using the given formatter.

impl FromArgMatches for Args

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for Args

fn parse() -> Self

Parse from std::env::args_os(), [exit][Error::exit] on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, [exit][Error::exit] on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, [exit][Error::exit] on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.