========================================================================
                    OpenCAMLib for Windows README
========================================================================

1. INTRODUCTION
-----------------------------------------------------------------------------------------

https://github.com/fra589/opencamlib is a fork of https://github.com/aewallin/opencamlib.
The only goal of this fork is to make a Windows available version for using with FreeCAD.


2.     INSTALL DEPENDENCY
-----------------------------------------------------------------------------------------

2.1. - Get latest full Python 2 Release with development files (I useed the 2.7.13) from https://www.python.org/downloads/windows/
2.2. - Install Python on his standard path : C:\Python27
     /!\ Install Python before Boost because the Boost build process need it. 
2.3. - Get latest Boost libraries from http://www.boost.org (I used the 1.62.0 from https://sourceforge.net/projects/boost/files/boost/1.62.0/boost_1_62_0.7z)
2.4. - Un7zip sources lib to it's standard path : C:\Program Files\boost\boost_1_62_0
2.5. - Créate configuration file %HOMEDRIVE%%HOMEPATH%\user-config.jam to tell Boost building where is Python, with the following content :
using python 
	: 2.7                           # Version
	: C:\\Python27\\python.exe      # Python Path
	: C:\\Python27\\include         # include path
	: C:\\\\Python27\\libs          # lib path(s)
	: <define>BOOST_ALL_NO_LIB=1
	;
2.6. - Start an Administrator shell command and cd to C:\Program Files\boost\boost_1_62_0 then type:
	.\bootstrap
	.\b2 -a --build-type=complete architecture=x86 address-model=64
    => This build all the boost's binaries libraries, This may take a while, depending of your PC.
	(The complette doc for Boost install and build is here : http://www.boost.org/doc/libs/1_62_0/more/getting_started/windows.html)


3.     GET OpenCAMLib source and compile library
-----------------------------------------------------------------------------------------

3.1. - git clone https://github.com/fra589/opencamlib.git or download and uncompress the ZIP file somewhere on your PC
3.2. - Open the Visual Studio Solution : <somewhere>/opencamlib/Windows/OpenCamLib.sln
3.3. - Select "Release" as active solution configuration and x64 as Active solution platform in the Visual Studio Configuration Manager.
     (if you have the 32 bits FreeCAD version, you need to create the corect config for  Release win32)
3.4. - Click on the “OpenCamLib” project in the solution explorer then click on:
	   PROJECT -> Properties -> Configuration Properies -> C/C++ Tab -> General -> Additional Include Directories
       verify the 2 directories :
       C:\Python27\include                              --- Or change it whatever other place where you installed it...
       C:\Program Files\boost\boost_1_62_0              --- Or change it whatever other place where you installed it...
	   In PROJECT -> Properties -> Configuration Properies -> Link editor -> General -> Additional Libraries Directories
       verify the 2 directories :
       C:\Python27\libs                                 --- Or change it whatever other place where you installed it...
       C:\Program Files\boost\boost_1_62_0\stage\lib    --- Or change it whatever other place where you installed it...
	   Click OK
3.5. - Click on BUILD -> Build Solution
       (This may take a while, depending of your PC)


4.       INSTALL for use with FreeCAD
-----------------------------------------------------------------------------------------

4.1. - Copy the resulting library from : <somewhere>\opencamlib\Windows\x64\Release X64\ocl.pyd
       to <FREECAD_PATH>\MOD\Path\ocl.pyd


========================================================================
         RUN FreeCAD and enjoy Path surfacing :-)
========================================================================