MS Windows Binaries

If you have a computer running a MS Windows (XP to win 8) OS and just want to find out what the Simple Dicom Reader 2 (Sdr2) can do for you, simply run sdr2.exe in the sdr2_win32_binaries folder.

Operating Systems

Sdr2 has been compiled under openSUSE 12.3 64-bit, Debian 8 ("Jessie") 32 bit, MS Windows XP, Windows 7 32-bit and 64-bit, and Windows 8 32-bit.
Sdr2 has not been compiled under any Mac OS.

Dependency 1: Qt 4.8.x

Sdr2's graphical user interface is Qt (Release 4.8.x). Regardless whether you compile Qt on your system or you download precompiled libraries please make sure that your C++ compiler for Qt matches the version used for Sdr2. Sdr2 has not been compiled with QT5 yet.

Dependency 2: DCMTK

Reading of DICOM files in Sdr2 is done by the DCMTK library as a backend.
DCMTK packages for GNU/Linux Debian and Ubuntu install like a breeze. Compilation of DCMTK under MS Windows can be painful. Precompiled libraries of DCMTK for MinGW32, MSVC 2008 and 2010 Express (32-bit) are provided as zip compressed folders (DcmTkMinGW.zip, DCMTK_MSVC_2008_32.zip and DCMTK_MSVC_2010_32.zip.)

Incorporated Software

Jeroen van der Waal's QT Dicom widgets, NIfTI/niftilib and some classes from Coin3d for basic linear algebra are part of the source code.

For GNU/Linux systems edit /etc/profile as root,
add
'DCMTK_BASEDIR=/usr/include/dcmtk
export DCMTK_BASEDIR'
and make sure that PATH points to folder of DCMTK libs:
PATH="...:/usr/lib:/..."

Environment variables for Windows have to be set correctly.
For Win7: start button->left click->Control Panel->System and Security-> System->Advanced system settings->Environment Variables:

New... Variable named 'DCMTK_BASEDIR' with value 'Path to DCMTK headers' (like C:\MinGW\DcmTkMinGW).
New... Variable named 'QTDIR' with value 'Path to Qt headers' (like C:MinGW\Qt\4.8.6).
And New... Variable named 'QMAKESPEC' with description of your platform so that a suitable makefile can be generated (like win32-msvc2008 or win32-g++).

Add 'Path to Qt and DCMTK libs' to the path variable (like %QTDIR%\lib;%DCMTK_BASEDIR%\lib;).

GNU/Linux and MinGW/MSYS

MinGW and MSYS provide a complete Open Source programming tool set for Microsoft Windows. Sdr2 has been tested under MinGW32 (gcc version 4.4.0).

Recommended: Qt Creator

Qt Creator is the preferred IDE for Sdr2. Make sure that Tools->Options->Build & Run->Qt Versions->Your Qt Version->Qt Version Details has detected correct Qt settings and directories during installation of Qt Creator.

Compilation of Sdr2 in an Open Source environment depends on qmake. Make sure to have Qt 4.8.x and DCMTK installed.
Either launch Qt Creator and open ./sdr2/build/sdr2.pro, or open a terminal, cd to the sdr2\build folder and fire up 'qmake' followed by 'make' or 'mingw32-make' respectively.

Sdr2 has been compiled in MSVC 2008 and 2010 Express only.
Launch msvc and open 'solution' sdr2.sln in the \build\m$vc2008_V9 or m$vc2010_V10 folder.
You might need to copy '.\sdr2\zlib_MSVC_win32\include', \lib, and \bin to 'C:\Program Files\Microsoft SDKs\Windows\v6.0A' (MSVC-2008) or \v7.0A (MSVC-2010).