documentation top

reference

1-d navigation

1. Install Freedom VR. This step is covered on the installation page.
2. Install the images. Your images must be in .gif or .jpg format and numbered sequentially; it's best to store the images in a subdirectory underneath the directory that your page is in, but for this example I'm storing everything in the same directory since some people can't make subdirectories on their web servers. You can look at this directory to see how the images are stored.
3. Write the applet tag: The APPLET tag for this example is

   <DIV align=center>
    <APPLET CODE="fvr2.class" ARCHIVE="fvr2Archive.jar" WIDTH=320 HEIGHT=240>
     <PARAM NAME="nFrames" VALUE="17">
     <PARAM NAME="modelBase" VALUE="">
     <PARAM NAME="progY" VALUE="200">
     <PARAM NAME="ccw" VALUE="true">
     <B>This page contains a java applet that displays a VR model.
     Java makes it possible to see multimedia content on many platforms without
     downloading plug-ins or installing software: 
     <A HREF="http://www.netscape.com/">Netscape Communicator</A> supports
     Java on many platforms.</B>
    </APPLET>
   </DIV>
   
   

   Lets go through this step by step.
   • The <DIV> tag is the official tag that you're supposed to use for centering images and applets according to the W3 consortium.
   • The <APPLET> tag tells the browser that you're inserting an applet, where to download the applet from and how big it is. All of the images are 320x240 pixels; the <PARAM> tags that follow all are parameters to be passed to the applet.
     • <PARAM NAME="nFrames"> specifies two things -- first, it specifies the number of images that makes up the model; less obviously, it tells Freedom VR that this is a horizontal 1-d model. If you specified mFrames" instead, Freedom VR would treat this as a vertical 1-d model. If you specified both, Freedom VR would treat this as a 2-d model.
     • <PARAM NAME="modelBase"> tells Freedom VR how the names of the images start. In this case the value is "" since the image names are just numbers. Image #i is stored at the URL modelBase+i+imgExt where imgExt is another parameter. By default imgExt is ".jpg", add the tag <PARAM NAME="imgExt" VALUE=".gif"> if you're using gif files instead.
     • <PARAM NAME="progY"> is optional -- I used it to move the progress bar to the bottom of the image so it wouldn't obscure the prettier part of the first frame.
     • <PARAM NAME="ccw"> tells the applet that the frames are stored in counter-clockwise order instead of clockwise. Add this tag if you find your model spins the wrong way.
     Any HTML that is left in the <APPLET> tag will be ignored by Java-capable browsers and displayed by other browsers.

Freedom VR has a few more options which are listed on the reference page. You can also read about how to create 2-d navigable models or how to add hotspots to a model.