Camera Mode: Manual Zoom

Filter camera mode providing manual FOV zoom control via player input (zoom in/out bindings). Displays a UI notification when FOV changes.

Overview

A hidden filter that reads MoveManager.zoomIn / MoveManager.zoomOut inputs and adjusts the camera's field of view accordingly. Used by other camera modes (onboard, relative, etc.) as a composable zoom component via require.

Class Properties

Methods

Usage as Component

-- Other camera modes use manualzoom as a composable filter
local manualzoom = require('core/cameraModes/manualzoom')

function C:init()
  self.manualzoom = manualzoom()
  self.manualzoom:init(self.fov)  -- pass default FOV
end

function C:update(data)
  self.manualzoom:update(data)    -- updates data.res.fov
end

Zoom Calculation

-- FOV delta scales with current FOV for consistent zoom feel
local fovDelta = 4.5 * data.dt * (MoveManager.zoomIn - MoveManager.zoomOut) * self.fov
local fov = clamp(self.fov + fovDelta, self.fovMin, self.fovMax)
data.res.fov = fov

Key Notes

• Disabled during OpenXR/VR sessions (returns immediately)
• FOV change speed scales with current FOV - zoom feels consistent at any level
• Shows ui_message notification when FOV changes by ≥0.1 degrees
• Returns true only when notification was displayed (FOV visibly changed)

See Also

• Camera Mode: Autopoint - Related reference
• Camera Mode: Autozoom - Related reference
• Camera Mode: Big Map - Related reference
• Core Systems Guide - Guide