Wayland协议-官网翻译

最新推荐文章于 2025-07-10 09:38:56 发布

懒猫不懒0127

最新推荐文章于 2025-07-10 09:38:56 发布

阅读量594

点赞数

CC 4.0 BY-SA版权

分类专栏： wayland 文章标签： wayland gpu linux

原文链接：https://wayland.freedesktop.org/docs/html/

wayland 专栏收录该内容

7 篇文章

订阅专栏

本文深入介绍了Wayland协议，它是一个用于合成器和客户端通信的协议，以及其实现的C库。文章探讨了合成器在不同场景下的角色，如系统、会话和嵌入式合成器，以及Wayland与X架构的区别。此外，还详细阐述了Wayland的渲染、硬件启用、协议和操作模型，包括对象创建、安全性和认证等方面。同时，提供了客户端和服务器API的概览。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Kristian Høgsberg
Intel Corporation
krh@bitplanet.net

版权申明

特此授予任何人免费获得本软件和相关文档文件（“软件”）副本的许可，不受限制地处理本软件，包括但不限于使用、复制、修改、合并的权利、发布、分发、再许可和/或出售软件的副本，并允许向其提供软件的人员这样做，但须符合以下条件：

本软件按“原样”提供，不提供任何形式的明示或暗示的保证，包括但不限于适销性、特定用途的适用性和不侵权的保证。在任何情况下，作者或版权持有人均不对任何索赔、损害或其他责任承担责任，无论是在合同诉讼、侵权行为或其他方面，由软件或软件的使用或使用或其他原因引起的或与之相关的软件。

简介

Wayland 是一个用于合成器与其客户端通信的协议，以及该协议的 C 库实现。合成器可以是运行在 Linux 内核模式设置和 evdev 输入设备上的独立显示服务器、X 应用程序或 Wayland 客户端本身。客户端可以是传统应用程序、X 服务器（无根或全屏）或其他显示服务器。

简介(Introduction)
动机(Motivation)
合成器即显示服务器(The compositing manager as the display server)
合成器类型(Types of Compositors)
系统合成器(System Compositor)
会话合成器(Session Compositor)
嵌入式合成器(Embedding Compositor)
Wayland 体系构架(Architecture)
X vs. Wayland 体系构架(Architecture)
Wayland 渲染(Rendering)
Wayland硬件使能(Hardware Enabling for Wayland)
Wayland 协议和操作模型(Protocol and Model of Operation)
基本原则(Basic Principles)
代码生成(Code Generation)
有线格式(Wire Format)(???)
接口(Interfaces)
Versioning
Connect Time
Security and Authentication
Creating Objects
Compositor
Surfaces
Input
Output
Data sharing between clients
X11 Application Support
Introduction
Two Modes for Foreign Windows
Architecture
X Window Manager (XWM)
A. Wayland Protocol Specification
wl_display - core global object
wl_registry - global registry object
wl_callback - callback object
wl_compositor - the compositor singleton
wl_shm_pool - a shared memory pool
wl_shm - shared memory support
wl_buffer - content for a wl_surface
wl_data_offer - offer to transfer data
wl_data_source - offer to transfer data
wl_data_device - data transfer device
wl_data_device_manager - data transfer interface
wl_shell - create desktop-style surfaces
wl_shell_surface - desktop-style metadata interface
wl_surface - an onscreen surface
wl_seat - group of input devices
wl_pointer - pointer input device
wl_keyboard - keyboard input device
wl_touch - touchscreen input device
wl_output - compositor output region
wl_region - region interface
wl_subcompositor - sub-surface compositing
wl_subsurface - sub-surface interface to a wl_surface
B. Client API
Introduction
wl_argument - Protocol message argument data types.
wl_array - Dynamic array.
wl_display - Represents a connection to the compositor and acts as a proxy to the wl_display singleton object.
wl_event_queue - A queue for wl_proxy object events.
wl_interface - Protocol object interface.
wl_list - Doubly-linked list.
wl_message - Protocol message signature.
wl_object - A protocol object.
wl_proxy - Represents a protocol object on the client side.
Functions
C. Server API
Introduction
wl_argument - Protocol message argument data types.
wl_array - Dynamic array.
wl_client
wl_display
wl_event_loop - An event loop context.
wl_event_source - An abstract event source.
wl_global
wl_interface - Protocol object interface.
wl_list - Doubly-linked list.
wl_listener - A single listener for Wayland signals.
wl_message - Protocol message signature.
wl_object - A protocol object.
wl_protocol_logger
wl_protocol_logger_message
wl_resource
wl_resource_iterator_context
wl_shm_buffer
wl_shm_pool
wl_shm_sigbus_data
wl_signal - A source of a type of observable event.
wl_socket
Functions
List of Figures