Resource API Docs

Meshes Resource API

Resource API Index

Purpose

Mesh helpers load, reserve, and drop mesh sources, including glTF/glb sub-assets by mesh index.

Meshes Resource API explains behavior, constraints, and practical usage so implementation decisions stay consistent across scripts and scenes.

API Source

Functions

mesh_load!mesh_reserve!mesh_drop!

Enums

// not documented yet for this module

Constants

glTF sub-asset suffix :mesh[index]

Types

ResourceWindowMeshIDScriptContext

Usage Pattern

let mesh = mesh_load!(res, "res://models/hero.glb:mesh[0]");let kept = mesh_reserve!(res, "res://models/tree.glb:mesh[1]");

Key Details

Repeated source loads return the same MeshID.

GPU upload happens asynchronously.

Use reserve for repeated complex meshes to avoid drop/recreate churn.

glTF sub-assets use :mesh[index] suffixes.