MeshManager is responsible for loading, attaching, and destroying meshes for entities. It supports different mesh sources (mesh://, gfx://, file://, http://, https://) and manages the lifecycle of SceneObjects and SceneMeshes. It also handles input events for meshes and forwards them to the data model.

Example usage:

// Register a custom mesh creator
meshManager.meshCreators["mesh://custom"] = { entity ->
    // Create and return a custom SceneMesh for the entity
    SceneMesh.box(
        -0.5f, -0.5f, -0.5f,
        0.5f, 0.5f, 0.5f,
        material.generateSceneMaterial(entity, context)
    )
}
// Set a mesh for an entity using a URI
meshManager.setMeshForEntity(
    entity,
    Uri.parse("models/cube.glb"),
    Uri.parse("file:///data/data/com.example.app/files/models/cube.glb"),
    "",  // default shader override
    -1,  // default scene override
    true // use cache
)
// Set a mesh directly for an entity
meshManager.setMeshForEntityDirectly(entity, sceneMesh)

Signature

class MeshManager(val scene: Scene, val meshCreators: HashMap<String, (ent: Entity) -> SceneMesh>, val sceneObjectSystem: SceneObjectSystem)

Constructors

MeshManager ( scene , meshCreators , sceneObjectSystem )

Signature

constructor(scene: Scene, meshCreators: HashMap<String, (ent: Entity) -> SceneMesh>, sceneObjectSystem: SceneObjectSystem)

Parameters

scene: Scene The Scene instance used for rendering

meshCreators: HashMap Map of URI schemes to mesh creator functions

sceneObjectSystem: SceneObjectSystem System for managing SceneObjects

Returns

MeshManager

Properties

meshCreators : HashMap [Get]	Map of URI schemes to mesh creator functions Signature val meshCreators: HashMap<String, (ent: Entity) -> SceneMesh>
scene : Scene [Get]	The Scene instance used for rendering Signature val scene: Scene
sceneObjectSystem : SceneObjectSystem [Get]	System for managing SceneObjects Signature val sceneObjectSystem: SceneObjectSystem

Methods

deleteMeshForEntity ( entity )	This method removes the SceneObject associated with the entity and destroys any meshes that were created for it. Signature fun deleteMeshForEntity(entity: Entity) Parameters `entity: Entity` The entity to remove the mesh from
destroy ()	Signature fun destroy()
preloadMesh ( meshSimpleUri , meshFullPathUri , defaultShaderOverride , defaultSceneOverride , useCache )	Preloads a mesh without attaching it to any entity for faster loading later. This method loads and caches a mesh from the specified URI so that when it's later attached to an entity, it will be available immediately. It supports the same URI schemes as setMeshForEntity: file:// - Loads a mesh from a local file http://, https:// - Loads a mesh from a network location apk:// - Loads a mesh from the APK assets Note: mesh:// and gfx:// schemes are not supported for preloading as they require entity-specific context. Signature fun preloadMesh(meshSimpleUri: Uri, meshFullPathUri: Uri, defaultShaderOverride: String, defaultSceneOverride: Int, useCache: Boolean = true) Parameters `meshSimpleUri: Uri` A simple URI used for identification and caching `meshFullPathUri: Uri` The full URI path to the mesh resource `defaultShaderOverride: String` Optional shader override to use when loading the mesh `defaultSceneOverride: Int` Optional scene index override to use when loading the mesh `useCache: Boolean` Whether to use cached meshes (default: true)
retrieveAssociatedMeshFilesForEntity ( entity )	Parameters `entity: Entity` Returns `Array?`
setMeshForEntity ( entity , meshSimpleUri , meshFullPathUri , defaultShaderOverride , defaultSceneOverride , useCache )	Attaches a mesh to an Entity based on the provided URIs. Avoid using this method directly and instead assign the Mesh component the Entity. This method loads a mesh from the specified URI and attaches it to the entity. It supports different URI schemes: mesh:// - Uses a registered mesh creator function gfx:// - Loads a mesh from the GFX system file:// - Loads a mesh from a local file http://, https:// - Loads a mesh from a network location Any previous mesh attached to the entity will be destroyed. Signature fun setMeshForEntity(entity: Entity, meshSimpleUri: Uri, meshFullPathUri: Uri, defaultShaderOverride: String, defaultSceneOverride: Int, useCache: Boolean = true) Parameters `entity: Entity` The entity to attach the mesh to `meshSimpleUri: Uri` A simple URI used for identification and caching `meshFullPathUri: Uri` The full URI path to the mesh resource `defaultShaderOverride: String` Optional shader override to use when loading the mesh `defaultSceneOverride: Int` Optional scene index override to use when loading the mesh `useCache: Boolean` Whether to use cached meshes (default: true)
setMeshForEntityDirectly ( entity , mesh )	Attaches a mesh directly to an Entity, bypassing the data model. Should use the Mesh component instead. This method should be used sparingly as it is not reflected by the data model. It's intended as an escape hatch when the mesh creators don't fit well with the standard workflow. Any previous mesh attached to the entity will be destroyed. Signature fun setMeshForEntityDirectly(entity: Entity, mesh: SceneMesh) Parameters `entity: Entity` The entity to attach the mesh to `mesh: SceneMesh` The SceneMesh to attach