Action Map Management

Action map management for the livery editor - handles input mode switching between transform, rotate, scale, and stamp modes.

Overview

ui_liveryEditor_controls manages input action maps for different livery editing modes. It switches between cursor-based and mouse-projection-based input and provides toggles for vehicle and edit-mode action maps.

Extension path: lua/ge/extensions/ui/liveryEditor/controls.lua

Exports (M)

Constants

Internals

Action Map Registry

local ACTION_MAPS = {
  rotate = "LiveryEditorRotate",
  scale = "LiveryEditorScale",
  skew = "LiveryEditorSkew",
  transform = "LiveryEditorTransform",
  transformStamp = "LiveryEditorTransformStamp",
  material = "LiveryEditorMaterial"
}

Mode Switching

useActionMap disables all action maps first, then activates the requested one. If the API is in mouse-position mode, transform is automatically upgraded to transformStamp:

M.useActionMap = function(actionMapKey)
  disableAllActionMaps()
  actionMapKey = actionMapKey == "transform" and api.isUseMousePos() and "transformStamp" or actionMapKey
  local actionMap = ACTION_MAPS[actionMapKey]
  if actionMap then
    pushActionMap(actionMap)
  end
end

Input Modes

Vehicle Control Override

During editing, vehicle controls are disabled to prevent accidental input:

M.enableVehicleControls = function(enable)
  scenetree.findObject("VehicleCommonActionMap"):setEnabled(enable)
  scenetree.findObject("VehicleSpecificActionMap"):setEnabled(enable)
end

How It Works

1. Livery editor starts → disableAllActionMaps() clears input state
2. Edit mode activates → useActionMap("transform") pushes appropriate map
3. User toggles mouse projection → liveryEditor_OnUseMousePosChanged switches mode
4. Mode change auto-selects transform vs transformStamp action map
5. On deactivation, all livery action maps are popped and vehicle controls restored

Additional Exports

The following exports are available but not yet documented in detail:

• M.dependencies
• M.disableAllActionMaps
• M.editAsController
• M.liveryEditor_OnUseMousePosChanged
• M.toggleEditActionMaps
• M.toggleUseMousePos
• M.useCursorProjection
• M.useMouseProjection

See Also

• Livery Editor - Camera - Related reference
• Livery Editor - Edit Mode - Related reference
• Livery Editor – Editor (Core) - Related reference
• UI System Guide - Guide