[Bf-docboard-svn] bf-manual: [9697] branches/blender-3.4-release/blender_docs/manual: Geometry Nodes: new Sample UV Surface node

[Hans Goudey]

Revision: 9697
          https://developer.blender.org/rBM9697
Author:   HooglyBoogly
Date:     2022-11-17 22:35:05 +0100 (Thu, 17 Nov 2022)
Log Message:
-----------
Geometry Nodes: new Sample UV Surface node

rBe65598b4fa2059ae6293464f5158eb341a84b814

Modified Paths:
--------------
    branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/curve/deform_curves_on_surface.rst
    branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/mesh/sample_nearest_surface.rst

Added Paths:
-----------
    branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleUVSurface.webp
    branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/mesh/sample_uv_surface.rst

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

Index: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleUVSurface.webp
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleUVSurface.webp	2022-11-17 20:51:47 UTC (rev 9696)
+++ branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleUVSurface.webp	2022-11-17 21:35:05 UTC (rev 9697)

Property changes on: branches/blender-3.4-release/blender_docs/manual/images/node-types_GeometryNodeSampleUVSurface.webp
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/webp
\ No newline at end of property
Modified: branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/curve/deform_curves_on_surface.rst
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/curve/deform_curves_on_surface.rst	2022-11-17 20:51:47 UTC (rev 9696)
+++ branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/curve/deform_curves_on_surface.rst	2022-11-17 21:35:05 UTC (rev 9697)
@@ -31,7 +31,9 @@
 
 In future development, this node will be generalized so the setup is more flexible.
 
+Parts of the internal operation are similar to the :doc:`/modeling/geometry_nodes/mesh/sample_uv_surface`.
 
+
 Inputs
 ======
 

Modified: branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/mesh/sample_nearest_surface.rst
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/mesh/sample_nearest_surface.rst	2022-11-17 20:51:47 UTC (rev 9696)
+++ branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/mesh/sample_nearest_surface.rst	2022-11-17 21:35:05 UTC (rev 9697)
@@ -32,8 +32,7 @@
 
 Sample Position
    The position to start from when finding the closest location on the target mesh.
-   Used in the *Nearest Face Interpolated* and *Nearest* modes. By default, this is the same as
-   if the :doc:`/modeling/geometry_nodes/input/position` was connected.
+   By default, this is the same as if the :doc:`/modeling/geometry_nodes/input/position` was connected.
 
 
 Properties

Added: branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/mesh/sample_uv_surface.rst
===================================================================
--- branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/mesh/sample_uv_surface.rst	                        (rev 0)
+++ branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/mesh/sample_uv_surface.rst	2022-11-17 21:35:05 UTC (rev 9697)
@@ -0,0 +1,52 @@
+.. index:: Geometry Nodes; Sample UV Surface
+.. _bpy.types.GeometryNodeSampleUVSurface:
+
+**********************
+Sample UV Surface Node
+**********************
+
+.. figure:: /images/node-types_GeometryNodeSampleUVSurface.webp
+   :align: center
+   :alt: Sample UV Surface node.
+
+The *Sample UV Surface* node finds values on a mesh's surface at specific UV locations.
+Internally the process is a "reverse UV lookup" from a location in 2D space. The node then
+finds the face that corresponds to each UV coordinate, and the location within that face.
+
+.. warning::
+   Because of the node's method of computatation, the UV map should not have any overlapping faces.
+   If the UV map is sampled at a location with no faces or overlapping faces, the node will
+   output the default value for the data type, which is zeros for most types.
+
+
+Inputs
+======
+
+Mesh
+   A geometry containing the mesh with a UV map for sampling.
+
+Value
+   A field to evaluate on the target *Mesh* geometry for later sampling at the surface positions.
+   
+Source UV Map
+   The mesh UV map to sample, evaluated on the *Mesh* input. Should not have overlapping faces.
+
+Sample UV
+   The coordinates to sample within the UV map.
+
+
+Properties
+==========
+
+Data Type
+   The :ref:`data type <attribute-data-types>` to use for the retrieved values.
+
+
+Outputs
+=======
+
+Value
+   The data retrieved and interpolated from the *Mesh* geometry, mapped based on the node's settings and inputs.
+
+Is Valid
+   Whether the node could find a single face to sample at the UV coordinate.


Property changes on: branches/blender-3.4-release/blender_docs/manual/modeling/geometry_nodes/mesh/sample_uv_surface.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property