Struct RawFrame 

struct RawFrame {
    idx: usize,
    ptr: *mut u8,
    len: usize,
    width: u16,
    height: u16,
    stride: usize,
    generation: u64,
    captured_ns: i64,
    changed: Vec<Rectangle<i32, Physical>>,
    complete: bool,
    planes: Option<*const Nv12Planes>,
}

A captured raw BGRA frame held in a pooled shm surface, ready to encode.

It carries the surface pointer plus geometry so the encode thread reads the pixels directly (no copy) and can rebuild its pipeline when the capture size changed (auto-adjust). It also carries the pool’s surface generation, so a rebuild is still triggered when the surfaces were recreated at the SAME size (a resize flap) and the new segments happen to reuse the old virtual addresses.

Fields

idx: usize

ptr: *mut u8

len: usize

width: u16

height: u16

stride: usize

generation: u64

captured_ns: i64

CLOCK_MONOTONIC nanoseconds at which the pixels were in hand.

changed: Vec<Rectangle<i32, Physical>>

Where the frame changed since the one before, in its own coordinates, as the server reported it and the overlays moved; empty where the server cannot say.

complete: bool

Whether changed holds every change: the shared framebuffer’s watch, which the server fills as it draws (X11Pipeline::process_reported), where XDamage can miss directly rendered GL.

planes: Option<*const Nv12Planes>

The frame’s picture where the capture converted it from the shared framebuffer instead of copying its pixels (the Nv12Planes of the surface’s index), which ptr then does not hold.

Trait Implementations

impl Send for RawFrame

RawFrame is Send: its raw pointer addresses a pooled shm surface that the pool guarantees is not reused until the encode thread recycles this frame, so the handle is safe to move across the capture -> encode thread boundary.