]> Creatis software - gdcm.git/blobdiff - vtk/vtkGdcmReader.cxx
Replace
[gdcm.git] / vtk / vtkGdcmReader.cxx
index 539d5fc8643b21c118d61a8183a5655fe64952a3..e46553e72108d440bd70a930a17dff63cb9f93ce 100644 (file)
@@ -1,20 +1,78 @@
-// vtkGdcmReader.cxx
+/*=========================================================================
+                                                                                
+  Program:   gdcm
+  Module:    $RCSfile: vtkGdcmReader.cxx,v $
+  Language:  C++
+  Date:      $Date: 2005/08/22 12:30:36 $
+  Version:   $Revision: 1.76 $
+                                                                                
+  Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
+  l'Image). All rights reserved. See Doc/License.txt or
+  http://www.creatis.insa-lyon.fr/Public/Gdcm/License.html for details.
+                                                                                
+     This software is distributed WITHOUT ANY WARRANTY; without even
+     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+     PURPOSE.  See the above copyright notices for more information.
+                                                                                
+=========================================================================*/
+                                                                                
 //-----------------------------------------------------------------------------
 // //////////////////////////////////////////////////////////////
+//
+//===>  Many users expect from vtkGdcmReader it 'orders' the images
+//     (that's the job of gdcm::SerieHelper ...)
+//     When user *knows* the files with same Serie UID 
+//        have same sizes, same 'pixel' type, same color convention, ...
+//     the right way to proceed is as follow :
+//
+//      gdcm::SerieHelper *sh= new gdcm::SerieHelper();
+//      // if user wants *not* to load some parts of the file headers
+//      sh->SetLoadMode(loadMode);
+//      // if user wants *not* to load some files 
+//      sh->AddRestriction(group, element, value, operator);
+//      sh->AddRestriction( ...
+//      sh->SetDirectory(directoryWithImages);
+//
+//      // if user wants to sort reverse order
+//      sh->SetSortOrderToReverse(); 
+//      // here, we suppose only the first Coherent File List is of interest
+//      gdcm::FileList *l = sh->GetFirstCoherentFileList();
+//      // if user is doesn't trust too much the files with same Serie UID 
+//      if ( !sh->IsCoherent(l) )
+//         return; // not same sizes, same 'pixel' type -> stop
+//      sh->OrderFileList(l);        // sort the list
+//
+//      vtkGdcmReader *reader = vtkGdcmReader::New();
+//      // if user wants to modify pixel order (Mirror, TopDown, 90°Rotate, ...)
+//      // he has to supply the function that does the job 
+//      // (a *very* simple example is given in vtkgdcmSerieViewer.cxx)
+//      reader->SetUserFunction (userSuppliedFunction);
+//      // to pass a 'Coherent File List' as produced by gdcm::SerieHelper
+//      reader->SetCoherentFileList(l); 
+//      reader->Update();
 // WARNING TODO CLEANME 
-// Actual limitations of this code:
+// Actual limitations of this code 
+//  when a Coherent File List from SerieHelper is not used (bad idea :-(
 //
 // /////// Redundant and unnecessary header parsing
 // In it's current state this code actually parses three times the Dicom
 // header of a file before the corresponding image gets loaded in the
 // ad-hoc vtkData !
 // Here is the process:
-//  1/ First loading happens in ExecuteInformation which in order to
-//     positionate the vtk extents calls CheckFileCoherence. The purpose
+//  1/ First loading happens in ExecuteInformation which, in order to
+//     positionate the vtk extents, calls CheckFileCoherence. The purpose
 //     of CheckFileCoherence is to make sure all the images in the future
-//     stack are "homogenous" (same size, same representation...). This
-//     can only be achieved by parsing all the Dicom headers...
-//  2/ ExecuteData is then responsible for the next two loadings:
+//     stack are "homogenous" (same size, same representation...).
+//     This can only be achieved by parsing all the Dicom headers...
+//     --> to avoid loosing too much time :
+//     If user is 150% sure *all* the files are coherent, that is to say :
+//     they may be open, they are gdcm-readable, they have the same sizes,
+//     they have the same 'pixel' type, they are single frame, 
+//     they have the same color convention ...
+//     he may use SetCheckFileCoherenceLight() to request a 'light' coherence
+//     checking
+//  2/ ExecuteData is then responsible for the next two loadings - 2 ?!?-:
 //  2a/ ExecuteData calls AllocateOutputData that in turn seems to 
 //      (indirectely call) ExecuteInformation which ends up in a second
 //      header parsing
 //      made (method Modified() ), the MTime value is increased. The fileTime
 //      is compared to this new value to find a modification in the class
 //      parameters
