Camera

include/XBase/Camera.h · XBase::Camera

相机模式、输入和恢复快照由 XBase 持有；宿主只切换模式并同步设置，不直接写相机对象。

模式与设置

enum class Mode {
    Disabled,
    Freecam,
    TopDown,
};

struct Settings {
    float freecamFov = 70.0f;
    int freecamSpeed = 1;
    int topDownZoom = 40;
};

bool SetMode(Mode mode);
Mode GetMode();
bool IsActive();
void SetSettings(const Settings& settings);
Settings GetSettings();

SetSettings() 会收敛范围：freecamFov 限制在 10115，freecamSpeed 限制在 110，topDownZoom 限制在 10~100；自由视角激活时立即应用 FOV。

自由视角

• 进入时生成不可见 dummy ped 并挂载相机，保存并关闭 HUD/雷达显示。
• WASD 移动，鼠标控制朝向；Shift 加速，Alt 减速。
• 鼠标滚轮调整移动速度（1~10）；按住 Ctrl 时改为调整 FOV。
• Enter 把玩家传送到当前视角位置的地面。
• 退出时删除 dummy ped，恢复 HUD/雷达与相机 FOV。

俯视相机

• 相机固定在玩家上方，高度由 topDownZoom 决定；玩家进入载具时按速度自动拉远。
• 使用视线检测避免相机穿入建筑。
• 退出时恢复进入前的 LOD 与相机状态。

生命周期

void NotifyGameInit();
void Process();
void Shutdown();

NotifyGameInit() 会把模式复位为 Disabled；Process() 由 Core 领域分发；Shutdown() 恢复相机与 HUD 状态。SetMode() 切换失败时返回 false 并保持原模式。

版本能力

VC/III 只接受 SetMode(Mode::Disabled)，其余模式返回 false；页面应通过 FeatureCapability 禁用入口。