documentation top

reference

2-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. Image numbers in a 2-d model are in the format _, for this model which is three frames high and nine frames wide, it looks like

   1_1	1_2	1_3	1_4	1_5	1_6	1_7	1_8	1_9
   2_1	2_2	2_3	2_4	2_5	2_6	2_7	2_8	2_9
   3_1	3_2	3_3	3_4	3_5	3_6	3_7	3_8	3_9

3. Write the applet tag: The APPLET tag for this example is

   <DIV align=center>
    <APPLET CODE="fvr2.class" ARCHIVE="fvr2Archive.jar" WIDTH=160 HEIGHT=120>
     <PARAM NAME="mFrames" VALUE="3">
     <PARAM NAME="nFrames" VALUE="9">
     <PARAM NAME="modelBase" VALUE="bsk">
     <PARAM NAME="noCircleM" VALUE="true">
     <PARAM NAME="initialI" VALUE="3">
     <PARAM NAME="initialJ" VALUE="5">
     <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="mFrames"> is the number of frames in the vertical direction, Freedom VR knows this is a 2d model because both nFrames and mFrames are specified
     • <PARAM NAME="nFrames"> is the number of frames in the vertical direction, Freedom VR knows this is a 2d model because both nFrames and mFrames are specified
     • <PARAM NAME="modelBase"> tells Freedom VR how the names of the images start. In this case the value is "bsk" 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="noCircleM"> tells Freedom VR that the images do not make a circle in the vertical direction -- you'd use noCircleN to do the same thing for the horizontal direction
     • <PARAM NAME="initialI"> and the initialJ tag specify the initial frame; the vertical and horizontal numbers of the frame you'd like viewers to see first.
     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.