User Guide

322 Chapter 15: The 3D Cast Member, 3D Text, and 3D Behaviors
The following methods and properties can be used to perform basic light operations:
Cameras
Cameras provide different views of the 3D world. A 3D cast member can have many cameras.
Each sprite that uses the cast member can display a different camera view of the 3D world.
The following cast member methods and properties can be used to perform basic
camera operations:
Method 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 script
error.
deleteLight
(name)
Deletes the light named name. Script
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. Script 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.
Method Function Returns
camera.count
Returns the number of camera objects
included in the cast member.
Integer.
camera(name)
Returns the camera named name. Returns the camera object
named
name if it exists. Returns
void if the object does not
exist.
camera[index]
Returns the camera at the designated
position in the index. The index number can
change if cameras are added or deleted.
Returns the camera object at
that index number if it exists.
Returns
void if the object does
not exist at that index number.
newCamera
(name)
Creates a new camera and adds it to the
camera object list.
Returns a new camera object
with a unique name. If the
name isn’t unique, returns a
script error.