OpenPTC 1.0 Win32 Compiler Instructions
---------------------------------------


The following compilers are currently supported by OpenPTC Win32:

1) Visual C++ - http://www.microsoft.com (commercial)
2) Watcom C++ - http://www.powersoft.com (commercial)
3) Cygnus C++ - http://sourceware.cygnus.com/cygwin (free)
4) LCC-Win32  - http://www.cs.virginia.edu/~lcc-win32 (free c only)

In order to use your compiler with OpenPTC Win32, you first
have to generate import libraries for the "ptc.dll" and
"ptcdebug.dll" so that you applications can link to OpenPTC.

Details on how to do this for each compiler are listed below:



1) Visual C++ 4.x, 5.0 and 6.0

- Open a command prompt or dos box in windows.

- If you use Visual C++ 4.x or 5.0 you will need to run the
  "vcvars32.bat" batch file included in the "bin" directory
  of your Visual C++ installation to make sure that all
  environment variables are correctly set to use Visual C++
  from the command line. Users of Visual C++ 6.0 can skip
  this step because the environment has already been setup
  by the installer.

- Run "scripts/visual/import.bat" to generate the import
  libraries for "ptc.dll" and "ptcdebug.dll". The import
  libraries will be placed in the "library/visual" directory.

- Visual C++ 5.0 or 6.0 users can use the project/workspace
  files provided to compile and run the examples and demos.
  See "install.txt" for details.

- Visual C++ 4.x users have to use the batch files in the
  "scripts/visual/4.x" directory to compile the examples and
  demos because Visual C++ 4.x cannot read version 5.0/6.0
  project files. See "scripts.txt" for more information.

- To make using the batch files easy you should add the
  "scripts/visual/4.x" directory to your path.



2) Watcom C++ 10.x and 11.0

- Open a command prompt or dos box in windows.

- Make sure that Watcom C++ is in your path and all of the
  compiler environment variables are set correctly. For
  example if Watcom c++ was installed in "c:\watcom":

    set WATCOM=c:\watcom
    set PATH=%WATCOM%\binnt;%PATH%
    set INCLUDE=%WATCOM%\h;%WATCOM%\h\nt

- Run "scripts/watcom/import.bat" to generate the import
  libraries for "ptc.dll" and "ptcdebug.dll". The import
  libraries will be placed in the "library/watcom" directory.

- To compile the examples and demo programs you can use the
  batch files in "scripts/watcom/10.x" for Watcom C++ 10.x,
  or "scripts/watcom/11.0" for Watcom C++ 11.0. See "scripts.txt"
  for more information.

- To make using the batch files easy you should add the
  "scripts/watcom/10.x" or "scripts/watcom/11.0" directory
  to your path.



3) Cygnus C++ (GNU-Win32/Cygwin)

- Open a command prompt or dos box in windows.

- Make sure that you have all the compilers and tools setup
  correctly. Read the documentation for more information.

- Run "scripts/cygnus/import.bat" to generate the import
  libraries for "ptc.dll" and "ptcdebug.dll". The import
  libraries will be placed in the "library/cygnus" directory.

- To compile the examples and demo programs you can use the
  batch files in "scripts/cygnus". See "scripts.txt" for more
  information.

- To make using the batch files easy you should add the
  "scripts/cygnus" directory to your path.



4) LCC-Win32

- Open a command prompt or dos box in windows.

- Make sure that you have the LCC-Win32 bin directory in your
  path. For example "set PATH=c:\lcc-win32\bin" if you installed
  lcc-win32 to "c:\lcc-win32".

- Run "scripts/lcc-win32/import.bat" to generate the import
  libraries for "ptc.dll" and "ptcdebug.dll". The import
  libraries will be placed in the "library/lcc-win32" directory.

- To compile the examples and demo programs you can use the
  batch files in "scripts/lcc-win32". See "scripts.txt" for more
  information.

- To make using the batch files easy you should add the
  "scripts/lcc-win32" directory to your path.

- Please note that LCC-Win32 is a C only compiler, so dont even
  bother trying to compile C++ example programs with it ok? =)