-//  2b/ the core of ExecuteData then needs gdcmFile (which in turns
-//      initialises gdcmHeader in the constructor) in order to access
+//  2b/ the core of ExecuteData then needs gdcm::File (which in turns
+//      initializes gdcm::File in the constructor) in order to access
 //      the data-image.
 //
 // Possible solution:
-// maintain a list of gdcmFiles (created by say ExecuteInformation) created
-// once and for all accross the life of vtkGdcmHeader (it would only load
-// new gdcmFile if the user changes the list). ExecuteData would then use 
-// those gdcmFile and hence avoid calling the construtor:
-//  - advantage: the header of the files would only be parser once.
+// maintain a list of gdcm::Files (created by say ExecuteInformation) created
+// once and for all accross the life of vtkGdcmFile (it would only load
+// new gdcm::File if the user changes the list). ExecuteData would then use 
+// those gdcm::File and hence avoid calling the constructor:
+//  - advantage: the header of the files would only be parsed once.
 //  - drawback: once execute information is called (i.e. on creation of
-//              a vtkGdcmHeader) the gdcmFile structure is loaded in memory.
-//              The average size of a gdcmHeader being of 100Ko, is one
-//              loads 10 stacks of images with say 200 images each, you
-//              end-up with a loss of 200Mo...
+//              a vtkGdcmFile) the gdcm::File structure is loaded in memory.
+//              The average size of a gdcm::File being of 100Ko, 
+//              if oneloads 10 stacks of images with say 200 images each,
+//              you end-up with a loss of 200Mo...
 //
 // /////// Never unallocated memory:
 // ExecuteData allocates space for the pixel data [which will get pointed
 // This data is never "freed" neither in the destructor nor when the
 // filename list is extended, ExecuteData is called a second (or third)
 // time...
+//
+//
+
 // //////////////////////////////////////////////////////////////
 
+#include "gdcmFileHelper.h"
 #include "gdcmFile.h"
-#include "gdcmHeader.h"
+#include "gdcmDocument.h"  // for NO_SEQ
+
 #include "vtkGdcmReader.h"
+#include "gdcmDebug.h"
 
 //#include <stdio.h>
 #include <vtkObjectFactory.h>
 #include <vtkPointData.h>
 #include <vtkLookupTable.h>
 
-vtkCxxRevisionMacro(vtkGdcmReader, "$Revision: 1.62 $");
-vtkStandardNewMacro(vtkGdcmReader);
+vtkCxxRevisionMacro(vtkGdcmReader, "$Revision: 1.76 $")
+vtkStandardNewMacro(vtkGdcmReader)
 
 //-----------------------------------------------------------------------------
 // Constructor / Destructor
@@ -67,6 +131,11 @@ vtkGdcmReader::vtkGdcmReader()
 {
    this->LookupTable = NULL;
    this->AllowLookupTable = 0;
+   this->AllowLightChecking = 0;
+   this->LoadMode = 0; // Load everything (possible values : NO_SEQ, NO_SHADOW,
+                       //                                    NO_SHADOWSEQ)
+   this->CoherentFileList = 0;
+   this->UserFunction     = 0;
 }
 
 vtkGdcmReader::~vtkGdcmReader()
@@ -79,7 +148,7 @@ vtkGdcmReader::~vtkGdcmReader()
 
 //-----------------------------------------------------------------------------
 // Print
-void vtkGdcmReader::PrintSelf(ostreamos, vtkIndent indent)
+void vtkGdcmReader::PrintSelf(ostream &os, vtkIndent indent)
 {
    this->Superclass::PrintSelf(os,indent);
    os << indent << "Filenames  : " << endl;
@@ -110,7 +179,7 @@ void vtkGdcmReader::AddFileName(const char* name)
 {
    // We need to bypass the const pointer [since list<>.push_bash() only
    // takes a char* (but not a const char*)] by making a local copy:
-   char * LocalName = new char[strlen(name) + 1];
+   char *LocalName = new char[strlen(name) + 1];
    strcpy(LocalName, name);
    this->FileNameList.push_back(LocalName);
    delete[] LocalName;
@@ -131,6 +200,15 @@ void vtkGdcmReader::SetFileName(const char *name)
    this->Modified();
 }
 
+/*
+ * Ask for a 'light' checking -actually : just initializing-
+ *if you are 150% sure *all* the files are coherent
+ */
+//void vtkGdcmReader::SetCheckFileCoherenceLight()
+//{
+//   LightChecking = true;
+//}
+
 //-----------------------------------------------------------------------------
 // Protected
 /*
@@ -140,7 +218,13 @@ void vtkGdcmReader::ExecuteInformation()
 {
    if(this->MTime>this->fileTime)
    {
-      this->TotalNumberOfPlanes = this->CheckFileCoherence();
+      if ( this->CoherentFileList != 0 )
+         this->TotalNumberOfPlanes = this->CheckFileCoherenceAlreadyDone();  
+      else if ( this->AllowLightChecking )
+         this->TotalNumberOfPlanes = this->CheckFileCoherenceLight();
+      else
+          this->TotalNumberOfPlanes = this->CheckFileCoherence();
+
       if ( this->TotalNumberOfPlanes == 0)
       {
          vtkErrorMacro(<< "File set is not coherent. Exiting...");
@@ -178,7 +262,7 @@ void vtkGdcmReader::ExecuteInformation()
          }
       }
 
-      // Positionate the Extent.
+      // Set the Extents.
       this->DataExtent[0] = 0;
       this->DataExtent[1] = this->NumColumns - 1;
       this->DataExtent[2] = 0;
@@ -186,7 +270,7 @@ void vtkGdcmReader::ExecuteInformation()
       this->DataExtent[4] = 0;
       this->DataExtent[5] = this->TotalNumberOfPlanes - 1;
   
-      // We don't need to positionate the Endian related stuff (by using
+      // We don't need to set the Endian related stuff (by using
       // this->SetDataByteOrderToBigEndian() or SetDataByteOrderToLittleEndian()
       // since the reading of the file is done by gdcm.
       // But we do need to set up the data type for downstream filters:
@@ -209,7 +293,6 @@ void vtkGdcmReader::ExecuteInformation()
       {
          vtkDebugMacro(<< "16 bits signed image");
          this->SetDataScalarTypeToShort();
-         //vtkErrorMacro(<< "Cannot handle 16 bit signed files");
       }
       else if ( ImageType == "32U" )
       {
@@ -235,23 +318,32 @@ void vtkGdcmReader::ExecuteInformation()
 
    this->Superclass::ExecuteInformation();
 }
-
 /*
  * Update => ouput->Update => UpdateData => Execute => ExecuteData 
  * (see vtkSource.cxx for last step).
  * This function (redefinition of vtkImageReader::ExecuteData, see 
- * VTK/IO/vtkImageReader.cxx) reads a data from a file. The datas
+ * VTK/IO/vtkImageReader.cxx) reads a data from a file. The data
  * extent/axes are assumed to be the same as the file extent/order.
  */
 void vtkGdcmReader::ExecuteData(vtkDataObject *output)
 {
-   if (this->InternalFileNameList.empty())
+   if ( CoherentFileList != 0 )   // When a list of names is passed
+   {
+      if (this->CoherentFileList->empty())
+      {
+         vtkErrorMacro(<< "Coherent File List must have at least a valid File*.");
+         return;
+      }
+   }
+   else if (this->InternalFileNameList.empty())
    {
       vtkErrorMacro(<< "A least a valid FileName must be specified.");
       return;
    }
 
    // FIXME : extraneous parsing of header is made when allocating OuputData
+   //         --> ?!?
    vtkImageData *data = this->AllocateOutputData(output);
    data->SetExtent(this->DataExtent);
    data->GetPointData()->GetScalars()->SetName("DicomImage-Volume");
@@ -277,40 +369,70 @@ void vtkGdcmReader::ExecuteData(vtkDataObject *output)
       // The actual advance measure:
       unsigned long UpdateProgressCount = 0;
 
-      // Feeling the allocated memory space with each image/volume:
+      // Filling the allocated memory space with each image/volume:
+
       unsigned char *Dest = (unsigned char *)data->GetScalarPointer();
-      for (std::list<std::string>::iterator filename  = InternalFileNameList.begin();
-           filename != InternalFileNameList.end();
-           ++filename)
-      { 
-         // Images that were tagged as unreadable in CheckFileCoherence()
-         // are substituted with a black image to let the caller visually
-         // notice something wrong is going on:
-         if (*filename != "GDCM_UNREADABLE")
-         {
-            // Update progress related for good files is made in LoadImageInMemory
-            Dest += this->LoadImageInMemory(*filename, Dest,
-                                            UpdateProgressTarget,
-                                            UpdateProgressCount);
-         } 
-         else 
-         {
-            // We insert a black image in the stack for the user to be aware that
-            // this image/volume couldn't be loaded. We simply skip one image
-            // size:
-            Dest += this->NumColumns * this->NumLines * this->PixelSize;
-
-            // Update progress related for bad files:
-            UpdateProgressCount += this->NumLines;
-            if (UpdateProgressTarget > 0)
+
+      if ( CoherentFileList == 0 )   // When a list of names is passed
+      {         
+         for (std::list<std::string>::iterator filename  = InternalFileNameList.begin();
+              filename != InternalFileNameList.end();
+              ++filename)
+         { 
+            // Images that were tagged as unreadable in CheckFileCoherence()
+            // are substituted with a black image to let the caller visually
+            // notice something wrong is going on:
+            if (*filename != "GDCM_UNREADABLE")
+            {
+               // Update progress related for good files is made in LoadImageInMemory
+               Dest += this->LoadImageInMemory(*filename, Dest,
+                                               UpdateProgressTarget,
+                                               UpdateProgressCount);
+            } 
+            else 
             {
-               if (!(UpdateProgressCount%UpdateProgressTarget))
+               // We insert a black image in the stack for the user to be aware that
+               // this image/volume couldn't be loaded. We simply skip one image
+               // size:
+               Dest += this->NumColumns * this->NumLines * this->PixelSize;
+
+               // Update progress related for bad files:
+               UpdateProgressCount += this->NumLines;
+               if (UpdateProgressTarget > 0)
                {
-                  this->UpdateProgress(UpdateProgressCount/(50.0*UpdateProgressTarget));
+                  if (!(UpdateProgressCount%UpdateProgressTarget))
+                  {
+                     this->UpdateProgress(UpdateProgressCount/(50.0*UpdateProgressTarget));
+                  }
                }
-            }
-         } // Else, file not loadable
-      } // Loop on files
+            } // Else, file not loadable
+         } // Loop on files
+
+      }
+      else  // when a Coherent File List is passed
+      {
+         for (std::vector<gdcm::File* >::iterator it =  CoherentFileList->begin();
+                                                  it != CoherentFileList->end();
+                                                ++it)
+         {
+     
+            //std::cout <<"----------------- " << (*it)->GetFileName() << std::endl;
+
+             Dest += this->LoadImageInMemory(*it, Dest,
+                                             UpdateProgressTarget,
+                                             UpdateProgressCount); 
+             // Update progress related for bad files:
+             UpdateProgressCount += this->NumLines;
+             if (UpdateProgressTarget > 0)
+             {
+                if (!(UpdateProgressCount%UpdateProgressTarget))
+                {
+                   this->UpdateProgress(UpdateProgressCount/(50.0*UpdateProgressTarget));
+                }
+              }
+           } // Loop on files 
+
+      } 
    }
 }
 
