[Bf-docboard-svn] bf-manual: [8524] trunk/blender_docs/manual: Geometry Nodes: Get and set nodes for ID attribute

Hans Goudey noreply at blender.org
Tue Oct 26 23:08:20 CEST 2021


Revision: 8524
          https://developer.blender.org/rBM8524
Author:   HooglyBoogly
Date:     2021-10-26 23:08:20 +0200 (Tue, 26 Oct 2021)
Log Message:
-----------
Geometry Nodes: Get and set nodes for ID attribute

rB7d3d09b69c0af677bd363cc009f37fdd1e4a7185

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst
    trunk/blender_docs/manual/modeling/geometry_nodes/input/index.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_set-id_node.png
    trunk/blender_docs/manual/images/modeling_geometry-nodes_input_input-id_node.png
    trunk/blender_docs/manual/modeling/geometry_nodes/geometry/set_id.rst
    trunk/blender_docs/manual/modeling/geometry_nodes/input/id.rst

Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_set-id_node.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_set-id_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_set-id_node.png	2021-10-26 19:39:40 UTC (rev 8523)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_set-id_node.png	2021-10-26 21:08:20 UTC (rev 8524)

Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_set-id_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_input-id_node.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_input-id_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_input_input-id_node.png	2021-10-26 19:39:40 UTC (rev 8523)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_input_input-id_node.png	2021-10-26 21:08:20 UTC (rev 8524)

Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_input-id_node.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst	2021-10-26 19:39:40 UTC (rev 8523)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst	2021-10-26 21:08:20 UTC (rev 8524)
@@ -17,6 +17,13 @@
    separate_geometry.rst
    transform.rst
 
+------------------------
+
+.. toctree::
+   :maxdepth: 1
+
+   set_id.rst
+
 .. missing documentation:
    ray_cast.rst
    set_position.rst

Added: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/set_id.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/set_id.rst	                        (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/set_id.rst	2021-10-26 21:08:20 UTC (rev 8524)
@@ -0,0 +1,45 @@
+.. index:: Geometry Nodes; Set ID
+.. _bpy.types.GeometryNodeSetID:
+
+***********
+Set ID Node
+***********
+
+.. figure:: /images/modeling_geometry-nodes_geometry_set-id_node.png
+   :align: right
+
+   Set ID Node
+
+The *Set ID* node fills the *id* attribute on the input geometry. If the attribute does not exist yet,
+it will be created with a default value of zero. The ID is also created by the
+:doc:`/modeling/geometry_nodes/point/distribute_points_on_faces`, and it is used in the
+:doc:`/modeling/geometry_nodes/utilities/random_value` and other nodes if it exists.
+
+The input node for this data is the :doc:`/modeling/geometry_nodes/input/id`.
+
+
+Inputs
+======
+
+Geometry
+   Standard geometry input.
+
+Selection
+    Whether or not to change the value on each point or instance. 
+    True values mean the value will be changed, false values mean the value will remain the same.
+
+ID
+   The value for each element.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Outputs
+=======
+
+Geometry
+   Standard geometry output.


Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/set_id.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/modeling/geometry_nodes/input/id.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/input/id.rst	                        (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/input/id.rst	2021-10-26 21:08:20 UTC (rev 8524)
@@ -0,0 +1,40 @@
+.. index:: Geometry Nodes; ID
+.. _bpy.types.GeometryNodeInputID:
+
+*******
+ID Node
+*******
+
+.. figure:: /images/modeling_geometry-nodes_input_input-id_node.png
+   :align: right
+
+   ID node.
+
+The *ID* node gives an integer value indicating the stable random ID of each element on the point domain,
+which is stored in the *id* attribute.
+
+The node to set this data is the :doc:`/modeling/geometry_nodes/geometry/set_id` node.
+
+.. node::
+
+   Unlike other built-in attribtutes, the *id* attribute does not always exist. In that case, this
+   node will output zero.
+
+
+Inputs
+======
+
+This node has no inputs.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Outputs
+=======
+
+Index
+   Integer value.


Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/input/id.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/input/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/input/index.rst	2021-10-26 19:39:40 UTC (rev 8523)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/input/index.rst	2021-10-26 21:08:20 UTC (rev 8524)
@@ -18,7 +18,7 @@
    vector.rst
 
 ------------------------
-
+set_id
 .. toctree::
    :maxdepth: 1
 
@@ -26,6 +26,7 @@
    normal.rst
    position.rst
    radius.rst
+   id.rst
 
 .. missing documentation
    boolean.rst



More information about the Bf-docboard-svn mailing list