iii
Preface v
Acknowledgments vii
1. Introduction 1
1.1. Motivation ..................................................................................................................... 1
1.2. The compositing manager as the display server ............................................................. 2
2. Types of Compositors 3
2.1. System Compositor ....................................................................................................... 3
2.2. Session Compositor ...................................................................................................... 3
2.3. Embedding Compositor ................................................................................................. 3
3. Wayland Architecture 5
3.1. X vs. Wayland Architecture ........................................................................................... 5
3.2. Wayland Rendering ....................................................................................................... 7
3.3. Hardware Enabling for Wayland .................................................................................... 7
4. Wayland Protocol and Model of Operation 9
4.1. Basic Principles ............................................................................................................ 9
4.2. Code Generation .......................................................................................................... 9
4.3. Wire Format ................................................................................................................. 9
4.4. Interfaces .................................................................................................................... 10
4.5. Versioning ................................................................................................................... 12
4.6. Connect Time ............................................................................................................. 13
4.7. Security and Authentication ......................................................................................... 13
4.8. Creating Objects ......................................................................................................... 13
4.9. Compositor ................................................................................................................. 13
4.10. Surfaces ................................................................................................................... 13
4.11. Input ......................................................................................................................... 13
4.12. Output ...................................................................................................................... 14
4.13. Data sharing between clients ..................................................................................... 14
A. Wayland Protocol Specification 17
A.1. wl_display - core global object .................................................................................... 17
A.2. wl_registry - global registry object ................................................................................ 19
A.3. wl_callback - callback object ....................................................................................... 20
A.4. wl_compositor - the compositor singleton ..................................................................... 20
A.5. wl_shm_pool - a shared memory pool ......................................................................... 20
A.6. wl_shm - shared memory support ................................................................................ 21
A.7. wl_buffer - content for a wl_surface ............................................................................. 26
A.8. wl_data_offer - offer to transfer data ............................................................................ 26
A.9. wl_data_source - offer to transfer data ......................................................................... 27
A.10. wl_data_device - data transfer device ........................................................................ 28
A.11. wl_data_device_manager - data transfer interface ...................................................... 31
A.12. wl_shell - create desktop-style surfaces ..................................................................... 31
A.13. wl_shell_surface - desktop-style metadata interface .................................................... 32
A.14. wl_surface - an onscreen surface .............................................................................. 38
A.15. wl_seat - group of input devices ................................................................................ 42
A.16. wl_pointer - pointer input device ................................................................................ 43
A.17. wl_keyboard - keyboard input device ......................................................................... 47
A.18. wl_touch - touchscreen input device .......................................................................... 49
A.19. wl_output - compositor output region ......................................................................... 51
A.20. wl_region - region interface ....................................................................................... 54
5. Wayland Library 57
5.1. Client API ................................................................................................................... 57
