OGRE 四卷实验指南

从四卷正文提取 180 个 C++ 实验,并用固定版本的 OGRE 与 Tiny 软件后端验证真实启动、帧回调和 Mesh 导出。

目录

卷一 · 卷二 · 卷三 · 卷四

独立 C++ 实验

将提取工具 和共享断言头 保存到同一目录。需要 Python 3.9+、POSIX shell 和支持 C++20 的编译器。以下命令从本站 Markdown 下载四卷正文,将其中的 L1 围栏提取为独立实验。每卷 45 个程序均可单独编译运行。

python3 extract-labs.py --output ogre-labs
sh ogre-labs/ogre-core-lab/run_all.sh
sh ogre-labs/ogre-render-lab/run_all.sh
sh ogre-labs/ogre-scene-lab/run_all.sh
sh ogre-labs/ogre-ext-lab/run_all.sh

--volume core 只提取卷一,其余卷使用 render、scene、ext。本地稿件可用 --source content/posts/books,Hugo 输出可用 --site 指向站点目录。工作区内请将输出放在 .local/ 下。每个实验包含入口、运行命令和断言。L1 表示独立教学模型,断言描述该模型的行为。

原生 OGRE 验证

下载原生探针 。以下命令以 macOS arm64、Apple Clang 16、CMake 4.4.4 和 Tiny 软件后端为基线,在工作区的 .local/ 里构建。

mkdir -p .local/checks/ogre-native
audit_dir="$PWD/.local/checks/ogre-native"
git clone --depth 1 --branch v14.6.3 https://github.com/OGRECave/ogre.git "$audit_dir/upstream"
test "$(git -C "$audit_dir/upstream" rev-parse HEAD)" = e3ee8850ecf5e0038b6d850ec4c865c2039342d5 || exit 1
cmake -S "$audit_dir/upstream" -B "$audit_dir/build" \
  -DCMAKE_BUILD_TYPE=Release -DOGRE_BUILD_DEPENDENCIES=OFF \
  -DOGRE_BUILD_LIBS_AS_FRAMEWORKS=OFF -DOGRE_BUILD_SAMPLES=OFF -DOGRE_BUILD_TOOLS=OFF \
  -DOGRE_BUILD_COMPONENT_OVERLAY=OFF -DOGRE_BUILD_COMPONENT_BITES=OFF \
  -DOGRE_BUILD_COMPONENT_PYTHON=OFF -DOGRE_BUILD_COMPONENT_JAVA=OFF \
  -DOGRE_BUILD_COMPONENT_CSHARP=OFF -DOGRE_BUILD_RENDERSYSTEM_GL=OFF \
  -DOGRE_BUILD_RENDERSYSTEM_GL3PLUS=OFF -DOGRE_BUILD_RENDERSYSTEM_GLES2=OFF \
  -DOGRE_BUILD_RENDERSYSTEM_TINY=ON -DOGRE_CONFIG_ENABLE_ZIP=OFF -DOGRE_BUILD_PLUGIN_STBI=OFF
cmake --build "$audit_dir/build" --target RenderSystem_Tiny --parallel 6

ogre_lib="$audit_dir/build/lib/macosx"
clang++ -std=c++20 -I"$audit_dir/upstream/OgreMain/include" \
  -I"$audit_dir/build/include" -L"$ogre_lib" -Wl,-rpath,"$ogre_lib" \
  native-probe.cpp -lOgreMain -o "$audit_dir/native-probe"
(cd "$audit_dir" && ./native-probe "$ogre_lib/RenderSystem_Tiny")

探针加载真实插件,创建离屏渲染窗口和视口,读回 RGB 255,0,0。它还检查三处帧回调返回 false 的后续行为、矩阵的平移布局、Ray 参数和实际导出的 Mesh chunk 长度。硬件后端的验收需要独立记录操作系统、驱动、后端能力和渲染结果。

原生场景调用链

场景样例源码 使用上节相同的 OGRE 构建和默认线程配置。在当前目录保存 depth-scene.cpp,然后执行以下命令。每次运行传一个新的资产子目录名。

clang++ -std=c++20 -Wall -I"$audit_dir/upstream/OgreMain/include" \
  -I"$audit_dir/build/include" -L"$ogre_lib" -Wl,-rpath,"$ogre_lib" \
  depth-scene.cpp -lOgreMain -o "$audit_dir/depth-scene"
(cd "$audit_dir" && ./depth-scene "$ogre_lib/RenderSystem_Tiny" assets)

