[Bf-docboard-svn] bf-manual: [7982] branches/blender-2.93-release/blender_docs/manual/render: Cycles: add a spread setting for area lights

[Aaron Carlisle]

Revision: 7982
          https://developer.blender.org/rBM7982
Author:   Blendify
Date:     2021-04-23 21:20:57 +0200 (Fri, 23 Apr 2021)
Log Message:
-----------
Cycles: add a spread setting for area lights

rBa4260ac21977acd5b9cd792f2a68c3aa78dd91cd

Modified Paths:
--------------
    branches/blender-2.93-release/blender_docs/manual/render/cycles/light_settings.rst
    branches/blender-2.93-release/blender_docs/manual/render/lights/light_object.rst

Modified: branches/blender-2.93-release/blender_docs/manual/render/cycles/light_settings.rst
===================================================================
--- branches/blender-2.93-release/blender_docs/manual/render/cycles/light_settings.rst	2021-04-23 18:30:51 UTC (rev 7981)
+++ branches/blender-2.93-release/blender_docs/manual/render/cycles/light_settings.rst	2021-04-23 19:20:57 UTC (rev 7982)
@@ -38,22 +38,26 @@
    and enabling this option will enable indirect light sampling to be used in addition to reduce noise.
 
 
+Area Lights
+===========
+
 .. _render-cycles-lights-area-portals:
 
-Light Portals
-=============
+Portals
+   Area lights can also function as light portals to help sample the environment light,
+   and significantly reduce noise in interior scenes.
+   Note that rendering with portals is usually slower, but as it converges more quickly, less samples are required.
 
-Area lights can also function as light portals to help sample the environment light,
-and significantly reduce noise in interior scenes.
-Note that rendering with portals is usually slower, but as it converges more quickly, less samples are required.
+   Light portals work by enabling the *Portal* option, and placing areas lights in
+   windows, door openings, and any place where light will enter the interior.
 
-Light portals work by enabling the *Portal* option, and placing areas lights in
-windows, door openings, and any place where light will enter the interior.
+   In outdoor scenes most rays do not bounce much and just fly off into the sky and therefore,
+   light portals are not helpful for outdoor scenes.
 
-In outdoor scenes most rays do not bounce much and just fly off into the sky and therefore,
-light portals are not helpful for outdoor scenes.
+   .. figure:: /images/render_cycles_light-settings_portals2.jpg
+   .. figure:: /images/render_cycles_light-settings_portals.jpg
 
-.. figure:: /images/render_cycles_light-settings_portals2.jpg
-.. figure:: /images/render_cycles_light-settings_portals.jpg
+      White Room model by Jay Hardy.
 
-   White Room model by Jay Hardy.
+Beam Shape
+----------

Modified: branches/blender-2.93-release/blender_docs/manual/render/lights/light_object.rst
===================================================================
--- branches/blender-2.93-release/blender_docs/manual/render/lights/light_object.rst	2021-04-23 18:30:51 UTC (rev 7981)
+++ branches/blender-2.93-release/blender_docs/manual/render/lights/light_object.rst	2021-04-23 19:20:57 UTC (rev 7982)
@@ -76,7 +76,7 @@
    Lights with larger size have softer shadows and specular highlights.
 
 
-Spot Shape
+Beam Shape
 ----------
 
 .. figure:: /images/render_lights_light-object_terms.png
@@ -171,6 +171,21 @@
    Dimensions for the *Square* or *Rectangle*.
 
 
+Beam Shape
+----------
+
+.. _bpy.types.AreaLight.spread:
+
+Spread :guilabel:`Cycles Only`
+   How wide the emitted light fans out controling how diffused the light is.
+   Larger values create soft shadows while smaller values create sharper light
+   simulating a `gridded softbox <https://en.wikipedia.org/wiki/Softbox>`__.
+
+   .. figure:: /images/render_lights_light-object-area-spread.png
+
+      Example of Spread at different angles.
+
+
 .. _light-type-sun:
 .. _bpy.types.SunLight: