The release of wayland-protocols version 1.42 has been published, containing a set of protocols and extensions that complement the basic Wayland protocol and provide the necessary capabilities for building composite servers and user environments.
Wayland-Protocols 1.42 features a new version of the 'cursor-shape' protocol, which enhances the appearance of the cursor, adds support for cursor shapes with informational indicators (question mark), and enables resizing. The 'tablet' protocol has also been updated to provide input capabilities from graphic tablets. The new version of the tablet protocol adds support for 'bustype' events and implements handling for events from rotary controls by transmitting relative changes similarly to mouse wheel movement.
All protocols go through phases of development, testing, and stabilization sequentially. After completing the development stage (the 'unstable' category), a protocol is moved to the 'staging' branch and officially included in the wayland-protocols set, and after testing is completed, it is moved to the stable category. Protocols from the 'staging' category can already be applied in composite servers and clients where related functionality is required. Unlike the 'unstable' category, no changes that break compatibility are allowed in 'staging', but if issues and shortcomings are identified during testing, the introduction of a new significant version of the protocol or another Wayland extension is not excluded.
To speed up the delivery of protocols to developers and encourage early implementation in existing projects, since the last but one release, an 'experimental' phase has been added, which allows changes that break compatibility and the addition of 'raw' protocols that can be gradually refined. While forming a support team and obtaining a certain number of acknowledgments (ACK) from reviewers is required for a protocol to enter the 'staging' phase, it is sufficient to have no objections (NACK) during a two-week review period for it to enter 'experimental'.
The current version of the wayland-protocols set includes the following stable protocols that ensure backward compatibility:
- âviewporterâ â allows clients to perform actions for scaling and cropping surface edges on the server side.
- âpresentation-timeâ â provides video display.
- «xdg-shell» â an interface for creating and interacting with surfaces as windows, allowing them to be moved around the screen, minimized, maximized, resized, etc.
- «linux-dmabuf» â provides capabilities for creating wl_buffers based on DMA-BUF.
- "tablet" â input organization from graphic tablets.
Protocols currently being tested in the 'staging' branch:
- drm-lease provides the resources necessary for forming a stereo image with different buffers for the left and right eye when outputting to virtual reality headsets.
- ext-session-lock defines session lock mechanisms, such as during the screensaver operation or the display of an authentication dialog.
- single-pixel-buffer allows the creation of single-pixel buffers that include four 32-bit RGBA values.
- xdg-activation enables focus transfer between different top-level surfaces (for example, using xdg-activation, one application can shift focus to another).
- content-type â enables clients to convey information about the displayed content to the composite server, which can be used to optimize behavior based on the content, such as setting specific DRM properties like 'content type'. Support is declared for the following content types: none (no data type information), photo (output of digital photos requiring minimal processing), video (video or animation, requiring more precise synchronization to avoid stuttering), and game (running games, requiring output with minimal delay).
- tearing-control allows disabling vertical synchronization (VSync) with frame-destroying pulse in fullscreen applications, used to prevent tearing during output. In multimedia applications, the appearance of artifacts due to tearing is an undesirable effect, but in gaming programs, artifacts can be tolerated if combating them leads to additional delays.
- ext-foreign-toplevel-list retrieves information about surfaces positioned at the very top level (toplevel) that allow the organization of window pinning over other content, for example, to connect custom panels and window switches.
- ext-foreign-toplevel-list retrieves information about surfaces positioned at the very top level (toplevel) that allow the organization of window pinning over other content, for example, to connect custom panels and window switches.
- security-context â allows identifying clients using sandbox isolation. A client can register a new connection to a composite server based on Wayland and attach a security context to it, after which the composite manager will restrict the capabilities available for the established connection according to the specified security context.
- cursor-shape â an alternative way to set the cursor appearance based on transmitting a series of cursor images instead of binding to a surface (wl_surface).
- 'ext-transient-seat' is designed for creating temporary independent sessions (seats) intended for use with virtual input devices. For instance, when implementing remote desktop connectivity, the protocol allows for creating a separate session with virtual keyboard and mouse for each user.
- «xdg-toplevel-drag» â extends the âdrag & dropâ mechanism by allowing the attachment of top-level windows to the movement operation, which can be used, for example, to organize mouse dragging of toolbars or browser tabs. The new protocol enables the creation of detachable parts of the window that, when dragged out of the original window, become new windows and can be moved above the existing window before reattaching.
- «xdg-dialog» â allows assigning top-level surfaces with properties specific to dialog windows, for example, it can create modal dialogs that block user interaction with the rest of the interface.
- «linux-drm-syncobj» â provides tools for explicit synchronization of buffers using DRM (Direct Rendering Manager) sync objects. It is expected that in the context of synchronization during rendering to a buffer, the proposed protocol will improve interaction with drivers based on graphical APIs Vulkan and OpenGL (the implementation is based on handlers in the drivers). The new protocol allows ensuring that the rendering operation to the buffer is completed before the composite manager displays this buffer.
- alpha-modifier, allowing clients to change the transparency level of the surface and offloading transparency operations to the composite server, which can, in turn, redirect these operations to KMS.
- xdg-toplevel-icon â binding an icon to a top-level window.
- ext-image-capture-source and ext-image-copy-capture â organizing the capture of content displayed on the screen.
- xdg-system-bell â allows the output of a system signal that can be used, for example, as a warning in terminal emulators. The form of the signal output is determined at the discretion of the composite manager; it can be not only sound but also a visual response.
- fifo â implements a FIFO mechanism (first-come, first-served) for processing the queue of updates to the displayed surface. Practically, the protocol allows for using vertical synchronization (vblank) waiting instead of callback calls whenever ready to display a new frame, addressing the issue of high GPU load when using VSync.
- commit-timing â allows a time constraint to be tied to the surface content (the composite server must display the content change as close to the specified time as possible, but not earlier).
- ext-data-control â allows privileged clients to manage data processing, for instance, for clipboard managers.
- ext-workspace â implements the concept virtual desktops and offers events with information about the state of the workspaces, as well as features for activating and deactivating workspaces. The protocol can be used to create panels and indicators that display the list of available virtual desktops and allow switching between them.
- color-management provides capabilities for color management and support for High Dynamic Range (HDR). With the added extension, client applications can obtain information about color reproduction properties of output devices and transmit data about their own content's color reproduction properties to the composite server. server This information can be used for automatic color management when displaying content on various output devices, for example, to convert content into formats suitable for HDR monitors. ICC profiles are used to describe color spaces.
Protocols being developed in the âunstableâ branch:
- «fullscreen-shell» â management of fullscreen operation.
- «input-method» â processing of input methods.
- «idle-inhibit» â prevents the screensaver (screen saver) from starting.
- «input-timestamps» â timestamps for input events.
- «keyboard-shortcuts-inhibit» â manages the attachment of keyboard shortcuts and hotkeys.
- «linux-explicit-synchronization» â Linux-specific buffer synchronization mechanism related to surfaces.
- «pointer-gestures» â manages input from touch screens.
- «pointer constraints» â pointer restrictions (blocking).
- «primary-selection» â similar to X11, enables the primary clipboard (primary selection), where information is typically pasted using the middle mouse button.
- «relative pointer events» â relative pointer events.
- «text-input» â organization of text input.
- «xdg-foreign» â interface for interaction with 'foreign' client surfaces.
- «xdg-decoration» â rendering of window decorations on the server side.
- «xdg-output» â additional information about video output (used for fractional scaling).
- «xwayland-keyboard-grab» â input capture in XWayland applications.
Source: opennet.ru
