# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# filename: README                                                        #
#                                                                         #
# UTILITY text: Medical Image Conversion Utility                          #
#                                                                         #
# purpose     : the (X)MedCon 'you-should-read' file                      #
#                                                                         #
# project     : (X)MedCon by Erik Nolf                                    #
#                                                                         #
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
#

Introduction:
------------
Here you can read first line information about the configuration, installation
and other issues related to (X)MedCon, a medical image conversion utility.

License & Copyright notices:
---------------------------
1. Read the files 'COPYING' & 'COPYING.LIB'

2. m-gif.c:  a)  changed original code GIF reader/writer copyright (c) 1991
                 Alchemy Mindworks, Inc.

             b)  Unisys Patent License (expired) ;-P

"No license or license fees are required for non-commercial, not-for-profit
 GIF-based applications or for non-commercial, not-for-profit GIF-freeware,
 so long as the LZW capability provided is only for GIF. However, a license
 is required if freeware is incorporated into, or sold or distributed with a
 commercial or for-profit product, introduced in 1995 [or later], or
 enhancements of products that were introduced prior to 1995."

3. m-matrix.h: changed original code 'matrix.h'

       "2.6 10/19/93  Copyright 1989-1993 CTI PET Systems, Inc."

   m-matrix.c: changed original code 'matrix.c'

       "2.2 10/19/93  Copyright 1989-1993 CTI PET Systems, Inc."

   Most changes applied for host endian independence.

4. m-qmedian.c: code adapted from 'tiffmedian.c' (see http://www.libtiff.org)

   Copyright (c) 1988-1997 Sam Leffler
   Copyright (c) 1991-1997 Silicon Graphics, Inc.

  "Permission to use, copy, modify, distribute, and sell this software and
   its documentation for any purpose is hereby granted without fee,
   provided that (i) the above copyright notices and this permission notice
   appear in all copies of the software and related documentation, and
   (ii) the names of Sam Leffler and Silicon Graphics may not be used in
   any advertising or publicity relating to the software without the
   specific, prior written permission of Sam Leffler and Silicon Graphics."

5. DICOM 3.0

 a) original library (libdicom 0.31 - 1998)
    ----------------

    Contributed by Tony Voet, released under the GNU (L)GPL license.
    Quite some changes have been made since.

 b) dictionary (dict-dicom.dic)
    ----------

    Dictionary borrowed from the superb OFFIS DCMTK Toolkit

    "Copyright (C) 1994-2001, OFFIS" (see http://www.offis.uni-oldenburg.de)

    For the full copyright & license notices see the "libs/dicom/README" file.

 c) encapsulated pixeldata (rle, lossless jpeg)
    ----------------------

    Contributed by Jaslet Bertrand, released under the GNU (L)GPL license.

    However, the lossless jpeg library (LJPG) is based in part on the work of:

    a) Cornell University LossLess JPEG lib   (see ftp://ftp.cs.cornell.edu)

        Copyright (c) 1993 Cornell University, Kongji Huang
        All rights reserved.

        Copyright (c) 1993 The Regents of the University of California,
        Brian C. Smith. All rights reserved.

    b) Independent JPEG Group's JPEG software (see http://www.ijg.org)

        This software is copyright (C) 1991, 1992, Thomas G. Lane.
        All Rights Reserved.

    For the full copyright & license notices see the "libs/ljpg/README" file.

6. NIfTI

  For more information on the code borrowed:

  See the niftilib webpage at http://niftilib.sourceforge.net/
  See the NIfTI webpage at http://nifti.nimh.nih.gov/

  "The niftilib code is released into the public domain"

7. Turku PET Centre libraries
   http://www.turkupetcentre.net/

/**
  Copyright (c) 2004-2010 by Turku PET Centre

  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Lesser General Public
  License as published by the Free Software Foundation; either
  version 2.1 of the License, or (at your option) any later version.

  This library is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  See the GNU Lesser General Public License for more details:
  http://www.gnu.org/copyleft/lesser.html

  You should have received a copy of the GNU Lesser General Public License
  along with this library/program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

  Turku PET Centre, Turku, Finland, http://www.turkupetcentre.fi/
**/



What do you need:
----------------
machine OS: Unix/Linux  (MingW/Cygwin on MS Windows)
compiler  : gcc         (GNU C Compiler !!)
utilities : make        (GNU make       !!)
packages  : just for the graphical front-end : Glib/Gdk-Pixbuf/Gtk

What to do first:
----------------
When you need GUI support:

  - Check Glib/Gdk-Pixbuf/Gtk packages are installed and shared libs can be found

    type: 'pkg-config gtk+-3.0 --modversion'
    type: 'pkg-config glib-2.0 --modversion'
    type: 'pkg-config gdk-pixbuf-2.0 --modversion'

Configure (X)MedCon project:
---------------------------
type: './configure' or 'sh ./configure'

The default installation directory is "/usr/local/xmedcon". You can use
the option "--prefix" to override this default location.

All supported formats are enabled. If you need to, you can disable it by
adding an option like "--disable-format". For more information about the
autoconf configure script, just type 'configure --help'.

Make (X)MedCon project:
----------------------
type: 'make'

Install (X)MedCon project:
-------------------------
type: 'make install'

You must install the project, since the files in the source directory are
merely wrapper scripts. If you use the default prefix dir, make sure to
become "root" before doing the actual install. For the programs to be found
you could make links to them from a bin-directory included in your "PATH" or
add the install bin-directory to this environment variable instead.

Try to run the newly installed executables. If they can not find a library,
make links or add the install lib-directory to your "LD_LIBRARY_PATH"
environment variable or something appropriate for your O.S.

Uninstall (X)MedCon project:
---------------------------
type: 'make uninstall'

Libraries & package structure:
-----------------------------
The relation between it all, is as follows:

 Extra             (X)MedCon              (X)MedCon
Packages            library               programs
--------            -------               --------
 DICOM   - - +         + - - - - - - - -> medcon     (command-line)
(static)     |         |
  |          |         |
 LJPG        |         |
(static)     + - ->  libmdc
             |   (static/shared)
 NIFTI   - - +         |
(static)               |
                       |
Gtk+   - - - - - - - - + - - - - - - - -> xmedcon     (graphical)
GdkPixbuf
(shared)


Contacts:
--------
Any problems? 	e-mail: enlf-at-users.sourceforge.net
Where to get?   URL   : http://xmedcon.sourceforge.net

