Updated Using BlenderCAM with OpenCAMLib (markdown)

Using-BlenderCAM-with-OpenCAMLib.md

@@ -1,49 +1,34 @@
-OpenCAMLib is an opensource CAM library created by Anders Wallin. It offers high quality waterline generation and drop cutter sampling algorithms. For drop cutter algorithms it's more reliable than Bullet Physics(Blenders builtin collision detection library) and offers better performance (up to 30 times faster than regular algorithm on 24-core machine).
+[OpenCAMLib](https://github.com/aewallin/opencamlib) is an open source CAM library created by Anders Wallin. It offers high quality waterline generation and drop cutter sampling algorithms. For drop cutter algorithms it's more reliable than Bullet Physics (Blender's built-in collision detection library) and offers better performance (up to 30 times faster than regular algorithm on 24-core machine).
 
 To use OpenCAMLib with BlenderCAM, it needs to be built from source and installed for python2.7 available from executable path.
 
 Building from source on Debian GNU/Linux (probably also Ubuntu):
 
-Install dependecies:  
+ 1. If haven't already, [[install blenderCAM|Using-Blendercam-from-github]].
 
-    sudo aptitude install libboost-dev libomp-dev libpython-dev python-dev python-vtk6 g++ cmake blender python3-numpy python3-shapely git libboost-python-dev  
+2. Install dependencies:  
+    `sudo apt install libboost-dev libomp-dev libpython-dev python-dev python-vtk6 g++ python3-numpy python3-shapely git libboost-python-dev`
+  For Debian Jessie you have to replace libomp-dev with libiomp-dev (libomp-dev is not in stable yet)
 
-Install optional dependencies:  
+3. Install optional dependencies:  
+   `sudo apt install amd64-microcode intel-microcode cmake-gui`
 
-    sudo aptitude install amd64-microcode intel-microcode cmake-gui
-
-For distribution Debian Jessi (8.3) instead libomp-dev it is necessary to put libiomp-dev, because libomp-dev missing in the repository
-
-    sudo aptitude install  libiomp-dev
-
-For Debian Jessie you have to replace libomp-dev with libiomp-dev (libomp-dev is not in stable yet)
-
-Then get BlenderCAM:
-
-    git clone https://github.com/vilemnovak/blendercam.git
-
-Then you have to run Blender from your distribution and set 'Scripts' directory in 'User preferences/File' to /home/yourusername/blendercam/scripts/
-
-After restarting Blender BlenderCAM will be available in 'User preferences/Addons'.
-
-Get newest OpenCAMLib from repository(this version is patched for VTK6 compatibility):
-
-    git clone https://github.com/ksuprynowicz/opencamlib.git
-
-If your system has VTK5, clone original OpenCAMLib instead:
-
-    git clone https://github.com/ksuprynowicz/opencamlib.git
-
-Configure and compile:
+4. Get newest OpenCAMLib (this version is patched for VTK6 compatibility):  
+    `git clone https://github.com/ksuprynowicz/opencamlib.git`
+   * If your system has VTK5, clone original OpenCAMLib instead:  
+    `git clone https://github.com/aewallin/opencamlib.git`
 
+5. Configure and compile:
+    ```
     mkdir opencamlib/build
     cd opencamlib/build
     cmake ..
     make
+    ```
 
-Install (by default in /usr/local):
+6. Install (by default in /usr/local):
+    `sudo make install`
 
-    sudo make install
+To use OpenCAMLib waterlines, select "Show experimental features" in Blender User Preferences / Addons / CAM - gcode generation tools. Then select Waterline strategy and "Use OpenCAMLib". The current version lacks dialog for waterline resolution and automatic determination of cutter length, those can be adjusted in `scripts/addons/cam/opencamlib/oclWaterline.py`.
 
-To use OpenCAMLib waterlines, select "Show experimental features" in Blender User Preferences / Addons / CAM - gcode generation tools. Then select Waterline strategy and "Use OpenCAMLib". Current version lacks dialog for waterline resolution and automatic determination of cutter length, those can be adjusted in "scripts/addons/cam/opencamlib/oclWaterline.py" file.
-For "parallel" strategy and other drop cutter sampling operations select both "Use exact mode" and "Use OpenCAMLib".
+For "parallel" strategy and other drop cutter sampling operations select both "Use exact mode" and "Use OpenCAMLib".