[Bf-docboard-svn] bf-manual: [8877] trunk/blender_docs/manual: Geometry Nodes: 4 Field Inputs for Mesh Topology Data
Hans Goudey
noreply at blender.org
Wed Jan 26 05:49:07 CET 2022
Revision: 8877
https://developer.blender.org/rBM8877
Author: HooglyBoogly
Date: 2022-01-26 05:49:07 +0100 (Wed, 26 Jan 2022)
Log Message:
-----------
Geometry Nodes: 4 Field Inputs for Mesh Topology Data
rB2814740f5be86fc389ba82ffbb3a40c43f47a9f5
Modified Paths:
--------------
trunk/blender_docs/manual/images/modeling_geometry-nodes_attribute_attribute-statistic_node.png
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/index.rst
Added Paths:
-----------
trunk/blender_docs/manual/images/modeling_geometry-nodes_input_edge-vertices_node.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_node.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_surface-area.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-neighbors_node.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_input_is-vertex-neighbors_node.png
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/edge_vertices.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/face_area.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/face_neighbors.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/vertex_neighbors.rst
Modified: trunk/blender_docs/manual/images/modeling_geometry-nodes_attribute_attribute-statistic_node.png
===================================================================
(Binary files differ)
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_edge-vertices_node.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_edge-vertices_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_input_edge-vertices_node.png 2022-01-26 04:45:57 UTC (rev 8876)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_input_edge-vertices_node.png 2022-01-26 04:49:07 UTC (rev 8877)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_edge-vertices_node.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_node.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_node.png 2022-01-26 04:45:57 UTC (rev 8876)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_node.png 2022-01-26 04:49:07 UTC (rev 8877)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_node.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_surface-area.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_surface-area.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_surface-area.png 2022-01-26 04:45:57 UTC (rev 8876)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_surface-area.png 2022-01-26 04:49:07 UTC (rev 8877)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-area_surface-area.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-neighbors_node.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-neighbors_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-neighbors_node.png 2022-01-26 04:45:57 UTC (rev 8876)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-neighbors_node.png 2022-01-26 04:49:07 UTC (rev 8877)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-neighbors_node.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_is-vertex-neighbors_node.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_is-vertex-neighbors_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_input_is-vertex-neighbors_node.png 2022-01-26 04:45:57 UTC (rev 8876)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_input_is-vertex-neighbors_node.png 2022-01-26 04:49:07 UTC (rev 8877)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_is-vertex-neighbors_node.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: trunk/blender_docs/manual/modeling/geometry_nodes/mesh/edge_vertices.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/mesh/edge_vertices.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/mesh/edge_vertices.rst 2022-01-26 04:49:07 UTC (rev 8877)
@@ -0,0 +1,44 @@
+.. index:: Geometry Nodes; Edge Vertices
+.. _bpy.types.GeometryNodeEdgeVertices:
+
+******************
+Edge Vertices Node
+******************
+
+.. figure:: /images/modeling_geometry-nodes_input_edge-vertices_node.png
+ :align: right
+
+ Edge Vertices Node.
+
+The *Edge Vertices* node outputs the position and index of the two vertices of each of a mesh's edges.
+
+.. note::
+
+ The order of the two vertices of an edge is arbitrary. In some cases it may be predictable
+ based on the internals of the algorithm that created the mesh, but in general the order should
+ not be relied upon.
+
+
+Inputs
+======
+
+This node has no inputs.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Outputs
+=======
+
+Vertex Index 1/2
+ The :doc:`index </modeling/geometry_nodes/input/input_index>` of the two vertices of the edge.
+
+Position 1/2
+ The :doc:`position </modeling/geometry_nodes/input/position>` of each of the edge's vertices.
+ This output is for convenience, it is the same as using index output to retrieve the position from the
+ :doc:`/modeling/geometry_nodes/utilities/field_at_index`.
+
Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/mesh/edge_vertices.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/modeling/geometry_nodes/mesh/face_area.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/mesh/face_area.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/mesh/face_area.rst 2022-01-26 04:49:07 UTC (rev 8877)
@@ -0,0 +1,51 @@
+.. index:: Geometry Nodes; Face Area
+.. _bpy.types.GeometryNodeFaceArea:
+
+**************
+Face Area Node
+**************
+
+.. figure:: /images/modeling_geometry-nodes_input_face-area_node.png
+ :align: right
+
+ Face Area Node.
+
+The *Face Area* node outputs the surface area of a mesh's faces.
+The units are in Blender units no matter the unit system,
+equivalent to meters-squared at the default unit scale.
+
+.. note::
+
+ For :term:`quads <Quad>` and :term:`N-gons <N-gon>`, when the face's vertices are not planar,
+ the output is not necessarily the same as the sum of every one of the face's triangles visible
+ in the viewport. In this case it should only be used an approximation. In some cases,
+ the :doc:`/modeling/geometry_nodes/mesh/triangulate` can be used to get an exact value.
+
+
+Inputs
+======
+
+This node has no inputs.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Outputs
+=======
+
+Area
+ The surface area of each of the mesh's faces.
+
+
+Examples
+========
+
+.. figure:: /images/modeling_geometry-nodes_input_face-area_surface-area.png
+ :align: right
+
+Combined with the :doc:`/modeling/geometry_nodes/attribute/attribute_statistic`,
+this node can be used to calculate the total surface area of a mesh.
Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/mesh/face_area.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/modeling/geometry_nodes/mesh/face_neighbors.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/mesh/face_neighbors.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/mesh/face_neighbors.rst 2022-01-26 04:49:07 UTC (rev 8877)
@@ -0,0 +1,37 @@
+.. index:: Geometry Nodes; Face Neighbors
+.. _bpy.types.GeometryNodeFaceNeighbors:
+
+*******************
+Face Neighbors Node
+*******************
+
+.. figure:: /images/modeling_geometry-nodes_input_face-neighbors_node.png
+ :align: right
+
+ Face Neighbors Node.
+
+The *Face Neighbors* node outputs topology information relating to each face of a mesh.
+
+
+Inputs
+======
+
+This node has no inputs.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Outputs
+=======
+
+Vertex Count
+ This output is simply the number of sides of each face, or how many corners each face has.
+
+Neighboring Face Count
+ The number of faces that connect to this face with at least one edge. On a regular manifold
+ mesh with only quads and triangles, this will be the same as the vertex count, otherwise it might
+ be completely different.
Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/mesh/face_neighbors.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/mesh/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/mesh/index.rst 2022-01-26 04:45:57 UTC (rev 8876)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/mesh/index.rst 2022-01-26 04:49:07 UTC (rev 8877)
@@ -22,7 +22,11 @@
.. toctree::
:maxdepth: 1
+ edge_vertices.rst
+ face_area.rst
+ face_neighbors.rst
is_shade_smooth.rst
+ vertex_neighbors.rst
------------------------
Added: trunk/blender_docs/manual/modeling/geometry_nodes/mesh/vertex_neighbors.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/mesh/vertex_neighbors.rst (rev 0)
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list