]> Creatis software - gdcm.git/blobdiff - Doc/Website/News.html
ENH: Update dict to make Peter's image more readable
[gdcm.git] / Doc / Website / News.html
index f44d24354fc321cf7afd33cdf6d237fa41c06973..461c05d8356e005230e17dd1cdcdbb2f528d46bb 100644 (file)
@@ -33,9 +33,9 @@ Any contribution is welcome.
           (LOw COmplexity LOssless COmpression for Images) 
           developed at Hewlett-Packard Laboratories] 
      </UL>
-     <LI> gdcm doesn't read yet JPEG2000 encoded files.
+     <LI> gdcm doesn't read yet all JPEG2000 encoded files.
      <UL>
-         But we are working on it.
+         But we are working on it (a lot of troubles with Jasper).
       </UL>
       <LI> gdcm doesn't read yet MPEG2 encoded files.
       <UL>
@@ -119,46 +119,127 @@ Any contribution is welcome.
    <UL>    
       <LI>
          <a href="uml-gdcm.pdf">gdcm UML Class Diagram</a> current version.
-      <LI>
+      <br><br>
    </UL>
 
    <LI> New Features
    <UL>
+      <LI> <TT>AnonymizeNoLoad</TT> used with <TT>dirin=inputDirectoryName</TT>
+           anonymizes all the files within the given Directory.
+           <br>
+           User may also choose extra elements he wants to rub out: <br>
+           <TT>rubout=listOfElementsToRubOut</TT><br>
+           with <tt>listOfElementsToRubOut : group1-elem1,group2-elem2,
+           ...</TT> (in hexa, no space within the list )
+           <br><br>
+      <LI> <TT>gdcm::SerieHelper()</TT> has a new method 
+           <TT>void AddGdcmFile(File *header)</TT>, that allows aware user to 
+           create a '<TT>FileList</TT>' (actually a 
+           <TT>std::vector< File* > </TT>).<br>
+           The <TT>FileList</TT> created this way will be the 
+           'first one' in the <TT>gdcm::FileHelper()</TT> (retrieve it with 
+           <TT>FileList *GetFirstCoherentFileList()</TT> ).<br>
+           It may be sorted using <TT>OrderFileList</TT>.<br>
+           No 'coherence check' will be performed on this <TT>FileList</TT>
+           before sorting.<br>
+           It may be passed to a <TT>vtkGdcmReader</TT> 
+           (to avoid parsing twice the files)
+           <br><br>
+      <LI> <TT>vtkGdcmReader</TT> can now get the result of
+           <TT>gdcm::SerieHelper</TT> (to avoid parsing twice the files)<br>
+            Proceed as follow :<br>
+           <pre>
+           gdcmSerieHelper *sh = new gdcmSerieHelper();
+           sh->SetDirectory(myImageDirectory, true);
+           gdcmFileList *l = s->GetFirstCoherentFileList();
+           s->OrderFileList(l);
+
+           vtkGdcmReader *gr = new vtkGdcmReader();
+           gr->SetCoherentFileList(l);
+           gr->Update();  
+           </pre>
+           This works with a directory that contains only one '<TT>Serie</TT>'
+           (same <TT>Serie UID</TT> for all the images).<br>
+           If it contains more than one <TT>Serie</TT>, you'll have to loop 
+           on the Series, using <TT>GetNextCoherentFileList()</TT>;<br>
+           It will be up to the user to delete the <TT>gdcm::File</TT>.
+           <br><br>
+           See <TT>vtkgdcmSerieViewer</TT> for an example.
+           <br><br>
       <LI>Both <TT>vtkgdcmViewer</TT> and <TT>vtkgdcmViewer2</TT> 
           are available to allow easy displaying of single/multiframe 
-          GreyLevel/RGB/PaletteColor images
+          GreyLevel/RGB/PaletteColor images<br><br>
       <LI> <TT>DICOMDIR</TT> anonymiser (<TT>Load</TT> and <TT>Noload</TT> mode)
