Editing Lighting Template

=Overview=
Lighting Templates are used to quickly and easily share lighting information between cells. A lighting template may be created from scratch or derived from an existing cell and then modified. Once created, a lighting template may be added to a cell through the [[Cell Lighting|Lighting]] tab. Individual components may then be customized on a cell-by-cell basis.

=Lighting Template Object=
'''Lighting Template''' objects are found in the [[Object Window]] under [[:Category:WorldData|WorldData]].
<br><br>
To create a new lighting template, right-click in the list of lighting templates in the [[Object Window]] and select "new" from the popup. This will open the Lighting Template dialog. Right-click a second time in the EditorId list to create a new template. To create a new lighting template based off an existing lighting template, right-click the lighting template you wish to use as a basis and select "duplicate".  To delete an existing lighting template, right-click that lighting template and select delete.

=Lighting Template Dialog=
[[image:jb_LightingTemplate01a.jpg]]
==Ambient==
Enter specific RGB values or choose "Select Color" and use the color picker. This value is only used by the "Set From Ambient" button for the Directional Ambient. It has no impact on the actual lighting. It is useful for getting your initial directional ambient values.
This value also influence the "light level" which is the luminosity value used by the game to calculate detection while sneaking, for example.

==Fog==
===Near/Far(color)===
Enter specific RGB values or choose "Select Color" and use the color picker.

===Near===
How many [[Unit|units]] before the fog starts to show up.

===Far===
The distance where the fog maxes out. If your max fog power is less than one, the distance where you reach your maximum fog value will be shorter than this.

===Pow===
The power of the fog (between 0 and 1). The lower this value is, the quicker the fog will show up.

===Max===
The maximum amount the fog color can impact the scene. 1 means it can go to 100% of the fog color. This is usually set around .7 to prevent scenes from going to a flat color.

===Clip Dist===
How many units until geometry is clipped out of the scene.

==Directional==
This is a light that impacts the entire cell. It is used to simulate bounced light. Enter specific RGB values or choose "Select Color" and use the color picker.
===Rotation===
This is the angle of the directional light.
===Fade===
This is the brightness of the light.

==Get Values from cell==
Use the drop down to pick a cell whose settings you want to use. A confirmation dialog will pop up when you choose a cell and press the "Get Values from cell" button.

==Directional Ambient Values==
===Set From Ambient===
This picks 6 colors for the directional ambient based on your current ambient color setting. It is a good starting point for setting these values.

===X+/-===
Enter specific RGB values or choose "Select Color" and use the color picker.

===Y+/-===
Enter specific RGB values or choose "Select Color" and use the color picker.

===Z+/-===
Enter specific RGB values or choose "Select Color" and use the color picker.

==Light Fade Distances==
===Start/End===
This is the distance at which regular omni lights start to fade out and when they are faded out completely. This has no impact on shadow casters.

==Specular==
This does nothing. It was never fully implemented.
===Fresnel Power===
This does nothing. It was never fully implemented. 

==Additional Notes==
Setting the RGB values to 0, 0, 0 may cause the lighting to turn completely off in certain spots, even if the player is using abilities such as "Night Eye". Setting the lights to pitch-black via the lighting template should be avoided.


[[Category:WorldData]]
[[Category:Object Classes]]