SilverlightOnly Viewer Usage

Control Panel (mouse control)

The Control Panel appears when moving the mouse close to the upper or bottom edge of the viewer. Commands are activated with the mouse. They are illustrated in the figure below.

The panorama selection list is an optional element and is a copy of the web page selection list. It is loaded through Javascript function "GetPhotoList" from the hosting page. If the function does not exist, the list icon is not displayed.
GetPhotoList could also read an XML file containing the list, see a sample.

Open file gives you three powerful options:

open a local JPG, MOV or XML file, like 'c:\mypanos\peak3.jpg'

open a remote JPG, MOV or XML file directly by pasting the URL, like 'http://www.alpen-panoramen.de/photo/7242.jpg'

open a local URL file pointing to a remote JPG or MOV file. See how to create URL files easily in Windows

Options 2 and 3 allow you to open any remote panorama from the web, even if authorization file crossdomain.xml is missing at the host server. Get here a sample collection of panorama URL files you can open in the viewer.

Full-Screen is activated through the menu icon, by double-clicking the image or by pressing the space keyboard key.

Photo information is a pop-up list of data describing the current photo. Most of the data is collected from metadata tags (EXIF) recorded automatically by the camera, or added thru software programs (date, size, exposure, etc.).
One important item is the GPS location where the photo or panorama was taken. It will show as an image-link on the bottom of the list. By clicking on it, you can see a Google Map of the location.
The icon represents = no GPS data, = GPS data present

Sound control relates to volume and mute. A vertical pop-up slider controls the volume. A click on the speaker icon toggles between mute and un-mute. If the sound selected is a local MP3 file and after the entire file has been played, the speaker icon will disappear. If the audio file or audio stream is unavailable or invalid, the speaker icon will not be displayed.

Keyboard commands

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.

Installation

Free Viewer Pro Viewer

1. read the license and make sure you agree to its terms 1. buy a domain license for the Pro Viewer

2. reference SLcontrol with Viewer.xap in a web page 2. the Pro Viewer xap file is delivered by email

3. copy ViewerHS.xap on your web server

4. reference SLcontrol with ViewerHS.xap in a web page
<object id="SLcontrol" 
     data="data:application/x-silverlight-2," 
     type="application/x-silverlight-2"
     width="600" height="400" >
  <param name="source" 
     value="http://silverlightonly.com/Viewer.xap"/>
  <param name="EnableHtmlAccess" value="true" />
  <param name="initParams" value="Image=dir/Photo1.jpg,
      Jpg360=T,AutoSpin=T,Title=My Panorama" />
</object>
<object id="SLcontrol" 
     data="data:application/x-silverlight-2," 
     type="application/x-silverlight-2"
     width="600" height="400" >
  <param name="source" 
     value="ViewerHS.xap"/>
  <param name="initParams" value="dir/pano.xml" />
</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.

Setup

Initialization parameters for the Free Viewer are set inside the web page, parameter initParams. For the Pro Viewer they are inside the sloVH XML file, in sloImage Tag attribute (see format).

Image Path to panorama file - required for Free 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. JPEG, MOV and sloVH XML files do not need this setting. The other supported files types are:

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.

FPP = Flash Panorama Player file with suffixes _l, _f, _r, _b, _u, _d
FPP0 = Flash Panorama Player file with suffixes _0, _1, _2, _3, _4, _5
A cubic panorama is stored as six side-files. Each side-file ends with a suffix. Suffix _f means "front side" photo (like pano1_f.jpg), _l (left), _r (right), _b (back), _u (up) and _d (down) sides. The panorama settings should be "Image=vacation/pano1,FileType=FPP". See also 'Acropolis' sample panorama on the home page.

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 menu 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.

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 named color or RGB value in format "#RRGGBB". Default is "White".

Bcolor Border color of the control. Could be any valid named color or RGB value in format "#RRGGBB". Default is "Transparent".

AutoSpin Auto-rotate cylindrical or 2D cubic panoramas on load. Options are True (T) or False (F), default is False.

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° - X value is relative to the photo left edge, Y value is relative to the photo center.

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 How to display the panorama loading progress. Two options:
Detail - current panorama is closed and progress is shown on a horizontal bar with error reporting (default)
Circle - current panorama remains visible with a small circular progress indicator on top, without error reporting

