MACROMEDIA DIRECTOR MX 2004-DIRECTOR SCRIPTING, Reference

Page: 572 / 1130

572 Chapter 12: Methods
•
When used with one argument,
memberObjRef
, the
unLoadMember()
method clears from
memory the cast members in that frame.
•
When used with two arguments,
fromMemberNameOrNum
and
toMemberNameOrNum
, the
unLoadMember()
method unloads all cast members in the range specified. You can specify a
range of cast members by frame numbers or frame labels.
Parameters
memberObjRef
Optional. A reference to the cast member to unload from memory.
fromMemberNameOrNum
Required if clearing a range of cast members. A string or integer that
specifies the name or number of the first cast member in a range to unload from memory.
toMemberNameOrNum
Required if clearing a range of cast members. A string or integer that
specifies the name or number of the last cast member in a range to unload from memory.
Example
This statement clears from memory the cast member Screen1:
-- Lingo syntax
_movie.unLoadMember(member("Screen1"))
// JavaScript syntax
_movie.unLoadMember(member("Screen1));
This statement clears from memory all cast members from cast member 1 to cast member Big
Movie:
-- Lingo syntax
_movie.unLoadMember(member(1), member("Big Movie"))
// JavaScript syntax
_movie.unLoadMember(member(1), member("Big Movie"));
See also
Movie
unLoadMovie()
Usage
-- Lingo syntax
_movie.unLoadMovie(
stringMovieName )
// JavaScript syntax
_movie.unLoadMovie(
stringMovieName );
Description
Movie method; removes the specified preloaded movie from memory.
This command is useful in forcing movies to unload when memory is low.
You can use a URL as the file reference.
If the movie isn’t already in RAM, the result is -1.