Interface SceneMeshParams

Free-form bin identifier the SceneMesh belongs to. Frozen after construction.

The scene assigns no semantics to bin on its own — it is a tag the caller stamps on a SceneMesh for downstream consumers to group by. A renderer — were it rendering this scene — is expected to honour the tag as follows:

• Partition the visible SceneMeshes by bin value (a missing or empty bin is treated as the implicit "default" group).
• Process the groups in an order the renderer documents. For example, a renderer may choose to draw the default group first and then any meshes tagged "overlay" after, with the depth buffer cleared between groups so the overlay group reads as "floating" on top of the rest of the scene.
• Honour any per-bin policy the renderer documents (e.g. depth clearing, depth-test enabled / disabled, picking priority).

The tag lives on SceneMesh rather than SceneObject because renderable batching happens at mesh granularity — a SceneMesh can be drawn by a renderer without ever being assigned to a SceneObject, so this is the layer at which bin membership is meaningful. Tools that consume the scene but do not render it — model builders, exporters, format converters, structural inspectors — may use bin as a free-form classification, or ignore it. Loaders and exporters round-trip the value verbatim.

RGB base color of the new SceneMesh.

• Default is [1,1,1].

ID of a SceneGeometry that was created previously with SceneModel.createGeometry or SceneModel.createGeometryCompressed.

ID for the new SceneMesh, unique within the SceneModel.

ID of a SceneMaterial that was created previously with SceneModel.createMaterial.

Optional local 3D transform matrix.

Overrides SceneMeshParams.position, SceneMeshParams.scale, SceneMeshParams.quaternion and SceneMeshParams.rotation.

Opacity of the new SceneMesh.

Default is 1.

Relative-to-center (RTC) origin.

When this is given, then SceneMeshParams.matrix will be relative to this origin.

ID of the parent SceneTransform that was created previously with SceneModel.createTransform.

Optional local 3D translation vector.

Optional local 3D rotation quaternion.

Optional local 3D rotation as Euler angles given in degrees, for each of the X, Y and Z axis.

Optional local 3D scale vector.