/ginkgocadx

Advanced DICOM viewer

Primary LanguageC++

Build Status Coverity Status

Ginkgo CADx

Preface

  • The project had been abandoned by the original authors. Since the programs requires an OpenGL compatibility profile porting it to use current VTK versions would require porting it also to wxWindgets >= 3.1, which has not yet a stable API. Since my personal interest in this projecr is now zero, I archive this project.

Introduction

Ginkgo CADx is an advanced DICOM viewer and dicomizer that can also be used to convert png, jpeg, bmp, pdf, tiff to DICOM files.

The version developed here is a continuation of the now abandoned free version developed by MetaEmotion:

http://ginkgo-cadx.com/en/

License

Ginkgo CADx is licensed under the terms of the Lesser GNU Public Licence 3.

Build

To build Ginkgo CADx the following software packages are required:

  • ITK (>= 4.8)
  • VTK (>= 6.2), Please note that the code does currently not compile with the VTK OpenGL2 rendering backend (see #21 and #34). VTK >= 7.0 defaults to this newer backend when configured without parameters, and currently you will have to set VTK_RENDERING_BACKEND=OpenGL when building VTK to sucessfully compile ginkgocadx.
  • wxWidgets (>= 3.0.1)
  • DCMTK (>= 3.6.1-20150924)
  • A C++ compiler that supports the C++11 standard
  • CMake

With these prerequisites available run cmake on the Ginkgo CADx source tree and then use the selected build system to build the software. After the software was sucessfully compiled run the install target:

mkdir build
cd build/
cmake ..
make

The original Ginkgo CADx implementation was done with cross-platform compatibility in mind, i.e. the software should compile on MS Windows, macOS, and flavours of Linux. However, currently the main development platforms are Debian GNU/Linux and Gentoo Linux using the GNU gcc compiler tool chain. Hence incompatibilities may creep in and bug reports with fixes for other platforms are very welcome.

Debian/Ubuntu specific build instructions

The following packages must be installed in order to compile it:

chrpath
cmake
libcairo2-dev
libcurl4-gnutls-dev
libdcmtk-dev
libfftw3-dev
libfreetype6-dev
libgtk2.0-dev
libinsighttoolkit4-dev
libjsoncpp-dev
libmysqlclient-dev
libsqlite3-dev
libssl-dev
libvtk6-dev
libwrap0-dev
libwxgtk3.0-dev
libxml2-dev
libgdcm-tools

On Debian Stretch and Sid these packages can be installed by simply running:

apt build-dep ginkgocadx

Alternatively, if you don't have the src in your sources.list, the following should enable you to install all the dependencies:

apt install chrpath cmake libcairo2-dev libcurl4-gnutls-dev libdcmtk-dev libfftw3-dev libfreetype6-dev libgtk2.0-dev libinsighttoolkit4-dev libjsoncpp-dev libmysqlclient-dev libsqlite3-dev libssl-dev libvtk6-dev libwrap0-dev libwxgtk3.0-dev libxml2-dev libgdcm-tools

On Ubuntu Xenial (16.04 )the package can be installed from the Xenial ports PPA:

https://launchpad.net/~gert-die/+archive/ubuntu/xenial-mia

For Yantal the package available from the usual Ubuntu repositories.