@@ -426,6 +548,10 @@ int vtkGdcmReader::CheckFileCoherence()
       ReturnedTotalNumberOfPlanes += 1;
 
       /////// Stage 0: check for file name:
+
+      // fixme : how can the filename be equal to "GDCM_UNREADABLE"
+      //         right now ?!?
+
       if(*filename == std::string("GDCM_UNREADABLE"))
          continue;
 
@@ -436,26 +562,31 @@ int vtkGdcmReader::CheckFileCoherence()
       if (!fp)
       {
          vtkErrorMacro(<< "Unable to open file " << filename->c_str());
-         vtkErrorMacro(<< "Removing this file from readed files "
-                     << filename->c_str());
+         vtkErrorMacro(<< "Removing this file from read files: "
+                       << filename->c_str());
          *filename = "GDCM_UNREADABLE";
          continue;
       }
       fclose(fp);
 
       // Stage 1.2: check for Gdcm parsability
-      gdcm::Header GdcmHeader(filename->c_str() );
-      if (!GdcmHeader.IsReadable())
+
+      // to save some parsing time.
+      gdcm::File GdcmFile;
+      GdcmFile.SetLoadMode( LoadMode );
+      GdcmFile.SetFileName(filename->c_str() );
+      GdcmFile.Load( );
+      if (!GdcmFile.IsReadable())
       {
          vtkErrorMacro(<< "Gdcm cannot parse file " << filename->c_str());
-         vtkErrorMacro(<< "Removing this file from readed files "
+         vtkErrorMacro(<< "Removing this file from read files: "
                         << filename->c_str());
          *filename = "GDCM_UNREADABLE";
          continue;
       }
 
       // Stage 1.3: further gdcm compatibility on PixelType
-      std::string type = GdcmHeader.GetPixelType();
+      std::string type = GdcmFile.GetPixelType();
       if (   (type !=  "8U") && (type !=  "8S")
           && (type != "16U") && (type != "16S")
           && (type != "32U") && (type != "32S") )
@@ -463,15 +594,15 @@ int vtkGdcmReader::CheckFileCoherence()
          vtkErrorMacro(<< "Bad File Type for file " << filename->c_str() << "\n"
                        << "   File type found : " << type.c_str() 
                        << " (might be 8U, 8S, 16U, 16S, 32U, 32S) \n"
-                       << "   Removing this file from readed files");
+                       << "   Removing this file from read files");
          *filename = "GDCM_UNREADABLE";
          continue;
       }
 
       // Stage 2: check coherence of the set of files
