[Bf-docboard-svn] bf-manual: [8779] trunk/blender_docs/manual: Merge branch 'blender-3.0-release'
Aaron Carlisle
noreply at blender.org
Wed Dec 8 20:06:44 CET 2021
Revision: 8779
https://developer.blender.org/rBM8779
Author: Blendify
Date: 2021-12-08 20:06:44 +0100 (Wed, 08 Dec 2021)
Log Message:
-----------
Merge branch 'blender-3.0-release'
Modified Paths:
--------------
trunk/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/trim_curve.rst
trunk/blender_docs/manual/modeling/geometry_nodes/fields.rst
trunk/blender_docs/manual/modeling/geometry_nodes/geometry/bounding_box.rst
trunk/blender_docs/manual/modeling/geometry_nodes/geometry/convex_hull.rst
trunk/blender_docs/manual/modeling/geometry_nodes/geometry/join_geometry.rst
trunk/blender_docs/manual/modeling/geometry_nodes/instances/instance_on_points.rst
trunk/blender_docs/manual/modeling/geometry_nodes/instances/realize_instances.rst
trunk/blender_docs/manual/modeling/geometry_nodes/instances.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/mesh_boolean.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/points_to_volume.rst
trunk/blender_docs/manual/scene_layout/object/properties/instancing/index.rst
Property Changed:
----------------
trunk/blender_docs/
Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs 2021-12-07 19:22:44 UTC (rev 8778)
+++ trunk/blender_docs 2021-12-08 19:06:44 UTC (rev 8779)
Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -1,3 +1,3 ##
/branches/blender-2.92-release/blender_docs:7610-7921
/branches/blender-2.93-release/blender_docs:7959-8113
-/branches/blender-3.0-release/blender_docs:8543-8761
\ No newline at end of property
+/branches/blender-3.0-release/blender_docs:8543-8778
\ 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 2021-12-07 19:22:44 UTC (rev 8778)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attributes_reference.rst 2021-12-08 19:06:44 UTC (rev 8779)
@@ -52,7 +52,7 @@
automatically interpolated when the geometry changes with other nodes, except for a few cases.
So generally, if the node link is still accessible, the attribute it references will be too.
However, anonymous attributes cannot be connected to a completely separate geometry
-that was not created from their source. To transfer attributes between separate pieces of geometry,
+that was not created from their source. To transfer attributes between separate geometries,
the :doc:`/modeling/geometry_nodes/attribute/transfer_attribute` can be used.
@@ -61,12 +61,16 @@
The type of an attribute is the kind of data stored at each element.
-:Float: Floating-point value
-:Integer: 32-bit integer
-:Boolean: True or false value
-:Vector: 3D vector with floating-point values
-:Color: RGBA color with floating-point precision
+ :Boolean: True or false value
+ :Integer: 32-bit integer
+ :Float: Floating-point value
+ :Vector: 3D vector with floating-point values
+ :Color: RGBA color with floating-point precision
+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
+type is preferred when there are matching names. This is particularly important when joining geometry
+with named attributes with the :doc:`/modeling/geometry_nodes/geometry/join_geometry`
Attribute Domains
=================
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/curve/trim_curve.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/curve/trim_curve.rst 2021-12-07 19:22:44 UTC (rev 8778)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/curve/trim_curve.rst 2021-12-08 19:06:44 UTC (rev 8779)
@@ -24,8 +24,11 @@
.. note::
- If the *Start* input is larger than the *End*, then the resulting spline
- will have a single point, located at the sample location of the *Start* value.
+ Since curve :doc:`normals </modeling/geometry_nodes/input/normal>` are calculated the final curve,
+ this node may change the resulting normals when the `Minimum` twist method is used, since the `Minimum`
+ method considers the entire length of the curve to decide the final normals. In some cases the
+ :doc:`/modeling/geometry_nodes/attribute/capture_attribute` could be used to avoid this,
+ by saving the original normals to be used later.
Inputs
======
@@ -36,6 +39,11 @@
Start
The factor or length used to determine where to start each output spline.
+ .. note::
+
+ If the *Start* input is larger than the *End*, then the resulting spline
+ will have a single point, located at the sample location of the *Start* value.
+
End
The factor or length used to determine where to end each output spline.
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/fields.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/fields.rst 2021-12-07 19:22:44 UTC (rev 8778)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/fields.rst 2021-12-08 19:06:44 UTC (rev 8779)
@@ -4,19 +4,19 @@
Fields
******
+Fundamentally, a field is a function: a set of instructions that can transform an arbitrary number
+of inputs into a single output. A field's result can then be calculated many times with different input data.
+They are used all over geometry nodes to allow calculations that have different results
+for every element (mesh vertices, faces, etc.).
+
.. figure:: /images/modeling_geometry-nodes_fields_title.png
:align: center
A field input to a node.
-Fundamentally, a field is a function: a set of instructions that can transform an arbitrary number
-of inputs into a single output. A field's result can then be calculated many times with different input data.
-They are used all over geometry nodes to allow calculations that have different results
-for every element (mesh vertices, faces, etc.).
-
For example, in the figure above, the field connected to the "Set Position" node
depends on two inputs, :doc:`position </modeling/geometry_nodes/input/position>` and
-:doc:`index </modeling/geometry_nodes/input/index>`, and transforms them into
+:doc:`index </modeling/geometry_nodes/input/input_index>`, and transforms them into
a vector using a single instruction.
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/bounding_box.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/bounding_box.rst 2021-12-07 19:22:44 UTC (rev 8778)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/bounding_box.rst 2021-12-08 19:06:44 UTC (rev 8779)
@@ -10,12 +10,13 @@
The Bounding Box node.
-The *Bounding Box* node creates a box with the minimum volume that encapsulates the geometry of the input.
-The node also can output the vector positions of the bounding dimensions.
+The *Bounding Box* node creates a box mesh with the minimum volume that encapsulates
+the geometry of the input. The node also can output the vector positions of the bounding dimensions.
-For instanced geometry, a bounding box is computed for each instance rather than the whole geometry.
-To compute the bounding box of the whole geometry,
-you must use a :doc:`/modeling/geometry_nodes/instances/realize_instances`.
+The mesh output and the *Min* and *Max* outputs do not take instances into account. Instead,
+for instanced geometry, a bounding box is computed for each instance rather than the whole geometry.
+To compute the bounding box including the instances,
+a :doc:`/modeling/geometry_nodes/instances/realize_instances` can be used.
Inputs
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/convex_hull.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/convex_hull.rst 2021-12-07 19:22:44 UTC (rev 8778)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/convex_hull.rst 2021-12-08 19:06:44 UTC (rev 8779)
@@ -14,7 +14,7 @@
.. note::
When the node is used on a geometry with instances, the algorithm will run once per instance,
- resulting in many convex hull meshes in the instance pieces of geometry. The *Realize Instances* node can
+ resulting in many convex hull meshes in the instance geometries. The *Realize Instances* node can
be used to get a convex hull of an entire geometry.
.. important::
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/join_geometry.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/join_geometry.rst 2021-12-07 19:22:44 UTC (rev 8778)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/join_geometry.rst 2021-12-08 19:06:44 UTC (rev 8779)
@@ -5,7 +5,7 @@
Join Geometry Node
******************
-The *Join Geometry* node merges separately generated pieces of geometry into a single one.
+The *Join Geometry* node merges separately generated geometries into a single one.
If the geometry inputs contain different types of data, the output will also contain different data types.
.. figure:: /images/modeling_geometry-nodes_geometry_join-geometry_node.png
@@ -33,12 +33,20 @@
a vector data type. The same heuristic is used for attribute domains, the domain with the most information
will be used for the output.
+.. warning::
+ Like other geometry nodes, this node always outputs generic typed attributes. So instead of a
+ :term:`Vertex Group` attribute, it will create a "Float" attribute on the result, and it will
+ create a generic 2D vector attribute instead of a special "UV Map" attribute. Some other areas
+ of Blender don't properly handle generic attributes in version 3.0.
+
+ Custom face corner normals are also not transferred currently.
+
Inputs
======
Geometry
- Pieces of geometry that will be joined. Multiple inputs are allowed.
+ Geometry that will be joined. Multiple inputs are allowed.
When the node is muted, only the first link will be passed through.
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/instances/instance_on_points.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/instances/instance_on_points.rst 2021-12-07 19:22:44 UTC (rev 8778)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/instances/instance_on_points.rst 2021-12-08 19:06:44 UTC (rev 8779)
@@ -20,7 +20,12 @@
The :ref:`bpy.ops.object.duplicates_make_real` operator can be used to create objects
from instances generated with this node.
+.. note::
+ To instance object types that do not contain geometry, like a light object, the
+ :doc:`/modeling/geometry_nodes/input/object_info` can be used. Other objects like
+ :doc:`Metaball </modeling/metas/introduction>` objects are not supported for instancing.
+
Inputs
======
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/instances/realize_instances.rst
===================================================================
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list