Skip to content

Scene.findAllByName

Summary

Scene.findAllByName returns all meshes whose name exactly matches the given string. This is useful when one logical label maps to multiple mesh instances. The returned array may be empty.

Syntax

Scene.findAllByName(name: string): Mesh[]
const meshes = scene.findAllByName(name);

Parameters

Name Type Required Description
name string Yes Exact mesh name to match.

Returns

Mesh[] - Array of matching meshes (possibly empty).

Type Details

// No additional descriptor expansion is required for this signature.

Example

const canvas = document.querySelector("canvas");
const wgpu = await WasmGPU.create(canvas);

const scene = wgpu.createScene();
for (let i = 0; i < 3; i++) {
    const m = wgpu.createMesh(wgpu.geometry.box(1, 1, 1), wgpu.material.unlit({ color: [0.8, 0.6, 0.2] }));
    m.name = "cell";
    scene.add(m);
}
console.log(scene.findAllByName("cell").length);

See Also