Category
Function
Creates a distant light source.
Syntax
light = Light(where, color, camera);
Inputs
| Name | Type | Default | Description |
|---|---|---|---|
| where | vector or camera | [0 0 1] | position or direction of light |
| color | vector or string | [1 1 1] | color and intensity of light |
| camera | flag | 0 | 0: fixed direction
1: direction relative to camera |
Outputs
| Name | Type | Description |
|---|---|---|
| light | light | a distant light |
Functional Details
where | specifies the direction to the light source. If this parameter is specified as a camera rather than as a vector, the module positions the light source behind the camera and to its left (this is also the default light supplied by Data Explorer). |
color | specifies the color and intensity of the light either as an RGB vector or as a color-name string. The color name must be one of the defined color-name strings (see Color). |
camera | specifies that where is to be interpreted relative to the camera coordinate system rather than the world coordinate system. If where is a camera, then the specification camera = 0 is an error. |
Use the Collect module to incorporate the output light in the scene given to the Render, Display, or Image.
If no light is present in the object passed to the Render, Display, or Image tool, a distant light of color [1 1 1] (behind and 45 degrees to the left of the viewer) is automatically incorporated in the scene. A small amount of ambient light is also used. Data Explorer removes these default lights if any light has been specified. The effect of the system's default lights by combining an ambient light (generated by using the default settings of AmbientLight) with the distant light generated by the Light module when a camera is specified for the where parameter.
Lights have no effect on volume-rendered objects.
Example Visual Programs
ThunderGlyphSheet.net UsingLight.net
See Also
AmbientLight, Collect, Color, Convert
[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]