Struct OutputNode 

pub struct OutputNode {
    pub id: u32,
    pub output: Output,
    pub global: GlobalId,
    pub pos: (i32, i32),
    pub damage_tracker: OutputDamageTracker,
    pub frame_buffer: Vec<u8>,
    pub offscreen_buffer: Option<(BufferObject<()>, Dmabuf)>,
    pub overlay_state: OverlayState,
    pub capture: Option<WlCapture>,
    pub frame_seq: u64,
    pub target_seeded: bool,
    pub content_hold_until: Option<Instant>,
}

One virtual output and everything sized to it: the Smithay Output + its advertised global, its layout position, the damage tracker, render targets, and the (at most one) capture bound to it. id is the Python-facing display key; id 0 is the primary HEADLESS-1 output, which is never destroyed.

Fields

id: u32

output: Output

global: GlobalId

pos: (i32, i32)

Layout offset: the output’s logical position in the Space AND its physical offset for absolute input injection. The two coincide at scale 1; with mixed scales the caller must place outputs so neither the logical nor the physical rectangles overlap.

damage_tracker: OutputDamageTracker

frame_buffer: Vec<u8>

Host-side scratch target: pixman throttle path renders here, GLES screenshots read back here.

offscreen_buffer: Option<(BufferObject<()>, Dmabuf)>

GPU render target for this output (GLES mode): the GBM BO and its dmabuf export.

overlay_state: OverlayState

Watermark overlay for THIS output: loaded at the output’s scale, positioned (and, for the bouncing anchor, animated) against the output’s own frame dimensions.

capture: Option<WlCapture>

frame_seq: u64

Monotonic count of frames reported presented through wp_presentation.

target_seeded: bool

Whether the render target already holds a fully composited frame, so a capture-less render (screenshot, copy-capture client) may use buffer age instead of redrawing everything. Cleared whenever the target is replaced.

content_hold_until: Option<Instant>

Deadline for this output’s post-reconfigure content hold. While it is set, the display composites but does not publish: a resized or freshly created output paints its clear colour wherever a client has not yet answered the new size, and that grey must not reach the stream. Cleared by the first tick a client covers the output, and by the deadline for one that never does.

Implementations

impl OutputNode

pub fn logical_geometry(&self) -> Option<Rectangle<i32, Logical>>

The output’s logical geometry in layout coordinates: origin plus mode/scale-derived logical size.