What's New in Director 8.5 > The 3D Cast Member > Lights |  |

Lights

Models in the 3D world are illuminated by lights. Each light has a color, direction, intensity, and other characteristics. By default, each 3D cast member contains one white light, which allows Director users to see the models in the cast member without having to explicitly add a light. This light has a default position of top-center in the world. You can modify or replace this light with one or more new lights. To turn off the default light, set its `color` property to `rgb(0,0,0)`.

The following commands and properties can be used to perform basic light operations:

Command | Function | Returns
--- | --- | ---
`light.count` | Returns the number of light objects included in the cast member. | Integer.
`light(``name``)` | Returns the light named `name`. | Returns the light object named `name` if it exists. Returns `void` if the object does not exist.
`light[``index``]` | Returns the light at the designated position in the index. The index number can change if lights are added or deleted. | Returns the light object at that index number if it exists. Returns `void` if the object does not exist at that index number.
`newLight(``name, type``)` | Creates a new light and adds it to the light object list. The `type` can be `#ambient`, `#directional`, `#point`, or `#spot`. | Returns a new light object with a unique name. If the name isn't unique, returns a Lingo error.
`deleteLight(``name``)` | Deletes the light named `name`. Lingo references to this light persist but can do nothing. | `TRUE (1)` if the light named `name` exists.`FALSE (0)` if the light named name doesn't exist.
`deleteLight(``index``)` | Deletes the light with the given index number. Lingo references to this light persist but can do nothing. | `TRUE (1)` if the light with this index number exists. `FALSE (0)` if the light with this index number doesn't exist.