-      int NX = GdcmHeader.GetXSize();
-      int NY = GdcmHeader.GetYSize();
-      int NZ = GdcmHeader.GetZSize();
+      int NX = GdcmFile.GetXSize();
+      int NY = GdcmFile.GetYSize();
+      int NZ = GdcmFile.GetZSize();
       if (FoundReferenceFile) 
       {
          // Stage 2.1: mandatory coherence stage:
@@ -479,10 +610,10 @@ int vtkGdcmReader::CheckFileCoherence()
              || ( NY   != this->NumLines )
              || ( type != this->ImageType ) ) 
          {
-            vtkErrorMacro(<< "This file is not coherent with previous ones"
-                           << filename->c_str());
-            vtkErrorMacro(<< "Removing this file from readed files "
-                           << filename->c_str());
+            vtkErrorMacro(<< "This file is not coherent with previous ones"
+                          << filename->c_str());
+            vtkErrorMacro(<< "Removing this file from read files: "
+                          << filename->c_str());
             *filename = "GDCM_UNREADABLE";
             continue;
          }
@@ -490,21 +621,20 @@ int vtkGdcmReader::CheckFileCoherence()
          // Stage 2.2: optional coherence stage
          if ( NZ != ReferenceNZ )
          {
-            vtkErrorMacro(<< "File is not coherent in Z with previous ones"
-                           << filename->c_str());
+            vtkErrorMacro(<< "File is not coherent in Z with previous ones"
+                          << filename->c_str());
          }
          else
          {
-            vtkDebugMacro(<< "File is coherent with previous ones"
-                           << filename->c_str());
+            vtkDebugMacro(<< "File is coherent with previous ones"
+                          << filename->c_str());
          }
 
-         // Stage 2.3: when the file contains a volume (as opposed to an image),
-         // notify the caller.
+         // Stage 2.3: when the file is 'multiframe', notify the caller.
          if (NZ > 1)
          {
-            vtkErrorMacro(<< "This file contains multiple planes (images)"
-                           << filename->c_str());
+            vtkErrorMacro(<< "This file is a 'Multiframe' one: "
+                          << filename->c_str());
          }
 
          // Eventually, this file can be added on the stack. Update the
