Lingo Dictionary > T-Z > unLoad |  |

unLoad

Syntax

    unLoad
    unLoad theFrameNum
    unLoad fromFrameNum, toFrameNum

Description

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

| When used without an argument, the `unLoad` command clears from memory the cast members in all the frames of a movie.
| When used with one argument, `theFrameNum`, the `unLoad` command clears from memory the cast members in that frame.
| When used with two arguments,`fromFrameNum` and `toFrameNum`, the `unLoad` command unloads all cast members in the range specified. You can specify a range of frames by frame numbers or frame labels.

Example

This statement clears the cast members used in frame 10 from memory:

    unLoad 10

Example

This statement clears the cast members used from the frame labeled first to the frame labeled last:

    unLoad "first", "last"

See also

`preLoad (command)`, `preLoadMember`, `unLoadMember`, `purgePriority`