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`