Mercurial > hg > orthanc
annotate INSTALL @ 189:ccbc2cf64a0d
record main dicom tags and changes
| author | Sebastien Jodogne <s.jodogne@gmail.com> |
|---|---|
| date | Mon, 12 Nov 2012 18:03:48 +0100 |
| parents | 09718f2fc5cb |
| children | 471df5fecb1e |
| rev | line source |
|---|---|
| 57 | 1 Orthanc - A Lightweight, RESTful DICOM Server |
| 2 ============================================= | |
| 2 | 3 |
| 4 | |
| 5 Dependencies | |
| 6 ------------ | |
| 7 | |
| 57 | 8 1) CMake: Orthanc uses CMake (http://www.cmake.org/) to automate its |
| 9 building process. | |
| 7 | 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 | |
| 57 | 29 Building Orthanc at a glance |
| 30 ---------------------------- | |
| 2 | 31 |
| 57 | 32 To build Orthanc, you must: |
| 2 | 33 |
| 34 1) Download the source code (either using Mercurial, or through the | |
| 35 released versions). For the examples below, we assume the source | |
| 57 | 36 directory is "~/Orthanc". |
| 2 | 37 |
| 38 2) Create a build directory. For the examples below, we assume the | |
| 57 | 39 build directory is "~/OrthancBuild". |
| 2 | 40 |
| 41 | |
| 42 | |
| 43 Native Linux Compilation | |
| 44 ------------------------ | |
| 45 | |
| 46 To build binaries with debug information: | |
| 47 | |
| 57 | 48 # cd ~/OrthancBuild |
| 49 # cmake -DCMAKE_BUILD_TYPE=DEBUG ~/Orthanc | |
| 2 | 50 # make |
| 51 # make doc | |
| 52 | |
| 53 | |
| 54 To build a release version: | |
| 55 | |
| 57 | 56 # cd ~/OrthancBuild |
| 57 # cmake -DCMAKE_BUILD_TYPE=RELEASE ~/Orthanc | |
| 2 | 58 # make |
| 59 # make doc | |
| 60 | |
| 61 | |
| 57 | 62 Under Linux, you have the possibility to dynamically link Orthanc |
| 2 | 63 against the shared libraries of your system, provided their version is |
| 64 recent enough. This greatly speeds up the compilation: | |
| 65 | |
| 57 | 66 # cd ~/OrthancBuild |
| 67 # cmake -DSTATIC_BUILD=OFF -DCMAKE_BUILD_TYPE=DEBUG ~/Orthanc | |
| 2 | 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 | |
| 57 | 78 # cd ~/OrthancBuild |
| 79 # cmake -DCMAKE_TOOLCHAIN_FILE=~/Orthanc/Resources/MinGWToolchain.cmake -DCMAKE_BUILD_TYPE=DEBUG ~/Orthanc | |
| 2 | 80 # make |
| 81 | |
| 82 | |
| 83 | |
| 7 | 84 Native Windows build with MinGW (VERY SLOW) |
|
13
7908a4c25a18
preparation for release
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
7
diff
changeset
|
85 ------------------------------------------- |
| 2 | 86 |
| 57 | 87 # cd [...]\OrthancBuild |
| 88 # cmake -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=DEBUG [...]\Orthanc | |
| 2 | 89 # mingw32-make |
| 7 | 90 |
| 91 | |
| 92 | |
| 93 Native Windows build with Microsoft Visual Studio 2005 | |
| 94 ------------------------------------------------------ | |
| 95 | |
| 57 | 96 # cd [...]\OrthancBuild |
| 97 # cmake -G "Visual Studio 8 2005" [...]\Orthanc | |
| 7 | 98 |
| 57 | 99 Then open the "[...]/OrthancBuild/Orthanc.sln" with Visual Studio. |
| 7 | 100 |
| 101 NOTES: | |
| 102 * More recent versions of Visual Studio should also work. | |
| 74 | 103 * You will have to install the Platform SDK (version 6 or above) for |
| 104 Visual Studio 2005: | |
| 7 | 105 http://en.wikipedia.org/wiki/Microsoft_Windows_SDK. |
|
13
7908a4c25a18
preparation for release
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
7
diff
changeset
|
106 Read the CMake FAQ: http://goo.gl/By90B |