Reference:Light Group - Revision history

Jholsenback: indexentries fixes

2016-12-16T18:18:02Z

indexentries fixes

Jholsenback: 1 revision: Reference Migration Initial Load

2012-03-15T19:07:21Z

1 revision: Reference Migration Initial Load

Jholsenback: 1 revision: Initial Load (TF)

2012-03-11T22:27:11Z

1 revision: Initial Load (TF)

New page

[[Category:Light Sources]]
Light groups make it possible to create a <code>union</code> of light sources and objects, where the objects in the group are illuminated by the lights in the group or, if so desired, by the global light sources as well. The light sources in the group can only illuminate the objects that are in the group, this also applies to <code>scattering</code> media, and it must be included in the light group as well. Keep in mind that if the scattering media also has an <code>absorption</code> component, it will be affected by light sources that are not in the light group definition.

Light groups are for example useful when creating scenes in which some objects turn out to be too dark but the average light is exactly how it should be, as the light sources in the group do not contribute to the global lighting.

Syntax :
<pre>
light_group {
LIGHT_GROUP LIGHT |
LIGHT_GROUP OBJECT |
LIGHT_GROUP
[LIGHT_GROUP MODIFIER]
}

LIGHT_GROUP LIGHT:
light_source | light_source IDENTIFIER
LIGHT_GROUP OBJECT:
OBJECT | OBJECT IDENTIFIER
LIGHT_GROUP MODIFIER:
global_lights BOOL | TRANSFORMATION
</pre>

<ul>
<li>To illuminate objects in the group with the light from global light sources, add <code>global_lights on</code> to the light group definition.</li>
<li>Light groups may be nested. In this case light groups inherit the light sources of the light group in which they are contained.</li>
<li>Light groups can be seen as a <code>union</code> of an object with a <code>light_source</code> and can be used with CSG.</li>
</ul>

Some examples of a simple light group:

<pre>
#declare RedLight =
light_source {
<-500,500,-500>
rgb <1,0,0>
}

light_group {
light_source {RedLight}
sphere {0,1 pigment {rgb 1}}
global_lights off
}
</pre>

A nested light group:

<pre>
#declare L1 =
light_group {
light_source {<10,10,0>, rgb <1,0,0>}
light_source {<0,0,-100>, rgb <0,0,1>}
sphere {0,1 pigment {rgb 1}}
}

light_group {
light_source {<0,100,0>, rgb 0.5}
light_group {L1}
}
</pre>

Light groups with CSG:
<pre>
difference {
light_group {
sphere {0,1 pigment {rgb 1}}
light_source {<-100,0,-100> rgb <1,0,0>}
global_lights off
}
light_group {
sphere {<0,1,0>,1 pigment {rgb 1}}
light_source {<100,100,0> rgb <0,0,1>}
global_lights off
}
rotate <-45,0,0>
}
</pre>
In the last example the result will be a sphere illuminated red, where the part that is differenced away is illuminated blue. The end result is comparable to the difference between two spheres with a different pigment.

← Older revision		Revision as of 18:18, 16 December 2016
Line 1:		Line 1:
	[[Category:Light Sources]]		[[Category:Light Sources]]
		+	{{#indexentry:global_lights}}
		+	{{#indexentry:light_group, keyword}}
		+	{{#indexentry:keyword, light_group}}
		+	{{#indexentry:light_source, light_group}}
		+	{{#indexentry:keyword, light_source}}
		+	{{#indexentry:global_lights, light_group}}
		+	{{#indexentry:keyword, global_lights}}
	<p>Light groups make it possible to create a <code>union</code> of light sources and objects, where the objects in the group are illuminated by the lights in the group or, if so desired, by the global light sources as well. The light sources in the group can <em>only</em> illuminate the objects that are in the group, this also applies to <code>scattering</code> media, and it <em>must</em> be included in the light group as well. Keep in mind that if the scattering media also has an <code>absorption</code> component, it <em>will</em> be affected by light sources that are <em>not</em> in the light group definition.</p>		<p>Light groups make it possible to create a <code>union</code> of light sources and objects, where the objects in the group are illuminated by the lights in the group or, if so desired, by the global light sources as well. The light sources in the group can <em>only</em> illuminate the objects that are in the group, this also applies to <code>scattering</code> media, and it <em>must</em> be included in the light group as well. Keep in mind that if the scattering media also has an <code>absorption</code> component, it <em>will</em> be affected by light sources that are <em>not</em> in the light group definition.</p>

← Older revision	Revision as of 19:07, 15 March 2012
(No difference)