]> Creatis software - gdcm.git/blob - Doc/Website/Main.html
Add a note about gdcm2
[gdcm.git] / Doc / Website / Main.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <HTML>
3 <HEAD>
4    <META http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
5    <TITLE>Gdcm Home Page</TITLE>
6 </HEAD>
7
8 <BODY>
9
10 <!#######################################################################>
11 <H1>Gdcm Home Page</H1>
12 <HR size="1"><ADDRESS style="align: right;"></ADDRESS>
13 <blink>Note for Google users : </blink><br>
14 If you don't see in the left part of your screen
15  the blue 'side bar', <br>
16  starting with 'News', 'Licence', 'Documentation',
17  'Download', etc better click on : </br>
18  <a
19  href="http://www.creatis.insa-lyon.fr/Public/Gdcm/">
20  http://www.creatis.insa-lyon.fr/Public/Gdcm/ </a> <br>
21  
22 <HR size="1"><ADDRESS style="align: right;"></ADDRESS>
23 <br><br><br>
24
25 <H2>(Important note for ITK users)</H2>
26
27    <UL>
28    <LI> ITK (Insight ToolKit) still uses gdcm 1.2.x
29    <LI> Current gdcm version is 1.3.x
30    </UL>  
31    
32 <H2>(Important note for new DICOM  users)</H2>
33    <UL>
34    <LI> An other version, called gdcm2 exists, an is a complete ground up rewrite of GDCM 1.x. 
35    (have a look at <a href="http://gdcm.sourceforge.net/wiki/index.php/GDCM_Release_2.0">
36                             http://gdcm.sourceforge.net/wiki/index.php/GDCM_Release_2.0
37                    </a>)</br>
38    If you are a new DICOM user, better use gdcm2, because its structure will allow much more features than gdcm1.x does (it's almost exclusively 'image oriented')
39    </UL> 
40
41 <br><br><br>
42
43  
44
45 Gdcm is yet another C++ library dedicated to reading/parsing and writing
46 <A HREF="http://medical.nema.org/">Dicom</A> medical files.
47 <BR>
48 <B>GDCM</B> stands as a short for "<B>G</B>rass roots
49 <B>D</B>i<B>C</B>o<B>M</B>. 
50
51 <!###################################>
52 <H2>What gdcm <font color=#00ff00>IS</font></H2>
53 <UL>
54 <LI>gdcm implements the
55    <A HREF="http://www.dclunie.com/dicom-status/status.html">
56            dicom base standard <B>part 5</B></A>
57    that concentrates on image file format.
58    Hence gdcm supports the following formats:
59    <UL>
60    <LI>ACR-NEMA version 1 and 2
61    </LI>
62    <LI>Dicom version 3.0 (including various encodings of JPEG -lossless and
63        lossy-, RLE).
64        Please refer to
65        <A HREF="ConformanceSummary.html">gdcm conformance summary</A>
66        for more details.
67    <LI>Papyrus V2 and V3 file headers are readable; the user will have to use 
68        low level accessors if he wants to get the image pixels -sorry-.
69    </LI>
70    </UL>
71 <LI> gdcm includes a lot of heuristics that allow reading all the 
72     'exotic' files (headers with oddities) we had to deal with.<BR>
73      Any king of 'exotic' Dicom file is welcome, to help us to improve our
74      library.
75 </LI>
76 </LI>
77 <LI>gdcm is distributed with
78    <A HREF="License.html">Berkeley-like license</A>.
79 </LI>
80 <LI>gdcm is cross platform (it compiles with gcc 2.95, 2.96, 3.0.x, 3.2.x,
81      3.3.x, 3.4.x, 4.0.x, 4.1.x , icc , cc (SunOS), VisualC++, Borland, 
82      nmake... )
83 </LI>
84 <LI> gdcm has a nightly Dashboard (the whole lib is checked every night)
85 </LI>
86 <LI>gdcm targets both GNU/Un*ces and Windows/VC++
87    (refer to
88    <A HREF="Installation.html#gdcmRequirements">requirements</A>
89    for details).
90 </LI>
91 <LI>gdcm comes with a
92    <A HREF="http://public.kitware.com/VTK">VTK</A>
93    shallow wrapper class <TT>vtkGdcmReader</TT> (refer to
94    <A HREF="VtkGdcm.html">VtkGdcm</A>)
95    to ease the burden of VTK users,
96 <LI>gdcm also comes with
97    <A HREF="html.developper/DoxyPythonComplete.html">gdcmPython</A>
98    it's
99    <A HREF="http://www.swig.org">SWIG</A>
100    generated
101   <A HREF="http://www.python.org">Python</A>
102   wrappers.
103 </LI>
104 </UL>
105
106 <!###################################>
107 <H2>What gdcm is <font color=#ff0000>NOT</font></H2>
108
109 Except for
110 <A HREF="http://www.dclunie.com/dicom-status/status.html">
111         dicom base standard <B>part 5</B></A>
112 gdcm does NOT implement any other part of the Dicom base standard
113 (as opposed to other C++ based with open license libraries like
114 <A HREF="http://www.offis.de/projekte/ig/dicom/soft-docs/soft01_d.html">
115         DCMTK</A>&nbsp;
116 or
117 <A HREF="http://www.erl.wustl.edu/DICOM/ctn.html">CTN</A>).
118 <BR>
119 In particular <B>gdcm is not aware</B> of:
120 <UL>
121 <LI>the Dicom network file exchange protocol (Query/Retrieve),
122 </LI>
123 <LI>the Dicom media storage formats (well ... it knows about the
124     <TT>DICOMDIR</TT> -reading and writing- and its parts <TT>PATIENT</TT>,
125     <TT>STUDY</TT>, <TT>SERIES</TT>, <TT>IMAGE</TT>)
126 </LI>
127 <LI>Print, Verification
128 </LI>
129 <LI>ANY OTHER PART of Dicom.
130 </LI>
131 </UL>
132
133 <!###################################>
134 <H2>What gdcm still misses</H2>
135
136 Among all the features of the
137 <A HREF="http://www.dclunie.com/dicom-status/status.html">
138         dicom part 5</A>
139 gdcm doesn't implement (yet?)
140 <UL>
141   <LI>the integration of (optional) overlays on image.
142   </li>
143   <LI> ...
144   </li>  
145 </UL>
146 Gdcm also still needs
147 <UL>
148 <LI> an enhanced and simpler API to access the various forms of pixel data
149      (e.g. RGB, GrayLevel, RawData...),
150 </LI>
151 <LI> a decent user's guide (currently, only a partial doxygenation is
152      available),
153 </LI>
154 <LI> the python wrappers to be fixed,
155 </LI>
156 <LI> a simple
157      <A HREF="http://www.wxwindows.org/">wxWidgets</A>
158      Dicom file editor.
159 </LI>
160 </UL>
161
162 <!###################################>
163 <UL>
164 </UL>
165
166 <HR size="1"><ADDRESS style="align: right;"></ADDRESS>
167
168 </BODY>
169 </HTML>