source: libs/SAMGAR V2/INSTALL_Linux.txt @ 633

Revision 633, 4.3 KB checked in by lmalek, 9 years ago (diff)

Samgar v2 Linux installation updated

Line 
1This document describes installation of SAMGAR V2 on Linux system (tested on Ubuntu x64).
2
3------------------------------------------------------------------------------------
4INSTALL
5------------------------------------------------------------------------------------
6
70. Start from creating a common directory for installation porpoise
8
9mkdir SRC_DIR
10cd SRC_DIR
11
121. Download the latest version of SAMGAR V2 from
13
14svn co https://svn.lirec.org/libs/SAMGAR%20V2/ SAMGAR_V2
15
16On yarp-2.3.0 aplication works but it was sometimes unstable. On yarp-2.3.1 aplication seams to work more stable.
17
182. Download and install the latest version of yarp from download page
19http://eris.liralab.it/yarp/specs/dox/download.html
20or do this from command line i.e.
21
22wget http://downloads.sourceforge.net/yarp0/yarp-2.3.1.tar.gz
23
24Then extract the archive
25
26tar xf yarp-2.3.1.tar.gz
27
283. Make sure that you have installed all essential software and libraries for compilation of yarp like ACE.
29
30sudo aptitude install libace-dev cmake cmake-curses-gui
31
32You can omit cmake-curses-gui, but I recommend to install this packet.
33Having all essential software and libraries installed you can install Qt that is required by SAMGAR V2
34
35sudo aptitude install libqt4-dev
36
374. Copy SAMGAR V2 GUI files to proper yarp subdirestory
38
39cp SAMGAR_V2/GUI/*.cpp yarp-2.3.1/src/yarpserver/src/
40cp SAMGAR_V2/GUI/*.h yarp-2.3.1/src/yarpserver/src/
41
425. Modify CMakeList.txt file responsible for compiling yarpserver
43
44gedit yarp-2.3.1/src/yarpserver/CMakeList.txt
45
46After line
47
48if (CREATE_YARPSERVER3)
49
50add following lines
51
52FIND_PACKAGE(Qt4 REQUIRED)
53SET(QT_USE_QTXML 1)
54INCLUDE(${QT_USE_FILE})
55
56then beforre the line
57
58add_executable(yarpserver3 ...)
59
60add line
61
62qt_wrap_cpp(yarpserver3 SERVER3GUI_MOC ${CMAKE_CURRENT_SOURCE_DIR}/src/server3Gui.h)
63
64add at the end of add_executable(yarpserver3 ...) file list following files
65
66${CMAKE_CURRENT_SOURCE_DIR}/src/samheader.h ${CMAKE_CURRENT_SOURCE_DIR}/src/server3Gui.h ${CMAKE_CURRENT_SOURCE_DIR}/src/server3Gui.cpp ${SERVER3GUI_MOC}
67
68Finally change the line
69
70target_link_libraries(yarpserver3 YARP_init)
71
72to
73
74target_link_libraries(yarpserver3 YARP_init ${QT_LIBRARIES})
75
76Then go to YARP directory
77
78cd yarp-2.3.1
79
80and configure cmake
81
82ccmake .
83
84I suggest building inside the source because otherwise one might have some problems with further usage of SWIG wrapper.
85
86Select to ON position variables CREATE_GUIS and CREATE_YARPSERVER3
87Then press two times [c] and [g] to generate makefile. Build yarp
88
89make
90
91and install it
92
93sudo make install
94
956. To build example SAMGAR application one have to prepare cmake to use YARP
96
97sudo cp FindYARP.cmake /usr/share/cmake-2.8/Modules/
98
99than go to module directory 
100
101cd ../SAMGAR_V2/Module
102
103to prevent making mess in code this time I suggest to build outside the source, so we have to create a new directory
104
105mkdir build
106cd build
107ccmake ../
108
109Type [c] two times and then [g]. After creating makefile compile the example module
110
111make
112
1137. To make example working first start
114
115yarpserver3
116
117and then the example module
118
119SAMGAR_V2/Module/build/SamExample
120
121Aster starting SamExample in yarpserver3 GUI appropriate elements should appear. You can connect modules ports by clicking
122left mouse button on the desired ports.
123
124------------------------------------------------------------------------------------
125KNOWN BUGS
126------------------------------------------------------------------------------------
127
1281. Above mentioned installation process does not include the icons and other graphical elements
129
1302. Starting yarpserver3 application in the directory containing SAMGAR V2 graphics (GUI/Bin directory) caused Segmentation Fault
131after starting SAMGAR_V2/Module/build/SamExample with following error description
132
133QObject::connect: Cannot queue arguments of type 'QTextCursor'
134(Make sure 'QTextCursor' is registered using qRegisterMetaType().)
135QPixmap: It is not safe to use pixmaps outside the GUI thread
136QPixmap: It is not safe to use pixmaps outside the GUI thread
137QPixmap: It is not safe to use pixmaps outside the GUI thread
138QPixmap: It is not safe to use pixmaps outside the GUI thread
139QPixmap: It is not safe to use pixmaps outside the GUI thread
140QPixmap: It is not safe to use pixmaps outside the GUI thread
141Segmentation fault
142
1433. Installation process should be more simple. Patches and script should be applied.
144
145
146--- lukasz.malek@pwr.wroc.pl
Note: See TracBrowser for help on using the repository browser.