Struct Config 

pub struct Config {
    pub media_type: MediaType,
    pub source: InputSource,
    pub output: Option<PathBuf>,
    pub num_threads: usize,
    pub color_depth: ColorDepth,
    pub ascii: Config,
    pub dither: Option<DitherOptions>,
    /* private fields */
}

A fully validated, immutable configuration produced by ConfigBuilder::build.

Cheap to share across threads/tasks behind an Arc<Config> — build it once and reuse it for every file in a batch or every frame of a video.

Fields

media_type: MediaType

source: InputSource

output: Option<PathBuf>

num_threads: usize

color_depth: ColorDepth

ascii: Config

dither: Option<DitherOptions>

Dithering applied when rendering, in place of iascii’s own plain per-cell nearest-palette color rounding — see crate::dither. None (the default) means the usual undithered rendering.

Implementations

impl Config

pub fn builder(media_type: MediaType) -> ConfigBuilder

Starts building a new configuration for the given media type.

pub fn thread_pool(&self) -> Result<&Arc<ThreadPool>, ConfigError>

Returns the Rayon thread pool for this Config, building it on first use and reusing it for every subsequent call. Sized from Config::num_threads (0 means Rayon’s own default).

Call sites that used to build a fresh ThreadPool per file/frame (image batches, async single-image rendering, video streaming) should call this instead so the pool — and its worker OS threads — is created once per Config and shared.

pub fn files(&self) -> Result<Vec<PathBuf>, ConfigError>

Resolves InputSource into the concrete list of files to process, sorted for deterministic ordering across parallel batch runs.

Trait Implementations

impl Debug for Config

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

Formats the value using the given formatter.