From c2e95188e56d534bde7ab6d2372df53c56100dbf Mon Sep 17 00:00:00 2001 From: Koen_Buys Date: Wed, 13 Mar 2013 13:29:27 +0100 Subject: [PATCH 1/2] added new tutorial about Eclipse configuration --- doc/tutorials/content/index.rst | 35 ++++-- .../content/using_pcl_with_eclipse.rst | 102 ++++++++++++++++++ 2 files changed, 127 insertions(+), 10 deletions(-) create mode 100644 doc/tutorials/content/using_pcl_with_eclipse.rst diff --git a/doc/tutorials/content/index.rst b/doc/tutorials/content/index.rst index 0b37b695d7b..a4de6901e7f 100644 --- a/doc/tutorials/content/index.rst +++ b/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** diff --git a/doc/tutorials/content/using_pcl_with_eclipse.rst b/doc/tutorials/content/using_pcl_with_eclipse.rst new file mode 100644 index 00000000000..1d6c4121dfc --- /dev/null +++ b/doc/tutorials/content/using_pcl_with_eclipse.rst @@ -0,0 +1,102 @@ +.. _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. + +Where to get more information +----------------------------- + +You can get more information here: http://www.vtk.org/Wiki/Eclipse_CDT4_Generator From 1431902ff952f29377b1bca2c36c1b9482150e4c Mon Sep 17 00:00:00 2001 From: Koen_Buys Date: Wed, 13 Mar 2013 13:33:29 +0100 Subject: [PATCH 2/2] added extra section how to set code style in Eclipse --- doc/tutorials/content/using_pcl_with_eclipse.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/tutorials/content/using_pcl_with_eclipse.rst b/doc/tutorials/content/using_pcl_with_eclipse.rst index 1d6c4121dfc..923b27c66c3 100644 --- a/doc/tutorials/content/using_pcl_with_eclipse.rst +++ b/doc/tutorials/content/using_pcl_with_eclipse.rst @@ -96,6 +96,12 @@ 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 -----------------------------