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