Struct Surface 

pub struct Surface {
    pub id: u32,
    pub committed: SurfaceState,
    pub pending: SurfaceState,
    pub position: (i32, i32),
    pub size: (u32, u32),
    pub dirty: bool,
    pub mapped: bool,
    pub client_id: u32,
}

A Wayland surface representing a renderable area.

Fields

id: u32

Surface ID (Wayland object ID)

committed: SurfaceState

Committed (current) state – what the compositor reads

pending: SurfaceState

Pending state – accumulated by attach/damage before commit

position: (i32, i32)

Position in compositor coordinate space (set by shell role)

size: (u32, u32)

Committed size (derived from buffer dimensions)

dirty: bool

Whether this surface has new content since last composite

mapped: bool

Whether the surface is mapped (has a committed buffer and a role)

client_id: u32

Owning client ID

Implementations

impl Surface

pub fn new(id: u32) -> Self

Create a new unmapped surface.

pub fn with_client(id: u32, client_id: u32) -> Self

Create a new surface with a specific client ID.

pub fn attach_buffer(&mut self, buffer: Buffer)

Attach a buffer to the pending state (wl_surface.attach).

pub fn attach_buffer_at(&mut self, buffer: Buffer, dx: i32, dy: i32)

Attach with an explicit offset.

pub fn damage(&mut self, x: i32, y: i32, width: u32, height: u32)

Mark a damage region on the pending state (wl_surface.damage).

pub fn damage_full(&mut self)

Mark the entire surface as damaged.

pub fn commit(&mut self) -> Result<(), KernelError>

Commit pending state to committed state (wl_surface.commit).

This is the atomic state-swap that the Wayland protocol requires.

pub fn has_buffer(&self) -> bool

Check whether this surface has a committed buffer.

pub fn clear_dirty(&mut self)

Clear the dirty flag after the compositor has rendered this surface.