Struct Pane 

pub struct Pane {

    pub id: PaneId,
    pub terminal: Arc<Mutex<TerminalManager>>,
    pub scroll_state: ScrollState,
    pub mouse: MouseState,
    pub bell: BellState,
    pub cache: RenderCache,
    pub refresh_task: Option<JoinHandle<()>>,
    pub working_directory: Option<String>,
    pub last_activity_time: Instant,
    pub last_seen_generation: u64,
    pub anti_idle_last_activity: Instant,
    pub anti_idle_last_generation: u64,
    pub silence_notified: bool,
    pub exit_notified: bool,
    pub session_logger: SharedSessionLogger,
    pub bounds: PaneBounds,
    pub background: PaneBackground,
    pub restart_state: Option<RestartState>,
    /* private fields */
}

A single terminal pane with its own state

Fields

id: PaneId

Unique identifier for this pane

terminal: Arc<Mutex<TerminalManager>>

The terminal session for this pane

scroll_state: ScrollState

Scroll state for this pane

mouse: MouseState

Mouse state for this pane

bell: BellState

Bell state for this pane

cache: RenderCache

Render cache for this pane

refresh_task: Option<JoinHandle<()>>

Async task for refresh polling

working_directory: Option<String>

Working directory when pane was created

last_activity_time: Instant

Last time terminal output (activity) was detected

last_seen_generation: u64

Last terminal update generation seen

anti_idle_last_activity: Instant

Last activity time for anti-idle keep-alive

anti_idle_last_generation: u64

Last terminal generation recorded for anti-idle tracking

silence_notified: bool

Whether silence notification has been sent for current idle period

exit_notified: bool

Whether exit notification has been sent for this pane

session_logger: SharedSessionLogger

Session logger for automatic session recording

bounds: PaneBounds

Current bounds of this pane (updated on layout calculation)

background: PaneBackground

Per-pane background settings (overrides global config if image_path is set)

restart_state: Option<RestartState>

State for shell restart behavior (None = shell running or closed normally)

Implementations

impl Pane

pub fn new( id: PaneId, config: &Config, _runtime: Arc<Runtime>, working_directory: Option<String>, ) -> Result<Self>

Create a new pane with a terminal session

pub fn new_for_tmux( id: PaneId, config: &Config, _runtime: Arc<Runtime>, ) -> Result<Self>

Create a new pane for tmux integration (no shell spawned)

This creates a terminal that receives output from tmux control mode rather than a local PTY.

pub fn is_bell_active(&self) -> bool

Check if the visual bell is currently active

pub fn is_running(&self) -> bool

Check if the terminal in this pane is still running

pub fn get_cwd(&self) -> Option<String>

Get the current working directory of this pane’s shell

pub fn set_background(&mut self, background: PaneBackground)

Set per-pane background settings (overrides global config)

pub fn background(&self) -> &PaneBackground

Get per-pane background settings

pub fn set_background_image(&mut self, path: Option<String>)

Set a per-pane background image (overrides global config)

pub fn get_background_image(&self) -> Option<&str>

Get the per-pane background image path (if set)

pub fn respawn_shell(&mut self, config: &Config) -> Result<()>

Respawn the shell in this pane

This resets the terminal state and spawns a new shell process. Used when shell_exit_action is one of the restart variants.

pub fn write_restart_prompt(&self)

Write a restart prompt message to the terminal

pub fn get_title(&self) -> String

Get the title for this pane (from OSC or CWD)

pub fn start_refresh_task( &mut self, runtime: Arc<Runtime>, window: Arc<Window>, max_fps: u32, )

Start the refresh polling task for this pane

pub fn stop_refresh_task(&mut self)

Stop the refresh polling task

pub fn resize_terminal(&self, cols: usize, rows: usize)

Resize the terminal to match the pane bounds

Trait Implementations

impl Drop for Pane

fn drop(&mut self)

Executes the destructor for this type.