openxr runtime Monado 源码解析源码分析：CreateInstance流程（设备系统和合成器系统）Compositor comp_main client compositor

化凡2012

1083人浏览 · 2022-11-20 20:31:39

化凡2012 · 2022-11-20 20:31:39 发布

monado系列文章索引汇总：
openxr runtime Monado 源码解析源码分析：源码编译准备工作说明 hello_xr解读
openxr runtime Monado 源码解析源码分析：整体介绍模块架构模块作用进程线程模型整体流程
openxr runtime Monado 源码解析源码分析：CreateInstance流程（设备系统和合成器系统）Compositor comp_main client compositor
openxr runtime Monado 源码解析源码分析：Prober设备发现和管理 system device HMD target instance
openxr runtime Monado 源码解析源码分析：InitializeSession client native multi_compositor client_compositor
openxr runtime Monado 源码解析源码分析：CreateSwapchain 画布 HardwareBuffer共享纹理渲染线程 xrEndeFrame comp_renderer

模块目的

容易混淆的概念：native和非native

XR对象与monado底层实现对象持有和转换关系

comp_render comp_util

总结

模块目的

创建进程唯一的XR资源句柄（指针）XrInstance，通过XrInstance在runtime层可以找到所有其它对象。Instance创建过程涉及两大核心模块创建：

合成器系统模块（xrt_system_compositor）：持有主合成器，当App开启Session时（client），负责管理client的链接和Layer提交，最终由主合成器合并一层（或多层）到最终画面。

设备系统模块（xrt_system_devices）：持有所有设备对象，由Prober模块负责发现，加载。在Prober篇详细介绍。

容易混淆的概念：native和非native

不正确但直观的理解：native指离vulkan更近的对象，非native离client跟近，非native持有native对象，用于vk共享纹理创建。
native对象，如
1）主合成器comp_compositor是native性质的对象，因为它使用vk渲染，申请很多vk内存、纹理等资源。
2）客户端layer提交和管理multi_compositor是native性质对象，因为它通过native swapchain间接使用vk资源，与vk跟近，使用vk资源。
3）后续文章涉及的重要概念native swapchain申请VkMemeory内存，共client端创建EglImage和glTexture，与vk跟近，使用vk资源。

非native概念：与client端跟近，如客户端是gl、vk、dx等资源。

1）与multi_compositor相对的comp_gl_client和comp_egl_client

2）与comp_swapchain（native vk）相对的client_gl_swapchan

XR对象与monado底层实现对象持有和转换关系

* C语言通过“组合式”继承，实现c++类继承

* 指针类型强转

主要类和关系

multi_system_devices: 合成器系统的具体实现者，runtime重要模块之一，持有主合成器对象和所有client连接实例。管理主合成器渲染线程。

comp_compositor: 主合成器，使用vulkan渲染，负责基础内容绘制和client提交的layer合成绘制，distortion等算法在此完成。

multi_compositor：与vk通信，通过HardwareBuffer共享纹理给client端使用，并负责client layer提交给主合成器合并渲染。这里不做详细介绍，在InitializeSession篇详细介绍。

xrt_compositor：所有compositor（native和非native类型）基类，代码注释表示与XrSession相同生命周期

持有关系。

XrInstance即oxr_instance，前者是官方规范，后者是monado的具体实现。

oxr_instance持有合成器系统xrt_system_compositor，具体实现为multi_system_compositor，在comp_multi库中。

合成器系统multi_system_compositor持有主合成器comp_compositor，用于runtime渲染，采用vulkan，并监听client链接，提交client layer数据到主合成器“逐层”合并渲染，并最终呈现。

主要流程

时序和代码注解

补充说明

compositor模块非常复杂，也是非常重要的模块，从monado模块设计上看出，compositor细分为几个独立的模块：comp_main, comp_client, comp_multi, comp_render, comp_util。原则上每个模块都可以按照接口自定义个性化实现。comp_main主合成器一般是重点性能优化模块，各XR厂家会提供深度优化的、自定义的主合成器模块。