📚 课程目录第1章课程导入

1. 课程导入

在嵌入式 Linux、车载座舱、移动终端与桌面级图形系统中，OpenGL ES 负责把应用提交的顶点、纹理、着色器与帧缓冲渲染为像素，而 Wayland 负责把这些像素以窗口、表面和缓冲区的方式合成并送到显示控制器。两者一个管“画什么”，一个管“怎么显示、谁来合成、何时上屏”。本课程要解决的核心问题，就是让 OpenGL ES 渲染结果在 Wayland 合成器体系下稳定、低延迟、无撕裂地呈现出来。

很多初学者会把二者割裂理解：认为 OpenGL ES 只是 GPU 编程，Wayland 只是窗口系统。实际工程中，二者通过 EGL、GBM、DRM/KMS、DMA-BUF、wl_surface 等关键机制紧密耦合。一次完整的显示链路，往往同时涉及应用进程、GPU 驱动、Wayland 合成器、内核显示驱动和显示硬件。理解这条链路，是后续排查黑屏、花屏、卡顿、撕裂、内存泄漏等问题的前提。

本节不是单纯罗列 API，而是建立一张“从应用到像素”的全局地图：应用如何创建 EGL 上下文，如何把渲染结果交给 Wayland 表面，合成器如何拿到缓冲区，DRM 如何扫描上屏，以及每一步可能出现的性能与兼容性问题。

一、核心概念：五个必须分清的对象

学习本课程前，需要先建立以下五个核心概念，它们贯穿全部 30 个章节：

OpenGL ES 上下文：GPU 渲染状态与资源的集合，包含着色器、纹理、FBO、VBO 等。上下文通常由 EGL 创建并绑定到某个线程。
EGLSurface 与 wl_egl_window：EGL 与 Wayland 之间的桥梁。应用通过 wl_egl_window_create 把 wl_surface 包装成 EGL 可识别的窗口表面。
wl_surface / wl_buffer：Wayland 协议中的表面与缓冲区抽象。应用渲染完成后，通过 wl_surface_attach 和 wl_surface_commit 提交。
Wayland 合成器：如 Weston、Mutter、KWin、Sway 或自研合成器，负责接收客户端缓冲区、合成多个表面并提交给 DRM。
DRM/KMS 与 DMA-BUF：内核显示子系统与跨设备缓冲区共享机制。DMA-BUF 让 GPU 渲染的缓冲区无需拷贝即可交给显示控制器扫描输出。

二、整体框架：从应用到上屏的信号与数据流

下图给出本节最关键的全局框架。它把应用侧 OpenGL ES 渲染、EGL 绑定、Wayland 协议提交、合成器合成、DRM 扫描输出串成一条完整链路，并标出 DMA-BUF 与 fence 同步的位置。后续章节会逐段展开。

三、方法流程：一次完整上屏的关键步骤

下面用一段伪代码概括应用侧最典型的集成流程。注意每一步的职责边界：OpenGL ES 只负责渲染，Wayland 只负责提交与合成，二者通过 EGL 和缓冲区握手。

// 1. 连接 Wayland 显示
display = wl_display_connect(NULL);
registry = wl_display_get_registry(display);
// 绑定 wl_compositor、wl_shm、xdg_wm_base 等

// 2. 创建 Wayland 表面
surface = wl_compositor_create_surface(compositor);
xdg_surface = xdg_wm_base_get_xdg_surface(wm_base, surface);

// 3. 用 EGL 包装为可渲染窗口
egl_window = wl_egl_window_create(surface, width, height);
egl_surface = eglCreateWindowSurface(egl_display, config, egl_window, NULL);
eglMakeCurrent(egl_display, egl_surface, egl_surface, egl_context);

// 4. OpenGL ES 渲染
glClearColor(0.1f, 0.2f, 0.3f, 1.0f);
glClear(GL_COLOR_BUFFER_BIT);
// ... 绘制命令 ...

// 5. 提交并等待合成
eglSwapBuffers(egl_display, egl_surface);
wl_display_flush(display);

这段代码看似简单，但隐藏了大量工程细节：eglSwapBuffers 内部如何选择缓冲区、如何触发 Wayland 提交、合成器何时回传 release 事件、GPU 与显示控制器之间如何用 fence 同步。这些正是本课程后续章节要逐一拆解的内容。

四、案例与场景：三个典型集成形态

不同产品形态下，OpenGL ES 与 Wayland 的集成方式差异很大。下表列出三种典型场景及其关键差异，帮助建立选型意识。

场景	渲染方式	缓冲区路径	典型问题
嵌入式 HMI / 车载仪表	单应用全屏 OpenGL ES 渲染	GPU → DMA-BUF → DRM Plane 直出	启动黑屏、分辨率切换失败
桌面多窗口应用	多客户端各自渲染，合成器统一合成	GPU → wl_buffer → 合成器 GPU 合成 → DRM	撕裂、输入延迟、缓冲区饥饿
视频播放 + UI 叠加	视频走硬件解码，UI 走 OpenGL ES	解码器 DMA-BUF + GPU 纹理 → 合成器叠加	色彩空间错误、同步抖动

五、常见误区与复盘

误区一：把 eglSwapBuffers 当成“立即上屏”。 它只是提交缓冲区并可能阻塞等待，真正上屏由合成器和 DRM 决定。忽略这一点会导致对延迟和帧率的误判。

误区二：认为 Wayland 只是“另一个 X11”。 Wayland 客户端不直接控制显示，所有合成与上屏由合成器统一管理，因此权限模型、缓冲区管理和同步机制与 X11 完全不同。

复盘建议： 遇到显示问题时，先按“应用渲染 → EGL 提交 → Wayland 协议 → 合成器 → DRM → 硬件”这条链路逐段确认，再结合 WAYLAND_DEBUG=1、drm_info、glxinfo 或厂商 GPU 调试工具定位。不要一上来就改着色器或重写合成器。

本课程后续将沿着这条链路，从 EGL 初始化、wl_egl_window 创建、缓冲区交换、DMA-BUF 导入导出、合成器集成、DRM 上屏、性能分析与故障排查逐步展开。掌握本节这张全局地图，后续每一章都能找到自己的位置。