[Bf-docboard-svn] bf-manual: [7067] trunk/blender_docs/manual: Data Transfer: Improve ray cast discription

[Aaron Carlisle]

Revision: 7067
          https://developer.blender.org/rBM7067
Author:   Blendify
Date:     2020-09-09 00:47:06 +0200 (Wed, 09 Sep 2020)
Log Message:
-----------
Data Transfer: Improve ray cast discription

@mont29 may want to review/improve this

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/modifiers/modify/data_transfer.rst
    trunk/blender_docs/manual/scene_layout/object/editing/relations.rst

Modified: trunk/blender_docs/manual/modeling/modifiers/modify/data_transfer.rst
===================================================================
--- trunk/blender_docs/manual/modeling/modifiers/modify/data_transfer.rst	2020-09-08 21:36:16 UTC (rev 7066)
+++ trunk/blender_docs/manual/modeling/modifiers/modify/data_transfer.rst	2020-09-08 22:47:06 UTC (rev 7067)
@@ -200,6 +200,13 @@
    (e.g. from a "hand" mesh towards a "full body" one).
 
 Ray Radius
-   For ray-casting-based mapping methods, the radius of the cast rays.
-   Especially important for 1D and 2D items (i.e. vertices and edges),
-   without some width there would be nearly no ray-casting matches...
+   The starting ray radius to use when `Ray Casting <https://en.wikipedia.org/wiki/Ray_casting>`
+   against vertices or edges. When transferring data between meshes Blender performs a series of
+   ray casts to generate mappings. Blender starts with a ray with the radius defined here,
+   if that does not return a hit than the radius is progressively
+   increased until a positive hit or a limit is reached.
+   This property acts as an accuracy/performance control;
+   using a lower ray radius will be more accurate however,
+   might take longer if Blender has to progressively increase the limit.
+   Lower values will work better for dense meshes with lots of detail
+   while larger values are probably better suited for simple meshes.

Modified: trunk/blender_docs/manual/scene_layout/object/editing/relations.rst
===================================================================
--- trunk/blender_docs/manual/scene_layout/object/editing/relations.rst	2020-09-08 21:36:16 UTC (rev 7066)
+++ trunk/blender_docs/manual/scene_layout/object/editing/relations.rst	2020-09-08 22:47:06 UTC (rev 7067)
@@ -173,10 +173,18 @@
    Max Distance
       Maximum allowed distance between source and destination element (for non-topology mappings).
 
-.. (TODO) The below definition is confusing for users. Change?
+Ray Radius
+   The starting ray radius to use when `Ray Casting <https://en.wikipedia.org/wiki/Ray_casting>`
+   against vertices or edges. When transferring data between meshes Blender performs a series of
+   ray casts to generate mappings. Blender starts with a ray with the radius defined here,
+   if that does not return a hit than the radius is progressively
+   increased until a positive hit or a limit is reached.
+   This property acts as an accuracy/performance control;
+   using a lower ray radius will be more accurate however,
+   might take longer if Blender has to progressively increase the limit.
+   Lower values will work better for dense meshes with lots of detail
+   while larger values are probably better suited for simple meshes.
 
-Ray Radius
-   Width of rays. Useful when ray casting against vertices or edges.
 Mix Mode
    How to affect destination elements with source values.