Livery Editor – Layers

Manages the UI-side layer data model - parsing, caching, and notifying the UI of layer stack changes.

Overview

ui_liveryEditor_layers transforms the raw API layer stack into a UI-friendly format with order indices, parent references, paths, and visibility flags. It maintains a layerMap keyed by UID for fast lookup and fires guihooks when layers change.

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

Exports (M)

Data Fields

Hook Listener Exports

Internals

UI Layer Format

Each layer is transformed into:

{
  uid = "...",
  id = "...",
  name = "Layer Name",
  type = "decal",         -- decal, fill, linkedSet
  enabled = true,
  locked = false,
  order = 3,              -- 1-based index within parent
  parentUid = "...",      -- nil for root layers
  path = {"uid1", "uid2"},           -- ancestry chain
  pathIndices = {1, 3},              -- index ancestry chain
  siblingCount = 5,
  childrenCount = 0,
  hidden = false,         -- true for non-decal/non-linkedSet types
  -- type-specific fields:
  preview = "texture/path",  -- decal
  rotation = 45.0,           -- decal (degrees)
  color = {r, g, b, a},     -- decal/fill
  mirrored = false,          -- decal
  scale = {x, y},            -- decal
  skew = {x, y},             -- decal
  colorPaletteMapId = 0,     -- fill
}

Layer Map

M.layerMap[uid] stores {order, parentUid, layer, hidden} for O(1) lookups.

Layer Ordering

Layers are inserted in reverse order (table.insert(uiLayers, 1, uiLayer)) so the UI displays top-to-bottom matching the visual stacking order.

Hook Listeners

How It Works

1. Any layer mutation triggers rebuildLayerData()
2. The full API layer stack is recursively parsed into UI format
3. layerMap is rebuilt for fast UID lookups
4. liveryEditor_OnLayersUpdated and liveryEditor_Layers_OnVisibleCountChanged are triggered to the UI

Additional Exports

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

• M.dynamicDecals_moveLayer
• M.dynamicDecals_onLayerAdded
• M.dynamicDecals_onLayerDeleted
• M.dynamicDecals_onLayerUpdated
• M.getChildrenCount
• M.getLayerByOrder
• M.getLayerByUid
• M.getLayers
• M.getVisibleLayersCount
• M.parseLayersData
• M.rebuildLayerData
• M.requestInitialData