Fill Layers

Manages fill layers - solid colour backgrounds that serve as the base coat in a livery.

Overview

ui_liveryEditor_layers_fill handles creation, colour editing, saving/restoring, and data requests for fill layers. Fill layers use a colorPaletteMapId system where 0 means custom colour and non-zero means the vehicle's default paint.

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

Exports (M)

Internals

Color Palette Map ID

• 0 - custom colour (user-editable)
• 1+ - vehicle default paint colour (read from getPlayerVehicle(0).color)

When adding a new fill layer with colorPaletteMapId == 0, the module sets the initial colour to the current vehicle paint colour.

changeColor

M.changeColor = function(color)
  local layer = api.getLayerByUid(M.layerUid)
  if layer.colorPaletteMapId ~= 0 then
    layer.colorPaletteMapId = 0  -- switch to custom
  end
  layer.color = Point4F.fromTable(color)
  api.setLayer(layer, true)
end

How It Works

1. addLayer({color = vehicleObj.color}) creates the base fill with the car's paint
2. changeColor({r, g, b}) sets a custom colour, overriding the palette
3. restoreDefault() reverts to palette ID 1 (vehicle paint)
4. requestLayerData() sends the current colour to the UI for the colour picker

Example Usage

local fill = extensions.ui_liveryEditor_layers_fill

-- Add a white fill layer
local layer = fill.addLayer({ color = {1, 1, 1, 1} })

-- Change to red
fill.setLayer(layer.uid)
fill.changeColor({1, 0, 0, 1})

-- Restore to vehicle default
fill.restoreDefault()

Additional Exports

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

• M.addLayer
• M.layerData
• M.requestLayerData
• M.restoreDefault
• M.restoreLayer
• M.saveChanges
• M.setLayer
• M.updateLayer

See Also

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