~ubuntu-branches/ubuntu/natty/xmedcon/natty

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
# 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.24 2007/11/14 23:08:37 enlf Exp $

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

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

a) Glib/Gtk+2 (default)

  - Check out http://www.gtk.org/download/

b) Glib/Gtk+1 (requires ./configure --enable-gtk1)

  - Glib v1.2.x from <ftp://ftp.gnome.org/pub/gnome/sources/glib/1.2/>
          Available? Type this to find out: "glib-config --version"
  - Gtk+ v1.2.x from <ftp://ftp.gnome.org/pub/gnome/sources/gtk+/1.2/>
          Available? Type this to find out: 'gtk-config --version'
  - GdkPixbuf v0.x <ftp://ftp.gnome.org/pub/gnome/sources/gdk-pixbuf/>
          Available? Type this to find out: 'gdk-pixbuf-config --version'

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

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

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