pub struct Name<'a> {
pub name: Str<'a>,
}
Expand description
name of this output
Many compositors will assign user-friendly names to their outputs, show them to the user, allow the user to refer to an output, etc. The client may wish to know this name as well to offer the user similar behaviors.
The name is a UTF-8 string with no convention defined for its contents. Each name is unique among all wl_output globals. The name is only guaranteed to be unique for the compositor instance.
The same output name is used for all clients for a given wl_output global. Thus, the name can be shared across processes to refer to a specific wl_output global.
The name is not guaranteed to be persistent across sessions, thus cannot be used to reliably identify an output in e.g. configuration files.
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.
The name event is sent after binding the output object. This event is only sent once per output object, and the name does not change over the lifetime of the wl_output global.
Compositors may re-use the same output name if the wl_output global is destroyed and re-created later. Compositors should avoid re-using the same name if possible.
The name event will be followed by a done event.
Fields§
§name: Str<'a>