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()