306
Chapter 12: Methods
externalParamName()
Usage
-- Lingo syntax
_player.externalParamName(
paramNameOrNum
)
// JavaScript syntax
_player.externalParamName(
paramNameOrNum
);
Description
Player method; returns the name of a specified parameter in the list of external parameters from
an HTML <EMBED> or <OBJECT> tag.
If specifying a parameter by name, this method returns any parameter names that matches
paramNameOrNum
. The match is not case sensitive. If no matching parameter name is found, this
method returns
VOID
(Lingo) or
null
(JavaScript syntax).
If specifying a parameter by number, this method returns the parameter name at the
paramNameOrNum
position in the parameter list. If no matching parameter position is found, this
method returns
VOID
or
null
.
This method is valid only for movies with Shockwave content that are running in a browser. It
cannot be used with Director movies or projectors.
The following list describes the pre-defined external parameters that can be used.
Parameter
Definition
swAudio
A string that specifies the location of a Shockwave Audio file to be played with the
movie. The value is a fully qualified URL.
swBackColor
A color value intended to modify the movie's Stage color property. The value is any
integer value from 0 to 255. Use 0 to 255 for movies in 8-bit color, and 0 to 15 for
movies in 4-bit color.
swBanner
A string that specifies the text to be used as a banner in the movie.
swColor
A color value for use in modifying the color of a specific object. The value is any
integer from 0 to 255. Use 0 to 255 for movies in 8-bit color, and 0 to 15 for
movies in 4-bit color.
swForeColor
A new foreground color value. Text written into field cast members is rendered in
the currently active foreground color. The value is any integer value from 0 to 255.
Use 0 to 255 for movies in 8-bit color, and 0 to 15 for movies in 4-bit color.
swFrame
A string value that is the name assigned to a given frame in the movie.
swList
A comma-delimited list of items that can be parsed with script. List values may be
key/value pairs, Boolean items, integers, or strings.
swName
A name, such as a user name, to be displayed or used within the movie.
swPassword
A password, perhaps for use it conjunction with the
swName
property, to be used
within the movie.
swPreloadTime
An integer value which specifies the number of seconds of an audio file sound that
should be preloaded before the sound begins to play. Used with Shockwave Audio
to improve playback performance by increasing the amount of audio already
downloaded before playback begins.
Summary of Contents for DIRECTOR MX 2004
Page 1: ...DIRECTOR MX 2004 Director Scripting Reference...
Page 48: ...48 Chapter 2 Director Scripting Essentials...
Page 100: ...100 Chapter 4 Debugging Scripts in Director...
Page 118: ...118 Chapter 5 Director Core Objects...
Page 594: ...594 Chapter 12 Methods...
Page 684: ...684 Chapter 14 Properties See also DVD...
Page 702: ...702 Chapter 14 Properties See also face vertices vertices flat...
Page 856: ...856 Chapter 14 Properties JavaScript syntax sprite 15 member member 3 4...
Page 1102: ...1102 Chapter 14 Properties...