X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=Doc%2FWebsite%2FNews.html;h=db5827e6997b71214ec03f152e6fd37999b8de08;hb=c68e4cf4e6ffeff9ce40adf544c237aa3a612f1e;hp=f819d889107dee590bd34f471d876c0152026c4c;hpb=b330c6f291515e40582b3aa1258d1a27b628aac3;p=gdcm.git

diff --git a/Doc/Website/News.html b/Doc/Website/News.html
index f819d889..db5827e6 100644
--- a/Doc/Website/News.html
+++ b/Doc/Website/News.html
@@ -24,35 +24,29 @@ 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 Shadow groups 
    <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
-           Shadow groups (if any)
+           <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, for
+   <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 Shadow groups against a user supplied 
-           Private Dicom Dictionary (pfff!...)
+   <LI> Allow parsing the <TT>Shadow groups</TT> against a user supplied 
+           private <TT>Dicom Dictionary</TT> (pfff!...)
    <LI> An accurate <TT>SerieHelper</TT>
+   <LI> A <TT>SerieHelper</TT> that would use the <TT>DICOMDIR</TT> (if any)
+        instead of parsing all the files within the Root Directory
 </UL>
 
 <!#######################################################################>
-
-
-
 <HR size="1"><ADDRESS style="align: right;"></ADDRESS>
 <H2>
    <A CLASS="anchor" NAME="NewsCurrentVersion">
@@ -64,58 +58,82 @@ Any contribution is welcome.
    <LI>State of the art
    <UL>    
       <LI>
-         <a href="uml-gdcmV1.0.pdf">gdcm UML Class Diagram</a> current version.
-
+         <a href="uml-gdcm.pdf">gdcm UML Class Diagram</a> current version.
       <LI>
    </UL>
 
-   <LI> New Features / Bug fixes
+   <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
+      <LI> <TT>DICOMDIR</TT> anonymiser (<TT>Load</TT> and <TT>Noload</TT> mode)       <LI> User is now allowed to tell <TT>gdcm::Document</TT> constructor 
+            he doesn't want to deal with <TT>SeqEntry</TT> 
+            (every time it's possible) <br> and/or he doesn't 
+            want to deal with <TT>Shadow groups</TT> (every time it's
+            possible)<br>
+            use : <br><TT>
+            gdcm::File *f = new gdcm::File();<br>
+            f->SetLoadMode(NO_SEQ | NO_SHADOW);<br>
+            f->Load(fileName);<br>
+            </TT>
+            instead of : <br>
+            <TT>
+            gdcm::File *f = new gdcm::File(fileName);</TT>
+           <br>
+  
+       <LI>
+   </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.
+      <LI> Element 0x0000 of <TT>Shadow groups</TT> is always forced to be a
+           <TT>ValEntry</TT> and its VR is forced to <TT>UL</TT> 
       <LI>
    </UL>
 
    <LI> A.P.I. breaking modifications (since previous version : <TT>1.0</TT>)
    <UL>    
-      <LI>
-      <LI>
-   </UL>
+      <LI> NEVER more API breaking modifications !!!
 
+   </UL>
 
    <LI> Known bugs
    <UL>
-      <LI> The difference between <TT>MONOCHROME1</TT> and <TT>MONOCHROME2</TT>
-           is not taken into account. It's up to the user to change the pixels
-           value
-      <LI> Writing a 'True Dicom' image after reading an ACR-NEMA image requests
-           from the user to build up 'manually' the Meta Elements group (0002) 
-      <LI> Management, on Big Endian Processors, of unloaded BinEntries
-      <LI> Old '24 Bits' ACR-NEMA are not correctly re-written in DICOM mode.
+      <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>
+         <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>
@@ -126,18 +144,50 @@ Documentation"</a>
  
    <LI> A.P.I. breaking modifications (since previous version : <TT>0.6</TT>)
    <UL>
-      <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 <TT>gdcm::Document</TT> is now specialized 
-           in <TT>gdcm::DicomDir</TT> and <TT>gdcm::File</TT>
+      <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>
@@ -154,20 +204,30 @@ Documentation"</a>
        <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
+      <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>
@@ -192,7 +252,7 @@ Documentation"</a>
    <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>gdcmDicomDirSerie</TT>, <TT>gdcmDicomDirPatient</TT> changed to 
+        <TT>gdcmSerie</TT>, <TT>gdcmPatient</TT> changed to 
         <TT>gdcmDicomDirPatient</TT>, <TT>gdcmDicomDirStudy</TT>, 
         <TT>gdcmDicomDirSerie</TT>, <TT>gdcmDicomDirPatient</TT>