REGoth-project · charlydelta · Sep 29, 2019 · Sep 29, 2019 · Oct 2, 2019 · Oct 2, 2019
diff --git a/docs-source/case-studies/images/sky_1_raw_bg_color.png b/docs-source/case-studies/images/sky_1_raw_bg_color.png
diff --git a/docs-source/case-studies/images/sky_2_color_layer.png b/docs-source/case-studies/images/sky_2_color_layer.png
diff --git a/docs-source/case-studies/images/sky_3_clouds_layer.png b/docs-source/case-studies/images/sky_3_clouds_layer.png
diff --git a/docs-source/case-studies/images/sky_color_layer_raw.png b/docs-source/case-studies/images/sky_color_layer_raw.png
diff --git a/docs-source/case-studies/images/sky_no_color_layer.png b/docs-source/case-studies/images/sky_no_color_layer.png
diff --git a/docs-source/case-studies/sky.rst b/docs-source/case-studies/sky.rst
@@ -0,0 +1,51 @@
+.. _sky:
+
+Sky
+===
+
+The sky consists of several layers, and uses different primitives as model depending on the game
+and graphic settings.
+The original Gothic game only used a plane to render the sky texture, while Gothic II added the
+possibility to render the sky as a dome, given enough processing power.
+
+The different layers of the sky are (1), a plain color layer as background (:numref:`fig-sky1`),
+(2) a color layer additively blended in (:numref:`fig-sky2`), and (3) the actual alpha-blended sky
+texture (:numref:`fig-sky3`).
+
+.. _fig-sky1:
+.. figure:: images/sky_1_raw_bg_color.png
+   :alt: Sky raw background color.
+
+   Background sky color (1) in Gothic II.
+
+.. _fig-sky2:
+.. figure:: images/sky_2_color_layer.png
+   :alt: Sky raw background color and color layer.
+
+   Background sky color (1) together with an additively blended color layer (2) rendered as sphere
+   in Gothic II.
+
+.. _fig-sky3:
+.. figure:: images/sky_3_clouds_layer.png
+   :alt: Sky raw background color, color layer, and texture layer.
+
+   Background sky color (1) together with an additively blended color layer (2) rendered as
+   sphere, as well as the alpha-blended sky texture (3) layer in Gothic II.
+
+
+The additively blended color layer (2) is necessary, because the sky looks dull otherwise.  See, for
+example, :numref:`fig-sky-no-color-layer`, where this layer was deactivated.  In
+:numref:`fig-sky-color-layer`, the color layer (2) can be seen on black background.
+
+.. _fig-sky-no-color-layer:
+.. figure:: images/sky_no_color_layer.png
+   :alt: Sky with raw background color and texture layer, but without color layer.
+
+   Background sky color (1) and the alpha-blended sky texture layer (3) without the additively
+   blended color layer (2).
+
+.. _fig-sky-color-layer:
+.. figure:: images/sky_color_layer_raw.png
+   :alt: Color layer only.
+
+   Additively blended color layer (2) only, rendered on black background.
diff --git a/docs-source/index.rst b/docs-source/index.rst
@@ -49,6 +49,7 @@ Welcome to REGoth's documentation!
   case-studies/scene-structure
   case-studies/character-statemachine
   case-studies/daedalus-vm
+  case-studies/sky
 
 
 .. toctree::

