Using the standalone viewers to display your content
The standalone viewer is essentially the same as the browser version; it can open panoramas in either simple or xml mode: You can drop simple panoramas in jpg, gif, png or bmp/pict format on the application icon, or SPi-V xml files.
Download and install
- Download and extract your viewer, either for Windows or for Mac OS X.
- Move the extracted folder to a convenient place. Under Windows, C:\Program Files\fieldOfView\SPi-V engine would be a good location, under OS X creating a SPi-V engine in the Applications folder would make sense.
- You may want to make a shortcut on your desktop or the dock.
- The first time you launch the viewer, it may need to download some additional Shockwave components (see below).
Using the viewerOpening a panorama or panoramic tour in the viewer is as simple as dropping a file on the projector icon or its shortcut on the desktop or dock. The viewer accepts the same files the borwser version accepts. Alternatively you can open the viewer without dropping any files on it, and press Control and O (Windows) or Command and O (OS X). You will be presented with a file open dialog and you can choose whichever file you want to open.
Here's a step-by-step example using some of the downloadable material:
- Download and extract the simple tour demo from the downloads page.
- Find the simple-tour.xml file and drop it on the SPi-V icon. After the scene has loaded you can look around and navigate to the second scene.
- Now instead of opening the XML file, we want to open one of the panorama jpgs in simple mode. This can be done by dragging one of the two panoramas found in the simple-tour folder onto the SPi-V icon, or if the viewer is already open press Control or Command O and select one of the jpgs.
Configuring the viewer using SPi-V.ini
The executable viewers can optionally be configured using a .ini file. This specially formatted text file can be created with most text editors, but be sure to save the file as 'plain text', without formatting. A sample SPi-V.ini file is shown below:
[Settings] Background=#ffffff File=panorama.jpg Fullscreen=true WindowRect=293 307 1010 826 SaveWindowRect=true
backgroundSpecifies the background color of the application window (like the Shockwave bgcolor parameter in HTML)
fileSpecifies a file to open. This enables you to create a 'doubleclickable' tour, instead of having to drag a tour onto the viewer or create a batch file.
fullscreenSpecifies wether or not the viewer opens fullscreen
windowrectIf not in fullscreen, specifies the window size and position
savewindowrectSpecifies wether or not the viewer should remember its windowrect and fullscreen settings when you close it.
Collecting tour files into a Director 'cast'
Instead of delivering your tour as seperate graphics files and one or more XML files, you can also collect all files into a Director 'cast', and open that as if it were an xml file. This is only available for the executable viewers.
To create a Director cast, you need a copy of Adobe Director.
- First make sure your tour is working as separate files
- In Director, create an empty cast
- Put the XML in a text members. Make sure your main XML file is the first XML member in the cast.
- Import your images to the same cast
- Replace all references to the files imported to the name of the castmembers, prefixed with an '#' (eg: '#mypanorama.jpg')
- Save the cast (and optionally compress and or protect it), and open it in the viewer as if it were an image.
Making the viewer independant of ShockwaveThe standalone viewers depend on Shockwave 10 being installed on the system. The required Shockwave system files are not included with the downloads to save serverspace and bandwidth. If Shockwave 10 is not installed, you will be prompted to download it. If only parts of Shockwave are missing, these parts will be downloaded. By copying files from your Shockwave install to a special folder inside the standalone viewer folder, you can make the viewers independant of Shockwave on the end-user's system, allowing you e.g. to run the viewers straight off a CD without requiring an install. Here's a step by step guide with all the files you need to copy (note that in order to make sure you have all the files, you must first run the standalone viewer on your system):
- Create a folder named 'Xtras' in the standalone viewer's folder
- Copy this files from %syswindir% (eg: c:\windows\system32\)
- Copy these files from %syswindir%\macromed\Shockwave 10 (eg: c:\windows\system32\macromed\Shockwave 10)
- The next few files may either be inside %syswindir%\macromed\Shockwave 10\Xtras or inside their own folder in %userprofile%\Application Data\Macromedia\Shockwave Player\xtras\download\MacromediaInc (eg: C:\Documents and Settings\Aldo\Application Data\Macromedia\Shockwave Player\xtras\download\MacromediaInc):
- Flash Asset.x32
- Font Asset.x32
- Font Xtra.x32
- Mix Services.x32
- PNG Import Export.x32
- Shockwave 3d Asset.x32
- Text Asset.x32
- Text Xtra.x32
For MacOS X:
- Create a folder named 'Xtras' in the standalone viewer's folder
- Copy these files from /Library/Application Support/Shockwave 10/Shockwave.bundle/contents/Mac OS
- The next few files may either be inside /Library/Application Support/Shockwave 10/Xtras or inside their own folder in %userprofile%/Library/Application Support/Shockwave 10/Xtras/MacromediaInc:
- Flash Asset PPC
- Font Asset PPC
- Font Xtra PPC
- INetURL PPC Xtra
- NetFile PPC Xtra
- NetLingo PPC Xtra
- Mix Services PPC
- PNG Import Export
- Shockwave 3d Asset Xtra
- SWA Decompression PPC
- Text Asset PPC
- Text Xtra PPC
Launching SPi-V from PhotoshopThe standalone applications support two additional image formats the standard engine does not support: TIF files and Photoshop files. On a sufficiently equiped system, SPi-V can be launched from inside photoshop to get an immediate view of the latest changes you made in the panorama.
To create a menu item in the 'File -> Jump to' menu inside photoshop, all you have to do is create a shortcut or alias to SPi-V in a special folder:
[Photoshop folder]\Helpers\Jump To Graphics Editor
eg: C:\Program Files\Adobe\Photoshop CS\Helpers\Jump To Graphics Editor\SPi-V engine.lnk
or: Macintosh HD:Applications:Adobe Photoshop CS:Helpers:Jump To Graphics Editor:SPi-V engine alias
Limitations and caveats:
- Only 8 bit RGB images are supported. Layered images should not be a problem.
- Additional channels beyond R, G and B are interpreted as alpha-channels. They will mask parts of the image.
- The image (not the file) has to fit in graphics memory. On a system with 64 Mb graphics memory, a 6000 * 3000 panorama should display just fine (regardless of the number of layers), but larger panoramas may display poorly. On the other hand a system with 128 Mb of graphics memory will have no problem displaying a 300 Mb+ Photoshop file of a 8200 * 4100 pixel panorama.