HomefieldOfView | SPi-V dev


  • required
  • not yet implemented



Using the standalone viewers to display your content

SPi-V can display panoramas in the browser, but there's also an executable version available that works outside the browser. This viewer is available for both Windows (Windows 98 and newer) and OS X (version 10.2 and newer).

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

  1. Download and extract your viewer, either for Windows or for Mac OS X.
  2. 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.
  3. You may want to make a shortcut on your desktop or the dock.
  4. The first time you launch the viewer, it may need to download some additional Shockwave components (see below).

Using the viewer

Opening 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:

  1. Download and extract the simple tour demo from the downloads page.
  2. 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.
  3. 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.
Control or Command F switched the viewer to and from fullscreen mode. On windows, the viewer can be started in fullscreen mode by supplying a '-f' argument in the command line. You can add this argument to a shortcut if you want.

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:

WindowRect=293 307 1010 826
  • background
    Specifies the background color of the application window (like the Shockwave bgcolor parameter in HTML)
  • file
    Specifies 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.
  • fullscreen
    Specifies wether or not the viewer opens fullscreen
  • windowrect
    If not in fullscreen, specifies the window size and position
  • savewindowrect
    Specifies 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.

  1. First make sure your tour is working as separate files
  2. In Director, create an empty cast
  3. Put the XML in a text members. Make sure your main XML file is the first XML member in the cast.
  4. Import your images to the same cast
  5. Replace all references to the files imported to the name of the castmembers, prefixed with an '#' (eg: '#mypanorama.jpg')
  6. 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 Shockwave

The 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):
For Windows:
  1. Create a folder named 'Xtras' in the standalone viewer's folder
  2. Copy this files from %syswindir% (eg: c:\windows\system32\)
    • msvcrt.dll
  3. Copy these files from %syswindir%\macromed\Shockwave 10 (eg: c:\windows\system32\macromed\Shockwave 10)
    • dirapi.dll
    • Proj.dll
    • iml32.dll
  4. 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
    • INetURL.x32
    • NetFile.x32
    • NetLingo.x32
    • Mix Services.x32
    • PNG Import Export.x32
    • Shockwave 3d Asset.x32
    • swadcmpr.x32
    • Text Asset.x32
    • Text Xtra.x32
For MacOS X:
  1. Create a folder named 'Xtras' in the standalone viewer's folder
  2. Copy these files from /Library/Application Support/Shockwave 10/Shockwave.bundle/contents/Mac OS
    • DPLLib
    • IMLLib
    • ProjLib
    • MacromediaRuntimeLib
  3. 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 Photoshop

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

Problem with OS X

I just wanted to try this out and downloaded the newest version for Mac OS X (linked above). I expanded the file and put them in a SPi-V folder in my applications folder. Upon launch I get:

Director Player Error
Property not found
Script Error. Continue?

And clicking yes or no gets me no where. Just a black box with no content.


This error occurs when the vi

This error occurs when the viewer can not initialise the 3d xtra. Odd. How about other content, eg in the SPi-V gallery or the fullscreen gallery? Does that work at all? It should be using the same 3d xtra...

Could you try reinstalling Shockwave from this link? This is the 'full' installer, as opposed to the standard installer that does not include the Shockwave 3d xtra.

Reinstalled Shockwave and eve

Reinstalled Shockwave and everything works perfectly now. Thanks!

Navigation with Keyboard Keys ?

Hello Aldo.
Today I tested your Standalone Viewer on Windows and notice that the user can not navigate the panorama using the keyboard arrows. Is possible to add that feature in a future release ? Please let me know and thanks a lot in advance. Best regards from Mexico City.


Implemented in SPi-V 1.3

updated instructions

Added instructions about the SPi-V.ini file and Director cast support.

Re: updated instructions

Where are updated instructions?

Re: updated instructions

In the text.
See 'Configuring the viewer using SPi-V.ini' and 'Collecting tour files into a Director 'cast''

Re: updated instructions

This is not working for me in photshop cs3

anyone got it working in cs3?
it works fine in cs


Re: updated instructions

Unfortunately Adobe removed the 'jump to...' functionality in Photoshop CS3. It is simply not there. It is probably possible to write a Photoshop javascript file (.jsx) to do something similar, but this will require some work. Is this important functionality for you?

Re: updated instructions

I would love to see this up and running on Photoshop cs3 too, unfortunatly my javascript =< hello world! so props to anyone with a nice tutorial / script that can help =)