Doc: Describe SpotLight Qt Quick 3D type

Update screenshots of all light types in 3D Editor.

Task-number: QDS-2056
Change-Id: I5f4fbacd01850c7cedcbd187969b9f310507649c
Reviewed-by: Miikka Heikkinen <miikka.heikkinen@qt.io>
Reviewed-by: Johanna Vanhatapio <johanna.vanhatapio@qt.io>
Reviewed-by: Mahmoud Badri <mahmoud.badri@qt.io>

7 files changed, 18 insertions, 1 deletions

diff --git a/doc/qtdesignstudio/images/area-light.png b/doc/qtdesignstudio/images/area-light.png
deleted file mode 100644
index 89d4c31dfa..0000000000
--- a/doc/qtdesignstudio/images/area-light.png
+++ /dev/null
diff --git a/doc/qtdesignstudio/images/directional-light.png b/doc/qtdesignstudio/images/directional-light.png
deleted file mode 100644
index cf7a1214cb..0000000000
--- a/doc/qtdesignstudio/images/directional-light.png
+++ /dev/null
diff --git a/doc/qtdesignstudio/images/studio-3d-area-light.png b/doc/qtdesignstudio/images/studio-3d-area-light.png
new file mode 100644
index 0000000000..d31661e992
--- /dev/null
+++ b/doc/qtdesignstudio/images/studio-3d-area-light.png
diff --git a/doc/qtdesignstudio/images/studio-3d-directional-light.png b/doc/qtdesignstudio/images/studio-3d-directional-light.png
index f5e16e8e40..e43f6ec541 100644
--- a/doc/qtdesignstudio/images/studio-3d-directional-light.png
+++ b/doc/qtdesignstudio/images/studio-3d-directional-light.png
diff --git a/doc/qtdesignstudio/images/studio-3d-point-light.png b/doc/qtdesignstudio/images/studio-3d-point-light.png
index 9252f47c78..ac3b7f51f9 100644
--- a/doc/qtdesignstudio/images/studio-3d-point-light.png
+++ b/doc/qtdesignstudio/images/studio-3d-point-light.png
diff --git a/doc/qtdesignstudio/images/studio-3d-spot-light.png b/doc/qtdesignstudio/images/studio-3d-spot-light.png
new file mode 100644
index 0000000000..cc678a801d
--- /dev/null
+++ b/doc/qtdesignstudio/images/studio-3d-spot-light.png
diff --git a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-lights.qdoc b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-lights.qdoc
index cfd19be883..361514e053 100644
--- a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-lights.qdoc
+++ b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-lights.qdoc
@@ -42,6 +42,7 @@
     \list
         \li \l{DirectionalLight}{Light Directional}
         \li \l{PointLight}{Light Point}
+        \li \l{SpotLight}{Light Spot}
         \li \l{AreaLight}{Light Area}
     \endlist
 
@@ -121,6 +122,22 @@
     Aside from fade, a point light has the same properties as a directional
     light.
 
+    \section1 Spot Light
+
+    A spot light emits light towards one direction in a cone shape.
+    The light intensity diminishes when approaching the value of the
+    \uicontrol {Cone angle} property. The angle at which the light
+    intensity starts to diminish is defined by the
+    \uicontrol {Inner cone angle} property. Both angles are defined in degrees.
+
+    Inside the inner cone angle, the spot light behaves similarly to the point
+    light. There the light intensity diminishes according to inverse-square-law.
+    However, the fade-off (and range) can be controlled with the
+    \uicontrol {Constant fade}, \uicontrol {Linear fade}, and
+    \uicontrol {Quadratic fade} properties.
+
+    \image studio-3d-spot-light.png
+
     \section1 Area Light
 
     An area light is similar to the directional light. However, instead of
@@ -135,7 +152,7 @@
     The image below shows an example on how to light an object with different
     colors using two different area lights.
 
-    \image area-light.png
+    \image studio-3d-area-light.png
 
     You can rotate, scale, and move area lights.