Wrote a tutorial on using Eclipse with PCL

doc/tutorials/content/index.rst

@@ -46,7 +46,7 @@ Basic Usage
              Author: *Razvan G. Mihalyi*
 
              Compatibility: > PCL 1.6
-             
+
              Takes the reader through all of the PCL modules and offers basic explanations on their functionalities.
      ======  ======
 
@@ -62,7 +62,7 @@ Basic Usage
              Author: *Radu B. Rusu*
 
              Compatibility: > PCL 1.0
-             
+
              Presents the basic data structures in PCL and discusses their usage with a simple code example.
      ======  ======
 
@@ -77,7 +77,7 @@ Basic Usage
              Author: *Nizar Sallem*
 
              Compatibility: > PCL 1.0
-             
+
              In this tutorial, we will learn how to link your own project to PCL using cmake.
      ======  ======
 
@@ -92,7 +92,7 @@ Basic Usage
              Author: *Nizar Sallem*
 
              Compatibility: > PCL 1.0
-             
+
              In this tutorial, we will explain the basic PCL cmake options, and ways to tweak them to fit your project.
      ======  ======
 
@@ -107,7 +107,7 @@ Basic Usage
              Authors: *Alessio Placitelli* and *Mourad Boufarguine*
 
              Compatibility: > PCL 1.0
-             
+
              In this tutorial, we will explain how to compile PCL's 3rd party dependencies from source on Microsoft Windows.
      ======  ======
 
@@ -122,7 +122,7 @@ Basic Usage
              Author: *Mourad Boufarguine*
 
              Compatibility: > PCL 1.0 
-             
+
              In this tutorial, we will explain how to compile PCL on Microsoft Windows.
      ======  ======
 
@@ -137,7 +137,7 @@ Basic Usage
              Author: *Justin Rosen*
 
              Compatibility: > PCL 1.0
-             
+
              This tutorial explains how to build the Point Cloud Library **from MacPorts and source** on Mac OS X platforms.
      ======  ======
 
@@ -159,6 +159,21 @@ Basic Usage
      .. |mi_6| image:: images/macosx_logo.png
                :height: 100px
 
+  * :ref:`using_pcl_with_eclipse`
+
+     ======  ======
+     |mi_7|  Title: **Using Eclipse as your PCL trunk editor**
+
+             Author: *Koen Buys*
+
+             Compatibility: > PCL 1.7
+
+             This tutorial shows you how to get your PCL trunk as a project in Eclipse.
+     ======  ======
+
+     .. |mi_7| image:: images/pcl_logo.png
+               :height: 75px
+
 .. _advanced_usage:
 
 Advanced Usage
@@ -172,7 +187,7 @@ Advanced Usage
              Author: *Radu B. Rusu*
 
              Compatibility: > PCL 0.9, < PCL 2.0
-             
+
              This document explains what templated point types are in PCL, why do they exist, and how to create and use your own `PointT` point type.
      ======  ======
 
@@ -187,7 +202,7 @@ Advanced Usage
              Author: *Radu B. Rusu, Luca Penasa*
 
              Compatibility: > PCL 0.9, < PCL 2.0
-             
+
              This short guide is to serve as both a HowTo and a FAQ for writing new PCL classes, either from scratch, or by adapting old code.
      ======  ======
 
@@ -200,7 +215,7 @@ Features
 --------
 
   * :ref:`how_3d_features_work`
-    
+
      ======  ======
      |fe_1|  Title: **How 3D features work**
 

doc/tutorials/content/using_pcl_with_eclipse.rst