@@ -516,13 +646,13 @@ int vtkGdcmReader::CheckFileCoherence()
       } 
       else 
       {
-         // We didn't have a workable reference file yet. Set this one
-         // as the reference.
+         // We didn't have a workable reference file yet. 
+         // Set this one as the reference.
          FoundReferenceFile = true;
          vtkDebugMacro(<< "This file taken as coherence reference:"
-                        << filename->c_str());
-         vtkDebugMacro(<< "Image dimension of reference file as read from Gdcm:" 
-                        << NX << " " << NY << " " << NZ);
+                       << filename->c_str());
+         vtkDebugMacro(<< "Image dimensions of reference file as read from Gdcm:" 
+                       << NX << " " << NY << " " << NZ);
          vtkDebugMacro(<< "Number of planes added to the stack: " << NZ);
          // Set aside the size of the image
          this->NumColumns = NX;
@@ -530,28 +660,21 @@ int vtkGdcmReader::CheckFileCoherence()
          ReferenceNZ      = NZ;
          ReturnedTotalNumberOfPlanes += NZ - 1; // First plane already added
          this->ImageType = type;
-         this->PixelSize = GdcmHeader.GetPixelSize();
+         this->PixelSize = GdcmFile.GetPixelSize();
 
-         if( GdcmHeader.HasLUT() && this->AllowLookupTable )
+         if( GdcmFile.HasLUT() && this->AllowLookupTable )
          {
             // I could raise an error is AllowLookupTable is on and HasLUT() off
-            this->NumComponents = GdcmHeader.GetNumberOfScalarComponentsRaw();
+            this->NumComponents = GdcmFile.GetNumberOfScalarComponentsRaw();
          }
          else
          {
-            this->NumComponents = GdcmHeader.GetNumberOfScalarComponents(); //rgb or mono
-         }
-       
+            this->NumComponents = GdcmFile.GetNumberOfScalarComponents(); //rgb or mono
+         }             
          //Set image spacing
-         this->DataSpacing[0] = GdcmHeader.GetXSpacing();
-         this->DataSpacing[1] = GdcmHeader.GetYSpacing();
-         this->DataSpacing[2] = GdcmHeader.GetZSpacing();
-
-         //Set image origin
-         //this->DataOrigin[0] = GdcmHeader.GetXOrigin();
-         //this->DataOrigin[1] = GdcmHeader.GetYOrigin();
-         //this->DataOrigin[2] = GdcmHeader.GetZOrigin();
-
+         this->DataSpacing[0] = GdcmFile.GetXSpacing();
+         this->DataSpacing[1] = GdcmFile.GetYSpacing();
+         this->DataSpacing[2] = GdcmFile.GetZSpacing();
       }
    } // End of loop on filename
 
@@ -593,26 +716,68 @@ void vtkGdcmReader::RemoveAllInternalFileName(void)
 /*
  * Adds a file name to the internal list of images to read.
  */
-void vtkGdcmReader::AddInternalFileName(const charname)
+void vtkGdcmReader::AddInternalFileName(const char *name)
 {
-   char * LocalName = new char[strlen(name) + 1];
+   char *LocalName = new char[strlen(name) + 1];
    strcpy(LocalName, name);
    this->InternalFileNameList.push_back(LocalName);
    delete[] LocalName;
 }
 
 /*
- * Loads the contents of the image/volume contained by Filename at
+ * Loads the contents of the image/volume contained by gdcm::File* f at
  * the Dest memory address. Returns the size of the data loaded.
  */
