Spotlight - Revision history

Redmaw: Added description and example images for Penumbra settings.

2023-02-10T23:54:46Z

Added description and example images for Penumbra settings.

Redmaw: Added descriptions and example images for Effects Tab and Import Tab. Soft Shadow Samples pending. Penumbra parameters pending.

2023-02-08T00:48:07Z

Added descriptions and example images for Effects Tab and Import Tab. Soft Shadow Samples pending. Penumbra parameters pending.

Redmaw: Fix typo.

2023-02-03T18:26:53Z

Fix typo.

Redmaw: Commented out Penumbra section. Update coming soon.

2023-02-03T18:25:13Z

Commented out Penumbra section. Update coming soon.

Redmaw: Added tab headings.

2023-02-02T05:30:40Z

Added tab headings.

Redmaw: Created wiki page for this node. Work in progress. Beam tab needs descriptions. Effects & Import tab coming soon.

2023-02-02T05:29:22Z

Created wiki page for this node. Work in progress. Beam tab needs descriptions. Effects & Import tab coming soon.

New page

[[File:Spotlight_00_GUI.png|none|470px|Spotlight]]

== Overview ==

Spotlight nodes provide a directional light source which can also be scaled. It is useful for creating beams or shafts of light.

'''Settings:'''

*'''Name:''' This setting allows you to apply a descriptive name to the node, which can be helpful when using multiple Spotlight nodes in a project.

*'''Enable:''' When checked, the spotlight is enabled and will contribute lighting information to the scene. When unchecked, the spotlight is completely turned off and will no longer contribute to the scene.

*'''Light surfaces:''' When checked, the light will illuminate the surfaces of the terrain or objects in the scene.

*'''Light Atmo/Cloud:''' When checked, the spotlight will illuminate the atmosphere and cloud layers.
<ul>
[[File:Spotlight_07_LightSurfAtmoCloud.jpg|None|800px| Comparison with Spotlight affecting surfaces, atmosphere and clouds.]]
</ul>

*'''Position:''' This setting allows you to position the spotlight along the XYZ axis.

*'''Rotation:''' This setting allows you to rotate the spotlight’s pitch, heading and bank along its XYZ axis.

*'''Colour:''' This setting controls the colour of the light emanating from the spotlight.
<ul>
[[File:Spotlight_04_Colour.jpg|none|800px|Spotlight colour approximating kelvin temperature and sRBG values.]]
</ul>

*'''Strength:''' This setting controls the intensity of the spotlight.
<ul>
[[File:Spotlight_05_Strength.jpg|none|800px|Spotlight strength.]]
</ul>

*'''Max Distance:''' This is the maximum distance calculated for light rays emanating from the spotlight. Note that this value does not affect the falloff of the light over the maximum distance.
<ul>
[[File:Spotlight_06_MaxDistance.jpg|none|800px|The Max distance value limits the distance over which the light rays are calculated.]]
</ul>

== Beam Tab ==
*'''Shape:''' This pop-up provides two options which determine the shape of the spotlight’s aperture and therefore beam.
<ul>
[[File:Spotlight_17_Shape_GUI.png|none|362px|Shape options.]]
*Circle: Selecting this option causes the shape of the beam to be circular. <br /n>
*Square: Selecting this option causes the shape of the beam to be square. <br /n>
</ul>
<ul>
[[File:Spotlight_08_Shape.jpg|none|800px|Spotlight shape options.]]
</ul>

*'''Aperture width:''' This setting controls the size of the aperture which emits light. Note in the example image below, as the value increases the size of the aperture gets larger, and light gets fainter as it is dispersed through a larger area.
<ul>
[[File:Spotlight_09_ApertureWidth.jpg|none|800px|Aperture width]]
</ul>

*'''Falloff power:''' This setting controls the exponent used to determine the attenuation, or falloff, of the light. A value of 0 is no falloff, a value of 1 is inverse-linear, the default value of 2 is equivalent to the inverse-square law, and a value of 3 would be inverse-cubed, etc.
<ul>
[[File:Spotlight_10_FalloffPower.jpg|None|800px| Falloff power]]
</ul>

*'''Outer angle:''' This setting describes the angle created by an imaginary line projecting from the center of the Spotlight to the outer edge of the Spotlight in degrees. Reducing the angle makes the beam narrower, while increasing the angle expands and widens the beam.
<ul>
[[File:Spotlight_11_OuterAngle.jpg|None|800px| Outer angle]]
</ul>

