[Bf-docboard-svn] bf-manual: [9284] trunk/blender_docs/manual: Merge branch 'blender-3.2-release'
Hans Goudey
noreply at blender.org
Mon May 16 18:57:42 CEST 2022
Revision: 9284
https://developer.blender.org/rBM9284
Author: HooglyBoogly
Date: 2022-05-16 18:57:42 +0200 (Mon, 16 May 2022)
Log Message:
-----------
Merge branch 'blender-3.2-release'
Modified Paths:
--------------
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/capture_attribute.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst
trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/input/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/inspection.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/index.rst
trunk/blender_docs/manual/modeling/modifiers/generate/geometry_nodes.rst
Added Paths:
-----------
trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_duplicate-elements_instance.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-is-planar-simple.png
trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-is-planar_simple.png
trunk/blender_docs/manual/images/node-types_GeometryNodeDuplicateElements.png
trunk/blender_docs/manual/images/node-types_GeometryNodeInputMeshFaceIsPlanar.png
trunk/blender_docs/manual/images/node-types_GeometryNodeNamedAttribute.png
trunk/blender_docs/manual/images/node-types_GeometryNodeRemoveNamedAttribute.png
trunk/blender_docs/manual/images/node-types_GeometryNodeStoreNamedAttribute.png
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/remove_named_attribute.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/store_named_attribute.rst
trunk/blender_docs/manual/modeling/geometry_nodes/geometry/duplicate_elements.rst
trunk/blender_docs/manual/modeling/geometry_nodes/input/named_attribute.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/face_is_planar.rst
Property Changed:
----------------
trunk/blender_docs/
Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs 2022-05-16 16:55:57 UTC (rev 9283)
+++ trunk/blender_docs 2022-05-16 16:57:42 UTC (rev 9284)
Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -2,4 +2,4 ##
/branches/blender-2.93-release/blender_docs:7959-8113
/branches/blender-3.0-release/blender_docs:8543-9034
/branches/blender-3.1-release/blender_docs:8904-9230
-/branches/blender-3.2-release/blender_docs:9236-9281
\ No newline at end of property
+/branches/blender-3.2-release/blender_docs:9236-9283
\ No newline at end of property
Copied: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_duplicate-elements_instance.png (from rev 9283, branches/blender-3.2-release/blender_docs/manual/images/modeling_geometry-nodes_geometry_duplicate-elements_instance.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-is-planar-simple.png (from rev 9283, branches/blender-3.2-release/blender_docs/manual/images/modeling_geometry-nodes_input_face-is-planar-simple.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/modeling_geometry-nodes_input_face-is-planar_simple.png (from rev 9283, branches/blender-3.2-release/blender_docs/manual/images/modeling_geometry-nodes_input_face-is-planar_simple.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeDuplicateElements.png (from rev 9283, branches/blender-3.2-release/blender_docs/manual/images/node-types_GeometryNodeDuplicateElements.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeInputMeshFaceIsPlanar.png (from rev 9283, branches/blender-3.2-release/blender_docs/manual/images/node-types_GeometryNodeInputMeshFaceIsPlanar.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeNamedAttribute.png (from rev 9283, branches/blender-3.2-release/blender_docs/manual/images/node-types_GeometryNodeNamedAttribute.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeRemoveNamedAttribute.png (from rev 9283, branches/blender-3.2-release/blender_docs/manual/images/node-types_GeometryNodeRemoveNamedAttribute.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeStoreNamedAttribute.png (from rev 9283, branches/blender-3.2-release/blender_docs/manual/images/node-types_GeometryNodeStoreNamedAttribute.png)
===================================================================
(Binary files differ)
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/capture_attribute.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/capture_attribute.rst 2022-05-16 16:55:57 UTC (rev 9283)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/capture_attribute.rst 2022-05-16 16:57:42 UTC (rev 9284)
@@ -35,15 +35,19 @@
Standard geometry input.
Value
- Float or Vector input to evaluate.
+ The input field to evaluate.
Properties
==========
-This node has no properties.
+Data Type
+ The :ref:`data type <attribute-data-types>` used for the evaluated data.
+Domain
+ Which :ref:`attribute domain <attribute-domains>` to store the evaluated data on.
+
Outputs
=======
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst 2022-05-16 16:55:57 UTC (rev 9283)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst 2022-05-16 16:57:42 UTC (rev 9284)
@@ -12,3 +12,5 @@
capture_attribute.rst
domain_size.rst
transfer_attribute.rst
+ store_named_attribute.rst
+ remove_named_attribute.rst
Copied: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/remove_named_attribute.rst (from rev 9283, branches/blender-3.2-release/blender_docs/manual/modeling/geometry_nodes/attribute/remove_named_attribute.rst)
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/remove_named_attribute.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/remove_named_attribute.rst 2022-05-16 16:57:42 UTC (rev 9284)
@@ -0,0 +1,43 @@
+.. index:: Geometry Nodes; Remove Named Attribute
+.. _bpy.types.GeometryNodeRemoveNamedAttribute:
+
+***************************
+Remove Named Attribute Node
+***************************
+
+.. figure:: /images/node-types_GeometryNodeRemoveNamedAttribute.png
+ :align: right
+ :alt: Remove Named Attribute node.
+
+The *Remove Named Attribute* node deletes an attribute with a certain name from its geometry input.
+Any attribute that exists on geometry data will be automatically propagated when the it is changed,
+which can be an expensive operation, so using this node can be a simple way to optimize the performance
+of a geometry node tree or even to lower the memory usage of the entire scene.
+
+Almost all attribute names can be removed. For certain :ref:`geometry-nodes_builtin-attributes`,
+removing it will mean that a default value will be used instead. For example, removing the
+:doc:`cyclic </modeling/geometry_nodes/curve/is_spline_cyclic>` attribute on curves means that
+all curves will be non-cyclic.
+
+
+Inputs
+======
+
+Geometry
+ Standard geometry input.
+
+Name
+ Float or Vector input to evaluate.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Outputs
+=======
+
+Geometry
+ Standard geometry output.
Copied: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/store_named_attribute.rst (from rev 9283, branches/blender-3.2-release/blender_docs/manual/modeling/geometry_nodes/attribute/store_named_attribute.rst)
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/store_named_attribute.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/store_named_attribute.rst 2022-05-16 16:57:42 UTC (rev 9284)
@@ -0,0 +1,59 @@
+.. index:: Geometry Nodes; Store Named Attribute
+.. _bpy.types.GeometryNodeStoreNamedAttribute:
+
+**************************
+Store Named Attribute Node
+**************************
+
+.. figure:: /images/node-types_GeometryNodeStoreNamedAttribute.png
+ :align: right
+ :alt: Store Named Attribute node.
+
+The *Store Named Attribute* node stores the result of a field on a geometry
+as an attribute with the specified name. If the attribute already exists, the data
+type and domain will be updated to the values chosen in the node.
+However, keep in mind that the domain and data type of :ref:`geometry-nodes_builtin-attributes`
+cannot be changed.
+
+Compared with the :doc:`/modeling/geometry_nodes/attribute/capture_attribute`, this node basically
+does the same thing, but the attribute gets a name instead of an anonymous reference.
+For reusing the data in the same node tree, the *Capture Attribute* node might be preferrable
+since it does not create the chance for name conflicts in the input geometry.
+
+.. note::
+
+ If the input geometry contains multiple geometry component types, the attribute will be
+ created on each component that has the chosen domain.
+
+
+Inputs
+======
+
+Geometry
+ Standard geometry input.
+
+Value
+ The input field to evaluate.
+
+Name
+ The name to give the stored data.
+
+
+Properties
+==========
+
+Data Type
+ The :ref:`data type <attribute-data-types>` used for the evaluated data.
+
+Domain
+ Which :ref:`attribute domain <attribute-domains>` to store the evaluated data on.
+
+
+Outputs
+=======
+
+Geometry
+ Standard geometry output.
+
+Attribute
+ The result of the evaluated field, stored on the geometry.
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst 2022-05-16 16:55:57 UTC (rev 9283)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst 2022-05-16 16:57:42 UTC (rev 9284)
@@ -61,6 +61,7 @@
that was not created from their source. To transfer attributes between separate geometries,
the :doc:`/modeling/geometry_nodes/attribute/transfer_attribute` can be used.
+.. _attribute-data-types:
Attribute Data Types
====================
@@ -69,9 +70,12 @@
:Boolean: True or false value
:Integer: 32-bit integer
+ :8-Bit Integer: Smaller integer with a range from -128 to 127
:Float: Floating-point value
:Vector: 3D vector with floating-point values
- :Color: RGBA color with floating-point precision
+ :2D Vector: 2D vector with floating-point values
+ :Color: RGBA color with 32-bit floating-point values
+ :Byte Color: RGBA color with 8-bit positive integer values
The above list is in the order of least to most "complex" (An integer can contain more data than a
boolean, so it is more complicated). When joining separate geometries together, the more complex data
Copied: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/duplicate_elements.rst (from rev 9283, branches/blender-3.2-release/blender_docs/manual/modeling/geometry_nodes/geometry/duplicate_elements.rst)
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/duplicate_elements.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/duplicate_elements.rst 2022-05-16 16:57:42 UTC (rev 9284)
@@ -0,0 +1,74 @@
+.. index:: Geometry Nodes; Duplicate Elements
+.. _bpy.types.GeometryNodeDuplicateElements:
+
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list