MeshData

class Communicator.MeshData()

Object which represents geometry data which will be inserted into the scene at run time. For performance reasons, it is not recommended to create meshes with large amounts of data on the client side as certain optimizations are not available to geometry inserted this way.

More information can be found here.

Methods

addFaces()
addPoints()
addPolyline()
clear()
getBackfacesEnabled()
getFaceWinding()
isManifold()
setBackfacesEnabled()
setFaceWinding()
setManifold()

Methods

addFaces

Communicator.MeshData.addFaces(vertexData, normalData, rgba32data, uvs, bits)

Adds face data to the mesh. Note that the arrays passed into this function are not copied and should remain unchanged until the mesh has been created. When adding vertex data into the mesh using this method, it is important to note that the data is interpreted as triangles in which each vertex must be explicitly enumerated.

Arguments

vertexData ({ }()) – floating point data describing the points in space for the faces to be added to the mesh
normalData ({ }()) – normals for the corresponding vertex data points.
rgba32data ({ }()) – colors for the corresponding vertex data points (four bytes per rbga).
uvs ({ }()) – texture parameters for the corresponding vertex data points.
bits ({ }()) – bitmask associated with the face.

Return type

void

addPoints

Communicator.MeshData.addPoints(pointData, rgba32data, bits)

Adds point data to the mesh. Note that the arrays passed into this function are not copied and should remain unchanged until the mesh has been created.

Arguments

pointData ({ }()) – floating point data describing the points to be added to the mesh
rgba32data ({ }()) – colors for the corresponding vertex data points (four bytes per rbga).
bits ({ }()) – bitmask associated with the point.

Return type

void

addPolyline

Communicator.MeshData.addPolyline(polylineData, rgba32data, bits)

Adds polyline data to the mesh.Note that the arrays passed into this function are not copied and should remain unchanged until the mesh has been created.

Arguments

polylineData ({ }()) – floating point data describing the polyline to be added to the mesh
rgba32data ({ }()) – colors for the corresponding vertex data points (four bytes per rbga).
bits ({ }()) – bitmask associated with the line.

Return type

void

clear

Communicator.MeshData.clear()

Removes all data from the object.

Return type: void

getBackfacesEnabled

Communicator.MeshData.getBackfacesEnabled()

Gets whether backfaces are enabled for this geometry

Return type: boolean
Returns: value indicting whether backfaces are enabled for this geometry.

getFaceWinding

Communicator.MeshData.getFaceWinding()

Gets the face winding used for this mesh.

Return type: Communicator.FaceWinding

isManifold

Communicator.MeshData.isManifold()

Gets if the mesh is set as manifold.

Return type: boolean
Returns: value indicating whether or not it’s a manifold mesh.

setBackfacesEnabled

Communicator.MeshData.setBackfacesEnabled(backfacesEnabled)

Sets whether backfaces should be enabled for this geometry. The default value is false. Setting this to true for geometry with a large amount of faces may affect performance.

Arguments

backfacesEnabled (boolean()) – indicated whether backfaces should be enabled for this geometry.

Return type

void

setFaceWinding

Communicator.MeshData.setFaceWinding(faceWinding)

Sets the face winding to be used for this mesh. The default value is CounterClockwise.

Arguments

faceWinding (Communicator.FaceWinding()) – the face winding to use for mesh geometry.

Return type

void

setManifold

Communicator.MeshData.setManifold(isManifold)

Sets whether the mesh is a manifold one or not (if the mesh is not set as manifold, then capping won’t happen while cutting).

Arguments

isManifold (boolean()) – indicated whether or not it’s a manifold mesh.

Return type

void