[Bf-docboard-svn] bf-manual: [9695] trunk/blender_docs/manual: Merge branch 'blender-3.4-release'
Aaron Carlisle
noreply at blender.org
Thu Nov 17 21:09:39 CET 2022
Revision: 9695
https://developer.blender.org/rBM9695
Author: Blendify
Date: 2022-11-17 21:09:39 +0100 (Thu, 17 Nov 2022)
Log Message:
-----------
Merge branch 'blender-3.4-release'
Modified Paths:
--------------
trunk/blender_docs/manual/compositing/types/output/viewer.rst
trunk/blender_docs/manual/images/node-types_GeometryNodeViewer.webp
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/output/viewer.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/distribute_points_on_faces.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/index.rst
trunk/blender_docs/manual/render/cycles/gpu_rendering.rst
Added Paths:
-----------
trunk/blender_docs/manual/images/node-types_GeometryNodeDistributePointsInVolume.png
trunk/blender_docs/manual/images/node-types_GeometryNodeSelfObject.webp
trunk/blender_docs/manual/modeling/geometry_nodes/input/self_object.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/distribute_points_in_volume.rst
Property Changed:
----------------
trunk/blender_docs/
Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs 2022-11-17 19:25:34 UTC (rev 9694)
+++ trunk/blender_docs 2022-11-17 20:09:39 UTC (rev 9695)
Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -4,5 +4,5 ##
/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-9611
-/branches/blender-3.4-release/blender_docs:9673-9681
+/branches/blender-3.4-release/blender_docs:9673-9694
/trunk/blender_docs:9673-9675
\ No newline at end of property
Modified: trunk/blender_docs/manual/compositing/types/output/viewer.rst
===================================================================
--- trunk/blender_docs/manual/compositing/types/output/viewer.rst 2022-11-17 19:25:34 UTC (rev 9694)
+++ trunk/blender_docs/manual/compositing/types/output/viewer.rst 2022-11-17 20:09:39 UTC (rev 9695)
@@ -8,8 +8,8 @@
:align: right
:alt: Viewer Node.
-The *Viewer* node is a temporary, in-process viewer.
-It can be plug in anywhere to inspect an image or value map in your node tree.
+The *Viewer* node allows temporarily visualizing data from inside a node graph.
+It can be plugged in anywhere to inspect an image or value map in your node tree.
Select a view node with :kbd:`LMB` to switch between multiple viewer nodes.
It is possible to automatically plug any other node into a Viewer node
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeDistributePointsInVolume.png (from rev 9694, branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeDistributePointsInVolume.png)
===================================================================
(Binary files differ)
Copied: trunk/blender_docs/manual/images/node-types_GeometryNodeSelfObject.webp (from rev 9694, branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSelfObject.webp)
===================================================================
(Binary files differ)
Modified: trunk/blender_docs/manual/images/node-types_GeometryNodeViewer.webp
===================================================================
(Binary files differ)
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/input/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/input/index.rst 2022-11-17 19:25:34 UTC (rev 9694)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/input/index.rst 2022-11-17 20:09:39 UTC (rev 9695)
@@ -16,6 +16,7 @@
material.rst
object_info.rst
scene_time.rst
+ self_object.rst
string.rst
value.rst
vector.rst
Copied: trunk/blender_docs/manual/modeling/geometry_nodes/input/self_object.rst (from rev 9694, branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/input/self_object.rst)
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/input/self_object.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/input/self_object.rst 2022-11-17 20:09:39 UTC (rev 9695)
@@ -0,0 +1,38 @@
+.. index:: Geometry Nodes; Self Object
+.. _bpy.types.GeometryNodeSelfObject:
+
+****************
+Self Object Node
+****************
+
+.. figure:: /images/node-types_GeometryNodeSelfObject.webp
+ :align: right
+ :alt: Self Object node.
+
+The *Self Object* node outputs the object that contains the geometry nodes modifier
+currently being executed. This can be used to retrieve the original transforms.
+
+.. note::
+ The geometry cannot be retrieved from this object with the
+ :doc:`/modeling/geometry_nodes/input/object_info`, since its final geometry is still
+ being evaluated.
+
+
+Inputs
+======
+
+This node has no inputs.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Outputs
+=======
+
+Self Object
+ The object currently being evaluated.
+
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/inspection.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/inspection.rst 2022-11-17 19:25:34 UTC (rev 9694)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/inspection.rst 2022-11-17 20:09:39 UTC (rev 9695)
@@ -53,8 +53,8 @@
Viewer Node
===========
-The Viewer node is used to display intermediate geometry in the Spreadsheet.
-For more information see :doc:`/modeling/geometry_nodes/output/viewer`.
+The Viewer node is used to display intermediate geometry in the :doc:`Spreadsheet Editor </editors/spreadsheet>`
+and the Viewport. For more information see :doc:`/modeling/geometry_nodes/output/viewer`.
Node Warnings
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/output/viewer.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/output/viewer.rst 2022-11-17 19:25:34 UTC (rev 9694)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/output/viewer.rst 2022-11-17 20:09:39 UTC (rev 9695)
@@ -6,15 +6,53 @@
***********
.. figure:: /images/node-types_GeometryNodeViewer.webp
- :align: center
+ :align: right
:alt: The Viewer node.
-Using a *Viewer* node a geometry, and optionally a field evaluated it,
-can be displayed in the :doc:`Spreadsheet Editor </editors/spreadsheet>`.
-A node can be connected with a Viewer node by pressing :kbd:`Shift-Ctrl-LMB`,
-while hovering the mouse over it, just like in the Compositor.
+The *Viewer* node allows viewing data from inside a geometry node group in the
+:doc:`Spreadsheet Editor </editors/spreadsheet>` and the 3D Viewport.
+Any geometry connected can be visualized in the viewport and its attribute values
+can be read in the spreadsheet.
+
+Activation and Deactivation
+---------------------------
+
+Using :kbd:`Shift-Ctrl-LMB` on any node or socket connects it to the viewer and makes it active.
+Using the same shortcut on empty space in the node editor makes deactivates the active viewer.
+When the active viewer is not visible anymore (e.g. another object is selected, or the current
+node group is exited), it is deactivated. The icon in the viewer node header can also be used
+to activate and deactivate it.
+
+.. _bpy.types.SpaceView3D.show_viewer:
+
+In the viewport, the *Show Viewer* option can turn off the viewer node visualization completely
+in order to see the final output of the object's evaluation instead.
+
+Attribute Visualization
+-----------------------
+
+When the viewer has a geometry and a separate value input connected, the values can be visualized
+with a :doc:`viewport overlays </editors/3dview/display/overlays>`. When possible, the
+:ref:`attribute domain <attribute-domains>` used to visualize the data is determined automatically.
+Otherwise, the viewer node falls back to the face corner domain on meshes and the point domain
+on curves. When necessary, the domain can be chosen manually.
+
+.. _bpy.types.View3DOverlay.show_viewer_attribute:
+.. _bpy.types.View3DOverlay.viewer_attribute_opacity:
+
+The attribute overlay opacity can be controlled with the *Viewer Node* setting in the overlays popover.
+
+The spreadsheet now only shows the "Viewer" column for the domain that is selected in the Viewer node.
+
+Pinning
+-------
+
+It can be helpful to pin a specific viewer node in the spreadsheet. When pinned, the spreadsheet
+still references the viewer node even when it becomes inactive.
+
+
Inputs
======
@@ -31,9 +69,14 @@
Properties
==========
-This node has no properties.
+Data Type
+ The data type used to evaluate the *Value* input, visible in the node side-bar.
+Domain
+ The :ref:`attribute domain <attribute-domains>` used to evaluate the *Value* input.
+ The *Auto* option chooses the domain automatically based on the connected nodes.
+
Outputs
=======
Copied: trunk/blender_docs/manual/modeling/geometry_nodes/point/distribute_points_in_volume.rst (from rev 9694, branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/point/distribute_points_in_volume.rst)
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/point/distribute_points_in_volume.rst (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/point/distribute_points_in_volume.rst 2022-11-17 20:09:39 UTC (rev 9695)
@@ -0,0 +1,51 @@
+.. index:: Geometry Nodes; Distribute Points in Volume
+.. _bpy.types.GeometryNodeDistributePointsInVolume:
+
+***************************
+Distribute Points in Volume
+***************************
+
+.. figure:: /images/node-types_GeometryNodeDistributePointsInVolume.png
+ :align: center
+ :alt: Distribute Points in Volume node.
+
+
+The *Distribute Points in Volume* node creates points inside of volume grids.
+The node has two basic modes of operation: distributing points randomly, or in
+a regular grid. Both methods operate on all of the float grids in the volume.
+
+
+Inputs
+======
+
+Volume
+ Standard volume geometry input.
+
+Density
+ Number of points to sample per unit volume.
+
+Spacing
+ Spacing between grid points.
+
+Threshold
+ Minimum value of a volume cell to contain a grid point
+
+
+Properties
+==========
+
+Distribution Method
+ :Random:
+ Distribute points randomly inside of the volume. The local point count is implicitly
+ defined as a product of of the global from the *Density* input and the local voxel value.
+ This method creates a distribution that is not stable as the input volume deforms.
+ :Grid:
+ Distribute the points in a grid pattern inside of the volume. At each grid point, the voxel
+ value is used to determine whether to add a point.
+
+
+Outputs
+=======
+
+Points
+ Standard point cloud geometry output.
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/point/distribute_points_on_faces.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/point/distribute_points_on_faces.rst 2022-11-17 19:25:34 UTC (rev 9694)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/point/distribute_points_on_faces.rst 2022-11-17 20:09:39 UTC (rev 9695)
@@ -24,7 +24,7 @@
Inputs
======
-Geometry
+Mesh
Standard geometry input.
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list