]> Creatis software - gdcm.git/blobdiff - Doc/Website/News.html
*** empty log message ***
[gdcm.git] / Doc / Website / News.html
index 80a89551c8a57188d9a8349749d2471d19b0d048..8bac7871c7de5c1af3ec38de0e6a409eeb4985f6 100644 (file)
@@ -7,9 +7,48 @@
 
 <BODY>
 
+
 <!#######################################################################>
 <H1>Gdcm News</a></H1>
 
+<!#######################################################################>
+
+<HR size="1"><ADDRESS style="align: right;"></ADDRESS>
+<H2>
+   <A CLASS="anchor" NAME="missing">
+      <B>Missing features</B></A>
+</H2>
+We know the following are missing; don't loose time looking for them ...<br>
+We know they could be helpfull. We shall add them some day.<br>
+Any contribution is welcome.
+
+<UL>
+   <LI> gdcm doesn't read yet JPEG-LS and JPEG2000 encoded files.
+   <LI> Allow user to tell <TT>gdcm::Document</TT> constructor he doesn't 
+           want to deal with <TT>SeqEntry</TT (every time it's possible)
+   <LI> Allow user to tell <TT>gdcm::Document</TT> constructor he doesn't 
+           want to deal with <TT>Shadow groups</TT> 
+   <LI> Allow user to tell <TT>gdcm::Document</TT> constructor he just wants 
+           to load a given list of <TT>DocEntries</TT> (to save CPU time and RAM
+           space)
+   <LI> Allow user to tell the Writer he doesn't want to write down
+           <TT>SeqEntry</TT> (if any) 
+   <LI> Allow user to tell the Writer he doesn't want to write down
+           <TT>Shadow groups</TT> (if any)
+   <LI> <TT>Icon Image</TT> management (Read and Write) 
+   <LI> <TT>DICOMDIR</TT> full management (not limited to
+           <TT> PATIENT</TT>/<TT>STUDY</TT>/<TT>SERIE</TT>/<TT>IMAGE</TT>)
+   <LI> Allow user to add an Entry to the default entry list, before
+           making a <TT>DICOMDIR</TT> from a root directory
+   <LI> <TT>DICOMDIR</TT> anonymiser (<TT>Load</TT> and <TT>Noload</TT> mode)
+   <LI> 16-bits-LUT full Management
+   <LI> User friendly management of <TT>Rescale Slope</TT> and
+           <TT>Rescale Intercept</TT>
+   <LI> Allow parsing the <TT>Shadow groups</TT> against a user supplied 
+           private <TT>Dicom Dictionary</TT> (pfff!...)
+   <LI> An accurate <TT>SerieHelper</TT>
+</UL>
+
 <!#######################################################################>
 <HR size="1"><ADDRESS style="align: right;"></ADDRESS>
 <H2>
    <B>Current Version</B></A>
       <B></B></A>
 </H2>
+
 <UL>
-   <LI> Final check of the jpeg sub-library: all 'classical' jpeg
-        compressed Dicom files can be read<br>
-        All the previously gdcm-breaker images are now readable<br>
-        gdcm doesn't read yet JPEG-LS and JPEG2000 encoded files.
-   <LI> Use of <TT> namespace</TT> : all the methods formerly called
-       <TT>className::gdcmXxx()</TT> are now called <TT>className::Xxx()</TT>
-   <LI> Removal of accessors <TT>GetXxxByname</TT>, <TT>SetXxxByname</TT> 
-        and <TT>GetXxxByNumber</TT>, <TT>SetXxxByNumber</TT> 
-        replaced by <TT>GetXxx</TT>, <TT>SetXxx</TT>
-   <LI> a gdcm::Document is now specialized in gdcm::DicomDir and gdcm::File
-   <LI> A huge number of memory leaks removed
-   <LI> Improvement of write process  
-</UL>
-<br>
-<pre>
-For people who get this new release :
-
-We consider now that :
-- any dicom related file is a gdcm::Document.
-- a gdcm::Document can be :
-      - a gdcm::File,     if it contains pixel data,
-      - a gdcm::DicomDir, if it contains only informations 
-                          on the files in a given directory
-
-- in a gdcm::Document, there are gdcm::DocEntry, that can be :
-     - gdcm::ContentEntry (any entry that has an actual value,
-                           *not* an embedded set of other gdcm::DocEntry)
-                           a gdcm::ContentEntry can be :
-          - gdcm::ValEntry (whose value is std::string representable 
-                            e.g. character values, or integers),
-          - gdcm::BinEntry (whose value is not std::string representable 
-                            e.g. color palettes, overlays, icons , ...)
-     - gdcm::Sequence (no proper 'value', but a set of gdcm::SQItems, 
-                       composed of a set of gdc::DocEntry, recursively)
+   <LI>State of the art
+   <UL>    
+      <LI>
+         <a href="uml-gdcm.pdf">gdcm UML Class Diagram</a> current version.
+      <LI>
+   </UL>
+
+   <LI> New Features
+   <UL>
+      <LI>Both <TT>vtkgdcmViewer</TT> and <TT>vtkgdcmViewer2</TT> 
+          are available to allow easy displaying of single/multiframe 
+          GreyLevel/RGB/PaletteColor images
+   </UL>
+
+   <LI> Bug fixes
+   <UL>
+      <LI> The difference between <TT>MONOCHROME1</TT> (low values = bright,
+            high values = dark) and <TT>MONOCHROME2</TT> (low values = dark,
+            high values = bright) is now taken into account.<br> 
+            It's no longer up to the user to change the pixels value
+      <LI> Writing a 'True Dicom' image after reading an ACR-NEMA image 
+           does not request any longer from the user to build up 
+            'manually' the Meta Elements group (0002)
+      <LI> Old '24 Bits' ACR-NEMA are now correctly re-written in DICOM mode.
  
-- in a gdcm::DicomDir, we only deal, hierarchically, with :
-     - gdcmPatient
-     - gdcmStudy
-     - gdcmSerie
-     - gdcmImage
-</pre>
-You can see <a href="uml-gdcm.pdf">gdcm UML Class Diagram</a>
+   </UL>
 
+   <LI> A.P.I. breaking modifications (since previous version : <TT>1.0</TT>)
+   <UL>    
+      <LI> NEVER more API breaking modifications !!!
+
+   </UL>
+
+   <LI> Known bugs
+   <UL>
+      <LI>
+   </UL>
+
+   <LI> Sample Data
+   <UL>
+      Get a <a href="gdcmData.tar.gz">gzipped tarball</a> of sample data 
+       (warning : 185 Megabytes ...)
+   </UL>
+</UL>
 
 
 
+<!#######################################################################>
+<HR size="1"><ADDRESS style="align: right;"></ADDRESS>
+<H2>
+   <A CLASS="anchor" NAME="NewsVersion1_0">
+      <B>Version 1.0 (Feb 14 2005)</B></A>
+</H2>
+<UL>
+   <LI>State of the art
+   <UL>
+      <LI>
+         <a href="Doc1.0/uml-gdcmV1.0.pdf">gdcm 1.0 UML Class Diagram</a> version.
+      <LI> <a href= "Doc1.0/html.user/index.html">User Documentation"</a>
+      <LI> <a href= "Doc1.0/html.developper/index.html">Developper
+         Documentation"</a>
+      <LI> Final check of the jpeg sub-library: all 'classical' jpeg
+        compressed Dicom files can be read<br>
+      <LI>All the previously gdcm-breaker images are now readable<br>
+      <LI> A huge number of memory leaks removed
+      <LI> Improvement of write process   
+   </UL>
+
+   <LI> A.P.I. breaking modifications (since previous version : <TT>0.6</TT>)
+   <UL>
+      <LI> Use of <TT> namespace</TT> : all the methods formerly named
+          <TT>className::gdcmXxx()</TT> are now named <TT>className::Xxx()</TT>
+          <br> End user will have to call them as <TT>gdcm::className::Xxx() </TT>
+      <LI> a <TT>gdcm::Document</TT> is now specialized in : 
+      <UL>
+         <LI> <TT>gdcm::DicomDir</TT>
+         <LI> <TT>gdcm::File</TT>
+      </UL>
+      <LI> a <TT>gdcm::DicomElementSet</TT> is composed of a set of 
+            <TT>gdcm::DicomDocEntry</TT>
+      <LI> a <TT>gdcm::DicomDocEntry</TT> can be :
+      <UL>
+         <LI> a <TT>gdcm::ContentEntry</TT>, specialized in :
+         <UL>
+            <LI> <TT>gdcm::ValEntry</TT>
+            <LI> <TT>gdcm::BinEntry</TT> (no longer a specialization of
+                 <TT>gdcm::ValEntry</TT>) 
+        </UL>
+      <LI> a <TT>gdcm::SeqEntry</TT> 
+      </UL>
+      <LI> Removal of useless accessors <TT>GetXxxByname</TT>, <TT>SetXxxByname</TT> 
+      <LI> Renaming of accessors <TT>GetXxxByNumber</TT>, <TT>SetXxxByNumber</TT> 
+           as follow :
+      <UL>
+         <LI> <TT>GetEntryByNumber 
+                  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+                                          --> GetEntryValue</TT>
+         <LI> <TT>GetEntryLengthByNumber  --> GetEntryLength</TT>
+         <LI> <TT>GetEntryOffsetByNumber  --> GetEntryOffset</TT>
+         <LI> <TT>GetEntryVRByNumber 
+                  &nbsp;&nbsp;&nbsp;      --> GetEntryVR</TT>
+         <LI>
+         <LI> <TT>GetDocEntryByNumber     
+                  &nbsp;&nbsp;            --> GetDocEntry</TT>
+         <LI> <TT>GetValEntryByNumber     
+                  &nbsp;&nbsp;            --> GetValEntry</TT>
+         <LI> <TT>GetBinEntryByNumber     
+                  &nbsp;&nbsp;            --> GetBinEntry</TT>
+         <LI> <TT>GetSeqEntryByNumber     
+                  &nbsp;&nbsp;            --> GetSeqEntry</TT>
+       </UL>
+   </UL>
+</UL>
+
 <!#######################################################################>
 <HR size="1"><ADDRESS style="align: right;"></ADDRESS>
 <H2>
@@ -72,28 +181,40 @@ You can see <a href="uml-gdcm.pdf">gdcm UML Class Diagram</a>
 </H2>
 <UL>
    This version will be used by Insight Tool Kit 
-   (<a href="http://www.itk.org">ITK</a> 1.10) at the beginning of 2005.<br>
+   (<a href="http://www.itk.org">ITK</a> 2.0) at the beginning of 2005.<br>
     It's not yet packaged ...<br><br>
+   <LI> <a href= "Doc0.6/html.user/index.html">User Documentation"</a>
+   <LI> <a href= "Doc0.6/html.developper/index.html">Developper Documentation"</a>  
    <LI> The new <TT>gdcmDocument</TT> class is a parent class of 
        <TT>gdcmHeader</TT> class and <TT>gdcmDicomDir</TT> class.
    <LI> Massive modifications in the Class Diagram :
    <UL>
-      <LI> Entries (<TT>gdcmEntry</TT>) are now separated into 
-          <TT>ValEntry</TT> and <TT>SeqEntry</TT> (whose VR =
-          <TT>SQ</TT>)
-      <LI> a <TT>gdcmDocument</TT> is_a <TT>gdcmElementSet</TT>,
-         composed of a set of <TT>gdcmValEntry</TT> 
-         and <TT>gdcmSeqEntry</TT>
-      <LI> a <TT>gdcmSeqEntry</TT> is considered as a set 
-          of <TT>gdcmSQItem</TT>
-      <LI> Dicom Sequences (VR = <TT>SQ</TT>) are now dealt as tree-like 
-          structures within <TT>gdcmSQItem</TT> class.<br>
-          they are considered as a set of <TT>gdcmSQItem</TT>s
-      <LI> a <TT>gdcmSQItem</TT> is_a <TT>gdcmElementSet</TT> 
-  </UL>
-  <LI> Improvement of the jpeg sub-library: jpeg
-        compressed Dicom files (lossless and lossy) 
-  might be read (check-it out)
+      <LI> any dicom related file is a <TT>gdcmDocument</TT>
+      <LI> a <TT>gdcmDocument</TT> can be :
+      <UL>
+         <LI> a <TT>gdcmHeader</TT>, if it contains pixel data
+         <LI> a <TT>gdcmDicomDir</TT>, if it contains only informations 
+              on the files in a given directory  
+      </UL>
+
+   <LI> a <TT>gdcmDocument</TT> is_a <TT>gdcmElementSet</TT>,
+        composed of a set of <TT>gdcmEntry</TT> separated into :
+      <UL>
+      <LI> <TT>gdcmValEntry</TT><br>
+           a specialization of <TT>gdcmValEntry</TT>, for 'non
+           <TT>std::string</TT> representable' values is 
+           <TT>gdcmBinEntry</TT> 
+       <LI> <TT>gdcmSeqEntry</TT> (VR = <TT>SQ</TT>, i.e Dicom Sequences)<br>
+             they are dealt as tree-like structures :<br>
+             - a <TT>gdcmSeqEntry</TT> is considered as a set 
+             of <TT>gdcmSQItem</TT>,<br>
+             - a <TT>gdcmSQItem</TT> is_a <TT>gdcmElementSet</TT>, composed 
+             of <TT>gdcmDocEntries</TT>, recursively <br>
+      </UL>
+   </UL>
+   <LI> Improvement of the jpeg sub-library: jpeg
+           compressed Dicom files (lossless and lossy) 
+           might be read (check-it out)
 </UL>
 
 <!#######################################################################>
@@ -103,6 +224,11 @@ You can see <a href="uml-gdcm.pdf">gdcm UML Class Diagram</a>
       <B>Version 0.4 (February 6 2004)</B></A>
 </H2>
 <UL>
+
+   <LI> <a href="Doc0.4/uml-gdcmV0.4.pdf">gdcm 0.4 UML Class Diagram</a>.
+   <LI> <a href= "Doc0.4/html.user/index.html">User Documentation"</a>
+   <LI> <a href= "Doc0.4/html.developper/index.html">Developper Documentation </a>
+
    <LI> Introduction of a jpeg sub-library: some very simple jpeg-lossy
         compressed Dicom files might be working (check-it out).
    <LI> And also, fewer memory leaks, cleaned-up stl usage (should work
@@ -110,6 +236,10 @@ You can see <a href="uml-gdcm.pdf">gdcm UML Class Diagram</a>
         supporting both Swig and vtk wrapping.
    <LI> Introduction of a RLE (Run-Time Encoding) library
    <LI> Color images (RGB or Palette Color) are dealt with
+   <LI> Confusing names <TT>gdcmPatient</TT>, <TT>gdcmStudy</TT>,
+        <TT>gdcmSerie</TT>, <TT>gdcmPatient</TT> changed to 
+        <TT>gdcmDicomDirPatient</TT>, <TT>gdcmDicomDirStudy</TT>, 
+        <TT>gdcmDicomDirSerie</TT>, <TT>gdcmDicomDirPatient</TT>
  
 </UL>