Difference between revisions of "Have a single ptviewer jar file per website"

From PanoTools.org Wiki
Jump to: navigation, search
(some stuff on mod_rewrite)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[PTViewer]] is a [[Java]] applet that is supplied as a file called <tt>ptviewer.jar</tt>.
+
[[PTViewer]] is a [[Java]] applet for interactively displaying [[equirectangular]]
 +
panoramas that is supplied as a file called <tt>ptviewer.jar</tt>.
  
 
Typically it is embedded in a web-page using ''applet'' or ''object'' HTML tags, the
 
Typically it is embedded in a web-page using ''applet'' or ''object'' HTML tags, the
Line 11: Line 12:
 
     <param
 
     <param
 
       name="file"
 
       name="file"
       value="panorama.jpg" />
+
       value="/the/path/to/panorama.jpg" />
 
   </applet>
 
   </applet>
  
This has caused problems in the past with some [[Java]] virtual machines which have
+
This causes problems with some [[Java]] virtual machines which require extra resources
interpreted the ''archive'' path differently, generally web-site creators place the
+
such as the file <tt>panorama.jpg</tt> to be in the same folder as the applet itself
[[JAR]] archive in the same directory as the HTML page and specify the location like so:
+
(or in a subfolder) � Generally web-site creators place the [[JAR]] archive and
 +
[[JPEG]] image in the same directory as the HTML, then specify the locations without
 +
full paths:
  
   archive="ptviewer.jar"
+
   <applet
 +
    archive="ptviewer.jar"
 +
    code="ptviewer.class"
 +
    width="320"
 +
    height="200">
 +
    <param
 +
      name="file"
 +
      value="panorama.jpg" />
 +
  </applet>
  
To avoid having superfluous copies of the applet on a server, you can use this apache
+
To avoid having superfluous copies of the applet on a server for every directory, you can use this apache
directive to make it appear that a single copy appears to exist in every directory:
+
directive to make it appear that a single copy appears to exist throughout the site:
  
 
   RewriteEngine on
 
   RewriteEngine on
Line 30: Line 41:
  
 
This requires apache with ''mod_rewrite'' enabled.  You can place the directive in the
 
This requires apache with ''mod_rewrite'' enabled.  You can place the directive in the
<tt>httpd.conf</tt> configuration file or in a <tt>?htaccess</tt> file in the root of your site.
+
<tt>httpd.conf</tt> configuration file or in a <tt>.</tt><tt>htaccess</tt> file in the root of your site.
 +
 
 +
 
 +
[[Category:Tutorial:Specialised]]

Latest revision as of 19:58, 4 December 2007

PTViewer is a Java applet for interactively displaying equirectangular panoramas that is supplied as a file called ptviewer.jar.

Typically it is embedded in a web-page using applet or object HTML tags, the ptviewer.jar file location is specified in the archive attribute:

 <applet
   archive="/path/to/ptviewer.jar"
   code="ptviewer.class"
   width="320"
   height="200">
   <param
     name="file"
     value="/the/path/to/panorama.jpg" />
 </applet>

This causes problems with some Java virtual machines which require extra resources such as the file panorama.jpg to be in the same folder as the applet itself (or in a subfolder) � Generally web-site creators place the JAR archive and JPEG image in the same directory as the HTML, then specify the locations without full paths:

 <applet
   archive="ptviewer.jar"
   code="ptviewer.class"
   width="320"
   height="200">
   <param
     name="file"
     value="panorama.jpg" />
 </applet>

To avoid having superfluous copies of the applet on a server for every directory, you can use this apache directive to make it appear that a single copy appears to exist throughout the site:

 RewriteEngine on
 RewriteRule (^|/)ptviewer\.jar$ /websites/mysite/html/ptviewer.jar

(replace /websites/mysite/html/ptviewer.jar with the system path on your server)

This requires apache with mod_rewrite enabled. You can place the directive in the httpd.conf configuration file or in a .htaccess file in the root of your site.