[Bf-docboard-svn] bf-manual: [9182] trunk/blender_docs/manual/render: Intial documentation for Light Groups

[Alaska]

Revision: 9182
          https://developer.blender.org/rBM9182
Author:   Alaska
Date:     2022-04-12 05:07:15 +0200 (Tue, 12 Apr 2022)
Log Message:
-----------
Intial documentation for Light Groups

Modified Paths:
--------------
    trunk/blender_docs/manual/render/cycles/object_settings/object_data.rst
    trunk/blender_docs/manual/render/layers/passes.rst
    trunk/blender_docs/manual/render/lights/world.rst

Modified: trunk/blender_docs/manual/render/cycles/object_settings/object_data.rst
===================================================================
--- trunk/blender_docs/manual/render/cycles/object_settings/object_data.rst	2022-04-12 00:14:28 UTC (rev 9181)
+++ trunk/blender_docs/manual/render/cycles/object_settings/object_data.rst	2022-04-12 03:07:15 UTC (rev 9182)
@@ -240,3 +240,17 @@
      - .. figure:: /images/render_cycles_object-settings_caustics-example2.png
 
           Rendering caustics inside an eye using MNEE at 32 samples per pixel.
+
+
+Light Group
+-----------
+
+.. _bpy.types.Object.lightgroup:
+Light Group
+   Select the :ref:`Light Group <bpy.types.ViewLayer.active_lightgroup_index>` to add the
+   current *Object* or *Light* too.
+
+   Add Light Group
+      If the name input into the *Light Group* field does not align with an existing
+      Light Group, then pressing this button will create a *Light Group* with that name
+      and assign the selected *Object* or *Light* to it.  

Modified: trunk/blender_docs/manual/render/layers/passes.rst
===================================================================
--- trunk/blender_docs/manual/render/layers/passes.rst	2022-04-12 00:14:28 UTC (rev 9181)
+++ trunk/blender_docs/manual/render/layers/passes.rst	2022-04-12 03:07:15 UTC (rev 9182)
@@ -261,6 +261,23 @@
    A *Value* type can be used for any single numerical value.
 
 
+Light Groups
+============
+
+:guilabel:`Cycles only`
+
+Light Groups provide render passes that only contains information from the lights within that group.
+Light Groups can be used to easily tweak the lighting color and intensity of specific lights without
+having to re-render the scene.
+
+.. _bpy.types.ViewLayer.active_lightgroup_index:
+
+Active Light Group Index
+   The name of the render pass. This is the name that is used when adding 
+   :ref:`World Shaders <bpy.types.World.lightgroup>`, :ref:`Lights and Objects <bpy.types.Object.lightgroup>`
+   to *Light Groups*.
+
+
 Combining
 =========
 

Modified: trunk/blender_docs/manual/render/lights/world.rst
===================================================================
--- trunk/blender_docs/manual/render/lights/world.rst	2022-04-12 00:14:28 UTC (rev 9181)
+++ trunk/blender_docs/manual/render/lights/world.rst	2022-04-12 03:07:15 UTC (rev 9182)
@@ -29,6 +29,18 @@
 strength factor for the intensity of the light.
 
 
+.. _bpy.types.World.lightgroup:
+
+Light Group :guilabel:`Cycles only`
+   Select the :ref:`Light Group <bpy.types.ViewLayer.active_lightgroup_index>` to add the
+   current *World Surface Shader* too.
+   
+   Add Light Group
+      If the name input into the *Light Group* field does not align with an existing
+      Light Group, then pressing this button will create a *Light Group* with that name
+      and assign this *World Shader* to it.  
+
+
 Image Based Lighting
 --------------------