目录
独立 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.ready | worker 已准备网格,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 脚本与交换链呈现另有独立路径。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。