parameter: fullscreen

Contributed by: Patrick Cheatham

fullscreen is a built-in Flash Panorama Player function, which will:

  • open the panorama window in fullscreen mode, if supported
  • change from fullscreen view to the normal view

Syntax 1: fullscreen([url])
Example: onClick="fullscreen(myPano.swf)"

Syntax 2: fullscreen()
Example: onClick="fullscreen()"

Syntax 3: fullscreen(-)
Example: onClick="fullscreen(-)"

Flash Player Plugin versions 9.0.0.0 to 9.0.18.60 do not support the fullscreen feature. Syntax example 1 shows using the optional [url] parameter, which will open a new browser window when the fullscreen feature is unsupported.

onClick="fullscreen()" switches screen mode to fullscreen, but does nothing if the Flash Player Plugin version doesn't support fullscreen mode.

onClick="fullscreen(myPano.swf)" switches screen mode to fullscreen; if Flash Player doesn't support fullscreen mode it opens a new browser window with the indicated URL (myPano.swf in this example).

onClick="fullscreen(-)" switches screen mode to fullscreen, if Flash Player doesn't support fullscreen mode it opens a new browser window with the current document URL (window.location).

Notes regarding security restrictions (as of this writing):
The current version of Flash Player disables keyboard events for fullscreen mode in browser.
The user must click inside the Flash Player window to enact a fullscreen() event; Using onLoad or onOver events is not recommended. Attach fullscreen() only to the onClick event.

Full XML example:

<?xml version='1.0' encoding="utf-8"?>
<panorama>

<parameters>

layer_20 = hotspots.swf

</parameters>

<hotspots>

<global>

<pano></pano>

<spot
id="myFullscreen"

url="myFullscreenButton.png"

onClick="fullscreen(-)"
/>

</global>

</hotspots>

</panorama>