<!-- This file copyright Persistence of Vision Raytracer Pty. Ltd. 2003-2004 -->
<html>
<head>
<!-- NOTE: In order to users to help find information about POV-Ray using -->
<!-- web search engines, we ask you to *not* let them index documentation -->
<!-- mirrors because effectively, when searching, users will get hundreds -->
<!-- of results containing the same information! For this reason, the two -->
<!-- meta tags below disable archiving and indexing of this page by all -->
<!-- search engines that support these meta tags. -->
<meta content="noarchive" name="robots">
<meta content="noindex" name="robots">
<meta content="no-cache" http-equiv="Pragma">
<meta content="0" http-equiv="expires">
<title>3.8.7 Lights</title>
<link href="povray35.css" rel="stylesheet" type="text/css">
</head>
<body>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_158.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_158.html">3.8.6 Camera</a>
</td>
<td align="center" valign="middle">
<strong class="NavBar">POV-Ray 3.6 for UNIX documentation</strong><br> <strong>3.8.7
Lights</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_160.html">3.8.8 Objects</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_160.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
<h3><a name="s03_08_07">3.8.7 </a>Lights</h3>
<a name="s03_08_07_i1"><a name="quickref, lights"></a><a name="s03_08_07_i2">
<dl class="Syntax">
<dt class="SubDesc">
Specify light sources for the scene or for specific objects
<dt>
LIGHT:
<dd>
<code>LIGHT_SOURCE | LIGHT_GROUP</code>
</dl>
<dl class="Syntax">
<dt class="SubDesc">
Describe the position, type and properties of a light source for the scene:
<dt>
LIGHT_SOURCE:
<dd class="Jump">
<a href="s_111.html#s03_04_07">Jump to SDL</a>
<dd>
<code><strong>light_source {</strong> V_LOCATION, COLOR [LIGHT_SOURCE_ITEMS] <strong>}</strong></code>
<dt>
LIGHT_SOURCE_ITEMS:
<dd>
<code>[LIGHT_TYPE] & [AREA_LIGHT_ITEMS] & [LIGHT_MODIFIERS]</code>
<dt>
LIGHT_TYPE:
<dd>
<code><strong>spotlight</strong> [SPOTLIGHT_ITEMS] | <strong>cylinder</strong> [SPOTLIGHT_ITEMS]</code>
<dt>
SPOTLIGHT_ITEMS:
<dd>
<code>[<strong>radius</strong> FLOAT] & [<strong>falloff</strong> FLOAT] & [<strong>tightness</strong> FLOAT]
& [<strong>point_at</strong> VECTOR]</code>
<dt>
AREA_LIGHT_ITEMS:
<dd>
<code><strong>area_light</strong> V_AXIS1, V_AXIS2, I_SIZE1, I_SIZE2 [AREA_LIGHT_MODIFIERS]</code>
<dt>
AREA_LIGHT_MODIFIERS:
<dd>
<code>[<strong>adaptive</strong> INT] & [<strong>jitter</strong>] & [<strong>circular</strong>]
& [<strong>orient</strong>]</code>
<dt>
LIGHT_MODIFIERS:
<dd>
<code>[LIGHT_PHOTONS] & [<strong>looks_like {</strong> OBJECT <strong>}</strong>] &
[TRANSFORMATION...] & [<strong>fade_distance</strong> FLOAT] & [<strong>fade_power</strong> FLOAT]
& [<strong>media_attenuation</strong> [BOOL]] & [<strong>media_interaction</strong> [BOOL]] & [<strong>shadowless</strong>]
& [<strong>projected_through {</strong> OBJECT_IDENTIFIER <strong>}</strong>] & [<strong>parallel</strong> [<strong>point_at</strong> VECTOR]]</code>
</dl>
<dl class="Syntax">
<dt class="SubDesc">
Specify how a light source should interact with photons:
<dt>
LIGHT_PHOTONS:
<dd>
<code><strong>photons {</strong> LIGHT_PHOTON_ITEMS <strong>}</strong></code>
<dt>
LIGHT_PHOTON_ITEMS:
<dd>
<code>[<strong>refraction</strong> BOOL] & [<strong>reflection</strong> BOOL] & [<strong>area_light</strong>]</code>
</dl>
<p>
<a href="s_153.html#s03_08_01">Quick Reference Contents</a>
</p>
<h4><a name="s03_08_07_01">3.8.7.1 </a>Lightgroup</h4>
<a name="s03_08_07_01_i1"><a name="quickref, lightgroup"></a><a name="s03_08_07_01_i2">
<dl class="Syntax">
<dt class="SubDesc">
Assign objects to specific light sources:
<dt>
LIGHT_GROUP:
<dd class="Jump">
<a href="s_112.html#s03_04_08">Jump to SDL</a>
<dd>
<code><strong>light_group {</strong> LIGHT_GROUP_ITEM... [LIGHT_GROUP_MODIFIERS] <strong>}</strong></code>
<dt>
LIGHT_GROUP_ITEM:
<dd>
<code>LIGHT_SOURCE | OBJECT | LIGHT_GROUP</code>
<dt>
LIGHT_GROUP_MODIFIERS:
<dd>
<code>[<strong>global_lights</strong> BOOL] & [TRANSFORMATION...]</code>
</dl>
<p>
<a href="s_153.html#s03_08_01">Quick Reference Contents</a>
</p>
<br>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_158.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_158.html">3.8.6 Camera</a>
</td>
<td align="center" valign="middle">
<strong>3.8.7 Lights</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_160.html">3.8.8 Objects</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_160.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
</body> </html>
