Parameters

name

The name of the polygon mesh

Upcasts an element to a specific element type. If this element is not of the given type then undefined is returned. If type_name does not have a matching element implementation an error is thrown. Note that this is not strictly an upcast but will return a new instance of the specific class representing type_name.

Parameters

type_name

the element type name to convert to.

Returns

the specific Element implementation for this element.

Commits any changes made to the mesh. This will overwrite the current mesh in the database with the modified version. Please note that no validation is performed on the mesh data. Additionally note that the original mesh data is shadowed in the database and not deleted. If you wish to ensure the old data is removed you should create a new mesh with a different name using the static create method and then remove the original mesh by calling its delete method.

Make a copy of this element in the database.

Parameters

name

The name of the new element to copy to.

privacy_level

The privacy level to which the element will be copied. Defaults to the privacy level of the current scope.

Returns

copied element

Creates a scene element called name. Throws on error.

Parameters

element_type

the type of element to create

privacy_level

The privacy level to create the element at. Defaults to the privacy level of the current scope.

Creates a new Polygon_mesh.

Parameters

name

the name of the polygon mesh to create

mesh

polygon mesh data used to create the mesh. See generate_mesh command for details

visible

if true will set the visible attribute on the generated mesh. Defaults to true

Returns

the generated mesh scene element

Remove this element from the database.

Returns whether the element exists or not.

Parameters

element_type

if provided then the element must also be of this type.

Localizes this element.

Parameters

privacy_level

The privacy level to which the element will be localized. Defaults to the privacy level of the current scope.

Retrieves and caches a property of an element. The value of the property must be retrievable via a command that takes a single argument which is the name of the element to retrieve the property from. The name of this Element is used. If the returned property is another named scene Element then the element's constructor can be provided to return the element itself rather than it's name. On error this will return undefined.

Parameters

cache

name of the property to cache the result to

command

name of the RS command to get the property value

element_name_arg

name of the command argument to use for the element name

as_a

if the property being retrieved is an RS Element then the element constructor should be passed in here. The result of the command is assumed to be the element name and this is used to create an Element instance to return rather than the name of the element. Use undefined if the retrieved value is not an element.

Returns

the property value if it exists or undefined

Sets and caches a property of an element. The value of the property must be set via a command that takes two arguments, one being the name of the element to set and the other being the property's value. The names of these arguments are passed in. If the property is another named scene Element then the element's constructor can be provided and value can either be the element itself or it's name. Will throw on error.

Parameters

cache

name of the property to cache the result to

command

name of the RS command to set the property value

element_name_arg

name of the command argument to use for the element name

value_arg_name

name of the value argument to use for the value

value

the value to set

from_a

if the property being set is a RealityServer Element then the element constructor should be passed in here. value can then either be the name of the scene element or the Element itself. If value is a name then an Element is constructed and cache rather than the name itself. Use undefined if the value does not represent an Element .

Sets the material and, optionally, material override on this element.

Parameters

material

the material to set, see Element_scene_graph.material

override

if defined then sets override on the material, see Element_scene_graph.material_override

The attributes associated with this element.

The array of the number of corner points in each polygon.

Set to true to disable the element and all elements below this in the scene graph. Set to false to show again or undefined to remove the disable attribute completely.

Returns whether the polygon mesh exists or not. This test is type checked.

Alias for disable.

The array of values representing whether a given polygon is a hole. If a polygon is a hole it must be specified immediately after the non-hole polygon into which it is cut. A value of 0 indicates a non-hole polygon and 1 indicates a hole polygon.

The material to use for this element. When setting can supply either a String giving the name of the material to use or a Mdl_material_instance . Arrays of these can also be used. Note that single values will always be converted to arrays when setting. Getting always returns an array of Mdl_material_instance .

The array of material_ids for each polygon.

The override attribute for the material. Accepts the strings override or standard as valid values. Truthy non-string values will be interpreted as override, otherwise standard.

The maximum displacement allowed on an object.

The actual mesh data in a binary representation retrieved on demand.

The name of the element. Read only.

The array of normal_indices which specify the normals to be used for each vertex of a polygon. This is a flat array and must be combined with the corners information to divide it into polygons. Random access is possible by using the offsets property to determine where a polygon starts and the corners property to determine its extent

The array of normal point values used by the mesh.

The array of offsets of the start point of each polygon in the index arrays.

The array of point_indices which specify the points to be used for each vertex of a polygon. This is a flat array and must be combined with the corners information to divide it into polygons. Random access is possible by using the offsets property to determine where a polygon starts and the corners property to determine its extent

Returns the array of position point values used by the mesh.

Whether or not the mesh should utilise the material_ids property to apply different materials to each polygon. If true then the material_ids property must also be present

The type name of the element. If the element does not exists returns undefined. Read only.

The array of Float32Array items each of which represent the user data values for a given named user data set.

The array of Uint32Array items which specify the user data to be used for each vertex of a triangle. This is a flat array, random access is possible by using the fact that all triangles always have three vertices

The array of string items which specify the names of the each user data set.

The array of number items which specify the size of the vectors used by the user data.

The array of Uint32Array items which specify the UVs to be used for each vertex of a polygon. This is a flat array and must be combined with the corners information to divide it into polygons. Random access is possible by using the offsets property to determine where a polygon starts and the corners property to determine its extent

The array of number items which specify the size of the vectors used by the texture space.

The array of Float32Array items each of which represent the UV values for a given texture coordinate space.