+           <br><br>
+      <LI> Because the <TT>gdcm::DicomDir::Load()</TT> method may be used
+           either for loading an already made <TT>DICOMDIR</TT> file or for
+           parsing all the dicom files with a given root directory we
+           syntaxically separated the operations: <br>
+           For loading an already made <TT>DICOMDIR</TT> file, use : <br>
+           <pre>
+           gdcm::DicomDir *d = new gdcm::DicomDir();
+           d->SetFileName(fileName);
+           d->Load( );  
+           </pre>
+           For parsing all the dicom files within a given root directory, use :<br>
+           <pre>
+           gdcm::DicomDir *d = new gdcm::DicomDir();
+           d->SetDirectoryName(dirName);
+           d->Load( )  
+           </pre>
+
+           <b>Don't</b> use any longer old deprecated style: <br>
+           <TT>
+           gdcm::DicomDir *d = new gdcm::DicomDir();<br>
+           d->SetParseDir(true);   // </TT>or <TT>d->SetParseDir(false);<br>
+           d->Load( fileName );<br>  
+           </TT>
+           <br> 
       <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> or he doesn't 
+            want to deal with <TT>SeqEntry</TT> that belong to a <TT>Shadow group</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>
+            use : <br>
+            <pre>
+            gdcm::File *f = new gdcm::File();
+                  f->SetLoadMode(NO_SEQ);            | depending on what
+                  f->SetLoadMode(NO_SHADOW);         | you want *not* 
+                  f->SetLoadMode(NO_SEQ | NO_SHADOW);| to load from the
+                  f->SetLoadMode(NO_SHADOWSEQ);      | target file
+            f->SetFileName(fileName);
+            f->Load( );
+            </pre>
+            <b>Don't</b> use any longer old deprecated style: <br>
             <TT>
             gdcm::File *f = new gdcm::File(fileName);</TT> <br>
-            (old style still available)    
-
+            <br>
         <LI> User is now allowed to tell <TT>gdcm::DicomDir</TT> constructor 
+            he doesn't want to deal with <TT>SeqEntry</TT> 
             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::DicomDir *dcmdir = new gdcm::DicomDir( );<br>
-            dcmdir->SetParseDir(true);<br>
-            dcmdir->SetLoadMode(NO_SEQ | NO_SHADOW);<br>
-            dcmdir->Load(dirName);<br>
-            </TT>
-            instead of : <br>
+            possible) <br> or he doesn't 
+            want to deal with <TT>SeqEntry</TT> that belong to a <TT>Shadow group</TT>  (every time it's
+            possible)<br> when he parses all the Dicom files within a given
+            directory
+            use : <br>
+            <pre>
+            gdcm::DicomDir *f = new gdcm::DicomDir();
+                  f->SetLoadMode(NO_SEQ);            | depending on what
+                  f->SetLoadMode(NO_SHADOW);         | you want *not* 
+                  f->SetLoadMode(NO_SEQ | NO_SHADOW);| to load from the files
+                  f->SetLoadMode(NO_SHADOWSEQ);      | within the root directory 
+            f->SetDirectoryName(rootDirectoryName);
+            f->Load( );
+            </pre>
+            <b>Don't</b> use any longer old deprecated style: <br>
             <TT>
             gdcm::DicomDir *dcmdir = new gdcm::DicomDir(dirName, true);</TT><br>
-            (old style still available)    
-       <LI>
+            <br>         
    </UL>
 
    <LI> Bug fixes
@@ -169,12 +250,12 @@ Any contribution is welcome.
             It's no longer up to the user to change the pixels value
       <LI> Writing a 'True Dicom' image after reading an <TT>ACR-NEMA</TT> image 
            does not request any longer from the user to build up 
-            'manually' the Meta Elements group (<TT>Ox0002</TT>)
+           'manually' the Meta Elements group (<TT>Ox0002</TT>)
       <LI> Old '24 Bits' <TT>ACR-NEMA</TT> are now correctly re-written
            in <TT>DICOM V3</TT> mode.
       <LI> Element <TT>0x0000</TT> of <TT>Shadow groups</TT> is always forced to be a
            <TT>ValEntry</TT> and its <TT>VR</TT> is forced to <TT>UL</TT> 
-      <LI>
+      <br><br>
    </UL>
 
    <LI> A.P.I. breaking modifications (since previous version : <TT>1.0</TT>)