User Guide

496
In Director, setting the preLoad property to TRUE causes the cast member to load completely
before playback starts. In Shockwave, 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
See also
state (3D)
preLoad (command)
Syntax
preLoad
preLoad toFrameNum
preLoad fromFrame, toFrameNum
Description
Command; preloads cast members in the specified frame or range of frames into memory and stops
when memory is full or when all of the specified cast members have been preloaded, as follows:
• When used without arguments, the command preloads all cast members used from the current
frame to the last frame of a movie.
• When used with one argument, toFrame, the command preloads all cast members used in the
range of frames from the current frame to the frame toFrameNum, as specified by the frame
number or label name.
• When used with two arguments, fromFrame and toFrameNum, preloads all cast members used
in the range of frames from the frame
fromFrame to the frame toFrameNum, as specified by the
frame number or label name.
The
preLoad command also returns the number of the last frame successfully loaded. To obtain
this value, use the
result function.
Examples
This statement preloads the cast members used from the current frame to the frame that has the
next marker:
preLoad marker (1)
This statement preloads the cast members used from frame 10 to frame 50:
preLoad 10, 50
See also
preLoadMember