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.