*'''Inner angle:''' This setting describes the angle created by an imaginary line projecting from the center of the Spotlight to the inner edge of the Spotlight in degrees. The appearance of light is strongest within this angle, and falls off between this value and the Outer angle value. The closer the Inner angle value is to the Outer angle value the sharper the light beam will appear.
<ul>
[[File:Spotlight_12_InnerAngle.jpg|none|800px|Inner angle]]
</ul>

*'''Penumbra gamma:''' This setting brightens the penumbra of the shadow.
<ul>
{|
|-
| [[File:Spotlight_22_PenumbraGamma_PointLight.jpg|none|800px|Prenumbra gamma comparison. Spotlight Aperture 0.]]
|-
| [[File:Spotlight_26_PenumbraGamma_Aperture10.jpg|none|800px|Penumbra gamma comparison. Spotlight Aperture 10.]]
|}
</ul>

*'''S-curve on penumbra:''' This applies an “S” curve to the falloff area between the Inner angle and Outer angle.
<ul>
{|
|-
| [[File:Spotlight_23_SCurveOFF_PointLight.jpg|none|800px|S-Curve on penumbra unchecked. Spotlight Aperture 0.]]
|-
| [[File:Spotlight_27_SCurveOFF_Aperture10.jpg|none|800px|S-Curve on penumbra unchecked. Spotlight Aperture 10.]]
|}
</ul>

*'''Reverse gamma curve: ''' Description coming.
<ul>
{|
|-
| [[File:Spotlight_24_ReverseON_PointLight.jpg|none|800px|Reverse gamma curve checked. Spotlight Aperture 0.]]
|-
| [[File:Spotlight_28_ReverseON_Aperture10.jpg|none|800px|Reverse gamma curve checked. Spotlight Aperture 10.]]
|-
| [[File:Spotlight_25_SCurveONReverseON_PointLight.jpg|none|800px|S-curve on penumbra checked. Reverse gamma curve checked. Spotlight Aperture 0.]]
|-
| [[File:Spotlight_29_SCurveONReverseON_Aperture10.jpg|none|800px|S-curve on penumbra checked. Reverse gamma curve checked. Spotlight Aperture 10.]]
|}
</ul>

@@ Line 43: / Line 43: @@
 == Beam Tab ==
 *'''Shape:''' This pop-up provides two options which determine the shape of the spotlight’s aperture and therefore beam.
 <ul>
@@ Line 77: / Line 80: @@
 </ul>
-<!--
-*'''Penumbra gamma:''' This setting brightens the penumbra of the shadow.
+*'''Penumbra gamma:''' This setting brightens the beam of light between the Inner and Outer Angle values.
 <ul>
-{|
+[[File:Spotlight_43_PenumbraGamma.jpg|none|800px|Penumbra gamma comparison. S-curve on penumbra checked.  Reverse gamma curve unchecked.  Spotlight Aperture = 0.]]
 </ul>
-*'''S-curve on penumbra:''' This applies an “S” curve to the falloff area between the Inner angle and Outer angle.
+*'''S-curve on penumbra:''' When checked, an “S” curve is applied to the falloff area between the Inner angle and Outer angle of the Spotlight’s beam.
 <ul>
-{|
+[[File:Spotlight_46_SCurveOnPenumbraOnOff.gif|none|400px|S-Curve on penumbra comparison.]]
 </ul>
-*'''Reverse gamma curve: ''' Description coming.
+*'''Reverse gamma curve: '''  When checked, the gamma is reversed.
 <ul>
-{|
+[[File:Spotlight_47_ReverseGammaCurveOnOff.gif|none|400px|Reverse gamma on and off.]]
-|-
+<br /n>
-| [[File:Spotlight_24_ReverseON_PointLight.jpg|none|800px|Reverse gamma curve checked. Spotlight Aperture 0.]]
+[[File:Spotlight_48_ReverseGammaOffOn.jpg|none|800px|Reverse gamma on and off.]]
 </ul>
--->
 ==Effects Tab==

@@ Line 117: / Line 117: @@
 ==Effects Tab==
-Coming soon.
+[[File:Spotlight_02_EffectsTab.png|none|467px|Effects Tab]]
 ==Import Tab ==
-Coming soon.
+*'''Cast Shadows:''' When checked, the Spotlight will cast shadows.  When unchecked, it will not cast shadows.

@@ Line 77: / Line 77: @@
 </ul>
+<--
 *'''Penumbra gamma:''' This setting brightens the penumbra of the shadow.
 <ul>
@@ Line 114: / Line 114: @@
 </ul>
 ==Effects Tab==

← Older revision		Revision as of 05:30, 2 February 2023
Line 113:		Line 113:
	\|}		\|}
	</ul>		</ul>
		+
		+
		+	==Effects Tab==
		+	Coming soon.
		+
		+	==Import Tab ==
		+	Coming soon.