2017-09-12 22:42:36 +02:00
<?xml version="1.0" encoding="UTF-8" ?>
2019-04-01 12:33:56 +02:00
<class name= "MeshDataTool" inherits= "Reference" category= "Core" version= "3.2" >
2017-09-12 22:42:36 +02:00
<brief_description >
2018-10-11 06:28:04 +02:00
Helper tool to access and edit [Mesh] data.
2017-09-12 22:42:36 +02:00
</brief_description>
<description >
2018-10-11 06:28:04 +02:00
The MeshDataTool provides access to individual vertices in a [Mesh]. It allows users to read and edit vertex data of meshes. It also creates an array of faces and edges.
To use the MeshDataTool, load a mesh with [method create_from_surface]. When you are finished editing the data commit the data to a mesh with [method commit_to_surface].
Below is an example of how the MeshDataTool may be used.
[codeblock]
var mdt = MeshDataTool.new()
mdt.create_from_surface(mesh, 0)
for i in range(mdt.get_vertex_count()):
2018-12-14 09:37:19 +01:00
var vertex = mdt.get_vertex(i)
...
mdt.set_vertex(i, vertex)
2018-10-11 06:28:04 +02:00
mesh.surface_remove(0)
mdt.commit_to_surface(mesh)
[/codeblock]
2017-09-12 22:42:36 +02:00
</description>
<tutorials >
</tutorials>
<methods >
<method name= "clear" >
<return type= "void" >
</return>
<description >
2018-10-11 06:28:04 +02:00
Clears all data currently in MeshDataTool.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "commit_to_surface" >
<return type= "int" enum= "Error" >
</return>
<argument index= "0" name= "mesh" type= "ArrayMesh" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Adds a new surface to specified [Mesh] with edited data.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "create_from_surface" >
<return type= "int" enum= "Error" >
</return>
<argument index= "0" name= "mesh" type= "ArrayMesh" >
</argument>
<argument index= "1" name= "surface" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Uses specified surface of given [Mesh] to populate data for MeshDataTool.
2019-06-27 12:34:26 +02:00
Requires [Mesh] with primitive type [constant Mesh.PRIMITIVE_TRIANGLES].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_edge_count" qualifiers= "const" >
<return type= "int" >
</return>
<description >
2018-10-11 06:28:04 +02:00
Returns the number of edges in this [Mesh].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_edge_faces" qualifiers= "const" >
<return type= "PoolIntArray" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns array of faces that touch given edge.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_edge_meta" qualifiers= "const" >
<return type= "Variant" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns meta information assigned to given edge.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_edge_vertex" qualifiers= "const" >
<return type= "int" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "vertex" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns index of specified vertex connected to given edge.
Vertex argument can only be 0 or 1 because edges are comprised of two vertices.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_face_count" qualifiers= "const" >
<return type= "int" >
</return>
<description >
2018-10-11 06:28:04 +02:00
Returns the number of faces in this [Mesh].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_face_edge" qualifiers= "const" >
<return type= "int" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "edge" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns specified edge associated with given face.
2018-11-04 22:15:11 +01:00
Edge argument must 2 or less because a face only has three edges.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_face_meta" qualifiers= "const" >
<return type= "Variant" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns meta data associated with given face.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_face_normal" qualifiers= "const" >
<return type= "Vector3" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Calculates and returns face normal of given face.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_face_vertex" qualifiers= "const" >
<return type= "int" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "vertex" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns specified vertex of given face.
2018-11-04 22:15:11 +01:00
Vertex argument must be 2 or less because faces contain three vertices.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_format" qualifiers= "const" >
<return type= "int" >
</return>
<description >
2019-06-27 12:34:26 +02:00
Returns format of [Mesh]. Format is an integer made up of [Mesh] format flags combined together. For example, a mesh containing both vertices and normals would return a format of [code]3[/code] because [constant ArrayMesh.ARRAY_FORMAT_VERTEX] is [code]1[/code] and [constant ArrayMesh.ARRAY_FORMAT_NORMAL] is [code]2[/code].
For list of format flags see [enum ArrayMesh.ArrayFormat].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_material" qualifiers= "const" >
<return type= "Material" >
</return>
<description >
2018-10-11 06:28:04 +02:00
Returns material assigned to the [Mesh].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex" qualifiers= "const" >
<return type= "Vector3" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns the vertex at given index.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex_bones" qualifiers= "const" >
<return type= "PoolIntArray" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns the bones of the given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex_color" qualifiers= "const" >
<return type= "Color" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns the color of the given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex_count" qualifiers= "const" >
<return type= "int" >
</return>
<description >
2018-10-11 06:28:04 +02:00
Returns the total number of vertices in [Mesh].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex_edges" qualifiers= "const" >
<return type= "PoolIntArray" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns array of edges that share given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex_faces" qualifiers= "const" >
<return type= "PoolIntArray" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns array of faces that share given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex_meta" qualifiers= "const" >
<return type= "Variant" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns meta data associated with given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex_normal" qualifiers= "const" >
<return type= "Vector3" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns normal of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex_tangent" qualifiers= "const" >
<return type= "Plane" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns tangent of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex_uv" qualifiers= "const" >
<return type= "Vector2" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns UV of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex_uv2" qualifiers= "const" >
<return type= "Vector2" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns UV2 of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_vertex_weights" qualifiers= "const" >
<return type= "PoolRealArray" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Returns bone weights of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_edge_meta" >
<return type= "void" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "meta" type= "Variant" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the meta data of given edge.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_face_meta" >
<return type= "void" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "meta" type= "Variant" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the meta data of given face.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_material" >
<return type= "void" >
</return>
<argument index= "0" name= "material" type= "Material" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the material to be used by newly constructed [Mesh].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_vertex" >
<return type= "void" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "vertex" type= "Vector3" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the position of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_vertex_bones" >
<return type= "void" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "bones" type= "PoolIntArray" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the bones of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_vertex_color" >
<return type= "void" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "color" type= "Color" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the color of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_vertex_meta" >
<return type= "void" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "meta" type= "Variant" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the meta data associated with given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_vertex_normal" >
<return type= "void" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "normal" type= "Vector3" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the normal of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_vertex_tangent" >
<return type= "void" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "tangent" type= "Plane" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the tangent of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_vertex_uv" >
<return type= "void" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "uv" type= "Vector2" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the UV of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_vertex_uv2" >
<return type= "void" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "uv2" type= "Vector2" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the UV2 of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "set_vertex_weights" >
<return type= "void" >
</return>
<argument index= "0" name= "idx" type= "int" >
</argument>
<argument index= "1" name= "weights" type= "PoolRealArray" >
</argument>
<description >
2018-10-11 06:28:04 +02:00
Sets the bone weights of given vertex.
2017-09-12 22:42:36 +02:00
</description>
</method>
</methods>
<constants >
</constants>
</class>