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];
| 参数 | 默认值 | 含义 |
|---|---|---|
mFOVy | 45° | y 方向视野角 |
mFarDist | 10000 | 远裁剪距离 |
mNearDist | 100 | 近裁剪距离 |
mAspect | 1.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 视口 。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。