Viewer Usage

Keyboard commands are an alternative to certain mouse-activated Control Panel commands.  They are enabled when focus is on the panorama image. Some browsers, like Google Chrome, will set focus only after a mouse-click on the image.

• space - toggle between normal and full-screen mode
• arrow keys - move over panorama up, down, left and right
• PgUp / PgDown - zoom in and out. You could also use + / - in normal-screen mode
• F1 - shows help information. Not available in full-screen mode

Setup parameters for the Viewer can be defined in three locations, in increasing priority order:

• in QueryString of the page's address, like http://silverlightonly.com/v/view1.htm?Image=/v/media/p_&FileType=CUBE0&Title=Crypt
• inside the web page, parameter initParams of the Silverlight object
• inside a Hotspot Xml file, in Viewer's Parameters attribute (see format)

Image	Path to panorama file - required for Lite Viewer. It could be a local path, like myfolder/pano2.jpg, or remote - http://anotherweb.com/photo1.jpg. See also how to use a proxy to get files from remote domains. File types supported are JPEG, MOV (Apple QuickTime VR), KRpano XML or Flash Panorama Player - see below.
FileType	Type of the file set in Image. Single JPEG, MOV and Hotspot Xml files do not need this setting. The other supported files types are: CUBE = JPEG files with suffixes l, f, r, b, u, d CUBE0 = JPEG files with suffixes 0, 1, 2, 3, 4, 5 A cubic panorama is stored as six face-files. Each face-file ends with a suffix. Suffix f means "front face" photo (like pano1_f.jpg), others are l (left), r (right), b (back), u (up) and d (down). The panorama settings should be "Image=vacation/pano1_,FileType=CUBE". A sample of such panorama is 'cave', in Showcase. KRP = KRpano XML file containing a cubic panorama (simple or multi-resolution)     example: Image=http://mydomain.com/panos/bluesky.xml,FileType=KRP     For multi-resolution cubes, the layer with maximal height below 2000 pixels is chosen.
Jpg360	Panorama type for JPEG photos. The options are: True (T)= cylindrical or equirectangular 360° JPEG False (F) = normal photo or partial panorama (<360°) JPEG, will not auto-spin If Jpg360 is not provided, the program tries to guess whether the image is a cylindrical 360° panoramic photo. It is considered such if - the file name contains string "360" as in "mypano360d.jpg" - or its width is more than five(5) times larger than its height - or its width is exactly two(2) times larger than its height (equirectangular panorama) When the file name contains string "Wide", as in "myphotoWide.jpg", the image is considered 'normal photo'. Then the Control Panel does not display auto-rotate items and mouse navigation is limited to the photo edges.
Title	Title text displayed over the panorama. Could be any text without comma. Value "none" means no title, which is the default. Links can be set in format url?text, like http://link2me.net?the%20author
Tsize	Title font size. Valid entries are from 1 to 50. Default is 12.
Tpos	Position of panorama title, four options are available: UR = upper right corner UL = upper left BR = bottom right (default) BL = bottom left
Tcolor	Title's color could be any valid color name or RGB value in format "#RRGGBB". Default is "White".
Bcolor	Border color of the control. Could be any valid color name or RGB value in format "#RRGGBB". Default is "Transparent".
AutoSpin	Auto-rotate panoramas on load. Values are coded in two characters, like 'L3'. First is the rotaton direction - R (right) or L (left), followed by delay seconds (0 to 9). Default is none.
Sound	Audio stream or MP3 file, which will play for the selected panorama only.
SoundStay	same as above, but audio is not affected by panorama selection change, it plays continuously
Mute	Determines how the audio is started. Mute can later be changed manually from the control panel. Options are True (T) or False (F). Default is False.
Zoom	Numeric value for desired initial zoom, default is 1.
LookAt	Desired initial horizontal (X) and vertical (Y) shifts in pixels applied before initial zoom. Format is X;Y. Normal photos - values are relative to the photo center. For horizontal X values, negative means left shift, positive means right shift from center. For vertical Y values, negative is up, positive is down from center. Example:  LookAt=150;-200 Panoramas 360° in 2D: X value is relative to the photo left edge, Y value is relative to the photo center; in 3D: X value is horizontal rotation and Y is vertical rotation, in degrees.
LatLon	Panorama location for Google Maps in format Latitude;Longitude. Example:  LatLon=69.634099;18.98970 Allows to geotag your panorama without changing the image file - see how.
LoadProgress	Determines how the panorama loading progress is shown. Two options: Detail - horizontal progress bar (default) Circle - small circular progress indicator
3D	Cubic panoramas are displayed in 3D by default. When this feature is disabled, the cube faces are shown in 2D as the original four flat photos stitched together (top and bottom faces are ignored). The 2D option is recommended for large cubic panoramas with image width > 2000 pixels. Options are True (T) or False (F), default is True.
Menu	Customize the Control Panel content. You can set multiple options, separated by semi-colon (;). edit - show button Edit . The current XML file will be opened in the Editor page. spin - show the AutoSpin controls - left,right,stop and speed slider share - show button Share . -info - hide the photo information button -zoom - hide the zoom controls - in, out and current zoom -open - hide icon "Open file" -tab - hide the bottom menu tab

