Geometry Nodes: Add pages for initial Tool-specific nodes #104617

Merged
17 changed files with 235 additions and 5 deletions

BIN
manual/images/node-types_GeometryNodeTool3DCursor.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
manual/images/node-types_GeometryNodeToolFaceSet.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
manual/images/node-types_GeometryNodeToolSelection.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
manual/images/node-types_GeometryNodeToolSetFaceSet.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
manual/images/node-types_GeometryNodeToolSetSelection.png (Stored with Git LFS) Normal file

Binary file not shown.

View File

@ -12,3 +12,4 @@
normal.rst
position.rst
radius.rst
selection.rst

View File

@ -0,0 +1,37 @@
.. index:: Geometry Nodes; Selection
.. _bpy.types.GeometryNodeToolSelection:
**************
Selection Node
**************
.. figure:: /images/node-types_GeometryNodeToolSelection.png
:align: right
:alt: Selection node.
The *Selection* node outputs true for geometry that is :doc:`selected </interface/selecting>`, and false elsewhere.
The corresponding data flow node is the :doc:`/modeling/geometry_nodes/geometry/write/set_selection`.
.. note::
This node can only be used in the :ref:`Tool context <tool_context>`.
Inputs
======
This node has no inputs.
Properties
==========
This node has no properties.
Outputs
=======
Selection
Boolean field set to true for geometry that is selected in edit mode.

View File

@ -8,3 +8,4 @@
set_id.rst
set_position.rst
set_selection.rst

View File

@ -0,0 +1,43 @@
.. index:: Geometry Nodes; Set Selection
.. _bpy.types.GeometryNodeToolSetSelection:
******************
Set Selection Node
******************
.. figure:: /images/node-types_GeometryNodeToolSetSelection.png
:align: right
:alt: Set Selection node.
The *Set Selection* node controls which geometry is :doc:`selected </interface/selecting>`.
The input node for this data is the :doc:`/modeling/geometry_nodes/geometry/read/selection`.
.. note::
This node can only be used in the :ref:`Tool context <tool_context>`.
Inputs
======
Geometry
Standard geometry input.
Selection
Boolean field for specifying which elements should be selected in the output geometry.
Elements for which this field evaluates to false are implicitly de-selected.
Properties
==========
Domain
Which :ref:`domain <attribute-domains>` to set the selection on.
Outputs
=======
Geometry
Standard geometry output.

View File

@ -0,0 +1,38 @@
.. index:: Geometry Nodes; 3D Cursor
.. _bpy.types.GeometryNodeTool3DCursor:
**************
3D Cursor Node
**************
.. figure:: /images/node-types_GeometryNodeTool3DCursor.png
:align: right
:alt: 3D Cursor node.
The *3D Cursor* node outputs the position and orientation of the 3D cursor in the scene.
.. note::
This node can only be used in the :ref:`Tool context <tool_context>`.
Inputs
======
This node has no inputs.
Properties
==========
This node has no properties.
Outputs
=======
Location
The position of the 3D cursor.
Rotation
The orientation of the 3D cursor as a standard rotation value.

View File

@ -6,6 +6,7 @@
.. toctree::
:maxdepth: 1
3d_cursor.rst
collection_info.rst
image_info.rst
is_viewport.rst

View File

@ -0,0 +1,42 @@
.. index:: Geometry Nodes; Face Set
.. _bpy.types.GeometryNodeToolFaceSet:
*************
Face Set Node
*************
.. figure:: /images/node-types_GeometryNodeToolFaceSet.png
:align: right
:alt: Face Set node.
The *Face Set Node* outputs which :ref:`face set <face_sets>` a face is in,
and whether or not face sets exist in the mesh at all.
The corresponding data flow node is the :doc:`/modeling/geometry_nodes/mesh/write/set_face_set`.
.. note::
This node can only be used in the :ref:`Tool context <tool_context>`.
Inputs
======
This node has no inputs.
Properties
==========
This node has no properties.
Output
======
Face Set
Integer indicating which face set a face is in, or 0 when the mesh does not have face sets.
When evaluated in the edge or point domain, outputs an interpolated value based on the connected faces.
Exists
Boolean value that indicates whether the element's mesh has face sets.

View File

@ -13,6 +13,7 @@
face_area.rst
face_group_boundaries.rst
face_neighbors.rst
face_set.rst
face_is_planar.rst
is_edge_smooth.rst
is_face_smooth.rst

View File

@ -6,4 +6,5 @@
.. toctree::
:maxdepth: 1
set_face_set.rst
set_shade_smooth.rst

View File

@ -0,0 +1,45 @@
.. index:: Geometry Nodes; Set Face Set
.. _bpy.types.GeometryNodeToolSetFaceSet:
*****************
Set Face Set Node
*****************
.. figure:: /images/node-types_GeometryNodeToolSetFaceSet.png
:align: right
:alt: Set Face Set node.
The *Set Face Set* node controls which :ref:`face set <face_sets>` that faces are in.
The input node for this data is the :doc:`/modeling/geometry_nodes/mesh/read/face_set`.
.. note::
This node can only be used in the :ref:`Tool context <tool_context>`.
Inputs
======
Mesh
Standard geometry input.
Selection
Boolean field that controls which faces will have the Face Set value applied.
Face Set
Integer field for specifying which face set each selected face should be moved to.
Ignored for faces where the value of Selection is false.
Properties
==========
This node has no properties.
Outputs
=======
Mesh
Standard geometry output.

View File

@ -14,6 +14,8 @@ They can be shared as any regular node group assets.
Node group tools integrated in the Selection menu.
.. _tool_context:
Tool Context
============
@ -62,11 +64,11 @@ Tool-specific Nodes
The following nodes are only supported in the tool context:
- 3D Cursor
- Face Set
- Selection
- Set Face Set
- Set Selection
- :doc:`/modeling/geometry_nodes/input/scene/3d_cursor`
- :doc:`/modeling/geometry_nodes/mesh/read/face_set`
- :doc:`/modeling/geometry_nodes/geometry/read/selection`
- :doc:`/modeling/geometry_nodes/mesh/write/set_face_set`
- :doc:`/modeling/geometry_nodes/geometry/write/set_selection`
.. note::

View File

@ -63,6 +63,9 @@ Both these operators can be quickly accessed in the :kbd:`A` pie menu.
More information about editing and using masks at the :doc:`Mask Menu </sculpt_paint/sculpting/editing/mask>`
.. _face_sets:
Face Sets
=========