Class BabylonMesh

Joins several meshes into one new mesh, which draws faster than many separate ones.

The sources are removed when disposeSource is true; set allow32BitsIndices when the meshes together have more than 65 thousand vertices, and use the sub-mesh options to keep separate materials.

Gives every triangle of a mesh its own vertices and normals, so faces show as flat facets instead of being smoothed across edges; the mesh is changed in place and given back.

Makes a copy of a mesh, with its children, that shares the geometry of the original and is placed at the same spot; the copy casts and receives shadows like the original.

Makes one copy of a mesh at every given position, in the same order; the copies share the geometry of the original.

Reads the node a mesh is parented to, which is what it moves with; a mesh at the top level has none.

Reads whether a mesh takes part in collision checking.

Sets whether a mesh answers to pointer picking, and its children too when includeChildren is true; an unpickable mesh is skipped by clicks and rays that pick.

Reads whether the mesh can be picked with the pointer.

Finds every mesh in the scene whose name contains the given text, case-sensitive, in scene order.

Lists the meshes parented under a mesh: all descendants, or only the direct children when directDescendantsOnly is true.

Finds every mesh in the scene with exactly the given id; ids need not be unique, so several may match.

Finds the first mesh in the scene with exactly the given id; use getMeshesOfId when several share it.

Finds the mesh with the given unique id, the number the scene assigns to every mesh once, as getUniqueId reads it.

Reads the id of a mesh, the label set by setId or by the loader that created it.

Reads the unique id of a mesh, the number the scene gives every mesh once and never reuses.

Reads the triangles of a mesh as lists of three points in the mesh's own coordinates, the form jscad.shapes.fromPolygonPoints and similar builders take. The mesh must be made of triangles.

Reads the name of a mesh, as set by setName or by whatever created it.

Reads the material of a mesh, the surface description its faces are drawn with.

Reads the position of a mesh relative to its parent, as a point.

Reads the position of a mesh in world coordinates, with every parent's transform applied.

Reads the rotation of a mesh around X, Y and Z, in radians, as its rotation property holds it.

Reads the scale factors of a mesh along X, Y and Z; 1 is unscaled.

Creates a placed instance of a mesh, as createMeshInstanceAndTransform does, without giving it back; for scripts that only need the copy to appear.

Creates an instance of a mesh, a lightweight copy that shares its geometry and draws cheaply, and places it at the given position, rotation in degrees and scaling.

A mesh with children gets one instance per child, gathered under a new container; the original is hidden.

Creates an instance of a mesh, a lightweight copy that shares its geometry and draws cheaply when many alike are needed, placed where the original is.

A mesh with children gets one instance per child, gathered under a new container.

Tells whether two meshes overlap, judged by their bounding boxes: axis-aligned ones by default, or boxes that follow each mesh's rotation when precise is true; includeDescendants tests their children too.

Tells whether a point lies inside the bounding box of a mesh.

Removes a mesh from the scene and frees its GPU resources; the mesh cannot be used afterwards. Nothing happens when no mesh is given.

Moves a mesh along its own forward direction, the local Z axis, by distance scene units; a turned mesh moves the way it faces.

Moves a mesh against its own forward direction, the local Z axis, by distance scene units.

Moves a mesh along its own up direction, the local Y axis, by distance scene units.

Moves a mesh against its own up direction, the local Y axis, by distance scene units.

Moves a mesh along its own right direction, the local X axis, by distance scene units.

Moves a mesh against its own right direction, the local X axis, by distance scene units.

Turns a mesh around its own Y axis by rotate degrees, on top of its current rotation, the way a car turns left or right.

Turns a mesh around its own X axis by rotate degrees, on top of its current rotation, the way a nose tips up or down.

Turns a mesh around its own Z axis by rotate degrees, on top of its current rotation, the way a wing banks.

Turns a mesh by angle degrees around an axis that passes through position, so the mesh orbits that point rather than spinning in place.

Makes one mesh the child of another, so it moves, turns and scales together with its parent from then on; its position becomes relative to the parent.

Turns collision checking on or off for a mesh, and its children when includeChildren is true, so a camera or another collider with collisions enabled cannot pass through it.

Lets a mesh, and its children when includeChildren is true, react to the pointer merely moving over it, which is off by default because it costs a pick on every pointer move.

Stops a mesh, and its children when includeChildren is true, from reacting to pointer moves, back to the default.

Sets the id of a mesh, a label that getMeshOfId finds it by and that need not be unique.

Sets the name of a mesh, and of its children too when includeChildren is true; names are what getMeshesWhereNameContains searches.

Gives a mesh a material, and its children too when includeChildren is true; the material decides the color, shininess and transparency of its surface.

Places a mesh, or an instance of one, at a point relative to its parent.

Sets the rotation of a mesh, or an instance of one, as angles in degrees around X, Y and Z, replacing its current rotation.

Sets the scale factors of a mesh, or an instance of one, along X, Y and Z, replacing its current scale; 1 is unscaled.

Multiplies the current scale of a mesh, or an instance of one, by one factor on all axes, so 2 doubles whatever size it has.

Moves, rotates, scales and recolors a drawn mesh in place, without drawing it again, which is faster when only the placement or the color changes.

rotation is in radians here. colours is one hex color, or a list with one entry per child mesh, or per point or line of such a drawing; any other list uses its first entry.

Sets how visible a mesh is, from 0 for fully transparent to 1 for fully shown, with the values between fading it; includeChildren applies the same value to its child meshes.

Hides a mesh without removing it from the scene, and its child meshes too when includeChildren is true; show brings it back.

Shows a mesh that hide or a hidden draw made invisible, and its child meshes too when includeChildren is true.