Struct indicatif::ProgressDrawTarget
source · pub struct ProgressDrawTarget { /* private fields */ }
Expand description
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§
source§impl ProgressDrawTarget
impl ProgressDrawTarget
sourcepub fn stdout() -> ProgressDrawTarget
pub fn stdout() -> ProgressDrawTarget
Draw to a buffered stdout terminal at a max of 20 times a second.
For more information see ProgressDrawTarget::to_term
.
sourcepub fn stderr() -> ProgressDrawTarget
pub fn stderr() -> ProgressDrawTarget
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::to_term
.
sourcepub fn stdout_with_hz(refresh_rate: u8) -> ProgressDrawTarget
pub fn stdout_with_hz(refresh_rate: u8) -> ProgressDrawTarget
Draw to a buffered stdout terminal at a max of refresh_rate
times a second.
For more information see ProgressDrawTarget::to_term
.
sourcepub fn stderr_with_hz(refresh_rate: u8) -> ProgressDrawTarget
pub fn stderr_with_hz(refresh_rate: u8) -> ProgressDrawTarget
Draw to a buffered stderr terminal at a max of refresh_rate
times a second.
For more information see ProgressDrawTarget::to_term
.
sourcepub fn term(term: Term, refresh_rate: u8) -> ProgressDrawTarget
pub fn term(term: Term, refresh_rate: u8) -> ProgressDrawTarget
Draw to a terminal, optionally 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 Some(0)
. To disable rate limiting use None
instead.
sourcepub fn term_like(term_like: Box<dyn TermLike>) -> ProgressDrawTarget
pub fn term_like(term_like: Box<dyn TermLike>) -> ProgressDrawTarget
Draw to a boxed object that implements the TermLike
trait.
A hidden draw target.
This forces a progress bar to be not rendered at all.
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.