Lingo Dictionary > D-F > fileName (cast property)

 

fileName (cast property)

Syntax

castLib(whichCast).fileName
the fileName of castLib whichCast

Description

Property; specifies the file name of the specified cast.

For an external cast, fileName gives the cast's full pathname and file name.

For an internal cast, the fileName castLib property depends on which internal cast is specified. For the first internal cast library, the fileName castLib property specifies the name of the movie. For remaining internal casts, fileName is an empty string.

The fileName of castLib property accepts URLs as references. However, to use a cast from the Internet and minimize download time, use the downloadNetThing or preloadNetThing command to download the cast's file to a local disk first and then set fileName castLib to the file on the disk.

If a movie sets the file name of an external cast, don't use the Duplicate Cast Members for Faster Loading option in the Projector Options dialog box.

This property can be tested and set for external casts. It can be tested only for internal casts.

Note: Director for Java does not support the downloadNetThing command.

Example

This statement displays the pathname and file name of the Buttons external cast in the Message window:

put castLib("Buttons").fileName

Example

This statement sets the file name of the Buttons external cast to Content.cst:

castLib("Buttons").fileName = the moviePath & "Content.cst"

The movie then uses the external cast file Content.cst as the Buttons cast.

Example

These statements download an external cast from a URL to the Director application folder and then make that file the external cast named Cast of Thousands:

downLoadNetThing("http://www.cbDeMille.com Thousands.cst", the  \ applicationPath&"Thousands.cst")
castLib("Cast of Thousands").fileName = the applicationPath & "Thousands.cst"

See also

downloadNetThing, preloadNetThing()