3D By default, MOV, KRpano and FPP cubic panoramas are displayed in 3D. When this feature is disabled, the cube sides are shown in 2D as the original four flat photos stitched together (top and bottom sides 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.

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 (Pro only) - hide or collapse the Viewer on the page

Requirements

• Microsoft Silverlight plugin installed on client's browser
• Minimal Silverlight Control <object> size width of 200 pixels and height of 50 pixels

Limitations

• Image formats other than JPEG (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 side width > 2000 pixels could display at less than optimal speed in 3D.
• Multi-resolution panoramas are not currently supported. There are plans for future development using DeepZoom.

Known Issues

The viewer has been tested in Windows with Firefox, IE and Chrome browsers. No testing has been done on Linux or Mac operating systems and Safari. Please contact us if you find a bug.
Chrome does not allow pop-ups by default, here is how to enable them. The viewer generates a Google Maps pop-up when GPS data is present. Chrome also cannot hold focus on the viewer, click on viewer before each command.

License for Free Viewer

SilverlightOnly Panorama Viewer by SilverlightOnly.com is licensed under a Creative Commons Attribution-Noncommercial-No Derivative Works 3.0 United States License.

The panorama selection list is an optional element and is a copy of the web page selection list. It is loaded through Javascript function "GetPhotoList" from the hosting page. If the function does not exist, the list icon is not displayed. GetPhotoList could also read an XML file containing the list, see a sample.
Open file gives you three powerful options: open a local JPG, MOV or XML file, like 'c:\mypanos\peak3.jpg' open a remote JPG, MOV or XML file directly by pasting the URL, like 'http://www.alpen-panoramen.de/photo/7242.jpg' open a local URL file pointing to a remote JPG or MOV file. See how to create URL files easily in Windows Options 2 and 3 allow you to open any remote panorama from the web, even if authorization file crossdomain.xml is missing at the host server. Get here a sample collection of panorama URL files you can open in the viewer.
Full-Screen is activated through the menu icon, by double-clicking the image or by pressing the space keyboard key.
Photo information is a pop-up list of data describing the current photo. Most of the data is collected from metadata tags (EXIF) recorded automatically by the camera, or added thru software programs (date, size, exposure, etc.). One important item is the GPS location where the photo or panorama was taken. It will show as an image-link on the bottom of the list. By clicking on it, you can see a Google Map of the location. The icon represents = no GPS data, = GPS data present
Sound control relates to volume and mute. A vertical pop-up slider controls the volume. A click on the speaker icon toggles between mute and un-mute. If the sound selected is a local MP3 file and after the entire file has been played, the speaker icon will disappear. If the audio file or audio stream is unavailable or invalid, the speaker icon will not be displayed.

	Free Viewer		Pro Viewer
1.	read the license and make sure you agree to its terms	1.	buy a domain license for the Pro Viewer
2.	reference SLcontrol with Viewer.xap in a web page	2.	the Pro Viewer xap file is delivered by email
		3.	copy ViewerHS.xap on your web server
		4.	reference SLcontrol with ViewerHS.xap in a web page
<object id="SLcontrol" data="data:application/x-silverlight-2," type="application/x-silverlight-2" width="600" height="400" > <param name="source" value="http://silverlightonly.com/Viewer.xap"/> <param name="EnableHtmlAccess" value="true" /> <param name="initParams" value="Image=dir/Photo1.jpg, Jpg360=T,AutoSpin=T,Title=My Panorama" /> </object>		<object id="SLcontrol" data="data:application/x-silverlight-2," type="application/x-silverlight-2" width="600" height="400" > <param name="source" value="ViewerHS.xap"/> <param name="initParams" value="dir/pano.xml" /> </object>

Image	Path to panorama file - required for Free 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. JPEG, MOV and sloVH XML files do not need this setting. The other supported files types are: 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. FPP = Flash Panorama Player file with suffixes _l, _f, _r, _b, _u, _d FPP0 = Flash Panorama Player file with suffixes _0, _1, _2, _3, _4, _5 A cubic panorama is stored as six side-files. Each side-file ends with a suffix. Suffix _f means "front side" photo (like pano1_f.jpg), _l (left), _r (right), _b (back), _u (up) and _d (down) sides. The panorama settings should be "Image=vacation/pano1,FileType=FPP". See also 'Acropolis' sample panorama on the home page.
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 menu 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.
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 named color or RGB value in format "#RRGGBB". Default is "White".
Bcolor	Border color of the control. Could be any valid named color or RGB value in format "#RRGGBB". Default is "Transparent".
AutoSpin	Auto-rotate cylindrical or 2D cubic panoramas on load. Options are True (T) or False (F), default is False.
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° - X value is relative to the photo left edge, Y value is relative to the photo center.
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	How to display the panorama loading progress. Two options: Detail - current panorama is closed and progress is shown on a horizontal bar with error reporting (default) Circle - current panorama remains visible with a small circular progress indicator on top, without error reporting
3D	By default, MOV, KRpano and FPP cubic panoramas are displayed in 3D. When this feature is disabled, the cube sides are shown in 2D as the original four flat photos stitched together (top and bottom sides 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.