Camera Reference
Module defined in `lua/common/jbeam/sections/camera.lua`. Processes camera definitions from JBeam data, handling onboard, relative, and onboard2 camera types with retrocompatibility upgrades.
Module defined in lua/common/jbeam/sections/camera.lua. Processes camera definitions from JBeam data, handling onboard, relative, and onboard2 camera types with retrocompatibility upgrades.
Exports
Functions
M.process(objID, vehicle)
Processes the cameras section of vehicle data. Handles retrocompatibility upgrades (old camera names → new), processes onboard cameras (resolving node positions, applying node transforms), relative cameras, and onboard2 cameras. Cleans camera data to minimize message size.
- Parameters:
objID- number - Vehicle object IDvehicle- table - Assembled vehicle data withcamerassection
- Returns:
self(module table, for chaining)
Internal Notes
- Only runs on game engine side (
vmType == 'game'). - Camera data cleanup removes:
group,firstGroup,partPath,childParts,partName,slotType,collision,selfCollision,nodeWeight, beam properties,cid, skin fields. - Processes three camera subtypes:
processOnboard(cockpit cameras with node-based positioning),processRelative(chase cameras),processOnboard2(newer onboard format). - Uses
jbeamUtils.getPosAfterNodeRotateOffsetMovefor node transform application. - Retrocompatibility: auto-upgrades old camera section names to current format via
upgradeCamera.
See Also
- Assorted Reference - Related reference
- Colors Reference - Related reference
- Events Reference - Related reference
- Common Libraries Overview - Guide
Assorted Reference
Module defined in `lua/common/jbeam/sections/assorted.lua`. Post-processes miscellaneous vehicle sections: engine water damage node groups and soundscape table restructuring.
Colors Reference
Module defined in `lua/common/jbeam/sections/colors.lua`. Applies vehicle color configuration from legacy color format to the 3D vehicle object.