[−][src]Enum wayland_protocols::wlr::unstable::output_management::v1::server::zwlr_output_head_v1::Event
Variants (Non-exhaustive)
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
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
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).
introduce a mode
This event introduces a mode for this head. It is sent once per supported mode.
Fields of Mode
mode: Resource<ZwlrOutputModeV1>
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
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
current position
This events describes the position of the head in the global compositor space. It is only sent if the output is enabled.
current transformation
This event describes the transformation currently applied to the head. It is only sent if the output is enabled.
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
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.
head manufacturer
This event describes the manufacturer of the head.
This must report the same make as the wl_output interface does in its geometry event.
Together with the model and serial_number events the purpose is to allow clients to recognize heads from previous sessions and for example load head-specific configurations back.
It is not guaranteed this event will be ever sent. A reason for that can be that the compositor does not have information about the make of the head or the definition of a make is not sensible in the current setup, for example in a virtual session. Clients can still try to identify the head by available information from other events but should be aware that there is an increased risk of false positives.
It is not recommended to display the make string in UI to users. For that the string provided by the description event should be preferred.
Only available since version 2 of the interface
Fields of Make
make: String
head model
This event describes the model of the head.
This must report the same model as the wl_output interface does in its geometry event.
Together with the make and serial_number events the purpose is to allow clients to recognize heads from previous sessions and for example load head-specific configurations back.
It is not guaranteed this event will be ever sent. A reason for that can be that the compositor does not have information about the model of the head or the definition of a model is not sensible in the current setup, for example in a virtual session. Clients can still try to identify the head by available information from other events but should be aware that there is an increased risk of false positives.
It is not recommended to display the model string in UI to users. For that the string provided by the description event should be preferred.
Only available since version 2 of the interface
Fields of Model
model: String
head serial number
This event describes the serial number of the head.
Together with the make and model events the purpose is to allow clients to recognize heads from previous sessions and for example load head- specific configurations back.
It is not guaranteed this event will be ever sent. A reason for that can be that the compositor does not have information about the serial number of the head or the definition of a serial number is not sensible in the current setup. Clients can still try to identify the head by available information from other events but should be aware that there is an increased risk of false positives.
It is not recommended to display the serial_number string in UI to users. For that the string provided by the description event should be preferred.
Only available since version 2 of the interface
Fields of SerialNumber
serial_number: String
Trait Implementations
impl Debug for Event
[src]
impl MessageGroup for Event
[src]
const MESSAGES: &'static [MessageDesc]
[src]
type Map = ResourceMap
The wrapper type for ObjectMap allowing the mapping of Object and NewId arguments to the object map during parsing. Read more
fn is_destructor(&self) -> bool
[src]
fn opcode(&self) -> u16
[src]
fn since(&self) -> u32
[src]
fn child<Meta: ObjectMetadata>(
opcode: u16,
version: u32,
meta: &Meta
) -> Option<Object<Meta>>
[src]
opcode: u16,
version: u32,
meta: &Meta
) -> Option<Object<Meta>>
fn from_raw(msg: Message, map: &mut Self::Map) -> Result<Self, ()>
[src]
fn into_raw(self, sender_id: u32) -> Message
[src]
unsafe fn from_raw_c(
obj: *mut c_void,
opcode: u32,
args: *const wl_argument
) -> Result<Event, ()>
[src]
obj: *mut c_void,
opcode: u32,
args: *const wl_argument
) -> Result<Event, ()>
fn as_raw_c_in<F, T>(self, f: F) -> T where
F: FnOnce(u32, &mut [wl_argument]) -> T,
[src]
F: FnOnce(u32, &mut [wl_argument]) -> T,
Auto Trait Implementations
impl !RefUnwindSafe for Event
impl Send for Event
impl Sync for Event
impl Unpin for Event
impl !UnwindSafe for Event
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Downcast for T where
T: Any,
T: Any,
pub fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
pub fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
pub fn as_any(&self) -> &(dyn Any + 'static)
pub fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
impl<T> DowncastSync for T where
T: Send + Sync + Any,
T: Send + Sync + Any,
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,