《OGRE 3D 渲染引擎原理与架构》2.1 相机与视锥

相机是场景的眼睛:OGRE 的 Camera 直接继承 Frustum,视锥参数(FOVy、近/远裁剪、宽高比、投影类型)全住在基类里,各带默认值。lab 复现 Camera/Frustum 骨架与相机↔视口的双向关联。

2.1 相机与视锥

场景需要一只「眼睛」把世界变成画面,这就是 Camera。OGRE 的相机不是孤立对象——它直接继承 Frustum(视锥),所以「看多远、看多宽、什么投影」这些几何参数全住在基类里。这一节拆开 Camera 与 Frustum 的类骨架。

本章与站内既有内容的分工

卷二讲过渲染目标与交换链(画面往哪画);卷一 5.x 讲过 MovableObject 与场景图。这一章讲的是画面从哪看:相机(Camera)、画面落在目标的哪块区域(Viewport)、以及「哪些东西看得见」的数学(投影与裁剪)。相机是 MovableObject 的直系子类,挂在场景节点上随节点移动。

Camera:Frustum 的相机化身

Camera 同时是「视锥」(知道投影几何)与「可移动对象」(能挂到场景节点上跟随),二者都来自继承:

// OgreMain/include/OgreCamera.h:Camera(v14.6.3 源码摘录,已删减)
    class _OgreExport Camera : public Frustum
    {
    public:
        /** Listener interface so you can be notified of Camera events. 
        */
        class _OgreExport Listener 
        {
        public:
            Listener() {}
            virtual ~Listener() {}

            /// Called prior to the scene being rendered with this camera
            virtual void cameraPreRenderScene(Camera* cam)
                        { (void)cam; }

            /// Called after the scene has been rendered with this camera
            virtual void cameraPostRenderScene(Camera* cam)
                        { (void)cam; }

            /// Called when the camera is being destroyed
            virtual void cameraDestroyed(Camera* cam)
                        { (void)cam; }

        };
    private:
        /// Is viewing window used.
        bool mWindowSet;
        /// Was viewing window changed.
        mutable bool mRecalcWindow;

        /** Whether aspect ratio will automatically be recalculated
            when a viewport changes its size
        */
        bool mAutoAspectRatio;

关键点:Camera : public Frustum。Frustum 里的 mFOVy/mNearDist/mFarDist/mAspect/mProjType 等投影参数,Camera 一个都不用重复声明——它就是视锥。相机内部还带一整套 Listener 事件(渲染前、渲染后、销毁),供外部挂接。

Frustum:投影几何的仓库

视锥到底是什么?OGRE 用两个枚举定义它的形态:

// OgreMain/include/OgreFrustum.h:ProjectionType 与 FrustumPlane(v14.6.3 源码摘录,已删减)
    enum ProjectionType : uint8
    {
        PT_ORTHOGRAPHIC,
        PT_PERSPECTIVE
    };

    /** Worldspace clipping planes.
    */
    enum FrustumPlane : uint8
    {
        FRUSTUM_PLANE_NEAR   = 0,
        FRUSTUM_PLANE_FAR    = 1,
        FRUSTUM_PLANE_LEFT   = 2,
        FRUSTUM_PLANE_RIGHT  = 3,
        FRUSTUM_PLANE_TOP    = 4,
        FRUSTUM_PLANE_BOTTOM = 5
    };

投影类型二选一:正交(PT_ORTHOGRAPHIC)或透视(PT_PERSPECTIVE)。六个裁剪平面按名字编号——后面的 isVisible 就靠这六个平面判定可见性。

参数本体都带默认值,让「什么参数都不设」的相机也能立刻出图:

// OgreMain/include/OgreFrustum.h:Frustum 成员(v14.6.3 源码摘录,已删减)
    protected:
        /// y-direction field-of-view (default 45)
        Radian mFOVy;
        /// Far clip distance - default 10000
        float mFarDist;
        /// Near clip distance - default 100
        float mNearDist;
        /// x/y viewport ratio - default 1.3333
        Real mAspect;
        /// Ortho height size (world units)
        Real mOrthoHeight;
        /// Off-axis frustum center offset - default (0.0, 0.0)
        Vector2 mFrustumOffset;
        /// Focal length of frustum (for stereo rendering, defaults to 1.0)
        Real mFocalLength;

        /// The 6 main clipping planes
        mutable Plane mFrustumPlanes[6];
参数默认值含义
mFOVy45°y 方向视野角
mFarDist10000远裁剪距离
mNearDist100近裁剪距离
mAspect1.3333宽高比(x/y)
mFrustumOffset(0,0)离轴视锥偏移(立体渲染用)

这些值全部通过 setFOVy/setNearClipDistance/setFarClipDistance/setAspectRatio 修改。注意默认近平面是 100、默认视野 45°——这是引擎「开箱即用」的保守取值,实际游戏都会显式调小 near 来获得更好的深度精度。

相机的派生状态

相机的世界姿势由它在场景图里的位置与朝向决定。OGRE 用「派生(derived)」一词表示「含节点继承与反射矩阵的最终值」:

// OgreMain/include/OgreCamera.h:getDerivedDirection(v14.6.3 源码摘录,已删减)
        /** Gets the derived direction vector of the camera, including any
            rotation inherited from a node attachment and reflection matrix. */
        Vector3 getDerivedDirection(void) const;
        /** Gets the derived up vector of the camera, including any
            rotation inherited from a node attachment and reflection matrix. */
        Vector3 getDerivedUp(void) const;
        /** Gets the derived right vector of the camera, including any
            rotation inherited from a node attachment and reflection matrix. */
        Vector3 getDerivedRight(void) const;

「方向、上、右」三个向量构成相机的正交基。它们不是相机自己存的原始朝向,而是节点旋转 + 反射矩阵叠加后的结果——这保证了相机无论挂在哪层节点下,朝向都对。

相机与视口:谁是观众

一个相机可以被多个视口使用(分屏、镜像),相机记录最后一次使用它的视口:

// OgreMain/include/OgreCamera.h:getViewport/_notifyViewport(v14.6.3 源码摘录,已删减)
        /** Get the last viewport which was attached to this camera. 
        @note This is not guaranteed to be the only viewport which is
            using this camera, just the last once which was created referring
            to it.
        */
        Viewport* getViewport(void) const {return mLastViewport;}
        /** Notifies this camera that a viewport is using it.*/
        void _notifyViewport(Viewport* viewport) {mLastViewport = viewport;}

_notifyViewport 是 _ 开头的内部通知方法——由视口创建/销毁时回调,不对外公开使用。文档注释特意提醒:这只是「最后」关联的视口,不保证唯一。

源码定位

  • OgreMain/include/OgreCamera.h :Camera 类(85-)、Listener(88-107)、mAutoAspectRatio 等成员(118-)、getSceneManager(214-)、getDerivedDirection(422-)、getViewport/_notifyViewport(543-545)
  • OgreMain/include/OgreFrustum.h :ProjectionType 枚举(47-)、FrustumPlane 枚举(58-)、Frustum 类与成员默认值(69-115)、setFOVy(183-)、setNearClipDistance(200-)、setFarClipDistance(226-)、setAspectRatio(240-)

上游引用固定到 OGRE v14.6.3 源码 。

可运行产物:C++ 最小验证

下面复现 Camera/Frustum 骨架。它与 src/02-1-camera-frustum.cpp 逐字节一致:

// file: src/02-1-camera-frustum.cpp
// tier: L1
// verify: clang++ -std=c++20 -I. src/02-1-camera-frustum.cpp -o bin/02-1-camera-frustum && ./bin/02-1-camera-frustum
//
// 复现 Camera/Frustum 骨架(对应 OgreCamera.h 85-、OgreFrustum.h 69-):
//   Camera extends Frustum:Frustum 持有视锥参数(FOVy/near/far/aspect/投影类型,各带默认值);
//   Camera 拥有派生方向(getDerivedDirection)与最后关联的 Viewport(getViewport/_notifyViewport);
//   Viewport 记录使用它的相机(双向关联)。
// 独立最小验证,非 OGRE 源码。
#include "verify.h"

#include <string>

namespace ogre_repro {

// 对应 ProjectionType(OgreFrustum.h 47-,uint8 底层)
enum class ProjectionType : uint8_t { PT_ORTHOGRAPHIC = 0, PT_PERSPECTIVE = 1 };

// 极简三维向量
struct Vec3 {
  float x = 0;
  float y = 0;
  float z = 0;
};

class Camera;  // 前向声明,Viewport 只存指针

// 极简 Viewport:记录使用它的相机
class Viewport {
 public:
  Viewport() : mCamera(nullptr) {}
  void setCamera(Camera* cam) { mCamera = cam; }
  Camera* getCamera() const { return mCamera; }

 private:
  Camera* mCamera;
};

// 对应 Frustum(OgreFrustum.h 69-,extends MovableObject):视锥参数默认值
class Frustum {
 public:
  Frustum()
      : mFovY(45.0f), mNearDist(100.0f), mFarDist(10000.0f),
        mAspect(1.3333f), mProjType(ProjectionType::PT_PERSPECTIVE) {}
  // 对应 setFOVy/getFOVy(OgreFrustum.h 183-)
  void setFovY(float fovy) { mFovY = fovy; }
  float getFovY() const { return mFovY; }
  // 对应 setNearClipDistance/getNearClipDistance(200-204)
  void setNearClipDistance(float d) { mNearDist = d; }
  float getNearClipDistance() const { return mNearDist; }
  // 对应 setFarClipDistance/getFarClipDistance(226-230)
  void setFarClipDistance(float d) { mFarDist = d; }
  float getFarClipDistance() const { return mFarDist; }
  // 对应 setAspectRatio/getAspectRatio(240-)
  void setAspectRatio(float r) { mAspect = r; }
  float getAspectRatio() const { return mAspect; }
  void setProjectionType(ProjectionType t) { mProjType = t; }
  ProjectionType getProjectionType() const { return mProjType; }

 private:
  float mFovY;       // y 方向视野,默认 45 度
  float mNearDist;   // 近裁剪距离,默认 100
  float mFarDist;    // 远裁剪距离,默认 10000
  float mAspect;     // x/y 视口比,默认 1.3333
  ProjectionType mProjType;
};

// 对应 Camera(OgreCamera.h 85-,extends Frustum)
class Camera : public Frustum {
 public:
  explicit Camera(const std::string& name) : mName(name) {}
  const std::string& getName() const { return mName; }
  // 对应 getDerivedDirection(OgreCamera.h 422-):默认朝 -Z
  Vec3 getDerivedDirection() const { return Vec3{0, 0, -1}; }
  // 对应 getViewport/_notifyViewport(OgreCamera.h 543-545)
  Viewport* getViewport() const { return mLastViewport; }
  void notifyViewport(Viewport* vp) {
    mLastViewport = vp;
    if (vp) vp->setCamera(this);
  }

 private:
  std::string mName;
  Viewport* mLastViewport = nullptr;
};

}  // namespace ogre_repro

int main() {
  using namespace ogre_repro;

  // Frustum 默认参数(OgreFrustum.h 73-79)
  Frustum f;
  CHECK(f.getFovY() == 45.0f);
  CHECK(f.getNearClipDistance() == 100.0f);
  CHECK(f.getFarClipDistance() == 10000.0f);
  CHECK(f.getAspectRatio() > 1.333f && f.getAspectRatio() < 1.334f);
  CHECK(f.getProjectionType() == ProjectionType::PT_PERSPECTIVE);
  f.setProjectionType(ProjectionType::PT_ORTHOGRAPHIC);
  CHECK(f.getProjectionType() == ProjectionType::PT_ORTHOGRAPHIC);

  // 视锥参数可改
  f.setNearClipDistance(0.1f);
  f.setFarClipDistance(0.0f);  // 0 = 无限远裁剪
  CHECK(f.getNearClipDistance() == 0.1f);
  CHECK(f.getFarClipDistance() == 0.0f);

  // Camera 继承 Frustum:既是相机也是视锥
  Camera cam("MainCamera");
  cam.setFovY(60.0f);
  cam.setAspectRatio(16.0f / 9.0f);
  CHECK(cam.getFovY() == 60.0f);
  CHECK(cam.getAspectRatio() > 1.777f && cam.getAspectRatio() < 1.778f);
  CHECK(cam.getName() == "MainCamera");
  Vec3 dir = cam.getDerivedDirection();
  CHECK(dir.z == -1.0f);

  // 相机 ↔ 视口双向关联
  Viewport vp;
  cam.notifyViewport(&vp);
  CHECK(cam.getViewport() == &vp);
  CHECK(vp.getCamera() == &cam);
  cam.notifyViewport(nullptr);
  CHECK(cam.getViewport() == nullptr);

  return lab::report("02-1 相机与视锥");
}

本机实测(Apple clang 16,clang++ -std=c++20):编译通过(-Wall 零警告),断言 15/15 通过。

小结

  • Camera : public Frustum——相机就是视锥,投影参数全住基类。
  • ProjectionType(正交/透视)与 FrustumPlane(六面)两个枚举定义视锥形态。
  • Frustum 参数各带默认值:FOVy 45°、near 100、far 10000、aspect 1.3333。
  • 相机派生状态(方向/上/右)含节点继承与反射,是场景图计算的结果。
  • 相机记录「最后」关联的视口,经 _notifyViewport 内部通知。

阅读导航:上一节:1.3 实体相机关联与 LOD · 下一节:2.2 视口 。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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