Lingo Dictionary > O-R > preLoadMember |  |

preLoadMember

Syntax

    preLoadMember
    member(whichCastMember).preLoad()
    preLoadMember whichCastMember
    member(fromCastmember).preLoad(toCastMember)
    preLoadMember fromCastmember, toCastmember

Description

Command; preloads cast members and stops when memory is full or when all of the specified cast members have been preloaded. The `preLoadMember` command returns the cast member number of the last cast member successfully loaded. To obtain this value, use the `result` function.

When used without arguments, `preLoadMember` preloads all cast members in the movie.

When used with the `whichCastMember` argument, `preLoadMember` preloads just that cast member. If `whichCastMember` is an integer, only the first cast is referenced. If `whichCastMember` is a string, the first member with the string as its name will be used.

When used with the arguments `fromCastmember` and `toCastmember`, the `preLoadMember` command preloads all cast members in the range specified by the cast member numbers or names.

Example

This statement preloads cast member 20 of the first (internal) cast:

    member(20).preLoad()

Example

This statement preloads cast member Shrine and the 10 cast members after it in the Cast window:

    member("Shrine").preLoad(member("Shrine").number + 10)

Example

To preload a specific member of a specific cast, use the following syntax:

    member("John Boy", "Family Members").preLoad()