------------------------------------            ________      ________
   The JavaViewLib Package for Maple            \   \   \    /   /   /
------------------------------------             \   \   \  /   /   /
        JVL v4.00 Sept. 2012                      \   \   \/   /   /
      Authored by Steven Dugaro            ________\   \      /   /________
        and Konrad Polthier                \            \    /            /
     Contact support@javaview.de            \            \  /            /
------------------------------------         \____________\/____________/ 

   The functions in this package allow you to export Maple plots to an 
   external geometry viewer and as web based visualization applets
   based on the JavaView software.
   
   This allows for dynamic Maple plots to remain dynamic when exported to 
   an .html file rather than simply exporting an assemblage of static images.
   Additionally, JVL allows a large variety of models to be imported back into
   Maple through JavaView's MPL or JVX formats. Furthermore, gzip integration 
   improves the efficiency of file transfer and storage of your geometry models.

   For new versions and support have a look at
            www.javaview.de/maple

Requirements:

   Maple 6 and later
   WINDOWS 9x/NT/2000/XP, IRIX, or LINUX
   Internet Explorer 4.01+, Netscape 4.08+, Firefox, or Opera 4+
   Java JDK 1.1 or later from Oracle at www.java.com
   (optional) gzip compression software

Installation:

  1a. Download the JavaViewLib package from
            www.javaview.de/maple.
      The JVL package contains the JVL Maple library and the JavaView
      runtime libraries in a bundle.

  1b. Unzip the JavaViewLib archive into a directory. For example, within the 
      Maple installation directory is common:
            c:\Program Files\Maple 6\JavaViewLib\
      This directory is called the JVL Installation Directory (JVL_INST_DIR).
      
  1c. UNIX users must check if the following files are executable
            <JVL_INST_DIR>\bin\javaview
            <JVL_INST_DIR>\bin\jvl
      Windows users can skip this step.

  1d. Obtain a free license from
            www.javaview.de/download/registration.html
      and save the emailed file jv-lic.lic at
            <JVL_INST_DIR>\rsrc\jv-lic.lic
      for example,
            c:\Program Files\Maple 6\JavaViewLib\rsrc\jv-lic.lic

  2a. Ensure that your PATH environment variable contains a permanent entry
      for the path to the browser(s) you intend to use. (Otherwise you will have
      to specify the browser's path every time you run JavaViewLib). An attempt will 
      be made to detect browsers here, and a warning will given if none
      could be found.
      JVL 3.0 automatically searches in the PATH for executables:
         Windows: {iexplore.exe,netscape.exe,netscp6.exe,netscp.exe,opera.exe,firefox.exe}
         Unix:    {netscape, opera, firefox}
      
      On Win9* you must specify the path in your "C:\autoexec.bat" file.
         For example, if Internet Explorer browser is located in the directory
         "C:\Program Files\Internet Explorer\" then the following line must be
         added to "C:\autoexec.bat":
            SET PATH = %PATH%;C:\Program Files\Internet Explorer\
      
      On WinNT and WinXP open the System Property dialog and edit
         the environment variable PATH. This variable can be set either for
         the current user or for all users. The PATH variable should include
         one or more directories such as
            c:\Program Files\Internet Explorer\
            c:\Program Files\Mozilla Firefox\
            c:\Program Files\Netscape\Netscape\
      The provided documentary file
            <JVL_INST_DIR>\docs\jvlSettingPath_snap.png
      shows a snapshot of the dialogs for setting the PATH variable at WinNT and WinXP.
      
      On Unix use the usual way to set the path environment variable.

  2b. (Optionally) Ensure that your PATH environment variable contains an
      entry to the GZIP compression software. GZIP is used by JVL to
      shrink the size of geometry files in order to improved download times.
      "gzip" should be available on a Unix installation. On Windows, "gzip.exe"
      is separately available from
            http://www.gzip.org/

   3. Prepend the JVL Installation Directory to the global libname variable in
      each Maple session in which you wish to use the JavaView package.
      For example:
            [> libname := "C:\\Program Files\\Maple 6\\JavaViewLib\\", libname;
      To avoid having to execute this line each time you wish to use the 
      JavaViewLib, add this line to your Maple initialization file maple.ini.

   4. Load the library JavaViewLib in each Maple session or in your Maple 
      initialization file using the case sensitive command:
            [> with(JavaViewLib);

   5. Optional: if you would like your working directory to be other than the 
      JVL installation directory, specify the path using:
            [> setWorkingPath("C:\\jvlModels\\session");
      Note, this command works on Maple 6 but may not work with more recent versions.
      The command works with Maple 10, but fails with Maple 9.

Notes:

   1. To test your installation, load the worksheet
            gettingStarted.mws.
      Additional help and error tracking tips are given in
            jvlDebug.mws
      Several Maple plots and JavaViewLib usage are shown in
            geometryPlots.mws
            generateApplets.mws

   2. Help on using the JavaViewLib can be found in the Maple help browser 
      under Graphics...JavaView... or type:
            [> ?JVL

   3. LINUX and IRIX users be sure that gzip and java are installed by
      running the commands from a shell.

   4. JavaView control keys for navigation inside the viewer are specified at
             www.javaview.de/jars/shortcuts.html
      and in your JVL installation at
             <JVL_INST_DIR>\jars\shortcuts.html
      for example,
             c:\Program Files\Maple 6\JavaViewLib\jars\shortcuts.html
      
   5. In case of questions and suggestions feel free to contact
             support@javaview.de
      Please, provide detailed information about your settings such as
             JVL version number
             JavaView version
             Java version
             Maple version
             Operating system
      when sending a bug report.
      
      Also let us know how JVL enhances your Maple experience.

--------------------------------------------------------------------------------------
