Enum wayrs_client::protocol::wl_surface::Event

#[non_exhaustive]
pub enum Event {
    Enter(ObjectId),
    Leave(ObjectId),
    PreferredBufferScale(i32),
    PreferredBufferTransform(Transform),
}

The event enum for WlSurface

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Enter(ObjectId)

Tuple Fields

0: ObjectId

output

output entered by the surface

surface enters an output

This is emitted whenever a surface’s creation, movement, or resizing results in some part of it being within the scanout region of an output.

Note that a surface may be overlapping with zero or more outputs.

Since version 1.

Leave(ObjectId)

Tuple Fields

0: ObjectId

output

output left by the surface

surface leaves an output

This is emitted whenever a surface’s creation, movement, or resizing results in it no longer having any part of it within the scanout region of an output.

Clients should not use the number of outputs the surface is on for frame throttling purposes. The surface might be hidden even if no leave event has been sent, and the compositor might expect new surface content updates even if no enter event has been sent. The frame event should be used instead.

Since version 1.

PreferredBufferScale(i32)

Tuple Fields

0: i32

factor

preferred scaling factor

preferred buffer scale for the surface

This event indicates the preferred buffer scale for this surface. It is sent whenever the compositor’s preference changes.

Before receiving this event the preferred buffer scale for this surface is 1.

It is intended that scaling aware clients use this event to scale their content and use wl_surface.set_buffer_scale to indicate the scale they have rendered with. This allows clients to supply a higher detail buffer.

Since version 6.

PreferredBufferTransform(Transform)

Tuple Fields

0: Transform

transform

preferred transform

preferred buffer transform for the surface

This event indicates the preferred buffer transform for this surface. It is sent whenever the compositor’s preference changes.

Before receiving this event the preferred buffer transform for this surface is normal.

It is intended that transform aware clients use this event to apply the transform to their content and use wl_surface.set_buffer_transform to indicate the transform they have rendered with.

Since version 6.

Trait Implementations

impl Debug for Event

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl TryFrom<Message> for Event

type Error = BadMessage

The type returned in the event of a conversion error.

fn try_from(event: Message) -> Result<Self, BadMessage>

Performs the conversion.