|
2
|
1 Palantir - A Lightweight, RESTful DICOM Server
|
|
|
2 ==============================================
|
|
|
3
|
|
|
4
|
|
|
5 Dependencies
|
|
|
6 ------------
|
|
|
7
|
|
7
|
8 1) CMake: Palantir uses CMake (http://www.cmake.org/) to automate its
|
|
|
9 building process.
|
|
|
10
|
|
|
11 2) Python: Some code is autogenerated through Python
|
|
|
12 (http://www.python.org/).
|
|
2
|
13
|
|
7
|
14 3) Mercurial: To use the cutting edge code, a Mercurial client must be
|
|
|
15 installed (http://mercurial.selenic.com/). We recommand TortoiseHg.
|
|
|
16
|
|
|
17 W) 7-Zip: For the native build under Windows, the 7-Zip tool is used
|
|
|
18 to uncompress the third-party packages (http://www.7-zip.org/).
|
|
|
19
|
|
|
20 You thus have to download and install CMake, Python, Mercurial and
|
|
|
21 possibly 7-Zip first. The path to their executable must be in the
|
|
|
22 "PATH" environment variable.
|
|
2
|
23
|
|
|
24 The other third party dependencies are automatically downloaded by the
|
|
|
25 CMake scripts. The downloaded packages are stored in the
|
|
|
26 "ThirdPartyDownloads" directory.
|
|
|
27
|
|
|
28
|
|
|
29 Building Palantir at a glance
|
|
|
30 -----------------------------
|
|
|
31
|
|
|
32 To build Palantir, you must:
|
|
|
33
|
|
|
34 1) Download the source code (either using Mercurial, or through the
|
|
|
35 released versions). For the examples below, we assume the source
|
|
|
36 directory is "~/Palantir".
|
|
|
37
|
|
|
38 2) Create a build directory. For the examples below, we assume the
|
|
|
39 build directory is "~/PalantirBuild".
|
|
|
40
|
|
|
41
|
|
|
42
|
|
|
43 Native Linux Compilation
|
|
|
44 ------------------------
|
|
|
45
|
|
|
46 To build binaries with debug information:
|
|
|
47
|
|
|
48 # cd ~/PalantirBuild
|
|
|
49 # cmake -DCMAKE_BUILD_TYPE=DEBUG ~/Palantir
|
|
|
50 # make
|
|
|
51 # make doc
|
|
|
52
|
|
|
53
|
|
|
54 To build a release version:
|
|
|
55
|
|
|
56 # cd ~/PalantirBuild
|
|
|
57 # cmake -DCMAKE_BUILD_TYPE=RELEASE ~/Palantir
|
|
|
58 # make
|
|
|
59 # make doc
|
|
|
60
|
|
|
61
|
|
|
62 Under Linux, you have the possibility to dynamically link Palantir
|
|
|
63 against the shared libraries of your system, provided their version is
|
|
|
64 recent enough. This greatly speeds up the compilation:
|
|
|
65
|
|
|
66 # cd ~/PalantirBuild
|
|
|
67 # cmake -DSTATIC_BUILD=OFF -DCMAKE_BUILD_TYPE=DEBUG ~/Palantir
|
|
|
68 # make
|
|
|
69
|
|
|
70
|
|
|
71
|
|
|
72 Cross-Compilation for Windows under Linux
|
|
|
73 -----------------------------------------
|
|
|
74
|
|
|
75 To cross-compile Windows binaries under Linux using MinGW, please use
|
|
|
76 the following command:
|
|
|
77
|
|
|
78 # cd ~/PalantirBuild
|
|
|
79 # cmake -DCMAKE_TOOLCHAIN_FILE=~/Palantir/Resources/MinGWToolchain.cmake -DCMAKE_BUILD_TYPE=DEBUG ~/Palantir
|
|
|
80 # make
|
|
|
81
|
|
|
82
|
|
|
83
|
|
7
|
84 Native Windows build with MinGW (VERY SLOW)
|
|
2
|
85 -------------------------------
|
|
|
86
|
|
7
|
87 # cd [...]\PalantirBuild
|
|
|
88 # cmake -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=DEBUG [...]\Palantir
|
|
2
|
89 # mingw32-make
|
|
7
|
90
|
|
|
91
|
|
|
92
|
|
|
93 Native Windows build with Microsoft Visual Studio 2005
|
|
|
94 ------------------------------------------------------
|
|
|
95
|
|
|
96 # cd [...]\PalantirBuild
|
|
|
97 # cmake -G "Visual Studio 8 2005" [...]\Palantir
|
|
|
98
|
|
|
99 Then open the "[...]/PalantirBuild/Palantir.sln" with Visual Studio.
|
|
|
100
|
|
|
101 NOTES:
|
|
|
102 * More recent versions of Visual Studio should also work.
|
|
|
103 * You will have to install the Platform SDK (version 6 or above):
|
|
|
104 http://en.wikipedia.org/wiki/Microsoft_Windows_SDK.
|
|
|
105 Read the CMake FAQ about MSVC 2005: http://goo.gl/By90B
|
