Livery Editor – Resources

Loads and categorises decal textures from the dynamic decals texture registry for the UI resource browser.

Overview

ui_liveryEditor_resources reads tagged texture files from editor_api_dynamicDecals_textures, organises them into categories, and provides query functions for the UI's decal picker.

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

Dependencies

editor_api_dynamicDecals_textures

Exports (M)

Data Fields

Data Fields

Internals

Texture Category Format

{
  value = "flames",        -- tag name / category id
  label = "flames",        -- display label
  items = {
    {
      name = "flame01.png",
      label = "flame01.png",
      value = "flame01.png",
      preview = "/art/dynamicDecals/flames/flame01.png"
    },
    ...
  }
}

Setup Flow

1. Calls texturesApi.setup() to initialise the texture file scanner
2. Gets all tag-to-file mappings via texturesApi.getTagsWithRefs()
3. Parses into the categorised format above
4. Scans for untagged textures via texturesApi.getTextureFiles() + readSidecarFile()
5. Untagged textures go into an "Others" category

Stub Hooks

dynamicDecals_onTextureFileAdded and dynamicDecals_onTextureFileDeleted are defined but empty - reserved for future hot-reload support.

How It Works

1. On setup(), all decal texture files are scanned and grouped by their sidecar tags
2. Textures without tags are collected into an "Others" bucket
3. The UI calls requestData() or getTextureCategories() to populate the decal picker
4. Categories are sorted alphabetically for consistent display

Example Usage

local resources = extensions.ui_liveryEditor_resources

-- After setup, get all categories
local categories = resources.getTextureCategories()
for _, cat in ipairs(categories) do
  print(cat.label, #cat.items .. " textures")
end

-- Get textures in a specific category
local flames = resources.getTexturesByCategory("flames")

Additional Exports

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

• M.dynamicDecals_onTextureFileAdded
• M.dynamicDecals_onTextureFileDeleted
• M.getCategories
• M.getDecalTextures
• M.getTextureCategories
• M.getTexturesByCategory
• M.requestData
• M.setup