Struct indicatif::ProgressDrawTarget

pub struct ProgressDrawTarget { /* private fields */ }

Target for draw operations

This tells a progress bar or a multi progress object where to paint to. The draw target is a stateful wrapper over a drawing destination and internally optimizes how often the state is painted to the output device.

Implementations

impl ProgressDrawTarget

pub fn stdout() -> Self

Draw to a buffered stdout terminal at a max of 20 times a second.

For more information see ProgressDrawTarget::term.

pub fn stderr() -> Self

Draw to a buffered stderr terminal at a max of 20 times a second.

This is the default draw target for progress bars. For more information see ProgressDrawTarget::term.

pub fn stdout_with_hz(refresh_rate: u8) -> Self

Draw to a buffered stdout terminal at a max of refresh_rate times a second.

For more information see ProgressDrawTarget::term.

pub fn stderr_with_hz(refresh_rate: u8) -> Self

Draw to a buffered stderr terminal at a max of refresh_rate times a second.

For more information see ProgressDrawTarget::term.

pub fn term(term: Term, refresh_rate: u8) -> Self

Draw to a terminal, with a specific refresh rate.

Progress bars are by default drawn to terminals however if the terminal is not user attended the entire progress bar will be hidden. This is done so that piping to a file will not produce useless escape codes in that file.

Will panic if refresh_rate is 0.

pub fn term_like(term_like: Box<dyn TermLike>) -> Self

Draw to a boxed object that implements the TermLike trait.

pub fn term_like_with_hz(term_like: Box<dyn TermLike>, refresh_rate: u8) -> Self

Draw to a boxed object that implements the TermLike trait, with a specific refresh rate.

pub fn hidden() -> Self

A hidden draw target.

This forces a progress bar to be not rendered at all.

pub fn is_hidden(&self) -> bool

Returns true if the draw target is hidden.

This is internally used in progress bars to figure out if overhead from drawing can be prevented.

Trait Implementations

impl Debug for ProgressDrawTarget

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

Formats the value using the given formatter.