[Bf-docboard-svn] bf-manual: [7666] branches/blender-2.92-release/blender_docs/manual/modeling/geometry_nodes: Geometry Nodes: Add attribute reference page

[Hans Goudey]

Revision: 7666
          https://developer.blender.org/rBM7666
Author:   HooglyBoogly
Date:     2021-01-25 20:59:23 +0100 (Mon, 25 Jan 2021)
Log Message:
-----------
Geometry Nodes: Add attribute reference page

This page should serve as an overview of attributes used in nodes.

Modified Paths:
--------------
    branches/blender-2.92-release/blender_docs/manual/modeling/geometry_nodes/index.rst

Added Paths:
-----------
    branches/blender-2.92-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst

Added: branches/blender-2.92-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst
===================================================================
--- branches/blender-2.92-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst	                        (rev 0)
+++ branches/blender-2.92-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst	2021-01-25 19:59:23 UTC (rev 7666)
@@ -0,0 +1,85 @@
+.. index:: Geometry Nodes; Attribute Reference
+
+**********
+Attributes
+**********
+
+An *attribute* is a generic term to describe data stored per-element in a geometry data-block.
+For example, every vertex can have an associated number or vector value. 
+
+
+Attributes can be adjusted by the nodes in the *Attribute* category, but some other nodes can
+change the values of specific attributes.
+
+.. note::
+
+   The blue attribute sockets are just string sockets, used to look up the list of data stored in the geometry.
+
+.. note::
+
+   Attribute data types are converted implicitly where possible, just like node sockets.
+
+
+Built In Attributes
+===================
+
+.. list-table::
+   :widths: 10 10 50
+   :header-rows: 1
+
+   * - Name
+     - Type
+     - Notes 
+
+   * - **position**
+     - *Vector*
+     - Built in attribute describing vertex or point locations, in the modifier object's
+       transform space. Any node that changes the location of points will adjust this attribute, like the
+       :doc:`Transform </modeling/geometry_nodes/geometry/transform>` and 
+       :doc:`Point Translate </modeling/geometry_nodes/point/point_translate>` nodes.
+
+   * - **radius**
+     - *Float*
+     - Used to set the size for the points created by the
+       :doc:`Point Distribute Node </modeling/geometry_nodes/point/point_distribute>` in the viewport.
+
+
+Naming Conventions
+==================
+
+.. list-table::
+   :widths: 10 10 50
+   :header-rows: 1
+
+   * - Name
+     - Type
+     - Notes
+
+   * - **rotation**
+     - *Vector*
+     - Used in the :doc:`Point Distribute </modeling/geometry_nodes/point/point_distribute>`
+       to control the rotation of instanced objects or collections. This is adjusted by the 
+       :doc:`Point Rotate Node </modeling/geometry_nodes/point/point_rotate>` and the 
+       :doc:`Align Rotation to Vector Node </modeling/geometry_nodes/point/align_rotation_to_vector>`.
+
+   * - **scale**
+     - *Vector*
+     - Used in the :doc:`Point Distribute </modeling/geometry_nodes/point/point_distribute>`
+       to control the scale. This is adjusted by the 
+       :doc:`Point Scale Node </modeling/geometry_nodes/point/point_rotate>` or other attribute nodes.
+
+   * - **id**
+     - *Integer*
+     - Created by the :doc:`Point Distribute </modeling/geometry_nodes/point/point_distribute>`
+       to provide stability when the shape of the input mesh changes. The values are large, with no order.
+       The attribute values are used by nodes that generate randomness, like the 
+       :doc:`Attribute Randomize Node </modeling/geometry_nodes/attribute/attribute_randomize>`.
+
+
+Vertex Groups
+=============
+
+All vertex groups can be used as attributes in the node tree when referred to by name.
+However, the result of the node tree does not always produce vertex groups, if a node like
+:doc:`Join Geometry </modeling/geometry_nodes/geometry/join_geometry>` is used.
+


Property changes on: branches/blender-2.92-release/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: branches/blender-2.92-release/blender_docs/manual/modeling/geometry_nodes/index.rst
===================================================================
--- branches/blender-2.92-release/blender_docs/manual/modeling/geometry_nodes/index.rst	2021-01-25 19:34:39 UTC (rev 7665)
+++ branches/blender-2.92-release/blender_docs/manual/modeling/geometry_nodes/index.rst	2021-01-25 19:59:23 UTC (rev 7666)
@@ -19,6 +19,7 @@
 .. toctree::
    :maxdepth: 1
 
+   attributes_reference.rst
    attribute/attribute_compare.rst
    attribute/attribute_fill.rst
    attribute/attribute_math.rst