Struct RenderingConfig 

pub struct RenderingConfig {
    pub max_fps: u32,
    pub vsync_mode: VsyncMode,
    pub power_preference: PowerPreference,
    pub reduce_flicker: bool,
    pub reduce_flicker_delay_ms: u32,
    pub maximize_throughput: bool,
    pub throughput_render_interval_ms: u32,
}

Frame rate target, VSync mode, GPU preference and output batching.

Fields

max_fps: u32

Maximum frames per second (FPS) target Controls how frequently the terminal requests screen redraws. Note: On macOS, actual FPS may be lower (~22-25) due to system-level VSync throttling in wgpu/Metal, regardless of this setting. Default: 60

vsync_mode: VsyncMode

VSync mode - controls GPU frame synchronization

• immediate: No VSync, render as fast as possible (lowest latency, highest power)
• mailbox: Cap at monitor refresh rate with triple buffering (balanced)
• fifo: Strict VSync with double buffering (lowest power, slight input lag)

Default: fifo (strict VSync — lowest power, most compatible)

power_preference: PowerPreference

GPU power preference for adapter selection

• none: Let the system decide (default)
• low_power: Prefer integrated GPU (saves battery)
• high_performance: Prefer discrete GPU (maximum performance)

Note: Requires app restart to take effect.

reduce_flicker: bool

Reduce flicker by delaying redraws while cursor is hidden (DECTCEM off). Many terminal programs hide cursor during bulk updates to prevent visual artifacts.

reduce_flicker_delay_ms: u32

Maximum delay in milliseconds when reduce_flicker is enabled. Rendering occurs when cursor becomes visible OR this delay expires. Range: 1-100ms. Default: 16ms (~1 frame at 60fps).

maximize_throughput: bool

Enable throughput mode to batch rendering during bulk output. When enabled, rendering is throttled to reduce CPU overhead for large outputs. Toggle with Cmd+Shift+T (macOS) or Ctrl+Shift+T (other platforms).

throughput_render_interval_ms: u32

Render interval in milliseconds when maximize_throughput is enabled. Higher values = better throughput but delayed display. Range: 50-500ms.

Trait Implementations

impl Clone for RenderingConfig

fn clone(&self) -> RenderingConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RenderingConfig

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

Formats the value using the given formatter.

impl Default for RenderingConfig

fn default() -> RenderingConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RenderingConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<RenderingConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RenderingConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.