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

Merge pull request #11529 from zommerfelds/patch-1

Browse Source 
Clarify SurfaceTool example with index
This commit is contained in:
Christian Zommerfelds
2025-12-19 11:38:36 +01:00
committed by GitHub
parent 0626b3aefb
commit d1db8c585b
1 changed files with 17 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
tutorials/3d/procedural_geometry/surfacetool.rst
View File

@@ -121,18 +121,12 @@ shrinks the vertex array to remove duplicate vertices.
st.add_vertex(Vector3(1, -1, 0))
st.add_vertex(Vector3(-1, -1, 0))
# We can make the quad more efficient by using an index array and only utilizing 4 vertices
# We can make the quad more efficient by using an index array and only utilizing 4 vertices:
# Suppose we have a quad defined by 6 vertices as follows
st.add_vertex(Vector3(-1, 1, 0))
st.add_vertex(Vector3(1, 1, 0))
st.add_vertex(Vector3(-1, -1, 0))
st.add_vertex(Vector3(1, 1, 0))
st.add_vertex(Vector3(1, -1, 0))
st.add_vertex(Vector3(-1, -1, 0))
# We can make the quad more efficient by using an index array and only utilizing 4 vertices
# Creates a quad from four corner vertices.
# add_index() can be called before or after add_vertex()
@@ -150,6 +144,21 @@ shrinks the vertex array to remove duplicate vertices.
.. code-tab:: csharp
// Suppose we have a quad defined by 6 vertices as follows.
st.AddVertex(new Vector3(-1, 1, 0));
st.AddVertex(new Vector3(1, 1, 0));
st.AddVertex(new Vector3(-1, -1, 0));
st.AddVertex(new Vector3(1, 1, 0));
st.AddVertex(new Vector3(1, -1, 0));
st.AddVertex(new Vector3(-1, -1, 0));
// We can make the quad more efficient by using an index array and only utilizing 4 vertices:
st.AddVertex(new Vector3(-1, -1, 0));
st.AddVertex(new Vector3(1, 1, 0));
st.AddVertex(new Vector3(-1, -1, 0));
st.AddVertex(new Vector3(1, 1, 0));
// Creates a quad from four corner vertices.
// AddIndex does not need to be called before AddVertex.
st.AddIndex(0);
@@ -160,7 +169,7 @@ shrinks the vertex array to remove duplicate vertices.
st.AddIndex(3);
st.AddIndex(2);
// Alternatively:
// Alternatively we can use `st.Index()` which will create the quad for us and remove the duplicate vertices.
st.Index();
Similarly, if you have an index array, but you want each vertex to be unique (e.g. because