样例写入自己的材质与平面网格,重新通过文件位置和资源组打开网格。两个 Entity 共享同一 Mesh,分别绑定到两个场景节点。关键日志如下:

事件应观察到的结果
group.initialised材质已登记,loaded=0
resource.future.readyworker 已准备网格,prepared=1 loaded=0 completions=0
resource.load.complete主线程完成加载,解码出一个 SubMesh
mesh.big_endian、mesh.truncated大端网格仍有一个 SubMesh 和六个索引,截断头在解码时被拒绝
resource.missing缺失的文件在准备阶段失败,loaded=0
frame.visible两个队列候选、四个三角形、非零前景像素
frame.culled相机移出后,队列候选、三角形与前景像素均为零
mesh.reload销毁两个 Entity 后卸载 Mesh,同名对象从磁盘重新加载
root.shutdown先处理持有 Mesh 的任务并卸载,再验证关停路径未执行无资源引用的标记任务

队列监听记录候选及材质方案,三角形统计与 Tiny 读回验证实际绘制。像素计数以本次分辨率和软件后端为条件。复用场景验证硬件后端时,应按该后端提供兼容材质及窗口条件。

资源组 · Mesh 加载 · 队列提交 · 目标调度 · 完整一帧 · 后台加载 · Paging 交接

原生插件与分页

插件源码 把一个自定义对象工厂登记到 Root。场景样例接收第三个可选参数作为插件路径,依次安装、创建对象、通过 SceneManager 销毁对象、卸载,并再次完成相同循环。

clang++ -std=c++20 -Wall -dynamiclib -fvisibility=hidden \
  -I"$audit_dir/upstream/OgreMain/include" -I"$audit_dir/build/include" \
  -L"$ogre_lib" -Wl,-rpath,"$ogre_lib" \
  depth-plugin.cpp -lOgreMain -o "$audit_dir/BookDepthPlugin.dylib"
(cd "$audit_dir" && ./depth-scene "$ogre_lib/RenderSystem_Tiny" assets-plugin "$audit_dir/BookDepthPlugin")

分页探针 使用一个 worker,向同一队列追加标记来确认后台准备阶段已经结束。每次保持 Page 存活到响应处理完毕。三个页分别验证正常提交、设置卸载标记后跳过,以及 provider 准备失败后跳过。

cmake --build "$audit_dir/build" --target OgrePaging --parallel 6
clang++ -std=c++20 -Wall -I"$audit_dir/upstream/OgreMain/include" \
  -I"$audit_dir/upstream/Components/Paging/include" -I"$audit_dir/build/include" \
  -L"$ogre_lib" -Wl,-rpath,"$ogre_lib" \
  depth-paging.cpp -lOgrePaging -lOgreMain -o "$audit_dir/depth-paging"
(cd "$audit_dir" && ./depth-paging "$ogre_lib/RenderSystem_Tiny")

预期仅页 1 记录 page.load main,页 2 和 3 都跳过最终加载。主线程处理完成后再从分区中移除对应页。该测试覆盖通用 Paging 组件,地形分页还有专门的任务和节流路径。

Metal 两级离屏渲染

Metal 样例源码 使用相同的平面几何,在 macOS 上建立一个不显示的引导窗口和两个离屏目标。第一个 Pass 写红色,第二个 Pass 采样第一张纹理并把红色分量写到绿色通道。关闭第一个目标中的实体后,第二张纹理的中心也变黑。

cmake -S "$audit_dir/upstream" -B "$audit_dir/build" -DOGRE_BUILD_RENDERSYSTEM_METAL=ON
cmake --build "$audit_dir/build" --target RenderSystem_Metal --parallel 6
clang++ -std=c++20 -Wall -fobjc-arc -I"$audit_dir/upstream/OgreMain/include" \
  -I"$audit_dir/build/include" -L"$ogre_lib" -Wl,-rpath,"$ogre_lib" \
  depth-metal.mm -lOgreMain -framework AppKit -o "$audit_dir/depth-metal"
(cd "$audit_dir" && ./depth-metal "$ogre_lib/RenderSystem_Metal")

需要能访问 Metal 设备和 macOS 窗口服务的进程。在 Apple M1 Pro 上,输入纹理中心读回红色,输出中心读回绿色,禁用输入对象后输出为黑色。样例验证两个 RenderTexture 的明确更新顺序,Compositor 脚本与交换链呈现另有独立路径。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图