[Bf-docboard-svn] bf-manual: [8897] trunk/blender_docs/manual: Attributes: add operator to convert generic attributes to other types

[Hans Goudey]

Revision: 8897
          https://developer.blender.org/rBM8897
Author:   HooglyBoogly
Date:     2022-01-28 07:09:23 +0100 (Fri, 28 Jan 2022)
Log Message:
-----------
Attributes: add operator to convert generic attributes to other types

rBf6888b530ac81abbe61755971449ad6b42b93c82

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/modeling_geometry-nodes_attribute-reference_convert.png

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

Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_attribute-reference_convert.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_attribute-reference_convert.png	2022-01-28 05:31:39 UTC (rev 8896)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_attribute-reference_convert.png	2022-01-28 06:09:23 UTC (rev 8897)

Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_attribute-reference_convert.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst	2022-01-28 05:31:39 UTC (rev 8896)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst	2022-01-28 06:09:23 UTC (rev 8897)
@@ -307,3 +307,40 @@
 :doc:`Join Geometry </modeling/geometry_nodes/geometry/join_geometry>` is used.
 Similarly, if the data type of a vertex group attribute is changed from the initial "Float" type,
 the attribute will no longer be a vertex group.
+
+
+.. _bpy.ops.object.attribute_convert:
+
+Attribute Conversion Operator
+=============================
+
+.. figure:: /images/modeling_geometry-nodes_attribute-reference_convert.png
+   :align: center
+
+This operator found in the *Attributes* panel of the property editor can change the
+domain or data type of an attribute.
+
+Due to ongoing development in the area of attributes, many areas of Blender can not yet work with
+the generic (identified with a name, stored on any domain with any data type)attributes used by
+geometry nodes. That makes this operator an essential workaround in some cases where existing
+tools must be used with data generated from geometry nodes.
+
+Mode
+   :Generic:
+      Inerpolate and convert the attribute between the domains and data types described on this page.
+   :UV Map:
+      Create a :term:`UV Map` layer, editable in the UV editor. These would otherwise
+      be represented by a 2D vector attribute on the face corner domain.
+   :Vertex Group:
+      Create a :doc:`Vertex Group </modeling/meshes/properties/vertex_groups/index>`
+      from the attribute, which corresponds to a float attribute on the point domain.
+   :Vertex Color:
+      Create a :doc:`Vertex Color </sculpt_paint/vertex_paint/index>`
+      from the attribute, which, despite it's name, corresponds to a color attribute on the
+      *face corner* domain.
+
+.. note::
+   
+   This operator only works on *original* object data, not including the results of modifiers,
+   so any attributes added or changed by geometry nodes will not be affected. To change the type
+   of an attribute generated procedurally, modifiers must be applied.