Parameters Type, Title, AutoSpin, Mute, Zoom, LookAt, LatLon and 3D affect only the current panorama. The others remain in effect until changed.
The only required parameter is Image. An alternative is to provide the panorama URL only, without any specific parameters, like <param name="initParams" value="media/myPano.jpg" />. This is valid for JPEG and MOV files only.
The hosting web page may contain three optional JavaScript functions for the Viewer to call :

GetPhotoList - get a list of panorama photos
GmapPop - pop-up a Google Maps window with current photo's location
HideSlCtrl - hide or collapse the Viewer on the page

1.	Build your panorama(s) with the Hotspot Editor or other editors.
2.	Test panoramas with the Pro Viewer page or the Lite Viewer page.
3.	When ready, buy a license for your domain thru PayPal and get the license file delivered by email
4.	Copy the viewer XAP file and the license file in the same folder on your domain server.
5.	Reference the viewer XAP file in your web page:
<object id="SLcontrol" data="data:application/x-silverlight-2," type="application/x-silverlight-2" width="600" height="400" > <param name="source" value="ViewerLite.xap"/> <param name="EnableHtmlAccess" value="true" /> <param name="initParams" value="Image=someFolder/Photo1.jpg, Jpg360=T,AutoSpin=L2,Title=My Panorama" /> </object>

Hosting XAP files may require small changes in the hosting server settings (add MIME type in IIS, or AddType in .htaccess). In shared hosting environments this may not be allowed. The work-around is to rename the XAP file extension to ZIP, as explained here.
If your web server is IIS, you'll need one more setting, for the license file. Set a new MIME Type as:

Extension:	.license
MIME Type:	application/octet-stream

As confirmation, you should be able to access(download) your license file through the browser as http://your-domain/vlite.license. See more information here.

• Microsoft Silverlight plugin installed on client's computer
• Silverlight Control <object> defined with minimal width of 200 pixels and height of 50 pixels

• Image formats other than JPEG (like GIF, PNG, etc.) are not supported.
• MOV vertical cylinders, compressed headers and non-JPEG images are not supported.
• Absolute zoom range is 0.1 to 10. Minimal and maximal zoom level depends on photo size and Silverlight Control's width.
• 3D field of view range is 10° to 120°.
• Cubic panoramas with face width > 2000 pixels could display at less than optimal speed in 3D.
• Equirectangular panoramas are not supported in 3D, only as cylindrical 2D. We plan to add this feature.
• Multi-resolution panoramas are not currently supported. There are plans for future development using DeepZoom.

The viewer has been tested with Firefox, IE, Chrome and Safari browsers. No testing has been done on Linux. Please contact us if you find a bug.
The viewer generates a Google Maps browser popup when GPS data is present and a button is hit. Firefox and Chrome browsers do not allow pop-ups by default, you need to enable them manually. Chrome cannot hold focus on the viewer, click on viewer before each command.