Enum wayland_protocols::wlr::unstable::output_management::v1::client::zwlr_output_head_v1::Event

#[non_exhaustive]pub enum Event {
    Name {
        name: String,
    },
    Description {
        description: String,
    },
    PhysicalSize {
        width: i32,
        height: i32,
    },
    Mode {
        mode: Main<ZwlrOutputModeV1>,
    },
    Enabled {
        enabled: i32,
    },
    CurrentMode {
        mode: ZwlrOutputModeV1,
    },
    Position {
        x: i32,
        y: i32,
    },
    Transform {
        transform: Transform,
    },
    Scale {
        scale: f64,
    },
    Finished,
}

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.

Name

head name

This event describes the head name.

The naming convention is compositor defined, but limited to alphanumeric characters and dashes (-). Each name is unique among all wlr_output_head objects, but if a wlr_output_head object is destroyed the same name may be reused later. The names will also remain consistent across sessions with the same hardware and software configuration.

Examples of names include 'HDMI-A-1', 'WL-1', 'X11-1', etc. However, do not assume that the name is a reflection of an underlying DRM connector, X11 connection, etc.

If the compositor implements the xdg-output protocol and this head is enabled, the xdg_output.name event must report the same name.

The name event is sent after a wlr_output_head object is created. This event is only sent once per object, and the name does not change over the lifetime of the wlr_output_head object.

Fields of Name

name: String

Description

head description

This event describes a human-readable description of the head.

The description is a UTF-8 string with no convention defined for its contents. Examples might include 'Foocorp 11" Display' or 'Virtual X11 output via :1'. However, do not assume that the name is a reflection of the make, model, serial of the underlying DRM connector or the display name of the underlying X11 connection, etc.

If the compositor implements xdg-output and this head is enabled, the xdg_output.description must report the same description.

The description event is sent after a wlr_output_head object is created. This event is only sent once per object, and the description does not change over the lifetime of the wlr_output_head object.

Fields of Description

description: String

PhysicalSize

head physical size

This event describes the physical size of the head. This event is only sent if the head has a physical size (e.g. is not a projector or a virtual device).

Fields of PhysicalSize

width: i32height: i32

Mode

introduce a mode

This event introduces a mode for this head. It is sent once per supported mode.

Fields of Mode

mode: Main<ZwlrOutputModeV1>

Enabled

head is enabled or disabled

This event describes whether the head is enabled. A disabled head is not mapped to a region of the global compositor space.

When a head is disabled, some properties (current_mode, position, transform and scale) are irrelevant.

Fields of Enabled

enabled: i32

CurrentMode

current mode

This event describes the mode currently in use for this head. It is only sent if the output is enabled.

Fields of CurrentMode

mode: ZwlrOutputModeV1

Position

current position

This events describes the position of the head in the global compositor space. It is only sent if the output is enabled.

Fields of Position

x: i32y: i32

Transform

current transformation

This event describes the transformation currently applied to the head. It is only sent if the output is enabled.

Fields of Transform

transform: Transform

Scale

current scale

This events describes the scale of the head in the global compositor space. It is only sent if the output is enabled.

Fields of Scale

scale: f64

Finished

the head has been destroyed

The compositor will destroy the object immediately after sending this event, so it will become invalid and the client should release any resources associated with it.

Trait Implementations

impl Debug for Event

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

Formats the value using the given formatter.

impl MessageGroup for Event

const MESSAGES: &'static [MessageDesc]

Wire representation of this MessageGroup

type Map = ProxyMap

The wrapper type for ObjectMap allowing the mapping of Object and NewId arguments to the object map during parsing.

fn is_destructor(&self) -> bool

Whether this message is a destructor

fn opcode(&self) -> u16

The opcode of this message

fn since(&self) -> u32

The minimal object version for which this message exists

fn child<Meta: ObjectMetadata>(
    opcode: u16,
    version: u32,
    meta: &Meta
) -> Option<Object<Meta>>

Retrieve the child Object associated with this message if any

fn from_raw(msg: Message, map: &mut Self::Map) -> Result<Self, ()>

Construct a message from its raw representation

fn into_raw(self, sender_id: u32) -> Message

Turn this message into its raw representation

unsafe fn from_raw_c(
    obj: *mut c_void,
    opcode: u32,
    args: *const wl_argument
) -> Result<Event, ()>

Construct a message of this group from its C representation

fn as_raw_c_in<F, T>(self, f: F) -> T where
    F: FnOnce(u32, &mut [wl_argument]) -> T, 

Build a C representation of this message