cpp
/
crown-engine
mirror of https://github.com/crownengine/crown.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242
							<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />

    <meta property="article:modified_time" content="2026-02-20T16:56:59+00:00" /><meta property="og:title" content="Lighting" />
<meta property="og:type" content="website" />
<meta property="og:url" content="https://docs.crownengine.org/html/latest/rendering/lighting.html" />
<meta property="og:site_name" content="Crown 0.62.0 Manual" />
<meta property="og:description" content="Crown provides three light types: directional, omni, and spot. Lights are regular Units with a Light Component attached; the component’s Type property selects the light type. Add a light to the level using Spawn-&gt; Light in the Menubar. Directional light: A directional light..." />
<meta property="og:image" content="https://docs.crownengine.org/html/latest/_images/lights_directional.png" />
<meta property="og:image:alt" content="Crown 0.62.0 Manual" />
<meta name="description" content="Crown provides three light types: directional, omni, and spot. Lights are regular Units with a Light Component attached; the component’s Type property selects the light type. Add a light to the level using Spawn-&gt; Light in the Menubar. Directional light: A directional light..." />

  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Lighting &mdash; Crown 0.62.0 Manual 0.62.0 documentation</title>
      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
      <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
    <link rel="shortcut icon" href="../_static/org.crownengine.Crown.svg"/>
    <link rel="canonical" href="https://docs.crownengine.org/html/latest/rendering/lighting.html" />
  <!--[if lt IE 9]>
    <script src="../_static/js/html5shiv.min.js"></script>
  <![endif]-->
  
        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
        <script src="../_static/jquery.js"></script>
        <script src="../_static/underscore.js"></script>
        <script src="../_static/doctools.js"></script>
    <script src="../_static/js/theme.js"></script>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="copyright" title="Copyright" href="../copyright.html" />
    <link rel="next" title="Materials" href="materials.html" />
    <link rel="prev" title="Rendering" href="index.html" /> 
</head>

<body class="wy-body-for-nav"> 
  <div class="wy-grid-for-nav">
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search" >
            <a href="../index.html">
            <img src="../_static/org.crownengine.Crown.svg" class="logo" alt="Logo"/>
          </a>
              <div class="version">
                Crown 0.62.0 Manual
              </div>
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>
        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
              <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
<li class="toctree-l1"><a class="reference internal" href="../introduction.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="../installing_crown/index.html">Installing Crown</a></li>
<li class="toctree-l1"><a class="reference internal" href="../getting_started/index.html">Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="../level_editor/index.html">Level Editor</a></li>
<li class="toctree-l1"><a class="reference internal" href="../importing_resources/index.html">Importing Resources</a></li>
<li class="toctree-l1"><a class="reference internal" href="../units/index.html">Units</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Rendering</a><ul class="current">
<li class="toctree-l2 current"><a class="current reference internal" href="#">Lighting</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#directional-light">Directional light</a></li>
<li class="toctree-l3"><a class="reference internal" href="#local-lights">Local lights</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#omni-light">Omni light</a></li>
<li class="toctree-l4"><a class="reference internal" href="#spot-light">Spot light</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#shadows">Shadows</a></li>
<li class="toctree-l3"><a class="reference internal" href="#skydome">Skydome</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="materials.html">Materials</a></li>
<li class="toctree-l2"><a class="reference internal" href="shading_environment.html">Shading Environment</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
<li class="toctree-l1"><a class="reference internal" href="../gameplay/index.html">Writing Gameplay</a></li>
<li class="toctree-l1"><a class="reference internal" href="../deploying/index.html">Deploying</a></li>
<li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="../lua_api.html">Lua API reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="../glossary.html">Glossary</a></li>
<li class="toctree-l1"><a class="reference internal" href="../copyright.html">License</a></li>
<li class="toctree-l1"><a class="reference internal" href="../hackers/index.html">Engine Hackers</a></li>
</ul>

        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="../index.html">Crown 0.62.0 Manual</a>
      </nav>

      <div class="wy-nav-content">
        <div class="rst-content">
          <div role="navigation" aria-label="Page navigation">
  <ul class="wy-breadcrumbs">
      <li><a href="../index.html" class="icon icon-home"></a> &raquo;</li>
          <li><a href="index.html">Rendering</a> &raquo;</li>
      <li>Lighting</li>
      <li class="wy-breadcrumbs-aside">
            <a href="../_sources/rendering/lighting.rst.txt" rel="nofollow"> View page source</a>
      </li>
  </ul>
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
             
  <section id="lighting">
