Dynamic Decals Layer Type: Path
Editor module for the Path layer type. Path layers place decals along a curve defined by control points, with linear or Bézier interpolation. Supports text rendering along paths using font files, orie
Editor module for the Path layer type. Path layers place decals along a curve defined by control points, with linear or Bézier interpolation. Supports text rendering along paths using font files, orientable decals, and gizmo-based control point editing.
Module Info
| Key | Value |
|---|---|
| File | extensions/editor/dynamicDecals/layerTypes/path.lua |
| logTag | editor_dynamicDecals_layerTypes_path |
| Dependencies | editor_api_dynamicDecals, editor_dynamicDecals_helper, editor_dynamicDecals_gizmo, editor_dynamicDecals_inspector, editor_dynamicDecals_inspector_utils, editor_dynamicDecals_fonts, editor_dynamicDecals_docs, editor_dynamicDecals_widgets |
Public API
| Function | Signature | Description |
|---|---|---|
M.registerEditorPreferences | (prefsRegistry) | Stub |
M.editorPreferenceValueChanged | (path, value) | Stub |
M.setup | (tool_in) | Registers "Path Properties" section (priority 80), inspector GUI, toolbar action, and docs |
Section GUI Properties
| Property | Description |
|---|---|
orientDecals | Align decals to follow curve direction |
pathType | Linear (0) or Bézier (1) interpolation |
fontPath | TTF font file for text rendering |
text | Text string (characters replace decal textures) |
interpolationSteps | Number of decals between control points (disabled when text is set) |
Inspector Properties
Full two-column inspector with: uid, name, enabled, type, camPosition, colorPaletteMapId, gradient color, decalScale, decalRotation, orientDecals, pathType, text, fontPath, interpolationSteps, decalUv (flip), decalSkew, mirrored, flipMirroredDecal, colorTextureScale, alphaMask*, SDF*, texture paths, blend mode, textCharacterPositions, and editable dataPoints with gizmo move support.
Toolbar Actions
When a path layer is active:
- Finish path -
api.finishPathLayer() - Remove last point -
api.removeLastPathLayerPoint()
Usage Example
local api = extensions.editor_api_dynamicDecals
-- Configure path properties before placing
api.setPathType(1) -- Bézier
api.setOrientPathDecals(true)
api.setPathLayerText("HELLO")
api.setPathLayerFontPath("/art/fonts/myfont.ttf")See Also
- Dynamic Decals Layer Type: Brush Stroke - Related reference
- Dynamic Decals Layer Type: Decal - Related reference
- Dynamic Decals Layer Type: Fill - Related reference
- World Editor Guide - Guide
Dynamic Decals Layer Type: Linked Set
Editor module for the Linked Set layer type. Linked Sets function like groups but allow adding arbitrary properties that can be bulk-applied to all child layers recursively via an "Apply" button.
Dynamic Decals Layer Type: Texture Fill
Editor module for the Texture Fill layer type. Applies a repeating texture pattern across the entire vehicle surface with configurable scale, offset, color, and palette mapping.