[Bf-docboard-svn] bf-manual: [8896] trunk/blender_docs/manual: Geometry Nodes: Extrude Mesh Node
Hans Goudey
noreply at blender.org
Fri Jan 28 06:31:39 CET 2022
Revision: 8896
https://developer.blender.org/rBM8896
Author: HooglyBoogly
Date: 2022-01-28 06:31:39 +0100 (Fri, 28 Jan 2022)
Log Message:
-----------
Geometry Nodes: Extrude Mesh Node
Includes a lot of detail about attribute propagation that may
be a bit of an information overload, or useful, I'm not totally sure.
The diagrams could be expanded too, they are probably
more helpful than the text.
rB95981c9876483256b2873ee2b63ef60a6c569bb5
Modified Paths:
--------------
trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_random-value_node.png
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/index.rst
Added Paths:
-----------
trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-edge-connecting-edges.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-face-connecting-edges.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-face-individual-connecting-edges.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-vertex-new-edges.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_node.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_sphere-materials.png
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/extrude_mesh.rst
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-edge-connecting-edges.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-edge-connecting-edges.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-edge-connecting-edges.png 2022-01-28 05:28:42 UTC (rev 8895)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-edge-connecting-edges.png 2022-01-28 05:31:39 UTC (rev 8896)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-edge-connecting-edges.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_extrude-mesh_attributes-face-connecting-edges.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-face-connecting-edges.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-face-connecting-edges.png 2022-01-28 05:28:42 UTC (rev 8895)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-face-connecting-edges.png 2022-01-28 05:31:39 UTC (rev 8896)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-face-connecting-edges.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_extrude-mesh_attributes-face-individual-connecting-edges.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-face-individual-connecting-edges.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-face-individual-connecting-edges.png 2022-01-28 05:28:42 UTC (rev 8895)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-face-individual-connecting-edges.png 2022-01-28 05:31:39 UTC (rev 8896)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-face-individual-connecting-edges.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_extrude-mesh_attributes-vertex-new-edges.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-vertex-new-edges.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-vertex-new-edges.png 2022-01-28 05:28:42 UTC (rev 8895)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-vertex-new-edges.png 2022-01-28 05:31:39 UTC (rev 8896)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_attributes-vertex-new-edges.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_extrude-mesh_node.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_node.png 2022-01-28 05:28:42 UTC (rev 8895)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_node.png 2022-01-28 05:31:39 UTC (rev 8896)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_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_extrude-mesh_sphere-materials.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_sphere-materials.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_sphere-materials.png 2022-01-28 05:28:42 UTC (rev 8895)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_sphere-materials.png 2022-01-28 05:31:39 UTC (rev 8896)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_extrude-mesh_sphere-materials.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Modified: trunk/blender_docs/manual/images/modeling_geometry-nodes_utilities_random-value_node.png
===================================================================
(Binary files differ)
Added: trunk/blender_docs/manual/modeling/geometry_nodes/mesh/extrude_mesh.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/mesh/extrude_mesh.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/mesh/extrude_mesh.rst 2022-01-28 05:31:39 UTC (rev 8896)
@@ -0,0 +1,191 @@
+.. index:: Geometry Nodes; Extrude Mesh
+.. _bpy.types.GeometryNodeExtrudeMesh:
+
+*****************
+Extrude Mesh Node
+*****************
+
+.. figure:: /images/modeling_geometry-nodes_extrude-mesh_node.png
+ :align: right
+
+ The Extrude Mesh node.
+
+The *Extrude Mesh Node* generates new vertices, edges, or faces, on selected geometry
+and transforms them based on an offset.
+
+The operations are similar to the :doc:`extrude tools </modeling/meshes/editing/mesh/extrude>`
+in mesh edit mode, though there are some differences. Most importantly, the node never keeps the back-faces
+of the extrusion in place, they are always removed. Attribute propagation rules may also be different.
+
+
+Inputs
+======
+
+Mesh
+ Standard geometry input.
+
+Selection
+ Whether to extrude each element.
+ True values mean elements will be extruded, false values mean elements will remain unchanged.
+
+Offset
+ The amount to translate the new geometry on each axis. The default value of the "Offset" input
+ is the mesh's :doc:`normals </modeling/geometry_nodes/input/normal>`. To change the distance,
+ the *Scale* input can be used. However, when an input is computed for this directly, the length
+ of the input vectors is used.
+
+ .. tip::
+
+ Because the default input is the mesh's normals, they may need to be calculated just for this node.
+ If the extrusion is only in one direction anyway, a potential performance improvement is to connect
+ a :doc:`/modeling/geometry_nodes/input/vector` instead.
+
+Scale
+ The factor used to scale elements or groups of elements.
+
+Individual :guilabel:`Face Mode Only`
+ Whether to extrude each face individually rather than extruding connected groups of faces together as regions.
+ A quad side face will be generated on each side of every selected face.
+
+
+Properties
+==========
+
+Mode
+ :Vertices:
+ This mode is quite simple, it just attaches new edges and vertices to the selected vertices.
+
+ :Edges:
+ Attach new quad faces to the selected edges. Vertices shared by the
+ original selected vertices are also shared in the duplicated edges.
+
+ .. note::
+
+ Depending on th situation, the normals of the new edges may be arbitrary. If the selected
+ edges only have one selected face, then the node can pick a consistent orientation for the
+ new faces, but if there is more than one connected face, or no connected faces, the normals
+ may have to be adjusted afterwards.
+
+ :Faces:
+ Extrudes contiguous regions of selected faces, or each selected face individually,
+ depending on the *Individual* boolean input.
+
+ When the *Individual* input is false, the node will find regions of connected faces and generate
+ new "side" faces on the boundaries of those regions. If the whole mesh is selected and it is already
+ a :term:`Manifold` shape, then result will just be that the whole mesh moves. Any vertices, edges
+ or faces on the *inside* of the face regions are just moved, they are not duplicated.
+
+
+Output
+======
+
+Mesh
+ Standard geometry output.
+
+Top
+ A boolean field output containing the top new top geometry. The :ref:`domain <attribute-domains>`
+ depends on the selected mode. In *Vertex* mode, this is a selection of the new vertices.
+ In *Edge* mode, this is a selection of the duplicated edges
+ and in *Face* mode, it is a selection of the new faces.
+
+Side
+ A boolean field output containing the "side" of the new geometry. In *Vertex* mode, it selects
+ the new edges, in *Edge* mode, the new faces, and in *Face* mode, the new side faces are selected,
+ which are all of the new faces that aren't in the *Top* selection.
+
+
+Examples
+========
+
+.. figure:: /images/modeling_geometry-nodes_extrude-mesh_sphere-materials.png
+ :align: center
+
+Here, the selection outputs are used to set materials on certain faces of the mesh.
+A :doc:`/modeling/geometry_nodes/utilities/random_value` node can be used to limit the
+extrusion to a random set of faces.
+
+
+Attribute Propagation
+=====================
+
+Attributes are transferred to the new elements with specific rules.
+An attribute will never change domains on the resulting mesh.
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list