last update: $Date: 2008/02/20 06:02:29 $

# Documents

## Installation manual

### Installing on Windows

1. System Requirement

   - Microsoft Windows 2000/XP (16bit color or better)
   - Microsoft OpenGL 4.0 or higher
   - Apple QuickTime 4.1 or higher
   - Java2 SDK 1.4.2 or higher
2. Installing SDK/JRE

   First, install Sun Microsystems's Java2 Software Development Kit (SDK) or Java2 Runtime Environment (JRE). SDK and JRE are both available at no cost from Sun Microsystems's Java Technology Homepage.

   JDK and JRE are provided as executable installer files, so after downloading, just run the installer and follow the instructions given.

3. Installing Apple QuickTime

   Download the Apple QuickTime and follow the instruction to install it. The Apple QuickTime is available for downloading from http://www.apple.com/quicktime/.

   Note that you don't have to install QuickTime for Java since Jun for Java doesn't need it.

   (additional remark) Since Jun500, you may choose to use QuickTime for Java.

4. Installing "Jun for Java"

   The most recent version of Jun for Java is available for downloading from SRA's FTP server.

   The downloadable files have been archived in ZIP format and restoring them will result the following files and directories.

   > `README` | ... | README file
   > `changes` | ... | Changes file
   > `doc/Installation/` | ... | Directory which contains the installation manual.
   > `src/` | ... | Source directory
   > `src-jni/GL/` | ... | Source directory of JNI shared library for OpenGL
   > `src-jni/QT/` | ... | Source directory of JNI shared library for Apple QuickTime
   > `lib/jun???.jar` | ... | Class library in JAR format. The ??? stands for the version number
   > `lib/windows/JunGL.dll` | ... | JNI-complient shared library file needed to access OpenGL from Jun for Java
   > `lib/windows/JunQT.dll` | ... | JNI-complient shared library file needed to access Apple QuickTime from Jun for Java

   Among these, `JunGL.dll` and `JunQT.dll` must be copied or moved to the path specified as the system directory.

   The downloaded file contains StPL (Smalltalk-Style Programming Library).

   > `README-StPL` | ... | README file of StPL.
   > `src/sra/smalltalk/` | ... | Source directory of StPL.
   > `src-jni/ST/` | ... | Source directory of JNI shared library for StPL
   > `lib/StPL??.jar` | ... | StPL in JAR format. The ?? stands for the version number.
   > `lib/windows/StPL.dll` | ... | JNI-complient shared library file needed to access StPL.

   As this library is a port of the original Jun written in Smalltalk (Jun for Smalltalk), Jun for Java uses SRA's StPL. Among these, `StPL.dll` must be copied or moved to the path specified as the system directory.

5. Invoking the Launcher

   Add the 2 JAR files that have been installed (i.e., `jun???.jar` and `StPL??.jar`) to the Java class path, then specify the class containing the method `main`, and invoke the Java virtual machine.

   For example, this can be accomplished by executing the following batch file.

           java -cp C:\Jun4Java\lib\jun699.jar;C:\Jun4Java\lib\StPL89.jar jp.co.sra.jun.system.support.JunLauncher

   In this, it is assumed that the JAR files have been installed in the path "`C:\Jun4Java`". If they have been installed elsewhere, then revise the specification of `CLASSPATH` appropriately.
6. Troubleshooting
   - The JunLauncher was not invoked and displayed the message "`Can't find JNI librarlly 'JunGL'.`"

     > Could not find `JunGL.dll`. Please copy `JunGL.dll` to a directory specified with the `PATH` environment variable.

   - The JunLauncher was not invoked and displayed the message "`JNI library 'JunGL' version error.`"

     > Different version of `JunGL.dll` was found. Please copy `JunGL.dll` included in the distribution to a directory specified with the `PATH` environment variable and overwrite the old one.

     > If more than one directories are specified with the `PATH` environment variable, be sure more than one `JunGL.dll` files are not exist.

   - Displayed the message "`Can't find JNI librally 'JunQT'.`" when you tried to open a movie window.

     > Could not find `JunQT.dll`. Please copy `JunQT.dll` to a directory specified with the `PATH` environment variable.

   - Displayed the message "`JNI library 'JunQT' version error.`" when you tried to open a movie window.

     > Different version of `JunQT.dll` was found. Please copy `JunQT.dll` included in the distribution to a directory specified with the `PATH` environment variable and overwrite the old one.

     > If more than one directories are specified with the `PATH` environment variable, be sure more than one `JunQT.dll` files are not exist.

http://www.sra.co.jp/people/nisinaka/
mailto:nisinaka@sra.co.jp