MeshSystem¶

Inherits: SubSystem

Creates meshes, loads models, builds sprites and tilemaps.

Methods¶

Sprite frame rectangles¶

static void setSpriteFrameRect(MeshComponent& mesh, SpriteComponent& sprite, Rect frameRect) applies a frame rectangle to the sprite's first submesh. Both components must belong to the same sprite. This C++ helper is shared by Sprite::setFrame() and sprite animation updates; gameplay code normally uses Sprite.setFrame.

Rectangles with all four values in [0, 1] are treated as UVs. Other rectangles are converted from pixels using the texture dimensions. If dimensions are not yet available, the helper stores one pending rectangle on the sprite for mesh updates to retry. Subsequent calls replace that request; requests are not queued. Frame selection also works before the sprite geometry has been built.

Static model hierarchy¶

bool canMergeStaticModel(const ModelComponent& model, std::string* reason = nullptr) const reports whether a loaded GLTF can flatten its mesh nodes into the root entity (ModelComponent::mergeStaticMeshes). Returns false with an optional reason for skinned, animated, morph-target, or single-node models, and when the flatten would exceed the root submesh limit. Animated models and models with more than one skin import a full node tree rather than mesh children only — see 3D Graphics — GLTF node hierarchy and Merging static model meshes.

bool canEditModelHierarchy(const ModelComponent& model, std::string* reason = nullptr) const reports whether the model's child mesh entities may be reparented at all. Returns false with an optional reason while the model is still loading and when it has no separate mesh parts (a single mesh or a merged model).

bool canEditModelPart(const ModelComponent& model, Entity part, std::string* reason = nullptr) const reports whether one part — or a plain entity grouping parts — may leave the place the file gave it. Returns false with the reason for joints, parts with joints below them, parts with their own translation, rotation, or scale keyframes, and rigid (unskinned) parts whose glTF ancestry contains an animated node. Skinned parts always pass, since their placement comes from the joints. The editor uses both methods to decide which parts can be rearranged in the Structure panel.

std::map<int, Entity> getModelNodeDefaultParents(Entity modelEntity, const ModelComponent& model) const maps each glTF node index to the entity the file parents that node under: its parent node's entity on the full node-tree path, or the model entity itself on the child-mesh path. bool hasCustomMeshParenting(Entity modelEntity, const ModelComponent& model) const is true when any mesh part sits under a different parent than that.

Asynchronous model-load control¶

These C++-only methods inspect or stop model loads started by the asynchronous resource pipeline:

Cancellation is synchronous: if a worker is already decoding a model, the cancellation method waits for that task to finish, removes its pending result, and marks its resource build as failed before returning. This guarantees that the worker cannot outlive scene, project, or resource-pool teardown.