Embedding QuickTime for Web Delivery

AUTOPLAY can either be set to TRUE or FALSE. The default behavior is set by the user in the 'QuickTime Plug-in Settings.' When set to TRUE, the AUTOPLAY attribute causes the movie to start playing as soon as the QuickTime Plug-In estimates that it will be able to play the entire movie without waiting for additional data.

For example:

<embed src="sample.mov" width="200" height="240" autoplay="true">

This attribute specifies the background color for any space that is not taken by the movie. For example, if a 160x120 movie was embedded in a space of 200x120, there would be 40 pixels of undefined color space in the width. Specifying the hex value of the background color will fill the undefined space with the value chosen.

For example:

<embed src="sample.mov" width="200" height="240" bgcolor="000000">

The QuickTime 4 Plug-in has additional support for the BGCOLOR attribute by recognizing color names. Acceptable values for this attribute are:

"BLACK" (#000000), "GREEN" (#008000), "SILVER" (#C0C0C0), "LIME" (#00FF00),
"GRAY" (#808080), "OLIVE" (#808000), "WHITE" (#FFFFFF), "YELLOW" (#FFFF00),
"MAROON" (#800000), "NAVY" (#000080), "RED" (#FF0000), "BLUE" (#0000FF),
"PURPLE" (#800080), "TEAL" (#008080), "FUCHSIA" (#FF00FF), "AQUA" (#00FFFF)

For example:

<embed src="sample.mov" width="200" height="240" bgcolor="black">

If CACHE=TRUE is specified, the browser will CACHE movies. If the movie is in CACHE when the user returns to the page, the movie will be played from CACHE instead of downloading again. CACHE can either be TRUE or FALSE, or simply CACHE. CACHE by itself implies TRUE. The default behavior is set by the user in the 'QuickTime Plug-in Settings.'

Note: The functionality of this attribute is only supported by Netscape Navigator, version 3.0 or later.

For example:

<embed src="sample.mov" width="200" height="240" cache="true">

The CONTROLLER attribute sets the visibility of the movie controller. CONTROLLER can either be TRUE or FALSE. By default, CONTROLLER is TRUE. If CONTROLLER is set to FALSE, the movie controller will not display.

Note: For compatibility with existing web pages, the default is FALSE for QuickTime VR movies, image files, and flash files.

For example:

<embed src="sample.mov" width="200" height="240" controller="false">

See also HEIGHT

CORRECTION can either be NONE or FULL. By default, CORRECTION equals FULL.This attribute is only appropriate for QuickTime VR panoramas.

For example:

<embed src="sample.mov" width="320" height="240" correction="full">

DONTFLATTENWHENSAVING makes the plug-ins' 'Save as QuickTime movie' work the same way the 'Save as source' does. Adding the DONTFLATTENWHENSAVING tag saves the data into a movie file without flattening it.

For example:

<embed src="sample.mov" width="320" height="240" dontflattenwhensaving>

The ENDTIME attribute defines the last frame of the movie. ENDTIME can be any time up to the duration of the movie. By default, ENDTIME is the duration of the movie. This attribute takes a time value in the form -- Hours:Minutes:Seconds:Frames (30ths). The frames component can be specified as a fixed point number so that more specific times can be specified for instance 3:30:22.5 means 3 minutes, 30 seconds and 22.5 frames.

For example:

<embed src="sample.mov" width="200" height="240" endtime="3:30:22.5">

See also STARTTIME

Only integer values between 8 and 64 degrees are supplied for this attribute. If no value is specified for FOV, the value stored in the movie is used. The FOV attribute allows you to specify the initial field of view angle for a QuickTime VR movie.

For example:

<embed src="sample.mov" width="320" height="240" fov="55">

The HEIGHT attribute specifies the height of the embedded file in pixels. If the movie controller is visible, an additional 16 pixels will need to added. The HEIGHT attribute is required unless the HIDDEN attribute is specified. The HEIGHT of the movie can be found by choosing 'Get Info...' in the 'Movie' menu within QuickTime Player. If you do not use the SCALE attribute and you supply a height that is smaller than the actual height of the movie (plus 16 if you are showing the controller), the movie will be cropped to fit the height. If you supply a height that is greater than the height of the movie, the movie will be centered inside this height.

Note:Never specify a height of less than 2 as this can cause problems with some browsers.

For example:

<embed src="sample.mov" width="200" height="240" controller="true">

See also WIDTH

There are no values to supply for this attribute. The HIDDEN attribute controls the visibility of the movie. If you do not supply HIDDEN, then the movie will be visible. If you supply HIDDEN, the movie is not visible on the page. This option is not appropriate for QuickTime VR Objects or Panoramas. The HIDDEN attribute is appropriate for sound-only movies which are hidden in the background.

For example:

<embed src="sample.mov" width="200" height="240" hidden>

This attribute enables clicking on a hotspot with the specified ID in a VR panorama to take the user to the specified URL.  n is the hotspot ID as defined when the hot spot is created in the QuickTime VR authoring tools.

For example:

<embed src="sample.mov" width="200" height="240" hotspot17="http://www.apple.com"">

When set, the HREF attribute provides a link to another page or movie when the movie is clicked on.

Note: If you are using a relative path name for the HREF then it should be relative to the location of the movie specified in the SRC attribute.

For example:

<embed src="sample.mov" width="200" height="240" href="http://www.apple.com/quicktime">

See also: TARGET and TARGET="QUICKTIME PLAYER"

KIOSKMODE is either TRUE or FALSE. By default, KIOSKMODE is FALSE. When KIOSKMODE is set to TRUE, the plug-in does not include its pop-up menu in the movie controller and does not allow drag and drop to save the movie.

For example:

<embed src="sample.mov" width="200" height="240" kioskmode="true">

LOOP is either TRUE, FALSE or PALINDROME. By default, LOOP is set to FALSE. When set, the LOOP attribute makes the movie play continuously. Setting LOOP to PALINDROME causes the movie to play alternately forwards and backwards. This option is not appropriate for QuickTime VR Objects and Panoramas.

For example:

<embed src="sample.mov" width="200" height="240" loop="true">

Just like MovieName, but uses a numeric ID instead of a name string. MovieID may be computed in the Wired Sprite scripts and may be useful where the MovieName of the target movie is not known.

For example:

<embed src="sample.mov" width="200" height="240" movieid="5">

With QuickTime 4.0 the targeting mechanism of wired actions has been extended to enable any action to target an element of another open movie. This means two or more movies within the same web page can communicate using the QuickTime 4.0 Plug-in. These same movies may communicate if they are opened in QuickTime Player if they are named using userdata atoms. For example, one movie can act as a controller for another movie setting things such as it's rate, volume, the pan angle of a QTVR track it contains, or the location of a sprite in a sprite track that it contains. In many cases things that required JavaScript can now be done using only the QuickTime Plug-in with Wired Movies.

For example:

<embed src="sample.mov" width="200" height="240" moviename="targetmov">

The NODE attribute allows you to specify the initial node for a multi-node QuickTime VR movie. Only integer values are supplied for this attribute. If no value is specified for this attribute, the default NODE and view (specified at creation time of the pano movie) is used.

For example:

<embed src="sample.mov" width="320" height="240" node="128">

See also: FOV, PAN, TILT

The PAN attribute allows you to specify the initial pan angle for a QuickTime VR movie. Only integer values are supplied for this attribute. The range of values for a typical movie would be 0.0 to 360.0 degrees. If no value for PAN is specified, the value stored in the movie is used. This attribute has no meaning for a standard QuickTime movie.

For example:

<embed src="sample.mov" width="320" height="240" pan="180">

See also: FOV, NODE, TILT

PLAYEVERYFRAME is either TRUE or FALSE. By default, PLAYEVERYFRAME is set to FALSE. When set, the PLAYEVERYFRAME attribute causes the movie to play every frame of the movie even if it is necessary to play at a slower rate to do so. This attribute is particularly useful to play simple animations. This option is appropriate for QuickTime movies. Note: PLAYEVERYFRAME=TRUE will turn off all audio tracks.

For example:

<embed src="sample.mov" width="200" height="240" playeveryframe="true">

The PLUGINSPAGE attribute allows you to specify a URL from which the user can fetch the necessary plug-in if it is not installed. This attribute is handled by your browser. If your browser cannot find the plug-in when loading your page, it will warn the user and allow them to bring up the specified URL, from which one could download QuickTime which includes the QuickTime Plug-In.

IMPORTANT: Please set this attribute to: "http://www.apple.com/quicktime/download/" which will point to the latest version of the plug-in. This option is appropriate for QuickTime movies and QuickTime VR Objects and Panoramas.

For example:

<embed src="sample.mov" width="200" height="240" pluginspage="http://www.apple.com/quicktime/download/">

QTNEXT can be used to specify the url of a movie to load and play at the end of the current movie. This allows up to 256 consecutive movies to play one after the other. This behaves exactly the same as if the movie has a HREF track with an auto-url ("A<url>") at the end of the movie. Where n is an integer greater than 0 and less than 256 that defines the index of the url in the playlist. A QTNEXT tag's value can be a url (and optional target) or GOTOnn where "nn" is the index of the QTNEXT url to load. This allows you to make an endlessly repeating playlist.

Note: that the original movie (the SRC attribute) is implicitly QTNEXT0.

For example:

<EMBED SRC="nameof.mov" WIDTH="200" HEIGHT="240"
QTNEXT1="<http://www.apple.com/quicktime/movies/sample.mov> T<myself>"
QTNEXT2="<rtsp://www.apple.com/quicktime/movies/sample.mov> T<myself>"
QTNEXT3="<URL> T<myself>
QTNEXT4="GOTO0"

See also: TARGET

This attribute allows content developers to force a browser to use the QuickTime Plug-in for a file no matter what its MIME type is. The attribute treats it's value as a URL to load, and ignores any data loaded by the browser from the "src" parameter.

For example:

<EMBED src="sample.mov" qtsrc="rtsp://www.apple.com/quicktime/movies/sample2.mov">

Using the QTSRCCHOKESPEED attribute gives content developers the ability to specify the datarate of a movie being served regardless of the connection speed an end user has. This may be useful when a particular movie is requested from a server by large volumes of users to eliminate congestion in routers.

For example:

<embed src="sample.mov" width="320" height="240" qtsrcchokespeed=33600>

SCALE is either TOFIT, ASPECT or a number. By default the value of SCALE is 1. If set to TOFIT, the movie is scaled to fit the embedded box as specified by the HEIGHT and WIDTH attributes. If this is set to ASPECT, the movie will scale to fit the embedded box while maintaining the aspect ratio. If this is set with a number, the movie will be scaled by that number (e.g. 1.5). Note: Using the number scale attribute with a QTVR Panorama movie can degrade the performance of the movie even on high-end systems.

For example:

<embed src="sample.mov" width="200" height="240" scale="tofit">

The SRC attribute defines the url to the file for the plugin or helper application to play. The SRC attribute is the most common way to embed the media, except for occasional instances where the TYPE attribute may be necessary.

For example:

<embed src="sample.mov" width="200" height="240">

See also: TYPE

The STARTTIME attribute defines the first frame of the movie STARTTIME can be any time within the length of the movie. By default, STARTTIME is the first frame of the movie (or 00:00:00). This attribute takes a time value in the form Hours:Minutes:Seconds:Frames (30ths). The frames component can be specified as a fixed point number so that more specific times can be specified for instance 3:30:22.5 means 2 minutes, 30 seconds and 22.5 frames.

For example:

<embed src="sample.mov" width="200" height="240" starttime="00:15:22.5">

See also: ENDTIME

When set, the QuickTime Plug-in will launch QuickTime Player as a helper application (if it is not already running) and opens the url of the movie file. In order for TARGET="QUICKTIMEPLAYER" to work, there needs to be an href attribute in the embed tag which points to the movie file.

For example:

<embed src="poster.mov" width="200" height="240" href="sample.mov" target="quicktimeplayer">

TARGET is an optional attribute, used in conjunction with the HOTSPOT or HREF attributes. When set, the TARGET attribute is the name of a valid frame (including _self, _top, _parent, _blank or an explicit frame name) that will be the target of a link specified by the HOTSPOT or HREF attribute. Leaving TARGET unspecified will open the new file in the same place as the current movie.

For example:

HOTSPOT32="http://www.apple.com/quicktime"TARGET32="_blank"

would specify that when hotspot 32 is clicked, the QuickTime home page will load in a new window.

NOTE: It is important to use the same ID# for both the HOTSPOT and TARGET for each URL reference. This ensures that the plug-in knows what HOTSPOT goes with what TARGET.

The TARGETCACHE attribute allows content creators to cache the movie the poster movie is targeting.TARGETCACHE is either TRUE or FALSE. By default, TARGETCACHE is FALSE.

For example:

<embed src="poster.mov" width="200" height="240" cache="true" href="sample2.mov" TARGET="myself" targetcache="true">

The TILT attribute allows you to specify the initial tilt angle for a QuickTime VR movie. Only integer values are supplied for this attribute. The range of values for a typical movie would be -42.5 to 42.5 degrees. If no value for TILT is specified, the value stored in the movie is used. This attribute has no meaning for a standard QuickTime movie.

For example:

<embed src="sample.mov" width="320" height="240" tilt="20.0">

See also: FOV, NODE, PAN

TYPE="MIMEtype" specifies the MIME type of the EMBED file, which in turn determines which plug-in to load. Use the TYPE attribute for a plug-in that requires no data, for example, a plug-in that draws an analog clock or fetches all of its data dynamically. For a visible plug-in, you must include both the WIDTH and HEIGHT attributes if you use TYPE; no default values are used.

Note: The functionality of this attribute is only supported by Netscape Navigator, version 2.0 or later.

For example:

<embed type="video/quicktime" width="200" height="240">

The VOLUME attribute sets the movie's initial audio volume. Only integer values between 0 through 100 are applied for this attribute. By default, VOLUME is set to 100. A setting of 0 effectively mutes the audio whereas a setting of 100 is the maximum volume.

For example:

<embed src="sample.mov" width="200" height="240" volume="50">

The WIDTH attribute specifies the WIDTH of the embedded file in pixels. The WIDTH of the movie can be found by choosing 'Get Info...' in the 'Movie' menu within QuickTime Player.

For example:

<embed src="sample.mov" width="200" height="240">

See also: HEIGHT