API ReferenceGE ExtensionseditortoolUtilities
Editor Tool Utilities – Mesh Audition Manager
Utility for previewing and selecting static meshes (DAE files) with a rotating 3D camera audition view and a searchable list window.
Utility for previewing and selecting static meshes (DAE files) with a rotating 3D camera audition view and a searchable list window.
Public API
| Function | Signature | Description |
|---|---|---|
M.getAvailableStaticMeshes | () → table | Returns array of {path, filename} for available static meshes |
M.populateAvailableStaticMeshes | () | Scans configured folders for .dae files and populates the mesh list |
M.addMeshToAudition | (selectedMeshIdx, callback) | Spawns a mesh at the audition height for preview; calls callback with (auditionMesh, path) |
M.goToMeshView | () | Moves camera to the audition preview position above the mesh |
M.manageRotateCam | () | Rotates the audition camera around the mesh center |
M.goToOldView | () | Returns camera to the position stored before audition began |
M.leaveAuditionView | () | Removes audition mesh, restores camera, and closes the window |
M.removeAuditionMesh | () | Deletes the audition mesh from the scene |
M.updateCameraPose | () | Recalculates camera distance based on current mesh bounding box |
M.registerWindow | () | Registers the mesh selection editor window |
M.handleMeshAuditionAndSelection | (meshTarget, onMeshSelectedFunct) | Renders mesh selection UI with search, folder selection, and auto-rotating preview |
Code Examples
local meshMgr = require('editor/toolUtilities/meshAuditionMgr')
-- Register the mesh selection window at editor init
meshMgr.registerWindow()
-- Populate mesh list from default folders
meshMgr.populateAvailableStaticMeshes()
local meshes = meshMgr.getAvailableStaticMeshes()
log('I', 'mesh', 'Found ' .. #meshes .. ' static meshes')
-- Begin audition of mesh at index 5
meshMgr.addMeshToAudition(5, function(auditionMesh, path)
log('I', 'mesh', 'Auditioning: ' .. path)
end)
-- Each frame, render the selection UI and manage camera rotation
meshMgr.handleMeshAuditionAndSelection('barrier', function(mesh, path)
log('I', 'mesh', 'User selected mesh: ' .. path)
mySpline.meshPath = path
meshMgr.leaveAuditionView()
end)
-- Leave the audition view and restore the old camera pose
meshMgr.leaveAuditionView()See Also
- Tool Utilities - Fit Polyline - Related reference
- Editor Tool Utilities – Geometry - Related reference
- Editor Tool Utilities – Gizmo - Related reference
- World Editor Guide - Guide
Editor Tool Utilities – Material Selection Manager
Utility for selecting materials with image thumbnails and a search bar. Used across road/decal tools to pick terrain or decal materials.
Editor Tool Utilities – Perlin Noise
Classic 2D Perlin noise implementation with a static permutation table for deterministic, repeatable noise generation.