OpenPTC 1.0 Win32 Distribution Building
---------------------------------------

In order to build this distribution of OpenPTC you will need a
copy of Visual C++ version 5.0 or 6.0. No other compilers are
likely to be supported for building. If you are using Visual 
C++ 5, you will get some warnings "ignoring unknown option XX"
while building. This is just a symptom of using VC6 projects
under VC5, so you can safely ignore these warnings. Soon it is
likely that only Visual C++ 6.0 will be supported for building.

NOTE: OpenPTC Win32 comes with precompiled libraries and binaries
so it is not necessary to build the library yourself anymore.

1) Download and install NASM

   - Now that OpenPTC Win32 has assembler support for fast
     conversions and clears you will need to have NASM installed
     to be able to build the ptc libraries.
   - You can download NASM from http://www.cryogen.com/nasm,
     make sure you get the windows version of the executable
     because the dos version often runs out of memory because
     it was compiled as a real mode app (eep!)
   - Now, once you have NASM you need to install it. You can
     either place the nasm.exe in your path, or add the
     nasm directory to your executables directory in VC++.
   - Now that NASM is installed you are ready to continue.

2) Configure JAVA support
   
   - Java support allows java apps to call out to ptc.dll to get
     a large speed and functionality boost.
   - If you want JNI (Java Native Interface) support then you
     will need to have JDK 1.1 or greater installed and configure
     Visual C++ to have the JDK /include directory in the include
     file search path (tools/options -> directories).
   - If you want RNI (Raw Native Interface) support then you
     must have the Microsoft Java SDK installed and configure
     Visual C++ to search its include directory for include files.
   - To disable java support, comment out the following defines
     in "source/config.h": "__PTC_JNI__" and "__PTC_RNI__".

3) Build "ptc.dll", "ptcdebug.dll" and "hermes.dll"

   - Open the workspace "Source.dsw" in the "Source" directory
   - Go to the build menu and select "Batch Build"
   - In the dialog that pops up, check both debug and release
     configurations of "Dynamic" then press the "Build" button.
   - Ignoring any warnings that may occur, the build should
     have completed successfully.
