User Guide

408 Chapter 17: Controlling the 3D World
Sprite properties
You can control the
directToStage and bgColor properties using the Property inspector. For
more information, see “Using the Property inspector for 3D” on page 308. Use the following
properties to work with 3D sprites in scripts.:
Sprite methods
Use these methods to work with 3D sprites:
Property Access Description Default
directTo
Stage
Get and set TRUE (1) or FALSE (0) specification of
whether rendering occurs directly to the
Stage or to the Director offscreen buffer. If
TRUE (1), other sprites that intersect with this
sprite may flicker. If
FALSE (0), rendering
layers well but speed declines.
TRUE (1):
rendering
occurs directly
to the Stage
bgColor
Get and set Background color in all views.
rgb(0,0,0)
camera
Get and set Determines which camera this sprite is using. None
targetFrame
Rate
Get and set Controls the desired playback speed. If the
useTargetFramerate property is TRUE (1),
then the
lod.bias property of all model
resources is dynamically altered until the
target frame rate is met.
30
useTarget
FrameRate
Get and set If a target frame rate has been set and you
want to use it, set this property to
TRUE (1).
TRUE (1)
Method Description Returns
camera(index)
Accesses a specific camera in the sprite’s list
of views.
The camera
requested
addCamera(camera, index)
Adds a camera named camera at the specified
index number. If the index number is greater
than the number of cameras in the sprite’s
camera count, or if there is no index, the
camera is added to the end of the list.
An error if a
camera of that
name can’t be
found
deleteCamera
(cameraOrIndex)
If cameraOrIndex is a camera, the camera by
that name is deleted. If
cameraOrIndex is an
index number, the camera at that index
number is deleted.
In either case, the cameras after
cameraOrIndex move forward in the list and
the camera count is decreased by 1.
An error if a
camera of that
name or index
number can’t be
found
cameraCount()
Returns the number of cameras in the sprite’s
cameraList.
An integer