source: bioView3D/BUILD.txt

Last change on this file was 179:09c3cda8e2f9, checked in by Dmitry Fedorov <fedorov@…>, 8 years ago

bioview3d: build instructions and scripts

File size: 3.4 KB
Line 
1bioView3D
2
3http://www.bioimage.ucsb.edu/bioview.html
4
5This software uses Trolltech Qt library and therefore make sure to have
6one installed on your system first. The Qt library is free for Open Source
7development and can be downloaded here:
8  http://www.trolltech.com/
9  http://www.trolltech.com/products/qt/downloads
10
11The Qt version used is: 4.6 note that qt4 is significantly different from qt3
12and therefore will not build on systems with only qt3 installed.
13
14There are some other libraries used besides Qt: libtiff, libjpeg, libpng, zlib
15These libraries are needed to show image previews. Their code is located in /libs
16the reason why we distribute the sources is historical, fist of all, we had modified
17libtiff that would overcome problems reading many proprietary formats based on it.
18Second, we have opted to distribute statically linked image libraries in order to
19avoid any possible trouble with future updated versions.
20
21The Qt project file is used to create bioView3D, it is file is called "bioview3d.pro"
22In order to generate the makefile for your system use "qmake" utility distributed with
23Qt library. Some changes in bioview3d.pro might have to take place, since the autoconf is
24not used you have to make sure the required libraries are linked and configured properly.
25
26Platform specific compilation notes:
27  1) Windows
28  2) Mac
29  3) Linux
30
31 
32-------------------------------------------
331) Windows
34-------------------------------------------
35
36Visual Studio:
37Visual C++ 2008 solution and project files can be found in the "msvc2008" directory. There are image
38libraries prebuild with VC2008 in /libs for both x86 and x64, if other version of VC are used they
39might have to be rebuild.
40
41Other compilers:
42In order to use other compilers the qmake utility should be used in order to generate the appropriate
43makefile. For windows the available modes are: win32-borland, win32-icc, win32-g++, win32-msvc
44The qmake can also generate Visual Studio compatible project files.
45
46-------------------------------------------
471) Mac
48-------------------------------------------
49
50Start by using the provided build script: build-bioview3d-macosx.sh
51
52If you would like to build manually or generate an XCode project:
53The qmake utility should be used in order to generate the appropriate makefile using "bioview3d.pro"
54project file. The xcode project can also be generated.
55The syntax of make can be found here: http://doc.trolltech.com/4.6/qmake-running.html
56
57If dynamically linked Qt is used, make sure to verify the bioView3D binary file is pointing to the right
58location of .dylib (or other) files. We suggest to place the needed libraries in
59bioview3d.app/Contents/Frameworks/ and then use the install_name_tool to point it to the right location.
60There are is a scripts in the root of bioview3d source that do just that: macx_deploy.
61
62e.g.:
63qmake -spec macx-g++ bioview3d.pro
64make -j 2
65sh macx_deploy
66
67
68-------------------------------------------
691) Linux
70-------------------------------------------
71
72Start by using the provided build script: build-bioview3d-linux.sh
73
74If you would like to build manually:
75The qmake utility should be used in order to generate the appropriate makefile using "wv.pro"
76project file. The syntax of make can be found here: http://doc.trolltech.com/4.1/qmake-running.html
77
78e.g.:
79qmake bioview3d.pro
80make -j 2
81
82KDevelop - at the moment, you're on your own, use the supplied bioview3d.pro file in order to create
83the KDevelop project.
84
Note: See TracBrowser for help on using the repository browser.