Struct dither::prelude::Opt

pub struct Opt {
    pub verbose: bool,
    pub input: PathBuf,
    pub bit_depth: u8,
    pub output: Option<PathBuf>,
    pub ditherer: Ditherer<'static>,
    pub color_mode: Mode,
}

Command-line interface & arguments. See clap.

Fields

verbose: bool

Provide verbose debug information. Default is false.

input: PathBuf

Input file. Supported file types: PNG JPEG GIF BMP ICO TIFF

bit_depth: u8

Color depth. Must be between 1 and 8. See create_quantize_n_bits_func and [create_convert_quantized_to_palette_func][crate::create_convert_quantized_to_palette_func]

output: Option<PathBuf>

Output file: will be written to as a .png or .jpg (inferred from file extension). If left empty, a default output path will be created: see Opt::output_path

ditherer: Ditherer<'static>

Ditherering algorithm to use. Options are

• “floyd” (default)
• “atkinson”
• “stucki”,
• “burkes”
• “jarvis”
• “sierra3”

color_mode: Mode

Color mode to use. Options are

• bw => grayscale with the specified bit depth. (default)
• color => color mode with the specified bit depth.
• cga => load the cga palette. equivalent to “cga.plt”.
• crayon => load the crayon palette. equivalent to “crayon.plt”
• $COLOR => single-color mode. options are
• $FILENAME“ => load palette from file, listed as line-separated RGB values. see “cga.plt” and the readme for more information on palette files.

Implementations

impl Opt

pub fn input_path<'a>(&'a self) -> Result<PathBuf>

the canonicalized input path

pub fn output_path<'a>(&'a self) -> Result<Cow<'a, Path>>

the actual output path. if opts.output exists, this is that, otherwise, this is "{base}_dithered_{dither}_{color}_{depth}.png", where base is the canonicalized input path, stripped of it’s extension. $dither bunny.png --color=color --dither=atkinson --depth=2 will save to bunny_atkinson_c_2.png

let mut opt = Opt::default();
opt.bit_depth=1;
opt.input = PathBuf::from("bunny.png".to_string());
let got_path = opt.output_path().unwrap();
assert_eq!("bunny_dithered_floyd_bw_1.png", Path::file_name(got_path.as_ref().as_ref()).unwrap().to_string_lossy());

Trait Implementations

impl Clap for Opt

pub fn parse() -> Self

Parse from std::env::args_os(), exit on error

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

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

pub fn parse_from<I, T>(itr: I) -> Self where
    T: Into<OsString> + Clone,
    I: IntoIterator<Item = T>, 

Parse from iterator, exit on error

pub fn try_parse_from<I, T>(itr: I) -> Result<Self, Error> where
    T: Into<OsString> + Clone,
    I: IntoIterator<Item = T>, 

Parse from iterator, return Err on error.

impl Clone for Opt

fn clone(&self) -> Opt

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Opt

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

Formats the value using the given formatter.

impl Default for Opt

fn default() -> Opt

Returns the “default value” for a type.

impl FromArgMatches for Opt

fn from_arg_matches(matches: &ArgMatches) -> Self

It’s common to have an “application context” struct (sometimes called config) that represents all the normalized values after being processed by the CLI.

impl IntoApp for Opt

fn into_app<'b>() -> App<'b>

@TODO @release @docs

fn augment_clap<'b>(app: App<'b>) -> App<'b>

@TODO @release @docs

impl PartialEq<Opt> for Opt

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralPartialEq for Opt