OpenPTC 1.0 Win32 Distribution Installation
-------------------------------------------


In order to use this distribution of OpenPTC you will need a
copy of Visual C++ version 5.0 or 6.0. No other compilers are
supported at this point in time. 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.

1) Build "ptc.dll" and "ptcdebug.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.

2) Install "ptc.dll" and "ptcdebug.dll"

   - You can either add the "Library/debug" and "Library/release"
     directories to your path, or copy the files "ptc.dll" and
     "ptcdebug.dll" into your windows system directory.
   - If you do not have the dynamic link libraries in your path
     none of your PTC executables will be able to run!
   - A nice installer program for the dll files is coming soon
     so you wont have to do this in future versions.

3) Enjoy compiling and running the examples and demos!

   - You can build the example programs by opening up the
     "Examples.dsw" directory in the "Examples" directory.
   - To build the demo programs open up the "Demos.dsw"
     workspace file in the "Demos" directory.
   - You can move between seperate projects in the workspace
     using "Set Active Configuration" in the build menu.

4) What if you cant get it to work??

   - You can get support on the newsgroup news.scene.org/coders.ptc
   - If you find a bug you can report it to news.scene.org/coders.ptc.bugs.
   - If you need some functionality in the Win32 distribution that is
     missing, post a request to news.scene.org/coders.ptc.development
     and we will see if we can help you.
   - Remember that this is a beta release. We have fixed all known major
     bugs, but some may still be lurking under the surface, and there
     are plenty of features left to be added. By telling us about bugs
     promptly we can fix them as fast as possible! Make sure you include
     the "ptc.log" file when you submit bug reports!


Good luck!
--
Glenn "Gaffer" Fiedler
ptc@gaffer.org
