Update Doc

[gdcm.git] / Doc / Website / News.html

diff --git a/Doc/Website/News.html b/Doc/Website/News.html
index 084ba4c6f062c8d3eb8781647556cf8f8f3b847d..01f4c67dbc3502a7cc374d4f365558722b0390ac 100644 (file)
--- a/Doc/Website/News.html
+++ b/Doc/Website/News.html
@@ -18,21 +18,99 @@
       <B></B></A>
 </H2>
 <UL>
-   <LI> Final check of the jpeg sub-library: all 'classical' jpeg
+   <LI>State of the art
+   <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  
+      <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> New Features
+<UL>
+   <LI>
+   <LI>
+</UL>
+ 
+   <LI> A.P.I. breaking modifications (since previous version)
+   <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>
+   </UL>
+
+   <LI> Missing features
+   <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 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)
+      <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
+           making a <TT>DICOMDIR</TT> from a root directory
+      <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> An accurate <TT>SerieHelper</TT>
+   </UL>
+
+   <LI> Known bugs
+   <UL>
+      <LI> <TT>DocEntrySet::InsertSeqEntry</TT> never used, never checked ...
+      <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 resquest
+           from the user to build up 'manually' the Meta Elements group (0002) 
+   </UL> 
 </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)
+ 
+- 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>
+
+
+
 
 <!#######################################################################>
 <HR size="1"><ADDRESS style="align: right;"></ADDRESS>