Struct EndSynchronizedUpdate 

pub struct EndSynchronizedUpdate;

Available on crate feature term only.

A command that instructs the terminal to end a synchronized frame.

Notes

• Commands must be executed/queued for execution otherwise they do nothing.
• Use BeginSynchronizedUpdate to enter the alternate screen.

When rendering the screen of the terminal, the Emulator usually iterates through each visible grid cell and renders its current state. With applications updating the screen a at higher frequency this can cause tearing.

This mode attempts to mitigate that.

When the synchronization mode is enabled following render calls will keep rendering the last rendered state. The terminal Emulator keeps processing incoming text and sequences. When the synchronized update mode is disabled again the renderer may fetch the latest screen buffer state again, effectively avoiding the tearing effect by unintentionally rendering in the middle a of an application screen update.

Examples

use std::io::{self, Write};
use crossterm::{execute, terminal::{BeginSynchronizedUpdate, EndSynchronizedUpdate}};

fn main() -> io::Result<()> {
    execute!(io::stdout(), BeginSynchronizedUpdate)?;

    // Anything performed here will not be rendered until EndSynchronizedUpdate is called.

    execute!(io::stdout(), EndSynchronizedUpdate)?;
    Ok(())
}

Trait Implementations

impl Clone for EndSynchronizedUpdate

fn clone(&self) -> EndSynchronizedUpdate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Command for EndSynchronizedUpdate

fn write_ansi(&self, f: &mut impl Write) -> Result<(), Error>

Write an ANSI representation of this command to the given writer. An ANSI code can manipulate the terminal by writing it to the terminal buffer. However, only Windows 10 and UNIX systems support this.

impl Copy for EndSynchronizedUpdate

impl Debug for EndSynchronizedUpdate

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

Formats the value using the given formatter.

impl Eq for EndSynchronizedUpdate

impl PartialEq for EndSynchronizedUpdate

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for EndSynchronizedUpdate