+size_t vtkGdcmReader::LoadImageInMemory(
+             gdcm::File *f, 
+             unsigned char *dest,
+             const unsigned long updateProgressTarget,
+             unsigned long &updateProgressCount)
+{
+  // vtkDebugMacro(<< "Copying to memory image [" << f->GetFileName() << "]");
+
+   return DoTheLoadingJob (f,
+                           dest,
+                           updateProgressTarget,
+                           updateProgressCount);
+}
+
+/*
+ * Loads the contents of the image/volume contained by char *fileName at
+ * the dest memory address. Returns the size of the data loaded.
+ */
 size_t vtkGdcmReader::LoadImageInMemory(
              std::string fileName, 
-             unsigned char * dest,
+             unsigned char *dest,
              const unsigned long updateProgressTarget,
-             unsigned long & updateProgressCount)
+             unsigned long &updateProgressCount)
 {
    vtkDebugMacro(<< "Copying to memory image [" << fileName.c_str() << "]");
-   gdcm::File file( fileName.c_str() );
+
+   gdcm::File *f;
+   f = new gdcm::File();
+   f->SetLoadMode( LoadMode );
+   f->SetFileName( fileName.c_str() );
+   f->Load( );
+
+   return DoTheLoadingJob (f,
+                           dest,
+                           updateProgressTarget,
+                           updateProgressCount);
+   delete f;
+}
+
+/*
+ *  Service method for LoadImageInMemory
+*/
+size_t vtkGdcmReader::DoTheLoadingJob (gdcm::File *f,
+                                       unsigned char *dest,
+                                       const unsigned long updateProgressTarget,
+                                       unsigned long &updateProgressCount)
+{
+   gdcm::FileHelper *fileH = new gdcm::FileHelper( f );
+   fileH->SetUserFunction( UserFunction );
+
    size_t size;
 
    // If the data structure of vtk for image/volume representation
@@ -622,18 +787,19 @@ size_t vtkGdcmReader::LoadImageInMemory(
    // line comes first (for some axis related reasons?). Hence we need
    // to load the image line by line, starting from the end.
 
-   int numColumns = file.GetHeader()->GetXSize();
-   int numLines   = file.GetHeader()->GetYSize();
-   int numPlanes  = file.GetHeader()->GetZSize();
-   int lineSize   = NumComponents * numColumns * file.GetHeader()->GetPixelSize();
+   int numColumns = fileH->GetFile()->GetXSize();
+   int numLines   = fileH->GetFile()->GetYSize();
+   int numPlanes  = fileH->GetFile()->GetZSize();
+   int lineSize   = NumComponents * numColumns * fileH->GetFile()->GetPixelSize();
+   int planeSize  = lineSize * numLines;
 
-   unsigned char * source;
+   unsigned char *src;
    
-   if( file.GetHeader()->HasLUT() && AllowLookupTable )
+   if( fileH->GetFile()->HasLUT() && AllowLookupTable )
    {
-      size               = file.GetImageDataSize();
-      source             = (unsigned char*) file.GetImageDataRaw();
-      unsigned char *lut = (unsigned char*) file.GetLutRGBA();
+      size               = fileH->GetImageDataSize();
+      src                = (unsigned char*) fileH->GetImageDataRaw();
+      unsigned char *lut = (unsigned char*) fileH->GetLutRGBA();
 
       if(!this->LookupTable)
       {
@@ -656,20 +822,19 @@ size_t vtkGdcmReader::LoadImageInMemory(
    }
    else
    {
-      size        = file.GetImageDataSize();
-      source      = (unsigned char*)file.GetImageData();
+      size = fileH->GetImageDataSize();
+      src  = (unsigned char*)fileH->GetImageData();
    } 
-   
-   unsigned char * destination = dest + size - lineSize;
 
+   unsigned char *dst = dest + planeSize - lineSize;
    for (int plane = 0; plane < numPlanes; plane++)
    {
       for (int line = 0; line < numLines; line++)
       {
          // Copy one line at proper destination:
-         memcpy((void*)destination, (void*)source, lineSize);
-         source      += lineSize;
-         destination -= lineSize;
+         memcpy((void*)dst, (void*)src, lineSize);
+         src += lineSize;
+         dst -= lineSize;
          // Update progress related:
          if (!(updateProgressCount%updateProgressTarget))
          {
@@ -677,18 +842,120 @@ size_t vtkGdcmReader::LoadImageInMemory(
          }
          updateProgressCount++;
       }
+      dst += 2 * planeSize;
    }
-   
-// DO NOT remove this commented out code .
-// Nobody knows what's expecting you ...
-// Just to 'see' what was actually read on disk :-(
-
-//   FILE * f2;
-//   f2 = fopen("SpuriousFile.RAW","wb");
-//   fwrite(Dest,size,1,f2);
-//   fclose(f2); 
-   
+   delete fileH;   
    return size;
 }
 
+// -------------------------------------------------------------------------
+
+// We assume the use *does* know all the files whose names 
+//  are in InternalFileNameList exist, may be open, are gdcm-readable
+//  have the same sizes, have the same 'pixel' type, are single frame
+//  have the same color convention, ..., anything else ? 
+
+int vtkGdcmReader::CheckFileCoherenceLight()
+{
+   std::list<std::string>::iterator filename = InternalFileNameList.begin();
+
+   gdcm::File GdcmFile;
+   GdcmFile.SetLoadMode( LoadMode );
+   GdcmFile.SetFileName(filename->c_str() );   
+   GdcmFile.Load( );
+
+   if (!GdcmFile.IsReadable())
+   {
+      vtkErrorMacro(<< "Gdcm cannot parse file " << filename->c_str());
+      vtkErrorMacro(<< "you should try vtkGdcmReader::CheckFileCoherence "
+                    << "instead of vtkGdcmReader::CheckFileCoherenceLight");
+      return 0;
+   }
+   int NX           = GdcmFile.GetXSize();
+   int NY           = GdcmFile.GetYSize();
+   // CheckFileCoherenceLight should be called *only* when user knows
+   // he deals with single frames files.
+   // Z size is then the number of files.
+   int NZ           = InternalFileNameList.size();
+   std::string type = GdcmFile.GetPixelType();
+   vtkDebugMacro(<< "The first file is taken as reference: "
+                 << filename->c_str());
+   vtkDebugMacro(<< "Image dimensions of reference file as read from Gdcm:" 
+                 << NX << " " << NY << " " << NZ);
+   vtkDebugMacro(<< "Number of planes added to the stack: " << NZ);
+   // Set aside the size of the image
+   this->NumColumns = NX;
+   this->NumLines   = NY;
+   this->ImageType  = type;
+   this->PixelSize  = GdcmFile.GetPixelSize();
+
+   if( GdcmFile.HasLUT() && this->AllowLookupTable )
+   {
+      // I could raise an error is AllowLookupTable is on and HasLUT() off
+      this->NumComponents = GdcmFile.GetNumberOfScalarComponentsRaw();
+   }
+   else
+   {
+      this->NumComponents = GdcmFile.GetNumberOfScalarComponents(); //rgb or mono
+   }
+       
+   //Set image spacing
+   this->DataSpacing[0] = GdcmFile.GetXSpacing();
+   this->DataSpacing[1] = GdcmFile.GetYSpacing();
+   this->DataSpacing[2] = GdcmFile.GetZSpacing();
+
+   return InternalFileNameList.size();
+}
+
+// We assume the use *does* know all the files whose names 
+//  are in InternalFileNameList exist, may be open, are gdcm-readable
+//  have the same sizes, have the same 'pixel' type, are single frame
+//  have the same color convention, ..., anything else ? 
+
+int vtkGdcmReader::CheckFileCoherenceAlreadyDone()
+{
+   if ( CoherentFileList->empty() )
+   {
+      vtkErrorMacro(<< "Coherent File List is empty ");
+      return 0;
+   }
+
+   gdcm::File *gdcmFile = (*CoherentFileList)[0];
+
+   int NX           = gdcmFile->GetXSize();
+   int NY           = gdcmFile->GetYSize();
+   // CheckFileCoherenceLight should be called *only* when user knows
+   // he deals with single frames files.
+   // Z size is then the number of files.
+   // --> TODO : loop on the File* to get NZ of each one !
+   int NZ           = CoherentFileList->size();
+   std::string type = gdcmFile->GetPixelType();
+   //vtkDebugMacro(<< "The first file is taken as reference: "
+   //              << (*CoherentFileList)[0]->GetFileName() );
+   vtkDebugMacro(<< "Image dimensions of reference file as read from Gdcm:" 
+                 << NX << " " << NY << " " << NZ);
+   vtkDebugMacro(<< "Number of planes added to the stack: " << NZ);
+   // Set aside the size of the image
+   this->NumColumns = NX;
+   this->NumLines   = NY;
+   this->ImageType  = type;
+   this->PixelSize  = gdcmFile->GetPixelSize();
+
+   if( gdcmFile->HasLUT() && this->AllowLookupTable )
+   {
+      // I could raise an error is AllowLookupTable is on and HasLUT() off
+      this->NumComponents = gdcmFile->GetNumberOfScalarComponentsRaw();
+   }
+   else
+   {
+      this->NumComponents = gdcmFile->GetNumberOfScalarComponents(); //rgb or mono
+   }
+       
+   //Set image spacing
+   this->DataSpacing[0] = gdcmFile->GetXSpacing();
+   this->DataSpacing[1] = gdcmFile->GetYSpacing();
+   this->DataSpacing[2] = gdcmFile->GetZSpacing();
+
+   return NZ;
+}
 //-----------------------------------------------------------------------------