# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# filename: README                                                        #
#                                                                         #
# UTILITY text: Medical Image Conversion Utility                          #
#                                                                         #
# purpose     : the (X)MedCon `you-should-read' file                      #
#                                                                         #
# project     : (X)MedCon by Erik Nolf                                    #
#                                                                         #
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# $Id: README,v 1.1.1.1 2000/10/28 16:49:53 enlf Exp $

Directory Structure:
-------------------
./README       : The file you are reading right now
./REMARKS      : Remarks on the code
./CHANGELOG    : CVS revision notes
./COPYING      : GNU General Public License
./COPYING.LIB  : GNU Library General Public License
./Makefile.am  : Makefile.in template for the project
./Makefile.in  : Makefile    template for the project
./acinclude.m4 : personal m4 file for configuration
./aclocal.m4   : aclocal  m4 file for configuration
./configure    : Configuration script
./configure.in : Configuration template
./dicom/       : Dir with DICOM library source files
./source/      : Dir with all the source files
./etc/         : Dir with config stuff (Gtk+ rcfiles)
./man/	       : Dir with man-pages
./extra/       : Dir with extra utilities/YourMakefile

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 ;-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."

   Both files were changed for host endian independency!

4. DICOM: the original DICOM library is written by Tony Voet and released
          under the GNU LGPL license. I did make a few changes ...


What do you need:
----------------

machine OS: Unix   (We do the port to Windoze for you)
compiler  : gcc    (GNU C Compiler !!)
utilities : make   (GNU make       !!)


  - Gtk+ v1.2.8      or higher package from <http://www.gtk.org>
  - GdkPixbuf v0.8.0 or higher package from <http://www.gnome.org>

What to do first:
----------------

- When you want X-support:

    *) Gtk+      package  : unpack;untar;configure;make;install 
    *) GdkPixbuf package  : unpack;untar;configure;make;install

         (GdkPixbuf doesn't install easily on every platform!)
         (Perhaps we can help to get it working:  `make -i'  )

Configuring the (X)MedCon project:
---------------------------------

type `./configure` or `sh ./configure`


Makeing the (X)MedCon project:
-----------------------------
type `make`


The relation between it all, is as follows:

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


Install the (X)MedCon project:
-----------------------------
type `make install`

You must install the project because the files in the source-directory are
wrapper scripts to find the non-installed shared libraries.
Try to run the newly installed executables. When they can not find a shared
library you should add a path to it in the "LD_LIBRARY_PATH" environment
variable or something appropriate for your O.S.


Uninstall the (X)MedCon project:
-------------------------------
type `make uninstall`

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

