The following parameters are supported:

In <billboard> tag:
width	width="300"	width of billboard window in pixels
	or
	width="20%"	width in percentage of pano stage width
height	height="200"	height of billboard window
	or
	height="25%"	height in percentage of pano stage height
time	time="20"	image display time in seconds (default=20),
		can also be set individually in <ad> tag
		or with with a plugin action="time(nn)" command
autoPlay	autoPlay="0"	show billboard images at startup, default=1
imageScaling	imageScaling="fill"	image scaling, "none", "fit" or "fill",
		default: "fit", see NOTES
In <ads><ad> tag:
id	id="ad4"	optional id for use with "action" attribute above
url	url="img/advert_5.png"	image file url
time	time="30"	optional image display time in seconds
transition	transition="pressdown"	type of transition betweeen images (see below)
tooltip	tooltip="Visit Grand Hotel"	tooltip at image mouse-over
onClick	onClick="global.goHotel()"	FPP command when image is clicked
onOver	onOver="global.showSpot()"	FPP command at image mouse-over
onOut	onOut="global.hideSpot()"	FPP command at image mouse-out
In <upload> tag:
<url>	<url>http://site.com/script.php</url>	url to server upload script
<prompt>	<prompt>Due to the Flash...</prompt>	upload prompt text
<maxsize>	<maxsize>150000</maxsize>	max file size allowed (in bytes, default: 102400)

NOTES:

All tag names must be written in lower case, but attribute names are case independent (onClick is equal to onclick).

Image fitting is determined by the imageScaling="..." attribute. Supported values are:

none	no image scaling, image is shown as is
fit	image is scaled to best fit billboard window size, image proportions are kept unchanged
fill	image is scaled to fill the billboard window size, image proportions can be changed

Setting image display time with the action="time(nnn)" command will override both the default and individual image display times until the action="time(0)" command has been received.

Supported image transitions are:

fade	new image fades in over previous image
pushup	previous image pushed up by new image
pushdown	previous image pushed down
pushleft	previous image pushed to the left
pushright	previous image pushed to the right
pressup	previous image pressed up by new image
pressdown	previous image pressed down
pressleft	previous image pressed to the left
pressright	previous image pressed to the right
coverup	previous image covered from bottom to top by new image
coverdown	previous image covered from top to bottom
coverleft	previous image covered from right to left
coverright	previous image covered from left to right
grow	new image grows from center
shrink	previous image shrinks into center

To all transitions you can append (n) = transition time in seconds (default 3.0), example: pressdown(1.5)
If no transition is specified, one will be chosen at random.
Plugin "actions" during transitions are delayed until transition is complete.

When the action commands "-" or "+" are used to show the previous or the next image, the plugin will also enter pause mode. The timer controlled image show may then be restarted by giving a "play" command. All "press-" and "push-" transitions will also change direction: "pressleft" will be "pressright", "pushup" will be "pushdown" a.s.o.

For the viewer to add images to the slideshow with server upload-download, there of course has to be a server script (PHP, Perl or shell script) or application that can store the images in a place where the plugin can get to them. The same script can also be used to remove previously uploaded images. The script url must be entered in the plugin XML file. You can also set the largest file size allowed and the built-in text prompt that is necessary due to Flash Player 10 security policy.

Example of plugin xml file:

<?xml version = '1.0'?>
<billboard width="410" height="200" time="10" imageScaling="fill">
   <ads>
      <ad id="ad1" url="img/advert_2.jpg" transition="pushdown" tooltip="Clicking will load another pano" onClick="global.goASS()" />
      <ad id="ad2" time="15" url="img/advert_3.jpg" transition="pressdown" tooltip="Clicking will open a new browser window" onClick="openUrl(http://wirestam.com/panos/Flash/plugins,_blank)" />
      <ad id="ad3" url="img/advert_4.jpg" transition="pressleft" tooltip="Clicking will pan away a bit" onClick="pano.pan=55,3000;pano.tilt=5,3000" />
      <ad id="ad5" url="img/advert_5.jpg" transition="grow" tooltip="This is ad #5" onClick="pano.pan=-10,3000;pano.tilt=0,3000" />
      <ad id="ad6" url="img/advert_6.jpg" transition="fade(3.5)" tooltip="This is ad #6" onClick="pano.pan=30,3000;pano.tilt=0,3000" />
   </ads>
   <upload>
      <url>http://wirestam.com/php/loadscript.php</url>
      <maxsize>102400</maxsize>
   </upload>
</billboard>
						

Version history: