第 11 章 相机与视图摘要本章系统介绍了 VulkanSceneGraph 中相机与视图的核心概念。相机vsg::Camera由投影矩阵Perspective/Orthographic、视图矩阵LookAt和视口状态三部分组成决定了观察场景的视角与范围。视图vsg::View将相机与要渲染的场景子图绑定作为渲染图RenderGraph的直接子节点。本章详细讲解了如何创建和配置相机、使用便捷函数实现窗口缩放同步、驱动相机动画以及实现多视图渲染并提供了常见问题的解决方案。本章定位相机决定「从哪看、看多大范围」。Camera由投影矩阵、视图矩阵、视口三部分组成View把相机与一段子图配对是RenderGraph的直接子节点。11.1 本章目标理解vsg::Camera的三个核心成员投影 / 视图 / 视口会用vsg::Perspective/vsg::Orthographic与vsg::LookAt理解vsg::View把「相机 子图」绑定在一起知道窗口缩放时视口如何自动更新以及每帧如何驱动相机动画。11.2 前置准备第 6 章场景图与第 12 章RenderGraph/CommandGraph建议先读概念已读了解投影矩阵 / 视图矩阵的基本概念。11.3Camera的三个成员vsg::Camera持有一个相机所需的全部矩阵与视口成员类型作用projectionMatrixref_ptrProjectionMatrix投影透视/正交viewMatrixref_ptrViewMatrix视图相机世界变换的逆viewportStateref_ptrViewportState视口与裁剪区域auto camera vsg::Camera::create(); camera-projectionMatrix vsg::Perspective::create( 60.0, // 垂直视场角 (度) static_castdouble(window-extent2D().width) / window-extent2D().height, // 宽高比 0.1, // 近平面 10.0); // 远平面 camera-viewMatrix vsg::LookAt::create( vsg::dvec3(0.0, 0.0, 3.0), // eye 眼睛位置 vsg::dvec3(0.0, 0.0, 0.0), // center 注视点 vsg::dvec3(0.0, 1.0, 0.0)); // up 上方向 camera-viewportState vsg::ViewportState::create(window-extent2D());11.4 投影矩阵Perspective与Orthographicvsg::Perspective::create(fovY, aspectRatio, near, far)透视投影近大远小vsg::Orthographic::create(left, right, bottom, top, near, far)正交投影无透视适合 2D / CAD。二者都继承ProjectionMatrix可作为camera-projectionMatrix赋给相机。⚠️宽高比务必用窗口真实宽高比window-extent2D().width / height否则画面会被拉伸。用createRenderGraphForView时缩放由WindowResizeHandler自动同步见第 12 章。11.5 视图矩阵LookAtvsg::LookAt::create(eye, center, up)生成「看向 center」的视图矩阵内部是相机世界变换的逆。参数为dvec3双精度适合大世界坐标。11.6View相机 子图vsg::View是一个Group把相机与要渲染的子图配对并作为RenderGraph的子节点auto view vsg::View::create(camera, scenegraph); // View 是 Group可继续 addChildviewID 在构造时自动分配View的关键成员camera、viewID自动分配用于区分多视图、mask遍历掩码、features如RECORD_LIGHTS/RECORD_SHADOW_MAPS、overridePipelineStates。// 典型装配推荐用便捷函数见第 12 章 auto renderGraph vsg::createRenderGraphForView(window, camera, scenegraph);createRenderGraphForView内部会创建View并接好WindowResizeHandler把相机视口与窗口缩放同步。11.7 驱动相机动画与多视图每帧更新轨道相机// 帧循环里 double t ...; camera-viewMatrix vsg::LookAt::create( vsg::dvec3(std::sin(t)*3.0, 0.0, std::cos(t)*3.0), // 绕原点旋转 vsg::dvec3(0.0, 0.0, 0.0), vsg::dvec3(0.0, 1.0, 0.0)); // 重新 compile / updateViewer 视情况而定纯 viewMatrix 改动通常无需重编译录制时实时读取完整相机动画示例下面是一个完整的、可运行的 VSG 相机动画示例包含三种驱动方式#include vsg/all.h int main(int argc, char** argv) { // 1. 创建窗口与场景 auto windowTraits vsg::WindowTraits::create(); windowTraits-width 1280; windowTraits-height 720; auto window vsg::Window::create(windowTraits); // 简单场景一个立方体 auto scenegraph vsg::Group::create(); auto transform vsg::MatrixTransform::create(); auto cube vsg::Builder::createBox(vsg::vec3(0.0f, 0.0f, 0.0f), 1.0f); transform-gt;addChild(cube); scenegraph-gt;addChild(transform); // 2. 创建相机 auto camera vsg::Camera::create(); camera-gt;projectionMatrix vsg::Perspective::create( 60.0, static_castlt;doublegt;(window-gt;extent2D().width) / window-gt;extent2D().height, 0.1, 100.0); camera-gt;viewMatrix vsg::LookAt::create( vsg::dvec3(0.0, 0.0, 5.0), // 初始位置 vsg::dvec3(0.0, 0.0, 0.0), // 注视点 vsg::dvec3(0.0, 1.0, 0.0)); // 上方向 camera-gt;viewportState vsg::ViewportState::create(window-gt;extent2D()); // 3. 创建渲染图 auto renderGraph vsg::createRenderGraphForView(window, camera, scenegraph); auto commandGraph vsg::createCommandGraphForView(window, camera, scenegraph); auto viewer vsg::Viewer::create(); viewer-gt;addWindow(window); viewer-gt;assignRecordAndSubmitTaskAndPresentation({commandGraph}); // 4. 方法一帧循环中直接更新相机位置轨道相机 auto updateCamera [amp;](vsg::Cameraamp; cam, double time) { // 绕Y轴旋转的轨道相机 double radius 5.0; double angle time * 0.5; // 每秒旋转180度 vsg::dvec3 eye( std::sin(angle) * radius, 2.0, // 保持一定高度 std::cos(angle) * radius ); cam.viewMatrix vsg::LookAt::create(eye, vsg::dvec3(0.0, 0.0, 0.0), vsg::dvec3(0.0, 1.0, 0.0)); // 注意仅修改 viewMatrix 通常不需要调用 viewer-amp;gt;compile() // 因为 viewMatrix 在录制命令时实时读取不涉及管线状态变更 // 但如果修改了 projectionMatrix 或 viewportState可能需要重编译 }; // 5. 方法二使用 vsg::AnimationPath预定义路径 auto animationPath vsg::AnimationPath::create(); animationPath-gt;add(vsg::AnimationPath::KeyTime{0.0, vsg::dvec3(0.0, 0.0, 5.0)}); animationPath-gt;add(vsg::AnimationPath::KeyTime{5.0, vsg::dvec3(5.0, 2.0, 0.0)}); animationPath-gt;add(vsg::AnimationPath::KeyTime{10.0, vsg::dvec3(0.0, 0.0, -5.0)}); animationPath-gt;add(vsg::AnimationPath::KeyTime{15.0, vsg::dvec3(-5.0, 2.0, 0.0)}); animationPath-gt;add(vsg::AnimationPath::KeyTime{20.0, vsg::dvec3(0.0, 0.0, 5.0)}); // 6. 方法三使用 vsg::MatrixTransform 驱动相机节点 // 将相机挂载到变换节点上通过动画系统驱动变换 auto cameraTransform vsg::MatrixTransform::create(); cameraTransform-gt;matrix vsg::translate(0.0, 0.0, 5.0); // 可以给 cameraTransform 添加 vsg::Animation 或 vsg::KeyFrameAnimation // 7. 帧循环 viewer-gt;compile(); auto startTime vsg::clock::now(); while (viewer-gt;advanceToNextFrame()) { double time std::chrono::durationlt;doublegt;(vsg::clock::now() - startTime).count(); // 使用方法一直接更新 updateCamera(*camera, time); // 或者使用方法二从动画路径获取位置 // auto position animationPath-amp;gt;interpolate(time); // camera-amp;gt;viewMatrix vsg::LookAt::create(position, vsg::dvec3(0.0, 0.0, 0.0), vsg::dvec3(0.0, 1.0, 0.0)); // 或者使用方法三更新变换矩阵 // double angle time * 0.3; // cameraTransform-amp;gt;matrix vsg::rotate(angle, vsg::dvec3(0.0, 1.0, 0.0)) * vsg::translate(0.0, 0.0, 5.0); // camera-amp;gt;viewMatrix vsg::inverse(cameraTransform-amp;gt;matrix); // 何时需要调用 viewer-amp;gt;compile() 或 viewer-amp;gt;updateViewer() // 1. 首次创建渲染图后必须调用 viewer-amp;gt;compile() // 2. 修改了 projectionMatrix、viewportState 或任何影响管线状态的内容后需要重编译 // 3. 仅修改 viewMatrix 通常不需要重编译因为它在每帧录制时读取 // 4. viewer-amp;gt;updateViewer() 在添加/移除节点、修改场景结构时调用 viewer-amp;gt;handleEvents(); viewer-amp;gt;update(); viewer-amp;gt;recordAndSubmit(); viewer-amp;gt;present(); } return 0; }关键说明帧循环更新示例展示了在while (viewer-advanceToNextFrame())循环中更新相机位置的完整逻辑。三种驱动方案直接计算在帧循环中实时计算相机位置如轨道相机。vsg::AnimationPath预定义关键帧路径适合固定轨迹的相机运动。vsg::MatrixTransform将相机作为变换节点的子节点通过动画系统驱动变换矩阵。编译与更新时机viewer-compile()首次创建渲染图后必须调用修改projectionMatrix、viewportState或任何管线状态后需要重编译。viewer-updateViewer()添加/移除场景节点、修改场景结构时调用。仅改viewMatrix通常无需重编译因为视图矩阵在每帧命令录制时实时读取。每帧更新轨道相机// 帧循环里 double t ...; camera-viewMatrix vsg::LookAt::create( vsg::dvec3(std::sin(t)*3.0, 0.0, std::cos(t)*3.0), // 绕原点旋转 vsg::dvec3(0.0, 0.0, 0.0), vsg::dvec3(0.0, 1.0, 0.0)); // 重新 compile / updateViewer 视情况而定纯 viewMatrix 改动通常无需重编译录制时实时读取性能与边界条件在实现相机动画与多视图时除了掌握驱动方案还需关注性能与数值精度等边界条件避免出现渲染异常或性能瓶颈。1. 频繁更新 viewMatrix 的性能影响与优化每帧更新viewMatrix是相机动画的常见操作。虽然 VSG 在命令录制时实时读取视图矩阵避免了管线重编译但频繁赋值仍会触发场景图遍历与状态更新。若场景复杂或视图数量多可能影响帧率。优化建议使用dirty()标记当相机节点或包含相机的变换节点被修改后调用camera-dirty()或view-dirty()标记该分支为“脏”状态。这能确保 VSG 的增量更新机制仅处理受影响的部分避免全图遍历。批量更新若同一帧内需要更新多个相机的视图矩阵尽量在一次遍历中完成减少状态切换开销。避免冗余计算在动画循环中若相机位置未变化例如相机静止或动画暂停可跳过矩阵重算与赋值。// 优化示例仅在位置变化时更新并标记脏状态 void updateCameraIfNeeded(vsg::ref_ptrvsg::Camera camera, const vsg::dvec3 newEye) { static vsg::dvec3 lastEye; if (newEye ! lastEye) { camera-viewMatrix vsg::LookAt::create(newEye, vsg::dvec3(0.0, 0.0, 0.0), vsg::dvec3(0.0, 1.0, 0.0)); camera-dirty(); // 标记相机为脏触发增量更新 lastEye newEye; } }2. 投影矩阵 near/far 平面设置与 Z-fighting投影矩阵的 near近平面和 far远平面值设置不当会导致深度缓冲精度问题常见现象为 Z-fighting闪烁或物体在特定距离消失。常见问题与建议near 值过小或为 0near 值不能为 0 或极小的正数如 1e-6。过小的 near 值会大幅压缩近处的深度精度导致靠近相机的物体出现 Z-fighting。建议 near ≥ 0.1单位与场景尺度一致。far 值过大far 值过大如 1e6会拉伸深度范围降低整体深度精度。在透视投影中深度非线性分布远处精度本就较低过大的 far 会加剧远处物体的 Z-fighting。near/far 比值过大深度缓冲精度有限通常为 24 位。若 far/near 比值超过 10⁶深度误差将变得明显。建议 far/near ≤ 10⁵并尽量根据场景实际可见范围设置。推荐值范围透视投影near 通常在 0.1~1.0 之间far 根据场景大小设定一般不超过 1000.0。例如vsg::Perspective::create(60.0, aspect, 0.1, 100.0)。正交投影near/far 可设置得更大但仍需避免比值过大。例如vsg::Orthographic::create(-10, 10, -10, 10, 0.1, 1000.0)。3. 大世界坐标与双精度dvec3使用当场景坐标范围很大如地理信息系统、太空模拟时使用单精度浮点数float、vec3会导致严重的精度丢失表现为相机抖动、物体位置漂移或深度测试异常。必要提醒VSG 原生支持双精度vsg::LookAt::create()、vsg::dvec3、vsg::dmat4等均使用双精度double。在大世界场景中务必使用双精度类型定义相机位置、注视点等参数。矩阵计算精度视图矩阵与投影矩阵的计算应全程使用双精度避免中间转换丢失精度。VSG 的矩阵运算如vsg::inverse()会自动保持输入精度。着色器中的精度处理虽然 CPU 端使用双精度但 GPU 着色器通常只支持单精度。需通过“相对坐标”或“相机相对偏移”策略将世界坐标转换为相机相对坐标后再传入着色器以保持渲染精度。// 大世界坐标下推荐使用双精度 vsg::dvec3 eye(1000000.0, 50000.0, 200000.0); // 大坐标 vsg::dvec3 center(1000100.0, 50000.0, 200100.0); camera-viewMatrix vsg::LookAt::create(eye, center, vsg::dvec3(0.0, 1.0, 0.0)); // 错误示例使用单精度会导致精度丢失 // vsg::vec3 eye(1000000.0f, 50000.0f, 200000.0f); // 可能产生舍入误差多视图分屏 / 画中画创建多个CameraView分别addChild到同一个RenderGraph各自renderArea不同即可一窗多视角。11.8 常见问题现象原因解决画面拉伸宽高比错误用window-extent2D()真实比例或交给createRenderGraphForView自动处理缩放后黑边/变形没同步视口用createRenderGraphForView自带WindowResizeHandler相机「穿模」near/far 设置不当调小 near、调大 far或改正交投影多视图重叠renderArea没分开为每个View设不同的ViewportState/renderArea11.9 小结CameraprojectionMatrix(Perspective/Orthographic) viewMatrix(LookAt) viewportStateView把相机与子图配对是RenderGraph的子节点viewID自动分配窗口缩放的视口同步交给createRenderGraphForView的WindowResizeHandler每帧改viewMatrix即可做相机动画多View实现一窗多视角。11.10 延伸阅读与下一章预告第 12 章《RenderGraph 与 CommandGraph》View如何被包进RenderGraph并录制成命令第 14 章《变换与动画》相机动画也可用CameraSampler驱动第 19 章《拾取与交互》射线从相机出发做鼠标拾取。