Lingo Dictionary > T-Z > unLoadMember

 

unLoadMember

Syntax

unLoadMember 
member(whichCastMember). unLoad()
unLoadMember member whichCastMember
member(whichCastMember, whichCastLib). unLoad()
unLoadMember member whichCastMember of castLib whichCast
member(firstCastmember). unLoad(lastCastMember)
unLoadMember member firstCastMember, lastCastMember

Description

Command; forces Director to clear the specified cast members from memory. Director automatically unloads the least recently used cast members to accommodate preLoad commands or normal cast loading.

When used without an argument, unLoadMember clears from memory the cast members in all the frames of a movie.

When used with the arguments whichCastMember and whichCast, the unLoadMember command clears from memory the cast member name or number that you specify.

When used with the arguments firstCastMember and lastCastMember, the unLoadMember command unloads all cast members in the range specified.

When used in a new movie with no loaded cast members, this command returns an error.

Cast members that you have modified during authoring or by setting picture, pasteClipBoadInto, and so on, cannot be unloaded.

Example

This statement clears from memory the cast member Screen1:

unLoadMember member "Screen1"

or

member("Screen1").unload() 

Example

This statement clears from memory all cast members from cast member 1 to cast member Big Movie:

unLoadMember 1, member "Big Movie"

or

member(1).unload("Big Movie") 

See also

preLoad (command), preLoadMember, purgePriority