Manual for the JsphereMini Spherical Panorama Viewer Applet

 

JsphereMini is a free JAVA applet for viewing equirectangular 360x180 degree panorama images. With its 5.3 KBytes file size it is the smallest spherical panorama viewer that features bilinear rendering, progress bar, and memory-aware decimator! See here for a complete list of capabilities and a comparison with our other Jsphere viewer applets.

JAVA required to view this content.  

Download "JsphereMini" version 1.2.3 - by downloading you agree with the license terms at the bottom of this WEB page:

 

1. Interactive Commands

Mouse:

The mouse is used to change the viewing direction (panning). Click inside the applet and drag the mouse in order to change the direction and the speed of change. The center is the neutral zone: simply drag the mouse cursor towards one of the edges - the closer you get to the edge, the bigger will the change in viewing direction be.

By pressing either the SHIFT or CTRL key before clicking inside the applet you can zoom in or zoom out, respectively.

Keyboard:

Panning can also be controlled by the cursor keys LEFT, RIGHT, UP and DOWN. Several other keys are associated with actions too as is shown in the following table:

Key Action
LEFT
RIGHT
UP
DOWN
Panning
+
>
a
Zoom in
-
<
z
Zoom out
0
HOME
Zero - reset viewing direction to initial value
s
SPACE
Stop/Start - toggles auto-rotate (= panning through 360 degrees in 60 seconds), default is ON
i Info - show software version
h
?
Help - open the Jsphere software Web page

 

2. Applet Parameters

There are four applet parameters defined. Two of them are mandatory, the parameters for the "splash image" and "caption" are optional. All parameter names are lowercase.

Name Type Parameter Value and Meaning
image.url URL/file name Mandatory - file name of the equirectangular panorama image (JPEG or GIF format). The "width:height ratio" must be 2:1.
software.copyright String Mandatory - the copyright notice must have exactly the following value:
"Copyright (C) 2000-2001 Panopan"
splash.url URL/file name Optional - file name of the splash/wait image (JPEG or GIF format). The image will be centered on a white background.
view.caption String Optional - a string to be displayed in the status line of the browser.

Class File - HTML Code Example

  <applet name=jsphere code=JsphereMini.class width=320 height=200>
    <param name=image.url          value=thePano.jpg>
    <param name=software.copyright value="Copyright (C) 2000-2001 Panopan">
    <param name=splash.url         value=myWaitImg.jpg>
    <param name=view.caption       value="Look at this great panorama!">
    JAVA required to view this content.
  </applet>

JAR File - HTML Code Example

The transfer size of an applet can be reduced by packing it into a "jar file". It is also possible to put the splash image into the same jar file (and even the panorama image, although this is not optimal since it results in a long loading time). The jar file is created by the following command (consult your JAVA book):
  your_prompt> jar cvfM my-jsphere-mini.jar JsphereMini.class myWaitImg.jpg

The HTML code below shows how to reference such a jar file:

  <applet name=jsphere archive=my-jsphere-mini.jar
          code=JsphereMini.class width=320 height=200>
    <param name=image.url          value=thePano.jpg>
    <param name=software.copyright value="Copyright (C) 2000-2001 Panopan">
    JAVA required to view this content.
  </applet>
It is recommended to not only copy the jar file to the web server but also all the files that it contains: old (pre-JAVA-1.1) browsers do not understand the "archive" attribute and thus will fetch the class and image files via an ordinary Web connection.

Harddisk and CD Considerations

If your panorama HTML page should be displayed from the harddisk or CDROM drive instead of a network connection, you have to take care of local file access restrictions that most browsers impose on applets. First, you should place your work in a subdirectory (more specifically: not a root directory in case of Windows). Second, for Netscape it depends on whether it can handle JAR files or not.

Best is to place the files in the following way:

  .../someDir/index.html
  .../someDir/JsphereMini.class
  .../someDir/img/myWaitImg.jpg
  .../someDir/img/thePano.jpg
  .../someDir/jar/my-jsphere-mini.jar
The corresponding HTML applet tag in .../someDir/index.html:
  <applet name=jsphere codebase="." archive=jar/my-jsphere-mini.jar 
          code=JsphereMini.class width=320 height=200>
    <param name=image.url          value=img/thePano.jpg>
    <param name=software.copyright value="Copyright (C) 2000-2001 Panopan">
    JAVA required to view this content.
  </applet>
If a splash image should be included in the jar file then you have to add it with the right .../someDir/img path prefix. You can do it in the following way, for example:
  your_prompt> cd ".../someDir"
  your_prompt> jar cvfM jar/my-jsphere-mini.jar JsphereMini.class img/myWaitImg.jpg

Finally, some parameterization may be required depending on the browser and version:

 

3. Branded Version

Turn JsphereMini into your spherical viewer for your clients! A branded version of JsphereMini is available for a modest fee: it embeds (a) a URL to a customer specific help page that is activated by the 'h' or '?' key stroke, and (b) a self chosen logo and background color as a splash image. Note that your logo image and the URL will be an integral and non-removable part of the class file.

 

4. License

The JsphereMini JAVA applet (the software) described above and made available through this page is licensed free of charge. It may not be sold, altered or reverse engineered and the copyright notice may not be removed. The software is provided "as is", without warranty of any kind, either expressed or implied.

Interested in the branded version? Click here for secure online order!


Copyright (c) 2000-2001 Panopan Immersive Media
This page  http://www.panopan.com/sw/jsphere/mini.html  last modified 2001-03-28