Transform Tool

Transform tool - translate, rotate, scale, skew, and stamp operations for cursor and decal layers.

Overview

ui_liveryEditor_tools_transform is the primary spatial editing tool. It provides translate, rotate, scale, skew, and stamp operations, dispatching to the appropriate handler (cursor, decal, or group) via doOperation.

Extension path: lua/ge/extensions/ui/liveryEditor/tools/transform.lua

Exports (M)

Internals

Stamp Mode

Stamp mode lets the user reposition a placed decal by projecting it through the cursor:

M.useStamp = function()
  local layer = api.getLayerByUid(layerUid)
  -- Copy layer properties to cursor
  api.setDecalRotation(layer.decalRotation)
  api.setDecalScale(layer.decalScale)
  api.setDecalSkew(layer.decalSkew)
  api.setDecalColor(layer.color)
  -- Hide layer (alpha=0), show cursor, enable mouse
  layer.color = Point4F(layer.color.x, layer.color.y, layer.color.z, 0)
  api.setLayer(layer, true)
end

Type-Based Dispatch

Each transform function routes by layer type:

Step Units (internal reference)

TRANSLATE_STEP_UNIT = 0.1
ROTATE_STEP_UNIT    = 1
SCALE_STEP_UNIT     = 0.1
SKEW_STEP_UNIT      = 0.1

Note: These are larger than the cursor/layerEdit step units (designed for the tool slider UI).

How It Works

1. The transform tool is activated via ui_liveryEditor_tools.useTool("transform")
2. Operations dispatch through doOperation to cursor or layer handlers
3. Stamp mode copies layer properties to the cursor for visual repositioning
4. cancelStamp restores the original layer; confirming stamps via editor module
5. Group transforms are stubbed but not yet implemented

Example Usage

local transform = extensions.ui_liveryEditor_tools_transform

-- Enter stamp mode for the selected layer
transform.useStamp()

-- Rotate the active target by 15 degrees clockwise
transform.rotate(15, false)

-- Set absolute scale
transform.setScale(0.5, 0.5)

-- Cancel stamp
transform.cancelStamp()

Additional Exports

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

• M.cancelStamp
• M.rotate
• M.scale
• M.setPosition
• M.setRotation
• M.setScale
• M.setSkew
• M.skew
• M.translate

See Also

• Livery Editor – Tools / Group - Related reference
• Livery Editor – Tools / Material - Related reference
• Livery Editor – Tools / Misc - Related reference
• UI System Guide - Guide