Enum PixelData 

pub enum PixelData {
    Bgra(Arc<Vec<u8>>),
    Rgba(Arc<Vec<u8>>),
    Nv12 {
        data: Arc<Vec<u8>>,
        y_stride: usize,
        uv_stride: usize,
    },
    DmaBuf {
        fd: Arc<OwnedFd>,
        fourcc: u32,
        modifier: u64,
        stride: u32,
        offset: u32,
    },
}

Pixel data in its native format, avoiding unnecessary colorspace conversions.

The inner buffers are wrapped in Arc so that cloning PixelData is O(1) (refcount bump) rather than a multi-megabyte memcpy.

Variants

Bgra(Arc<Vec<u8>>)

BGRA packed pixels (from Wayland SHM buffers). Layout: [B, G, R, A] per pixel, row-major, no padding.

Rgba(Arc<Vec<u8>>)

RGBA packed pixels (legacy path / capture conversions). Layout: [R, G, B, A] per pixel, row-major, no padding.

Nv12

NV12 planar: Y plane followed by interleaved UV plane. y_stride and uv_stride may differ from width (DMA-BUF padding). Stored contiguously: data[..y_stride*height] is Y, data[y_stride*height..] is UV.

Fields

data: Arc<Vec<u8>>

y_stride: usize

uv_stride: usize

DmaBuf

DMA-BUF file descriptor for zero-copy GPU encoding.

The fd is dup’d from the Wayland buffer — the original wl_buffer has been released, but this fd keeps the DMA-BUF kernel object alive. The encoder imports this directly into GPU memory (VA-API VPP or CUDA-EGL) without any CPU-side pixel copies.

Fields

fd: Arc<OwnedFd>

fourcc: u32

DRM fourcc (e.g. DRM_FORMAT_ARGB8888)

modifier: u64

DRM format modifier (e.g. DRM_FORMAT_MOD_LINEAR)

stride: u32

offset: u32

Implementations

impl PixelData

pub fn to_rgba(&self, width: u32, height: u32) -> Vec<u8>

Convert to RGBA for consumers that require it (screenshots, etc.). Panics for DmaBuf variant — callers must handle that case separately.

pub fn to_bgra_vec(&self, width: u32, height: u32) -> Vec<u8>

Return the pixel data as BGRA bytes (for compositing). For DmaBuf, attempts mmap readback. Returns empty on failure.

pub fn is_empty(&self) -> bool

pub fn is_dmabuf(&self) -> bool

Returns true if this is a DMA-BUF reference (GPU-resident).

Trait Implementations

impl Clone for PixelData

fn clone(&self) -> PixelData

Returns a duplicate of the value.

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

Performs copy-assignment from source.