 |
|
Shockmachine parameters
Within the EMBED tag and/or OBJECT tag, a single parameter (name/value pair) controls all Shockmachine functionality and has separate subparameters, as shown in the following example. The parameter name is swRemote ; it appears as follows in an HTML tag designed to work with both Microsoft Internet Explorer and Netscape Navigator. (For more information, see Netscape's applet and plug-in documentation.) All the code you need, including swRemote , is provided for you by the Publish feature in Director.
The following example contains both EMBED and OBJECT tags. It was generated using the Shockwave Default HTML template. The subparameters of swRemote are explained in the table that follows the example. |
|
|
|
<html>
<head>
<title>mymovie</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body bgcolor="#FFFFFF">
<object classid="clsid:166B1BCA-3F9C-11CF-8075-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/director/sw.cab#version=8,0,0,0"
ID=mymovie width=320 height=240>
<param name=src value="mymovie.dcr">
<param name=swRemote value="swSaveEnabled='true' swVolume='true' swRestart='true' swPausePlay='true' swFastForward='true' swCategory='games' swTitle='My Shockmachine Movie' swSendUrl='http://www.mydomain.com/mymovie.html' swPicon='http://www.mydomain.com/icon.gif' swPackage='http://www.mydomain.com/package.txt' swPackageSize='12' swContextMenu='true' ">
<param name=swStretchStyle value=none>
<PARAM NAME=bgColor VALUE=#FFFFFF> <embed src="mymovie.dcr" bgColor=#FFFFFFwidth=320 height=240 swRemote="swSaveEnabled='true' swVolume='true' swRestart='true' swPausePlay='true' swFastForward='true' swCategory='games' swTitle='My Shockmachine Movie' swSendUrl='http://www.mydomain.com/mymovie.html' swPicon='http://www.mydomain.com/icon.gif' swPackage='http://www.mydomain.com/package.txt' swPackageSize='12' swContextMenu='true' " swStretchStyle=none
type="application/x-director" pluginspage="http://www.macromedia.com/shockwave/download/"></embed>
</object>
</body>
</html>
|
|
|
|
Note that the swRemote parameter and its value are duplicated: this name/value pair is used once for the EMBED tag and once for the OBJECT tag. To specify an swRemote parameter, use a structure like this:
"NAME='VALUE' NAME='VALUE'"
The following table lists the subparameters you can specify in the HTML OBJECT and EMBED tags in order to improve both the Shockmachine saving process and the content's playback in Shockmachine.
| Subparameter |
Notes |
swPicon |
A fully qualified URL to a picon BMP or GIF file. The image should be a 64 x 64 pixels, 8-bit image and use the Web system palette.
If a picon is not specified, one will be generated automatically, but it is highly recommended that you provide custom art.
The value for swPicon is generated from the data entered in the Shockwave Save tab's Icon File text box. |
swPackage |
A fully qualified or relative URL (relative to the primary movie) of a package text file. This text file, in XML format, provides the URLs of all the files that need to download for a complete save of your movie.
The value for swPackage is generated from the data entered in the Shockwave Save tab's Package File text box.
For more information about package files, see Saving titles with multiple movies or external media. |
swTitle |
A text string that provides the user interface name for the Shockwave movie. The text can include spaces.
The title will appear in the Name field of the Save to Shockmachine dialog box when a user saves your movie to Shockmachine.
If you do not provide a title, Shockmachine will generate one based on the movie's file name, but it is highly recommended that you provide the title.
The value for swTitle is generated from the data entered in the Shockwave Save tab's Shockwave Title text box. |
swTotalSize |
For content with packages (see swPackage , above), specifies the size, in bytes, of all the content that needs to be downloaded for the piece to save successfully. The size should include the movie currently being saved, even though it's already in the cache. If nothing is specified, an estimate is calculated based on URLs already downloaded.
The value for swTotalSize is generated from the data entered in the Shockwave Save tab's Total Title Size text box. |
swSaveEnabled |
The values are TRUE or FALSE . The default setting for Director files is FALSE . Selecting the Save Local option in File > Publishing Settings sets the value to TRUE . Without a value of TRUE , the movie cannot be saved to Shockmachine.
Selecting the Save Local option also provides the necessary internal publish bit that makes saving possible. This bit must be used in conjunction with the swSaveEnabled code to make the movie savable to Shockmachine. |
| swCategory |
Specifies the category that will appear in the Category field of the Save to Shockmachine dialog box when a user saves your movie to Shockmachine.
If a category is not specified or is unavailable, the category that comes first alphabetically will be chosen.
The value for swCategory is generated from the data entered in the Shockwave Save tab's Suggested Category box. |
swSendUrl |
Specifies the URL to be sent when the user clicks the Shockmachine Send button, or chooses Send from the context menu of the Shockwave player.
The value of swSendUrl is generated from the data entered in the Shockwave Save tab's Send URL text box. |
| swSend |
This parameter is used by Shockwave player, not Shockmachine, but it may be of interest to developers of Shockmachine titles. It turns the Send feature in the Shockwave player context menu on or off. The values are TRUE (on) and FALSE (off).
To use this parameter, you must enter it manually in the HTML file. If the swSend parameter is not present, the Shockwave player assumes a value of TRUE .
The Send button in Shockmachine is always on. |
The following parameters are used by Shockwave Player but are ignored by Shockmachine.
| Subparameter |
Notes |
swVolume |
Lets users adjust the volume of the movie's sound track. The values are TRUE and FALSE .
To specify a value of TRUE , select the Volume Control option in the Shockwave tab of the Publish Settings dialog box. |
swPausePlay ,
swRestart ,
swFastForward |
The swPausePlay parameter lets users stop a movie's playback. The swRestart parameter lets users Restart a movie that has been paused. The swFastForward parameter lets users fast-forward through the movie. The values are TRUE and FASLE .
To specify a value of TRUE for all of these parameters, select the Transport Control option in the Shockwave tab of the Publish Settings dialog box. |
|
|
|
|