diff --git a/docs/_images/sky_1_raw_bg_color.png b/docs/_images/sky_1_raw_bg_color.png
diff --git a/docs/_images/sky_2_color_layer.png b/docs/_images/sky_2_color_layer.png
diff --git a/docs/_images/sky_3_clouds_layer.png b/docs/_images/sky_3_clouds_layer.png
diff --git a/docs/_images/sky_color_layer_raw.png b/docs/_images/sky_color_layer_raw.png
diff --git a/docs/_images/sky_no_color_layer.png b/docs/_images/sky_no_color_layer.png
diff --git a/docs/_sources/case-studies/sky.rst.txt b/docs/_sources/case-studies/sky.rst.txt
@@ -0,0 +1,51 @@
+.. _sky:
+
+Sky
+===
+
+The sky consists of several layers, and uses different primitives as model depending on the game
+and graphic settings.
+The original Gothic game only used a plane to render the sky texture, while Gothic II added the
+possibility to render the sky as a dome, given enough processing power.
+
+The different layers of the sky are (1), a plain color layer as background (:numref:`fig-sky1`),
+(2) a color layer additively blended in (:numref:`fig-sky2`), and (3) the actual alpha-blended sky
+texture (:numref:`fig-sky3`).
+
+.. _fig-sky1:
+.. figure:: images/sky_1_raw_bg_color.png
+   :alt: Sky raw background color.
+
+   Background sky color (1) in Gothic II.
+
+.. _fig-sky2:
+.. figure:: images/sky_2_color_layer.png
+   :alt: Sky raw background color and color layer.
+
+   Background sky color (1) together with an additively blended color layer (2) rendered as sphere
+   in Gothic II.
+
+.. _fig-sky3:
+.. figure:: images/sky_3_clouds_layer.png
+   :alt: Sky raw background color, color layer, and texture layer.
+
+   Background sky color (1) together with an additively blended color layer (2) rendered as
+   sphere, as well as the alpha-blended sky texture (3) layer in Gothic II.
+
+
+The additively blended color layer (2) is necessary, because the sky looks dull otherwise.  See, for
+example, :numref:`fig-sky-no-color-layer`, where this layer was deactivated.  In
+:numref:`fig-sky-color-layer`, the color layer (2) can be seen on black background.
+
+.. _fig-sky-no-color-layer:
+.. figure:: images/sky_no_color_layer.png
+   :alt: Sky with raw background color and texture layer, but without color layer.
+
+   Background sky color (1) and the alpha-blended sky texture layer (3) without the additively
+   blended color layer (2).
+
+.. _fig-sky-color-layer:
+.. figure:: images/sky_color_layer_raw.png
+   :alt: Color layer only.
+
+   Additively blended color layer (2) only, rendered on black background.
diff --git a/docs/_sources/index.rst.txt b/docs/_sources/index.rst.txt
@@ -49,6 +49,7 @@ Welcome to REGoth's documentation!
   case-studies/scene-structure
   case-studies/character-statemachine
   case-studies/daedalus-vm
+  case-studies/sky
 
 
 .. toctree::

diff --git a/docs/case-studies/character-statemachine.html b/docs/case-studies/character-statemachine.html
@@ -127,6 +127,7 @@
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="daedalus-vm.html">Daedalus VM</a></li>
+<li class="toctree-l1"><a class="reference internal" href="sky.html">Sky</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Code Reference</span></p>
 <ul>

diff --git a/docs/case-studies/daedalus-vm.html b/docs/case-studies/daedalus-vm.html
@@ -36,7 +36,7 @@
   <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
     <link rel="index" title="Index" href="../genindex.html" />
     <link rel="search" title="Search" href="../search.html" />
-    <link rel="next" title="Core" href="../code-ref/core.html" />
+    <link rel="next" title="Sky" href="sky.html" />
     <link rel="prev" title="Character state machine" href="character-statemachine.html" /> 
 </head>
 
@@ -135,6 +135,7 @@
 </li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="sky.html">Sky</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Code Reference</span></p>
 <ul>
@@ -419,7 +420,7 @@ <h4>Current Instance<a class="headerlink" href="#current-instance" title="Permal
 
     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-        <a href="../code-ref/core.html" class="btn btn-neutral float-right" title="Core" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
+        <a href="sky.html" class="btn btn-neutral float-right" title="Sky" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
 
 
         <a href="character-statemachine.html" class="btn btn-neutral float-left" title="Character state machine" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>

diff --git a/docs/case-studies/object-kinds.html b/docs/case-studies/object-kinds.html
@@ -113,6 +113,7 @@
 <li class="toctree-l1"><a class="reference internal" href="scene-structure.html">Scene structure</a></li>
 <li class="toctree-l1"><a class="reference internal" href="character-statemachine.html">Character state machine</a></li>
 <li class="toctree-l1"><a class="reference internal" href="daedalus-vm.html">Daedalus VM</a></li>
+<li class="toctree-l1"><a class="reference internal" href="sky.html">Sky</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Code Reference</span></p>
 <ul>

diff --git a/docs/case-studies/scene-structure.html b/docs/case-studies/scene-structure.html
@@ -112,6 +112,7 @@
 </li>
 <li class="toctree-l1"><a class="reference internal" href="character-statemachine.html">Character state machine</a></li>
 <li class="toctree-l1"><a class="reference internal" href="daedalus-vm.html">Daedalus VM</a></li>
+<li class="toctree-l1"><a class="reference internal" href="sky.html">Sky</a></li>
 </ul>
 <p class="caption"><span class="caption-text">Code Reference</span></p>
 <ul>
-Original file line number
+Diff line change
@@ Expand Up / @@ -127,6 +127,7 @@ @@
     </ul>
     </li>
     <li class="toctree-l1"><a class="reference internal" href="daedalus-vm.html">Daedalus VM</a></li>
+    <li class="toctree-l1"><a class="reference internal" href="sky.html">Sky</a></li>
     </ul>
     <p class="caption"><span class="caption-text">Code Reference</span></p>
     <ul>
@@ Expand Down @@