<h1>Lighting<a class="headerlink" href="#lighting" title="Permalink to this headline">¶</a></h1>
<p>Crown provides three light types: directional, omni, and spot. Lights are
regular <a class="reference internal" href="../units/introduction.html#units"><span class="std std-ref">Units</span></a> with a Light Component attached; the component’s
<code class="docutils literal notranslate"><span class="pre">Type</span></code> property selects the light type. Add a light to the level using
<code class="docutils literal notranslate"><span class="pre">Spawn</span></code> -&gt; <code class="docutils literal notranslate"><span class="pre">Light</span></code> in the <a class="reference internal" href="../level_editor/level_editor.html#editor-overview"><span class="std std-ref">Menubar</span></a>.</p>
<section id="directional-light">
<h2>Directional light<a class="headerlink" href="#directional-light" title="Permalink to this headline">¶</a></h2>
<p>A directional light illuminates objects from a uniform direction; The
brightest directional light in a Level (the one with the highest
<code class="docutils literal notranslate"><span class="pre">Intensity</span></code>) is considered the sun. The sun typically renders shadows for
the entire level using Cascaded Shadow Maps. Crown adds a default sun unit to
new levels created from the <a class="reference internal" href="../level_editor/level_editor.html#level-editor"><span class="std std-ref">Level Editor</span></a>.</p>
<figure class="align-center" id="id1">
<img alt="../_images/lights_directional.png" src="../_images/lights_directional.png" />
<figcaption>
<p><span class="caption-text">A directional light illuminating objects in the Level Viewport.</span><a class="headerlink" href="#id1" title="Permalink to this image">¶</a></p>
</figcaption>
</figure>
</section>
<section id="local-lights">
<h2>Local lights<a class="headerlink" href="#local-lights" title="Permalink to this headline">¶</a></h2>
<p>Local lights affect only nearby objects. They expose a maximum range property
to limit their influence. Keep ranges reasonably small to reduce performance
cost and to avoid shadowing artifacts; very large ranges can make shadows and
lighting harder to tune.</p>
<section id="omni-light">
<h3>Omni light<a class="headerlink" href="#omni-light" title="Permalink to this headline">¶</a></h3>
<p>Omni lights emit in all directions and are suitable for simulating point light
sources such as light bulbs, fireplaces and so on.</p>
<figure class="align-center" id="id2">
<img alt="../_images/lights_omni.png" src="../_images/lights_omni.png" />
<figcaption>
<p><span class="caption-text">An omni light illuminating objects in the Level Viewport.</span><a class="headerlink" href="#id2" title="Permalink to this image">¶</a></p>
</figcaption>
</figure>
</section>
<section id="spot-light">
<h3>Spot light<a class="headerlink" href="#spot-light" title="Permalink to this headline">¶</a></h3>
<p>Spot lights emit light inside a cone. Use the Light Component’s <code class="docutils literal notranslate"><span class="pre">Spot</span> <span class="pre">Angle</span></code>
and <code class="docutils literal notranslate"><span class="pre">Range</span></code> to shape the cone. Spot lights are appropriate for torches,
street lights and similar sources.</p>
<figure class="align-center" id="id3">
<img alt="../_images/lights_spot.png" src="../_images/lights_spot.png" />
<figcaption>
<p><span class="caption-text">A spot light illuminating objects in the Level Viewport.</span><a class="headerlink" href="#id3" title="Permalink to this image">¶</a></p>
</figcaption>
</figure>
</section>
</section>
<section id="shadows">
<h2>Shadows<a class="headerlink" href="#shadows" title="Permalink to this headline">¶</a></h2>
<p>Crown uses different shadow mapping approaches depending on the light type.
Directional light shadows are rendered with Cascaded Shadow Maps (4 splits).
Local lights combine tetrahedron mapping and regular shadow maps inside a
single shadow atlas. Use the <span class="xref std std-ref">Render Config</span> to tune shadow-map
resolution and related parameters.</p>
<p>Rendering convincing shadows require careful tuning. Two common shadow mapping
artifacts are shadow acne and peter-panning. Use the Light Component’s
<code class="docutils literal notranslate"><span class="pre">Shadow</span> <span class="pre">Bias</span></code> property to reduce these issues.</p>
<p>The <code class="docutils literal notranslate"><span class="pre">Shadow</span> <span class="pre">Bias</span></code> offsets depth comparisons to compensate for shadow map
precision limits. Lower bias values reduce peter-panning but can expose
shadow acne; higher bias values reduce acne but can cause noticeable
separation between casting objects and their shadows (peter-panning). Adjust
bias incrementally to find the best compromise for your Level.</p>
<figure class="align-center" id="id4">
<img alt="../_images/shadow_artifacts.png" src="../_images/shadow_artifacts.png" />
<figcaption>
<p><span class="caption-text">Left: shadow acne (low bias). Right: peter-panning (high bias).</span><a class="headerlink" href="#id4" title="Permalink to this image">¶</a></p>
</figcaption>
</figure>
</section>
<section id="skydome">
<h2>Skydome<a class="headerlink" href="#skydome" title="Permalink to this headline">¶</a></h2>
<p>Crown automatically adds an implicit skydome Unit to every new Level created
with the <a class="reference internal" href="../level_editor/level_editor.html#level-editor"><span class="std std-ref">Level Editor</span></a>. It is rendered on the current
camera’s far plane and is always centered to it, so it appears infinitely
distant and does not shift as the camera moves. Its texture and intensity are
configured via the <a class="reference internal" href="shading_environment.html#global-lighting"><span class="std std-ref">Shading Environment</span></a>.</p>
</section>
</section>


           </div>
          </div>
          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
        <a href="index.html" class="btn btn-neutral float-left" title="Rendering" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
        <a href="materials.html" class="btn btn-neutral float-right" title="Materials" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
    </div>

  <hr/>

  <div role="contentinfo">
    <p>&#169; <a href="../copyright.html">Copyright</a> Except where otherwise noted, content on this page is licensed under a CC-BY-SA 4.0 Int. License.
      <span class="lastupdated">Last updated on Feb 20, 2026.
      </span></p>
  </div>

  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
    provided by <a href="https://readthedocs.org">Read the Docs</a>.
   

</footer>
        </div>
      </div>
    </section>
  </div>
  <script>
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script>
    <!-- Theme Analytics -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-XNVGCMNDZH"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());

      gtag('config', 'G-XNVGCMNDZH', {
          'anonymize_ip': true,
      });
    </script> 

</body>
</html>