|
|
(8 intermediate revisions by one other user not shown) |
Line 1: |
Line 1: |
| [[Slicer3:Developers:Projects:QtSlicer|QtSlicer]]/[[Slicer3:Developers:Projects:QtSlicer/Tutorials|Tutorials]]← | | [[Slicer3:Developers:Projects:QtSlicer|QtSlicer]]/[[Slicer3:Developers:Projects:QtSlicer/Tutorials|Tutorials]]← |
| = Building Slicer with Qt = | | = Building Slicer with Qt = |
− | == 1 Build Qt ==
| + | '''Note: See [[Slicer4:Build_Instructions|the Slicer4 build instructions]] for the latest information on building 3D Slicer with a Qt user interface. This page is no longer used (to access previous information consult this page's history tab).''' |
− | [http://qt.nokia.com/downloads Download and install Qt]. As of winter 2009, get the [http://qt.nokia.com/doc/4.6/qt4-6-intro.html 4.6 version]. | |
− | * Linux/Mac - install full QtCreator package (use "-arch x86_64" for a 64 bit build on snowleopard)
| |
− | <pre>
| |
− | cd Slicer3-lib
| |
− | mkdir Qt
| |
− | mkdir Qt-build
| |
− | cd Qt
| |
− | wget http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.6.0.tar.gz
| |
− | tar xvfz qt-everywhere-opensource-src-4.6.0.tar.gz
| |
− | cd qt-everywhere-opensource-src-4.6.0
| |
− | echo yes | ./configure -prefix ../../Qt-build -debug-and-release -opensource -no-qt3support
| |
− | make -j 16
| |
− | make install
| |
− | </pre>
| |
− | On a 64 bit system, you may have to add -arch x86_64 to the Qt configure (?)
| |
− | | |
− | * Windows - need to get [http://qt.nokia.com/downloads source code]. On the LGPL tab, select the source code download page for windows and visual studio 2008, and note that there is a link below where you can download the [http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.6.0.zip source code in a zip archive] (use a windows extracter, don't use cygwin unzip it).
| |
− | ** launch the msvc2008 command prompt (MSVC08 Tools->Visual Studio 2008 CommandPrompt)
| |
− | ** build with <code>configure.exe -platform win32-msvc2008</code>
| |
− | *** Note: if you are compiling Slicer in Debug mode, please add the <code>-debug</code> argument to the command line above to generate a compatible build; Release is the default.
| |
− | **** Using the Qt Designer on Windows requires that the Slicer widget plugins are compiled in the same mode than Qt. If Qt is compiled in Release mode (default), Slicer would have to be compiled in Release. However if Qt is compiled in Debug mode only, Slicer must be compiled in Debug. (and if Qt is in "Release and Debug", Slicer must be compiled in Release). So for developers, the <b>Debug mode is recommended</b>.
| |
− | ***According to [http://qt.nokia.com/doc/4.6/supported-platforms.html] Qt does not support msvc2008 on windows xp. However, running configure.exe with no <code>-platform</code> argument seems to work. If you run configure with the <code>-platform</code> argument first by mistake, and if <code>configure -clean</code> doesn't work, then you may need to start from a fresh extraction from the .zip archive before running <code>configure</code> again with no <code>-platform</code>, unless you can run <code>nmake</code> with the config clean target.
| |
− | ** run <code>vcvars32.bat</code> first
| |
− | ** and then <code>nmake</code>.
| |
− | ** building with webkit support requires that <i>src/3rdparty/webkit/WebCore/tmp/moc/{debug,release}_shared/mocinclude.tmp</i> be removed. else you will get linker errors like <code>QNetworkReplyHandler.obj : error LNK2001: unresolved external symbol "public: virtual struct QMetaObject const * __thiscall WebCore::FormDataIODevice::metaObject(void)const (?metaObject@FormDataIODevice@WebCore@@UBEPBUQMetaObject@@XZ)</code>
| |
− | ** If you encounter the following error <code>api\qscriptextensionplugin.h(43): Error: Undefined interface,</code>, delete the files <i>\src\script\tmp\moc\debug_shared\mocinclude.tmp</i> and <i>\src\script\tmp\moc\release_shared\mocinclude.tmp</i> and restart nmake. For more info, please see [http://bugreports.qt.nokia.com/browse/QTBUG-6470 QTBug 6470]].
| |
− | | |
− | == 2 Build Slicer without Qt first ==
| |
− | Do a standard build of Slicer and then we will convert it to use Qt
| |
− | | |
− | == 3 Build VTK with Qt enabled==
| |
− | <pre>
| |
− | cd ../../VTK-build
| |
− | ../CMake-build/bin/ccmake .
| |
− | Press 't' to enter advanced mode.
| |
− | VTK_USE_GUISUPPORT to ON
| |
− | (and VTK_USE_QT to ON if it exists) | |
− | Press 'c' to configure.
| |
− | VTK_USE_QVTK to ON
| |
− | Press 'c' to configure.
| |
− | DESIRED_QT_VERSION to 4
| |
− | Press 'c' to configure.
| |
− | QT_QMAKE_EXECUTABLE to {path to}/Slicer3-lib/Qt-build/bin/qmake
| |
− | Press 'c' to configure.
| |
− | Press 'g' to generate
| |
− | make -j16
| |
− | </pre>
| |
− | * issues
| |
− | ** if you encounter compilation errors like <code>undefined reference to `QMapData::createData(int)'</code>, delete the entire build directory (<i>VTK-build</i>) and start a build from scratch (you can use the same CMakeCache.txt)
| |
− | | |
− | == 4 Build Slicer with Qt enabled.==
| |
− | <pre>
| |
− | cd ../../Slicer3-build
| |
− | ../Slicer3-lib/CMake-build/bin/ccmake .
| |
− | Slicer3_USE_QT ON
| |
− | Press 'c' to configure
| |
− | QT_QMAKE_EXECUTABLE to {path to}/Slicer3-lib/Qt-build/bin/qmake
| |
− | Press 'c' to configure and then press 'g' to generate.
| |
− | make -j16
| |
− | </pre>
| |
− | | |
− | = Useful links for Qt =
| |
− | * [http://qt.nokia.com/doc/4.6/index.html Documentation]
| |
− | * [http://qt.nokia.com/doc/4.6/how-to-learn-qt.html First steps]
| |
− | * [http://qt.nokia.com/doc/4.6/tutorials.html Tutorials]
| |
− | * [http://qt.nokia.com/doc/4.6/examples.html Examples]
| |