Decal Operations

Provides per-layer decal operations - querying actions, adding decals, and reading formatted layer data for the cursor/decal UI.

Overview

ui_liveryEditor_layers_decal manages individual decal layer interactions. It defines the available actions for a decal layer, provides a centred-add helper, and formats layer data for the cursor UI display.

Extension path: lua/ge/extensions/ui/liveryEditor/layers/decal.lua

Exports (M)

Internals

Action Menu

The available actions for a single decal layer:

Add Layer Flow

M.addLayer = function(params)
  resetCursor()  -- centre, white, default scale
  api.setDecalColor(color)
  api.setDecalTexturePath("color", params.texturePath)
  return api.addDecal()
end

addLayerCentered temporarily switches to cursor mode (non-mouse) to ensure the decal is placed at (0.5, 0.5), then resets and hides the cursor.

How It Works

1. setLayer(uid) sets the active layer for the module
2. getLayerActions(uid) builds an actions array; the "enabled" action includes the current state
3. addLayer resets the cursor to defaults, applies params, and stamps via api.addDecal()
4. addLayerCentered forces cursor mode to guarantee centre placement

Example Usage

local decalLayer = extensions.ui_liveryEditor_layers_decal

-- Add a new decal at centre
local layer = decalLayer.addLayerCentered({
  texturePath = "/art/decals/stripe.png",
  color = {1, 1, 1, 1}
})

-- Get actions for context menu
local actions = decalLayer.getLayerActions(layer.uid)

Additional Exports

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

• M.addLayerCentered
• M.getLayerActions
• M.layerUid
• M.setLayer
• M.updateLayer

See Also

• Livery Editor – Layers / Cursor - Related reference
• Livery Editor – Layers / Decals - Related reference
• Livery Editor – Layers / Fill - Related reference
• UI System Guide - Guide