godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2025-12-31 17:49:03 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
2.1
godot-docs/classes/class_surfacetool.rst
Rémi Verschelde 53517d1d21 classref: Sync with current 2.1 source
2017-09-06 14:47:12 +02:00

212 lines
26 KiB
ReStructuredText
Raw Permalink Blame History

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
.. _class_SurfaceTool:
SurfaceTool
===========
**Inherits:** :ref:`Reference<class_reference>` **<** :ref:`Object<class_object>`
**Category:** Core
Brief Description
-----------------
Helper tool to create geometry.
Member Functions
----------------
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_bones<class_SurfaceTool_add_bones>` **(** :ref:`IntArray<class_intarray>` bones **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_color<class_SurfaceTool_add_color>` **(** :ref:`Color<class_color>` color **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_index<class_SurfaceTool_add_index>` **(** :ref:`int<class_int>` index **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_normal<class_SurfaceTool_add_normal>` **(** :ref:`Vector3<class_vector3>` normal **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_smooth_group<class_SurfaceTool_add_smooth_group>` **(** :ref:`bool<class_bool>` smooth **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_tangent<class_SurfaceTool_add_tangent>` **(** :ref:`Plane<class_plane>` tangent **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_to_format<class_SurfaceTool_add_to_format>` **(** :ref:`int<class_int>` flags **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_triangle_fan<class_SurfaceTool_add_triangle_fan>` **(** :ref:`Vector3Array<class_vector3array>` vertexes, :ref:`Vector2Array<class_vector2array>` uvs=Vector2Array([]), :ref:`ColorArray<class_colorarray>` colors=ColorArray([ColorArray]), :ref:`Vector2Array<class_vector2array>` uv2s=Vector2Array([]), :ref:`Vector3Array<class_vector3array>` normals=Vector3Array([]), :ref:`Array<class_array>` tangents=Array() **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_uv<class_SurfaceTool_add_uv>` **(** :ref:`Vector2<class_vector2>` uv **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_uv2<class_SurfaceTool_add_uv2>` **(** :ref:`Vector2<class_vector2>` uv2 **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_vertex<class_SurfaceTool_add_vertex>` **(** :ref:`Vector3<class_vector3>` vertex **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`add_weights<class_SurfaceTool_add_weights>` **(** :ref:`RealArray<class_realarray>` weights **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`append_from<class_SurfaceTool_append_from>` **(** :ref:`Mesh<class_mesh>` existing, :ref:`int<class_int>` surface, :ref:`Transform<class_transform>` transform **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`begin<class_SurfaceTool_begin>` **(** :ref:`int<class_int>` primitive **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`clear<class_SurfaceTool_clear>` **(** **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Mesh<class_mesh>` | :ref:`commit<class_SurfaceTool_commit>` **(** :ref:`Mesh<class_mesh>` existing=NULL **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`create_from<class_SurfaceTool_create_from>` **(** :ref:`Mesh<class_mesh>` existing, :ref:`int<class_int>` surface **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`deindex<class_SurfaceTool_deindex>` **(** **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`generate_normals<class_SurfaceTool_generate_normals>` **(** **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`generate_tangents<class_SurfaceTool_generate_tangents>` **(** **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`index<class_SurfaceTool_index>` **(** **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`set_material<class_SurfaceTool_set_material>` **(** :ref:`Material<class_material>` material **)** |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
Description
-----------
The :ref:`SurfaceTool<class_surfacetool>` is used to construct a :ref:`Mesh<class_mesh>` by specifying vertex attributes individually. It can be used to construct a :ref:`Mesh<class_mesh>` from script. All properties except index need to be added before a call to :ref:`add_vertex<class_SurfaceTool_add_vertex>`. For example adding vertex colors and UVs looks like
::
var st = SurfaceTool.new()
st.begin(Mesh.PRIMITIVE_TRIANGLES)
st.add_color(Color(1, 0, 0))
st.add_uv(Vector2(0, 0))
st.add_vertex(Vector3(0, 0, 0))
The :ref:`SurfaceTool<class_surfacetool>` now contains one vertex of a triangle which has a UV coordinate and a specified :ref:`Color<class_color>`. If another vertex were added without calls to :ref:`add_uv<class_SurfaceTool_add_uv>` or :ref:`add_color<class_SurfaceTool_add_color>` then the last values would be used.
It is very important that vertex attributes are passed **before** the call to :ref:`add_vertex<class_SurfaceTool_add_vertex>`, failure to do this will result in an error when committing the vertex information to a mesh.
Member Function Description
---------------------------
.. _class_SurfaceTool_add_bones:
- void **add_bones** **(** :ref:`IntArray<class_intarray>` bones **)**
Add an array of bones for the next Vertex to use.
.. _class_SurfaceTool_add_color:
- void **add_color** **(** :ref:`Color<class_color>` color **)**
Specify a :ref:`Color<class_color>` for the next Vertex to use.
.. _class_SurfaceTool_add_index:
- void **add_index** **(** :ref:`int<class_int>` index **)**
Adds an index to index array if you are using indexed Vertices. Does not need to be called before adding Vertex.
.. _class_SurfaceTool_add_normal:
- void **add_normal** **(** :ref:`Vector3<class_vector3>` normal **)**
Specify a normal for the next Vertex to use.
.. _class_SurfaceTool_add_smooth_group:
- void **add_smooth_group** **(** :ref:`bool<class_bool>` smooth **)**
Specify whether current Vertex (if using only Vertex arrays) or current index (if also using index arrays) should utilize smooth normals for normal calculation.
.. _class_SurfaceTool_add_tangent:
- void **add_tangent** **(** :ref:`Plane<class_plane>` tangent **)**
Specify a Tangent for the next Vertex to use.
.. _class_SurfaceTool_add_to_format:
- void **add_to_format** **(** :ref:`int<class_int>` flags **)**
.. _class_SurfaceTool_add_triangle_fan:
- void **add_triangle_fan** **(** :ref:`Vector3Array<class_vector3array>` vertexes, :ref:`Vector2Array<class_vector2array>` uvs=Vector2Array([]), :ref:`ColorArray<class_colorarray>` colors=ColorArray([ColorArray]), :ref:`Vector2Array<class_vector2array>` uv2s=Vector2Array([]), :ref:`Vector3Array<class_vector3array>` normals=Vector3Array([]), :ref:`Array<class_array>` tangents=Array() **)**
Insert a triangle fan made of array data into :ref:`Mesh<class_mesh>` being constructed.
.. _class_SurfaceTool_add_uv:
- void **add_uv** **(** :ref:`Vector2<class_vector2>` uv **)**
Specify UV Coordinate for next Vertex to use.
.. _class_SurfaceTool_add_uv2:
- void **add_uv2** **(** :ref:`Vector2<class_vector2>` uv2 **)**
Specify an optional second set of UV coordinates for next Vertex to use.
.. _class_SurfaceTool_add_vertex:
- void **add_vertex** **(** :ref:`Vector3<class_vector3>` vertex **)**
Specify position of current Vertex. Should be called after specifying other vertex properties (e.g. Color, UV).
.. _class_SurfaceTool_add_weights:
- void **add_weights** **(** :ref:`RealArray<class_realarray>` weights **)**
Specify weight value for next Vertex to use.
.. _class_SurfaceTool_append_from:
- void **append_from** **(** :ref:`Mesh<class_mesh>` existing, :ref:`int<class_int>` surface, :ref:`Transform<class_transform>` transform **)**
.. _class_SurfaceTool_begin:
- void **begin** **(** :ref:`int<class_int>` primitive **)**
Called before adding any Vertices. Takes the primitive type as an argument (e.g. Mesh.PRIMITIVE_TRIANGLES).
.. _class_SurfaceTool_clear:
- void **clear** **(** **)**
Clear all information passed into the surface tool so far.
.. _class_SurfaceTool_commit:
- :ref:`Mesh<class_mesh>` **commit** **(** :ref:`Mesh<class_mesh>` existing=NULL **)**
Returns a constructed :ref:`Mesh<class_mesh>` from current information passed in. If an existing :ref:`Mesh<class_mesh>` is passed in as an argument, will add an extra surface to the existing :ref:`Mesh<class_mesh>`.
.. _class_SurfaceTool_create_from:
- void **create_from** **(** :ref:`Mesh<class_mesh>` existing, :ref:`int<class_int>` surface **)**
.. _class_SurfaceTool_deindex:
- void **deindex** **(** **)**
Removes index array by expanding Vertex array.
.. _class_SurfaceTool_generate_normals:
- void **generate_normals** **(** **)**
Generates normals from Vertices so you do not have to do it manually.
.. _class_SurfaceTool_generate_tangents:
- void **generate_tangents** **(** **)**
.. _class_SurfaceTool_index:
- void **index** **(** **)**
Shrinks Vertex array by creating an index array. Avoids reusing Vertices.
.. _class_SurfaceTool_set_material:
- void **set_material** **(** :ref:`Material<class_material>` material **)**
Sets :ref:`Material<class_material>` to be used by the :ref:`Mesh<class_mesh>` you are constructing.
Reference in New Issue View Git Blame Copy Permalink