Control the lighting level in a 3D window
VO <ScenarioPath> Lighting {LightOption} [<Parameter>]
The VO Lighting command allows you to control the level of ambient and direct light displayed in the 3D window.
{LightOption} and <Parameter> are described in the following tables.
Global lighting options control the illumination levels in the entire 3D scene.
| {LightOption} | <Parameter> | Description |
|---|---|---|
| Show | On | Define lighting conditions for the globe in the 3D Graphics window. |
| Off | The entire scene is illuminated equally. | |
| Ambient | <AmbientLevel> | Ambient light controls the additive lighting in the scene. Indicate the level of additional brightness that will be applied to the scene by specifying a <AmbientLevel>, where 0 is the least amount of illumination and 100 is a very bright illumination. A value of 100 adds additional illumination to the entire scene, so that sun levels are not as dramatic, while a value of 0 adds no additional illumination. |
| Sun | <SunLevel> | Indicate the overall brightness of the sun by specifying a <SunLevel>, where 0 is the least amount of illumination and 500 is a very bright illumination. A value of 100 illuminates both sides of the central body equally, while a value of 0 makes the dark side of the central body completely black. |
| NightLights | <NightLightLevel> | Indicate the overall brightness of a night lights texture by specifying a <LightValue>, where 0 means night lights are not visible, and 500 produces night lights that are easily seen. |
| Positional | On | Use the position of the Sun to calculate all lighting effects. |
| Off | Only the direction of the Sun as seen
from the 3D window's central body is used in calculating lighting
effects.
Warning: Turning Positional Lighting off can increase performance but can lead to incorrect lighting when viewing other central bodies or objects far from the view's central body. |
|
| UsePerPixelLighting | On | Compute lighting at every pixel across a given rendered geometry, to produce a smoother look. |
| Off | Compute lighting only at the vertices of geometry and interpolated over the geometry's surface. | |
| WindowID | <WinNumber> | Enter the number of the 3D Graphics
window to which the changes should be applied.
Note: Object level lighting options will also be applied to the 3D Graphics window specified. |
Object level lighting options control the illumination of objects in the 3D scene.
| {LightOption} | <Parameter> | Description |
|---|---|---|
| Object | On | Define lighting conditions for objects in the 3D Graphics window. |
| Off | Only global lighting is applied. | |
| ObjAmbient | <AmbientValue> | Objects are drawn using the ambient level set here and ignores the ambient level set globally (that is, the object can be illuminated even if the general ambient level is low). Use the <AmbientValue> to specify the ambient level, where 0 means that the object is dark and 100 means that the object is illuminated. |
| ObjSun | <SunLevel> | Objects ignore the Sun level set globally and use the level set here. Use the <SunLevel> to specify a value for overall brightness level, where 0 is the least amount of illumination, and 500 is a very bright illumination. |
| SolarIntensity | On | STK checks to see if light is blocked by the Earth so that objects are not illuminated during umbra and are only partially illuminated during penumbra. |
| Off | Illuminations levels are not changed during umbra and penumbra. |
Use the Flashlight option to illuminate objects and/or the globe and allow its color and intensity to be set.
| {LightOption} | <Parameter> | Description |
|---|---|---|
| FlashlightShow | {On | Off} | Turn on or off the flashlight. |
| FlashlightGlobe | {On | Off} | If On is entered the flashlight will be used when lighting the central body globe. |
| FlashlightObjects | {On | Off} | If On is entered the flashlight will be used when lighting 3D objects. |
| FlashlightLevel | <Level> | Indicate the overall brightness of the light, where 0 is the least amount of illumination, and 500 is a very bright illumination |
| FlashlightColor | {Color} | Specifies the color of the light.
Default color is blue.
For valid {Color} options see Common Options. |
| FlashlightIsAntiSunDir | {On | Off} | On sets the light direction from central body to sun, Off sets the light direction from the camera, in the view direction (into screen). |
To apply a slightly brighter illumination to the entire 3D scene, and turn on the default object lighting:
VO * Lighting Show On Ambient 32 Object On
To make nightlights more visible, turn off positional lighting for the entire scene, and turn off object lighting:
VO * Lighting NightLights 256 Positional Off Object Off
To use the flashlight on the globe, setting color to green:
VO * Lighting FlashlightShow On FlashlightGlobe On FlashlightObjects Off FlashlightLevel 100 FlashlightColor #00ff00
If activated, Connect returns an acknowledgement message.
This command belongs to the following group(s):
10
STK Programming Interface 11.0.1