[Bf-docboard-svn] bf-manual: [9456] trunk/blender_docs/manual: Merge branch 'blender-3.3-release'
Hans Goudey
noreply at blender.org
Sun Aug 7 23:30:18 CEST 2022
Revision: 9456
https://developer.blender.org/rBM9456
Author: HooglyBoogly
Date: 2022-08-07 23:30:18 +0200 (Sun, 07 Aug 2022)
Log Message:
-----------
Merge branch 'blender-3.3-release'
Modified Paths:
--------------
trunk/blender_docs/manual/glossary/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/instances/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/mesh_boolean.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/field_at_index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/volume/index.rst
trunk/blender_docs/manual/sculpt_paint/brush/cursor.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/introduction.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/add_curves.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/comb_curves.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/pinch_curves.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/selection_paint.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/slide_curves.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/smooth_curves.rst
trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/snake_hook_curves.rst
Added Paths:
-----------
trunk/blender_docs/manual/images/modeling_geometry-nodes_mesh_shortest-edge-paths_distance.png
trunk/blender_docs/manual/images/node-types_GeometryDeformCurvesOnSurface.png
trunk/blender_docs/manual/images/node-types_GeometryNodeEdgePathsToCurves.png
trunk/blender_docs/manual/images/node-types_GeometryNodeEdgePathsToSelection.png
trunk/blender_docs/manual/images/node-types_GeometryNodeInputInstanceRotation.png
trunk/blender_docs/manual/images/node-types_GeometryNodeInputInstanceScale.png
trunk/blender_docs/manual/images/node-types_GeometryNodeInputShortestEdgePaths.png
trunk/blender_docs/manual/images/node-types_GeometryNodeInterpolateDomain.png
trunk/blender_docs/manual/images/node-types_GeometryNodeMeshToVolume.png
trunk/blender_docs/manual/images/node-types_GeometryNodePoints.png
trunk/blender_docs/manual/images/node-types_GeometryNodeVolumeCube.png
trunk/blender_docs/manual/images/node-types_GeometryUVPackIslands.png
trunk/blender_docs/manual/images/node-types_GeometryUVUnrwap.png
trunk/blender_docs/manual/modeling/geometry_nodes/curve/deform_curves_on_surface.rst
trunk/blender_docs/manual/modeling/geometry_nodes/instances/instance_rotation.rst
trunk/blender_docs/manual/modeling/geometry_nodes/instances/instance_scale.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/edge_paths_to_curves.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/edge_paths_to_selection.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/mesh_to_volume.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/shortest_edge_paths.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/points.rst
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/interpolate_domain.rst
trunk/blender_docs/manual/modeling/geometry_nodes/uv/
trunk/blender_docs/manual/modeling/geometry_nodes/volume/volume_cube.rst
Property Changed:
----------------
trunk/blender_docs/
Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs 2022-08-07 21:28:07 UTC (rev 9455)
+++ trunk/blender_docs 2022-08-07 21:30:18 UTC (rev 9456)
Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -3,4 +3,4 ##
/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-9417
-/branches/blender-3.3-release/blender_docs:9438-9451
\ No newline at end of property
+/branches/blender-3.3-release/blender_docs:9438-9455
\ No newline at end of property
Modified: trunk/blender_docs/manual/glossary/index.rst
===================================================================
--- trunk/blender_docs/manual/glossary/index.rst 2022-08-07 21:28:07 UTC (rev 9455)
+++ trunk/blender_docs/manual/glossary/index.rst 2022-08-07 21:30:18 UTC (rev 9456)
@@ -903,7 +903,7 @@
Vertex
Vertices
- A point in 3D space containing a location. It may also have a defined color.
+ A point in 3D space containing a location.
Vertices are the terminating points of :term:`Edges <Edge>`.
Vertex Group
Copied: trunk/blender_docs/manual/images/modeling_geometry-nodes_mesh_shortest-edge-paths_distance.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/modeling_geometry-nodes_mesh_shortest-edge-paths_distance.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryDeformCurvesOnSurface.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryDeformCurvesOnSurface.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeEdgePathsToCurves.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryNodeEdgePathsToCurves.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeEdgePathsToSelection.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryNodeEdgePathsToSelection.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeInputInstanceRotation.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryNodeInputInstanceRotation.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeInputInstanceScale.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryNodeInputInstanceScale.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeInputShortestEdgePaths.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryNodeInputShortestEdgePaths.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeInterpolateDomain.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryNodeInterpolateDomain.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeMeshToVolume.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryNodeMeshToVolume.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodePoints.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryNodePoints.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeVolumeCube.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryNodeVolumeCube.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryUVPackIslands.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryUVPackIslands.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryUVUnrwap.png (from rev 9455, branches/blender-3.3-release/blender_docs/manual/images/node-types_GeometryUVUnrwap.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/modeling/geometry_nodes/curve/deform_curves_on_surface.rst (from rev 9455, branches/blender-3.3-release/blender_docs/manual/modeling/geometry_nodes/curve/deform_curves_on_surface.rst)
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/curve/deform_curves_on_surface.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/curve/deform_curves_on_surface.rst 2022-08-07 21:30:18 UTC (rev 9456)
@@ -0,0 +1,52 @@
+.. index:: Geometry Nodes; Deform Curves on Surface
+.. _bpy.types.GeometryNodeDeformCurvesOnSurface:
+
+*****************************
+Deform Curves on Surface Node
+*****************************
+
+.. figure:: /images/node-types_GeometryDeformCurvesOnSurface.png
+ :align: center
+ :alt: Deform Curves on Surface node.
+
+
+The *Deform Curves on Surface* node translates and rotates each curve based on the
+difference in its root position. The root position is defined by UV coordinates stored
+on each curve and the :term:`UV Map` selected for the purpose in the
+:ref:`Curves surface settings <bpy.types.Curves.surface>`.
+
+The transformation is calculated based on the difference of the original mesh
+(before shape keys and modifiers are evaluated), and the final mesh.
+
+Unlike other geometry nodes, this node has quite a few implicit inputs:
+
+- The original and evaluated mesh are retrieved from the modifier object's :ref:`surface <bpy.types.Curves.surface>`
+ property. This means the node only works for curves objects.
+- The original and evaluated UV map are also retrieved from the object's surface property.
+- A 3D vector attribute named ``rest_position``, used for calculating tangents for rotating
+ curves that are consistent with the tangents calculated on the original mesh (the rotation
+ needs to be calculated from the normal and tangent of the original and evaluated meshes).
+- A 2D vector attribute on the curve domain named ``surface_uv_coordinate`` to store the
+ location of the root positions on the surface mesh's UV map.
+
+In future development, this node will be generalized so the setup is more flexible.
+
+
+Inputs
+======
+
+Curves
+ Standard curves input.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Outputs
+=======
+
+Curves
+ Standard curves output.
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/curve/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/curve/index.rst 2022-08-07 21:28:07 UTC (rev 9455)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/curve/index.rst 2022-08-07 21:30:18 UTC (rev 9456)
@@ -11,6 +11,7 @@
curve_length.rst
curve_to_mesh.rst
curve_to_points.rst
+ deform_curves_on_surface.rst
fill_curve.rst
fillet_curve.rst
resample_curve.rst
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/index.rst 2022-08-07 21:28:07 UTC (rev 9455)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/index.rst 2022-08-07 21:30:18 UTC (rev 9456)
@@ -39,4 +39,5 @@
utilities/index.rst
vector/index.rst
volume/index.rst
+ uv/index.rst
group.rst
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/instances/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/instances/index.rst 2022-08-07 21:28:07 UTC (rev 9455)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/instances/index.rst 2022-08-07 21:30:18 UTC (rev 9456)
@@ -14,3 +14,11 @@
scale_instances.rst
translate_instances.rst
realize_instances.rst
+
+----
+
+.. toctree::
+ :maxdepth: 1
+
+ instance_rotation.rst
+ instance_scale.rst
Copied: trunk/blender_docs/manual/modeling/geometry_nodes/instances/instance_rotation.rst (from rev 9455, branches/blender-3.3-release/blender_docs/manual/modeling/geometry_nodes/instances/instance_rotation.rst)
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/instances/instance_rotation.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/instances/instance_rotation.rst 2022-08-07 21:30:18 UTC (rev 9456)
@@ -0,0 +1,38 @@
+.. index:: Geometry Nodes; Instance Rotation
+.. _bpy.types.GeometryNodeInputInstanceRotation:
+
+**********************
+Instance Rotation Node
+**********************
+
+.. figure:: /images/node-types_GeometryNodeInputInstanceRotation.png
+ :align: right
+ :alt: Instance Rotation node.
+
+The *Instance Rotation* outputs the XYZ :term:`Euler` rotation of each top-level instance in the
+local space of the modifier object.
+
+The :doc:`/modeling/geometry_nodes/instances` page contains more information about geometry instances.
+
+.. note::
+
+ Though rotations are often displayed in units of degrees in the spreadsheet or node editor,
+ they are stored internally in radians, so this node outputs
+
+Inputs
+======
+
+This node has no inputs.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Outputs
+=======
+
+Rotation
+ Vector that indicates the rotation of each top-level instance in radians.
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list