Erstellt von Seite

HS-Mannheim dsViewer FR 1/4

DS Version Datum
Dokumentation 0001.001 2010-12-09

(Florian Roeske. Dic. 2010)

1. Einleitung
Was ist der dsViewer?

Funktion

Aufbau

Plugin System

2. Verwendung

Abhängigkeiten

WxWidgets
Der dsViewer basiert auf den wxWidgets, um in zu kompilieren werden die
WX-GTK Development-Pakete benötigt.

WxPropertyGrid
Die Seitenleiste für die Plugineinstellungen werden in einem WxPopertyGrid
dargestellt. Hierfür muss WxPopertyGrid von folgender Seite
heruntergeladen und manuel installiert werden.

http://wxpropgrid.sourceforge.net/cgi-bin/index

/home/diego/Downloads/Dokumentation_DS_Viewer.doc 10/12/2010
 Erstellt von Seite
HS-Mannheim dsViewer FR 2/4
DS Version Datum
Dokumentation 0001.001 2010-12-09

Installation mit
./configure
make
make install

OpenGL Bibliotheken
Die Darstellung der 3D Daten im dsViewer ist mit OpenGL realisiert.

Alle fehlenden Bibliotheken, bis auf wxPropertyGrid, sollten mit folgendem Aufruf installiert werden.

sudo apt-get install libwxgtk2.8-dev libglc-dev

Für das Objekterkennungsplugin wird zusätzlich die compilierte dsVisionToolbox benötigt. d.h. Die
dsVisionTollbox muss zuvor mit „cmake . && make && make install“ compiliert worden sein.

Compilieren
Wenn alle oben genannten Abhängigkeiten installiert wurden kann der dsViewer compiliert werden.
Dazu muss in das dsViewer Verzeichnis, welches sich im Unterverzeichnis „apps“ der
dsVisionToolbox befindet, gewechselt werden. z.B.

flo@flo-pc:~/dsvision/apps/dsViewer$
flo@flo-pc:~/dsvision/apps/dsViewer$ cmake .
flo@flo-pc:~/dsvision/apps/dsViewer$ make

Im Hauptverzeichnis muss nun „cmake . && make“ aufgerufen werden. Danach sollten sich im „bin“
Verzeichnis eine ausführbare Version des dsViewers befinden. Plugins die in der CmakeLists.txt Datei
im Hauptverzeichnis des dsViewers eingetragen wurden werden mit übersetzt und automatisch in das
Plugin Verzeichnis unter bin kopiert. Somit werden sie direkt beim Aufruf des Viewers mitgeladen.

Vorhandene Plugins

MyExamplePlugin

objectRecognitionPlugin

MyDisparityPlugin

KinectPlugin

/home/diego/Downloads/Dokumentation_DS_Viewer.doc 10/12/2010
 Erstellt von Seite
HS-Mannheim dsViewer FR 3/4
DS Version Datum
Dokumentation 0001.001 2010-12-09

sudo apt-get install git-core cmake libglut3-dev pkg-config build-essential libxmu-dev libxi-dev libusb-
1.0-0-dev
git clone https://github.com/OpenKinect/libfreenect.git
cd libfreenect
mkdir build
cd build
cmake ..
make
sudo make install
sudo ldconfig /usr/local/lib64/

Siehe auch http://openkinect.org/wiki/Getting_Started#Ubuntu_Manual_Install

Das KinectPlugin wird nicht automatisch mit dem dsViewer compiliert. Um das Plugin zu erstellen
muss entweder der Pfad des Plugins in der CmakeLists.txt um Hauptverzeichnis des dsViewers
hinzugefügt werden oder ein manueller build im direkt im Verzeichnis des KinectPlugins durchgeführt
werden.

3. Erstellen eines neuen PlugIns

Zum erstellen eines Neuen PlugIns für den dsViewer müssen folgende Schritte durchlaufen werden.
Als Name für das neue Plugin wird „NeuerPluginName“ gewählt.

1. Kopieren des MyExamplePlugin Ordners

2. Verzeichnis umbennenen in NeuerPluginName

3. Setzen des Plugin-Namens in der CmakeLists.txt

set(plugin_name "MyExamplePluginTest")

4. Anpassen der Namen der cpp und h Datei.

/home/diego/Downloads/Dokumentation_DS_Viewer.doc 10/12/2010
 Erstellt von Seite
HS-Mannheim dsViewer FR 4/4
DS Version Datum
Dokumentation 0001.001 2010-12-09

MyExamplePlugin.cpp → NeuerPluginName.cpp
MyExamplePlugin.h → NeuerPluginName.h

5. Anpassen des Headerincludes in der cpp Datei.

#include "NeuerPluginName.h"

6. Anspassen des PluginNamens in der HeaderDatei

#define PLUGIN_NAME "NeuerPluginName"

#define PLUGIN_CLASS_NAME NeuerPluginName

7. Eintragen des Plugins in der Haupt CmakeLists.txt der dsViewerApplication. Somit wird beim
compilieren des dsViewers ds Plugin mit übersetzt.

add_subdirectory (plugins/NeuerPluginName)

4. Ausblick – Verbesserungsmöglichkeiten
Plugins neu laden/bei start nicht laden (cmd arg)/ entladen
→ menupunkt plugins

Laden und speichern von Punktwolken

/home/diego/Downloads/Dokumentation_DS_Viewer.doc 10/12/2010