User Guide

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 isnt already in RAM, the result is -1.