Lingo Dictionary > O-R > preLoad (command) |  |

preLoad (command)

Syntax

    preLoad
    preLoad toFrameNum
    preLoad fromFrame, toFrameNum

Description

Command; preloads cast members in the specified frame or range of frames into memory and stops when memory is full or when all of the specified cast members have been preloaded, as follows:

| When used without arguments, the command preloads all cast members used from the current frame to the last frame of a movie.
| When used with one argument, `toFrame`, the command preloads all cast members used in the range of frames from the current frame to the frame `toFrameNum`, as specified by the frame number or label name.
| When used with two arguments, `fromFrame` and `toFrameNum`, preloads all cast members used in the range of frames from the frame `fromFrame` to the frame `toFrameNum`, as specified by the frame number or label name.

The `preLoad` command also returns the number of the last frame successfully loaded. To obtain this value, use the `result` function.

Example

This statement preloads the cast members used from the current frame to the frame that has the next marker:

    preLoad marker (1)

Example

This statement preloads the cast members used from frame 10 to frame 50:

    preLoad 10, 50

See also

`preLoadMember`