Camera Path Editor

Editor tool for creating and editing camera paths with spline interpolation. Supports marker-based keyframes, replay linking, vehicle tracking, frustum visualization, camera preview, and overlay guides.

---

Public Functions

---

Key Features

• Spline Paths - Camera paths defined by time-stamped marker keyframes
• Replay Linking - Synchronize camera paths with vehicle replays
• Vehicle Tracking - Track vehicle center with configurable XYZ offset
• Frustum Visualization - 3D camera frustum cones at each marker
• Camera Preview - Real-time preview window with configurable aspect ratio
• Overlay Modes - Rule of thirds, 16
  , 9
  composition guides
• Cut Support - Markers can be flagged as cuts (instant camera jumps)
• LOD Spline Resolution - Adaptive spline detail based on camera distance

---

Dependencies

• M.dependencies = { 'core_camera' }

Overlay Modes

---

Marker Data

Each camera path marker contains:

• Position and rotation (quaternion)
• Time stamp (seconds from start)
• FOV (field of view)
• Cut flag (instant jump vs smooth interpolation)
• Optional tracking target

---

Spline Resolution by Distance

---

Module Variables

• currentPath (table|nil) - The currently selected camera path object.
• dependencies (table) - { 'core_camera' }

Functions

onExtensionLoaded()

Callback for extension loaded event.

onEditorInitialized()

Registers the camera path edit mode, tool windows, and keyboard shortcuts.

onEditorGui()

Main per-frame UI rendering, 3D marker visualization, spline drawing, and input handling.

onClientStartMission()

Resets the selected path to nil on mission start.

onPreRender()

Updates aspect ratio and draws camera overlay guides.

onUpdate(dtReal, dtSim, dtRaw)

Per-frame update callback (currently unused, reserved for future use).

• dtReal (number)
• dtSim (number)
• dtRaw (number)

selectPath(path)

Selects a camera path and loads its associated replay if available.

• path (table|nil) - Camera path object (from core_paths), or nil to deselect

getTrackingOffset()

Returns the vehicle tracking offset table if any offset is non-zero.

Returns: table|nil - {x, y, z} offset or nil if all zero

Additional Exports

• M.getTrackingOffset
• M.onClientStartMission
• M.onExtensionLoaded
• M.onPreRender
• M.onUpdate
• M.selectPath

---

See Also

• cameraBookmarks - Quick camera position bookmarks
• cameraTransform - Camera transform copy/paste