@@ -0,0 +1,108 @@
+.. _using_pcl_with_eclipse:
+
+Using PCL from trunk with Eclipse
+---------------------------------
+
+This tutorial explains how to use Eclipse as a PCL editor
+
+Prerequisites
+-------------
+
+We assume you have downloaded, compiled and installed PCL from trunk (see Downloads, experimental) on your machine.
+
+Creating the eclipse project files
+----------------------------------
+
+Open a terminal window and do::
+
+  $ cd /PATH/TO/MY/TRUNK/ROOT
+  $  cmake -G"Eclipse CDT4 - Unix Makefiles" .
+
+You will see something similar to::
+
+-- The C compiler identification is GNU
+-- The CXX compiler identification is GNU
+-- Could not determine Eclipse version, assuming at least 3.6 (Helios). Adjust CMAKE_ECLIPSE_VERSION if this is wrong.
+-- Check for working C compiler: /home/u0062536/bin/gcc
+-- Check for working C compiler: /home/u0062536/bin/gcc -- works
+-- Detecting C compiler ABI info
+-- Detecting C compiler ABI info - done
+-- Check for working CXX compiler: /home/u0062536/bin/c++
+-- Check for working CXX compiler: /home/u0062536/bin/c++ -- works
+-- Detecting CXX compiler ABI info
+-- Detecting CXX compiler ABI info - done
+-- -- GCC > 4.3 found, enabling -Wabi
+-- Using CPU native flags for SSE optimization:  -march=native
+-- Performing Test HAVE_MM_MALLOC
+-- Performing Test HAVE_MM_MALLOC - Success
+-- Performing Test HAVE_POSIX_MEMALIGN
+-- Performing Test HAVE_POSIX_MEMALIGN - Success
+-- Performing Test HAVE_SSE4_2_EXTENSIONS
+-- Performing Test HAVE_SSE4_2_EXTENSIONS - Success
+-- Performing Test HAVE_SSE4_1_EXTENSIONS
+-- Performing Test HAVE_SSE4_1_EXTENSIONS - Success
+-- Performing Test HAVE_SSE3_EXTENSIONS
+-- Performing Test HAVE_SSE3_EXTENSIONS - Success
+-- Performing Test HAVE_SSE2_EXTENSIONS
+-- Performing Test HAVE_SSE2_EXTENSIONS - Success
+-- Performing Test HAVE_SSE_EXTENSIONS
+-- Performing Test HAVE_SSE_EXTENSIONS - Success
+-- Found SSE4.2 extensions, using flags:  -march=native -msse4.2 -mfpmath=sse
+-- Try OpenMP C flag = [-fopenmp]
+-- Performing Test OpenMP_FLAG_DETECTED
+-- Performing Test OpenMP_FLAG_DETECTED - Success
+-- Try OpenMP CXX flag = [-fopenmp]
+-- Performing Test OpenMP_FLAG_DETECTED
+-- Performing Test OpenMP_FLAG_DETECTED - Success
+-- Found OpenMP: -fopenmp 
+-- Found OpenMP
+-- Boost version: 1.46.1
+-- The following subsystems will be built:
+--   common
+--   kdtree
+--   octree
+--   io
+--   search
+--   sample_consensus
+--   filters
+--   2d
+--   features
+--   keypoints
+--   geometry
+--   ml
+--   segmentation
+--   visualization
+--   outofcore
+--   stereo
+--   surface
+--   tracking
+--   registration
+--   people
+--   recognition
+--   global_tests
+--   tools
+-- The following subsystems will not be built:
+--   examples: Code examples are disabled by default.
+--   simulation: Disabled by default.
+--   apps: Disabled by default.
+-- Configuring done
+-- Generating done
+-- Build files have been written to: /data/git/pcl
+
+Importing into Eclipse
+----------------------
+
+Now you launch your Eclipse editor and you select File->Import...
+Out of the list you select General->Existing Projects into Workspace and then next.
+At the top you select Select root directory to be the root of your pcl trunk installation and press Finish.
+
+Setting the PCL code style in Eclipse
+-------------------------------------
+
+You can find a PCL code style file for Eclipse in trunk/doc/advanced/content/files/. 
+In Eclipse go to Project->Properties, then select Code Style in the left field and Enable project specific settings, then Import and select where your trunk/doc/advanced/content/files/PCL_eclipse_profile.xml file is.
+
+Where to get more information
+-----------------------------
+
+You can get more information here: http://www.vtk.org/Wiki/Eclipse_CDT4_Generator