MACROMEDIA DIRECTOR MX 2004-DIRECTOR SCRIPTING, Reference

Page: 468 / 1130

468 Chapter 12: Methods
Example
This statement loads the cast member Mel Torme into memory:
-- Lingo syntax
member("Mel Torme").preLoadBuffer()
// JavaScript syntax
member("Mel Torme").preLoadBuffer();
See also
preLoadTime
preLoadMember()
Usage
-- Lingo syntax
_movie.preLoadMember({
memberObjRef })
_movie.preLoadMember( fromMemNameOrNum , toMemNameOrNum )
// JavaScript syntax
_movie.preLoadMember({
memberObjRef });
_movie.preLoadMember( fromMemNameOrNum , toMemNameOrNum );
Description
Movie method; preloads cast members and stops when memory is full or when all of the specified
cast members have been preloaded.
This method returns the cast member number of the last cast member successfully loaded. To
obtain this value, use the
result()
method.
When used without arguments,
preLoadMember()
preloads all cast members in the movie.
When used with the
memberObjRef
argument,
preLoadMember()
preloads just that cast member.
If
memberObjRef
is an integer, only the first cast library is referenced. If
memberObjRef
is a string,
the first member with the string as its name will be used.
When used with the arguments
fromMemNameOrNum
and
toMemNameOrNum
,
preLoadMember()
preloads all cast members in the range specified by the cast member numbers or names.
Parameters
memberObjRef
Optional. A reference to the cast member to preload.
fromMenNameOrNum
Required when preloading a range of cast members. A string or an integer
that specifies the first cast member in the range of cast members to preload.
toMemNameOrNum
Required when preloading a range of cast members. A string or an integer that
specifies the first cast member in the range of cast members to preload.
See also
Movie , preLoad() (Member) , result