[Bf-docboard-svn] bf-manual: [9691] branches/blender-3.4-release/blender_docs/manual: Geometry Nodes: viewport preview

[Hans Goudey]

Revision: 9691
          https://developer.blender.org/rBM9691
Author:   HooglyBoogly
Date:     2022-11-17 20:10:21 +0100 (Thu, 17 Nov 2022)
Log Message:
-----------
Geometry Nodes: viewport preview

rBc55d38f00b8c0e6ae8bda9cc66614afe28fb3fc9

Modified Paths:
--------------
    branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeViewer.webp
    branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/inspection.rst
    branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/output/viewer.rst

Modified: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeViewer.webp
===================================================================
(Binary files differ)

Modified: branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/inspection.rst
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/inspection.rst	2022-11-15 15:28:13 UTC (rev 9690)
+++ branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/inspection.rst	2022-11-17 19:10:21 UTC (rev 9691)
@@ -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: branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/output/viewer.rst
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/output/viewer.rst	2022-11-15 15:28:13 UTC (rev 9690)
+++ branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/output/viewer.rst	2022-11-17 19:10:21 UTC (rev 9691)
@@ -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
 =======