preLoad (3D)
933
•
#software
specifies the Director built-in software renderer that works with both Macintosh
and Windows platforms.
•
#auto
specifies that the most suitable renderer should be chosen. This is the default value for
this property.
The value set for this property is used as the default for the Renderer Services object’s
renderer
property.
This property differs from the
getRendererServices()
object’s
renderer
property in that the
preferred3dRenderer
specifies the preferred renderer to use, whereas the
getRendererServices()
object’s
renderer
property indicates what renderer is actually being
used by the movie.
Shockwave Player users have the option of specifying the renderer of their choice using the 3D
Renderer context menu in Shockwave Player. If the user selects the “Obey content settings”
option, the renderer specified by the
renderer
or
preferred3DRenderer
property is used to
draw the movie (if available on the user’s system), otherwise, the renderer selected by the user
is used.
Example
This statement allows the movie to pick the best 3D renderer available on the user’s system:
-- Lingo syntax
_movie.preferred3dRenderer = #auto
// JavaScript syntax
_movie.preferred3dRenderer = "auto";
See also
getRendererServices()
,
Movie
,
renderer
preLoad (3D)
Usage
member(
whichCastmember
).preload
memberReference
.preload
Description
3D property; allows you to get or set whether data is preloaded before playing (
TRUE
), or is
streamed while playing (
FALSE
). This property can be used only with linked files. The default
value is
FALSE
.
In Director, setting the
preLoad
property to
TRUE
causes the cast member to load completely
before playback starts. In Shockwave Player, setting the
preLoad
property to
TRUE
causes the cast
member to begin streaming when the movie starts playing. Before perfoming any Lingo
operations on a 3D cast member that is streaming, be sure to check that the cast member’s
state
property has a value greater than or equal to 2.
Example
This statement sets the
preload
property of the cast member PartyScene to
FALSE
, which allows
externally linked media to stream into PartyScene during playback:
ember("PartyScene").preload = FALSE
member("3D world").preload
Summary of Contents for DIRECTOR MX 2004-DIRECTOR SCRIPTING
Page 1: ...DIRECTOR MX 2004 Director Scripting Reference...
Page 48: ...48 Chapter 2 Director Scripting Essentials...
Page 100: ...100 Chapter 4 Debugging Scripts in Director...
Page 118: ...118 Chapter 5 Director Core Objects...
Page 594: ...594 Chapter 12 Methods...
Page 684: ...684 Chapter 14 Properties See also DVD...
Page 702: ...702 Chapter 14 Properties See also face vertices vertices flat...
Page 856: ...856 Chapter 14 Properties JavaScript syntax sprite 15 member member 3 4...
Page 1102: ...1102 Chapter 14 Properties...