]> Creatis software - gdcm.git/blobdiff - src/gdcmPixelConvert.cxx
* src/gdcmDocEntryArchive.[h|cxx] : bug fix and add a method to temporary
[gdcm.git] / src / gdcmPixelConvert.cxx
index b9e5e3ab0f97554944e5dc0398c78a1e1345cafc..05fe19d642c77f7c4cd49814c38d75b5b2dfb02a 100644 (file)
@@ -3,8 +3,8 @@
   Program:   gdcm
   Module:    $RCSfile: gdcmPixelConvert.cxx,v $
   Language:  C++
-  Date:      $Date: 2004/10/15 10:43:28 $
-  Version:   $Revision: 1.14 $
+  Date:      $Date: 2004/11/24 10:23:47 $
+  Version:   $Revision: 1.32 $
                                                                                 
   Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
   l'Image). All rights reserved. See Doc/License.txt or
 
 #include "gdcmDebug.h"
 #include "gdcmPixelConvert.h"
+#include <fstream>
+#include <stdio.h>
 
 namespace gdcm
 {
-                                                                                
 #define str2num(str, typeNum) *((typeNum *)(str))
 
 // For JPEG 2000, body in file gdcmJpeg2000.cxx
-bool gdcm_read_JPEG2000_file (FILE* fp, void* image_buffer);
+bool gdcm_read_JPEG2000_file (std::ifstream* fp, void* image_buffer);
 
 // For JPEG 8 Bits, body in file gdcmJpeg8.cxx
-bool gdcm_read_JPEG_file8    (FILE* fp, void* image_buffer);
+bool gdcm_read_JPEG_file8    (std::ifstream* fp, void* image_buffer);
 
 // For JPEG 12 Bits, body in file gdcmJpeg12.cxx
-bool gdcm_read_JPEG_file12   (FILE* fp, void* image_buffer);
+bool gdcm_read_JPEG_file12   (std::ifstream* fp, void* image_buffer);
 
 // For JPEG 16 Bits, body in file gdcmJpeg16.cxx
 // Beware this is misleading there is no 16bits DCT algorithm, only
 // jpeg lossless compression exist in 16bits.
-bool gdcm_read_JPEG_file16   (FILE* fp, void* image_buffer);
+bool gdcm_read_JPEG_file16   (std::ifstream* fp, void* image_buffer);
 
 
 //-----------------------------------------------------------------------------
@@ -53,16 +54,31 @@ PixelConvert::PixelConvert()
    RGBSize = 0;
    Decompressed = 0;
    DecompressedSize = 0;
+   LutRGBA = 0;
+   LutRedData = 0;
+   LutGreenData = 0;
+   LutBlueData =0;
 }
 
 void PixelConvert::Squeeze() 
 {
-   if ( RGB ) {
+   if ( RGB )
+   {
       delete [] RGB;
    } 
-   if ( Decompressed ) {
+   RGB = 0;
+
+   if ( Decompressed )
+   {
       delete [] Decompressed;
    }
+   Decompressed = 0;
+
+   if ( LutRGBA )
+   {
+      delete [] LutRGBA;
+   }
+   LutRGBA = 0;
 }
 
 PixelConvert::~PixelConvert() 
@@ -75,7 +91,7 @@ void PixelConvert::AllocateRGB()
   if ( RGB ) {
      delete [] RGB;
   }
-  RGB = new uint8_t[RGBSize];
+  RGB = new uint8_t[ RGBSize ];
 }
 
 void PixelConvert::AllocateDecompressed()
@@ -87,41 +103,40 @@ void PixelConvert::AllocateDecompressed()
 }
 
 /**
- * \brief Read from file a 12 bits per pixel image and uncompress it
+ * \brief Read from file a 12 bits per pixel image and decompress it
  *        into a 16 bits per pixel image.
  */
-void PixelConvert::ReadAndDecompress12BitsTo16Bits( FILE* fp )
+void PixelConvert::ReadAndDecompress12BitsTo16Bits( std::ifstream* fp )
                throw ( FormatError )
 {
    int nbPixels = XSize * YSize;
    uint16_t* localDecompres = (uint16_t*)Decompressed;
-                                                                                
+
    for( int p = 0; p < nbPixels; p += 2 )
    {
       uint8_t b0, b1, b2;
-      size_t ItemRead;
-                                                                                
-      ItemRead = fread( &b0, 1, 1, fp );
-      if ( ItemRead != 1 )
+
+      fp->read( (char*)&b0, 1);
+      if ( fp->fail() || fp->eof() )//Fp->gcount() == 1
       {
          throw FormatError( "PixelConvert::ReadAndDecompress12BitsTo16Bits()",
                                 "Unfound first block" );
       }
-                                                                                
-      ItemRead = fread( &b1, 1, 1, fp );
-      if ( ItemRead != 1 )
+
+      fp->read( (char*)&b1, 1 );
+      if ( fp->fail() || fp->eof())//Fp->gcount() == 1
       {
          throw FormatError( "PixelConvert::ReadAndDecompress12BitsTo16Bits()",
                                 "Unfound second block" );
       }
-                                                                                
-      ItemRead = fread( &b2, 1, 1, fp );
-      if ( ItemRead != 1 )
+
+      fp->read( (char*)&b2, 1 );
+      if ( fp->fail() || fp->eof())//Fp->gcount() == 1
       {
          throw FormatError( "PixelConvert::ReadAndDecompress12BitsTo16Bits()",
                                 "Unfound second block" );
       }
-                                                                                
+
       // Two steps are necessary to please VC++
       //
       // 2 pixels 12bit =     [0xABCDEF]
@@ -130,7 +145,7 @@ void PixelConvert::ReadAndDecompress12BitsTo16Bits( FILE* fp )
       *localDecompres++ =  ((b0 >> 4) << 8) + ((b0 & 0x0f) << 4) + (b1 & 0x0f);
       //                        F                     C                 E
       *localDecompres++ =  ((b2 & 0x0f) << 8) + ((b1 >> 4) << 4) + (b2 >> 4);
-                                                                                
+
       /// \todo JPR Troubles expected on Big-Endian processors ?
    }
 }
@@ -146,15 +161,15 @@ void PixelConvert::ReadAndDecompress12BitsTo16Bits( FILE* fp )
 bool PixelConvert::DecompressRLE16BitsFromRLE8Bits( int NumberOfFrames )
 {
    size_t PixelNumber = XSize * YSize;
-   size_t uncompressedSize = XSize * YSize * NumberOfFrames;
+   size_t decompressedSize = XSize * YSize * NumberOfFrames;
 
    // We assumed Decompressed contains the decoded RLE pixels but as
    // 8 bits per pixel. In order to convert those pixels to 16 bits
    // per pixel we cannot work in place within Decompressed and hence
    // we copy it in a safe place, say copyDecompressed.
 
-   uint8_t* copyDecompressed = new uint8_t[ uncompressedSize * 2 ];
-   memmove( copyDecompressed, Decompressed, uncompressedSize * 2 );
+   uint8_t* copyDecompressed = new uint8_t[ decompressedSize * 2 ];
+   memmove( copyDecompressed, Decompressed, decompressedSize * 2 );
 
    uint8_t* x = Decompressed;
    uint8_t* a = copyDecompressed;
@@ -164,8 +179,8 @@ bool PixelConvert::DecompressRLE16BitsFromRLE8Bits( int NumberOfFrames )
    {
       for ( unsigned int j = 0; j < PixelNumber; j++ )
       {
-         *(x++) = *(a++);
          *(x++) = *(b++);
+         *(x++) = *(a++);
       }
    }
 
@@ -176,28 +191,28 @@ bool PixelConvert::DecompressRLE16BitsFromRLE8Bits( int NumberOfFrames )
 }
 
 /**
- * \brief Implementation of the RLE decoding algorithm for uncompressing
+ * \brief Implementation of the RLE decoding algorithm for decompressing
  *        a RLE fragment. [refer to PS 3.5-2003, section G.3.2 p 86]
  * @param subDecompressed Sub region of \ref Decompressed where the de
  *        decoded fragment should be placed.
  * @param fragmentSize The length of the binary fragment as found on the disk.
- * @param uncompressedSegmentSize The expected length of the fragment ONCE
+ * @param decompressedSegmentSize The expected length of the fragment ONCE
  *        decompressed.
  * @param fp File Pointer: on entry the position should be the one of
  *        the fragment to be decoded.
  */
 bool PixelConvert::ReadAndDecompressRLEFragment( uint8_t* subDecompressed,
                                                  long fragmentSize,
-                                                 long uncompressedSegmentSize,
-                                                 FILE* fp )
+                                                 long decompressedSegmentSize,
+                                                 std::ifstream* fp )
 {
    int8_t count;
    long numberOfOutputBytes = 0;
    long numberOfReadBytes = 0;
-                                                                                
-   while( numberOfOutputBytes < uncompressedSegmentSize )
+
+   while( numberOfOutputBytes < decompressedSegmentSize )
    {
-      fread( &count, 1, 1, fp );
+      fp->read( (char*)&count, 1 );
       numberOfReadBytes += 1;
       if ( count >= 0 )
       // Note: count <= 127 comparison is always true due to limited range
@@ -205,7 +220,7 @@ bool PixelConvert::ReadAndDecompressRLEFragment( uint8_t* subDecompressed,
       //       signed integer of width N is 2^(N-1) - 1, which for int8_t
       //       is 127].
       {
-         fread( subDecompressed, count + 1, 1, fp);
+         fp->read( (char*)subDecompressed, count + 1);
          numberOfReadBytes   += count + 1;
          subDecompressed     += count + 1;
          numberOfOutputBytes += count + 1;
@@ -215,7 +230,7 @@ bool PixelConvert::ReadAndDecompressRLEFragment( uint8_t* subDecompressed,
          if ( ( count <= -1 ) && ( count >= -127 ) )
          {
             int8_t newByte;
-            fread( &newByte, 1, 1, fp);
+            fp->read( (char*)&newByte, 1);
             numberOfReadBytes += 1;
             for( int i = 0; i < -count + 1; i++ )
             {
@@ -239,12 +254,12 @@ bool PixelConvert::ReadAndDecompressRLEFragment( uint8_t* subDecompressed,
 
 /**
  * \brief     Reads from disk the Pixel Data of 'Run Length Encoded'
- *            Dicom encapsulated file and uncompress it.
+ *            Dicom encapsulated file and decompress it.
  * @param     fp already open File Pointer
  *            at which the pixel data should be copied
  * @return    Boolean
  */
-bool PixelConvert::ReadAndDecompressRLEFile( FILE* fp )
+bool PixelConvert::ReadAndDecompressRLEFile( std::ifstream* fp )
 {
    uint8_t* subDecompressed = Decompressed;
    long decompressedSegmentSize = XSize * YSize;
@@ -256,9 +271,9 @@ bool PixelConvert::ReadAndDecompressRLEFile( FILE* fp )
       ++it )
    {
       // Loop on the fragments
-      for( int k = 1; k <= (*it)->NumberFragments; k++ )
+      for( unsigned int k = 1; k <= (*it)->NumberFragments; k++ )
       {
-         fseek( fp, (*it)->Offset[k] ,SEEK_SET );
+         fp->seekg(  (*it)->Offset[k] , std::ios_base::beg );
          (void)ReadAndDecompressRLEFragment( subDecompressed,
                                              (*it)->Length[k],
                                              decompressedSegmentSize, 
@@ -266,13 +281,13 @@ bool PixelConvert::ReadAndDecompressRLEFile( FILE* fp )
          subDecompressed += decompressedSegmentSize;
       }
    }
-                                                                                
+
    if ( BitsAllocated == 16 )
    {
       // Try to deal with RLE 16 Bits
       (void)DecompressRLE16BitsFromRLE8Bits( ZSize );
    }
-                                                                                
+
    return true;
 }
 
@@ -282,7 +297,7 @@ bool PixelConvert::ReadAndDecompressRLEFile( FILE* fp )
 void PixelConvert::ConvertSwapZone()
 {
    unsigned int i;
-                                                                                
+
    if( BitsAllocated == 16 )
    {
       uint16_t* im16 = (uint16_t*)Decompressed;
@@ -385,11 +400,11 @@ void PixelConvert::ConvertReorderEndianity()
 
 /**
  * \brief     Reads from disk the Pixel Data of JPEG Dicom encapsulated
- &            file and uncompress it.
+ &            file and decompress it.
  * @param     fp File Pointer
  * @return    Boolean
  */
-bool PixelConvert::ReadAndDecompressJPEGFile( FILE* fp )
+bool PixelConvert::ReadAndDecompressJPEGFile( std::ifstream* fp )
 {
    uint8_t* localDecompressed = Decompressed;
    // Loop on the fragment[s]
@@ -398,7 +413,7 @@ bool PixelConvert::ReadAndDecompressJPEGFile( FILE* fp )
         it != JPEGInfo->Fragments.end();
       ++it )
    {
-      fseek( fp, (*it)->Offset, SEEK_SET );
+      fp->seekg( (*it)->Offset, std::ios_base::beg);
 
       if ( IsJPEG2000 )
       {
@@ -415,7 +430,7 @@ bool PixelConvert::ReadAndDecompressJPEGFile( FILE* fp )
             return false;
          }
       }
-      else if ( BitsStored == 12)
+      else if ( BitsStored <= 12)
       {
          // Reading Fragment pixels
          if ( ! gdcm_read_JPEG_file12 ( fp, localDecompressed ) )
@@ -423,7 +438,7 @@ bool PixelConvert::ReadAndDecompressJPEGFile( FILE* fp )
             return false;
          }
       }
-      else if ( BitsStored == 16)
+      else if ( BitsStored <= 16)
       {
          // Reading Fragment pixels
          if ( ! gdcm_read_JPEG_file16 ( fp, localDecompressed ) )
@@ -439,12 +454,12 @@ bool PixelConvert::ReadAndDecompressJPEGFile( FILE* fp )
                    "jpeg lossy compression ");
          return false;
       }
-                                                                                
+
       // Advance to next free location in Decompressed 
       // for next fragment decompression (if any)
       int length = XSize * YSize * SamplesPerPixel;
       int numberBytes = BitsAllocated / 8;
-                                                                                
+
       localDecompressed += length * numberBytes;
    }
    return true;
@@ -500,7 +515,7 @@ void PixelConvert::ConvertYcBcRPlanesToRGBPixels()
    uint8_t* localDecompressed = Decompressed;
    uint8_t* copyDecompressed = new uint8_t[ DecompressedSize ];
    memmove( copyDecompressed, localDecompressed, DecompressedSize );
-                                                                                
+
    // to see the tricks about YBR_FULL, YBR_FULL_422,
    // YBR_PARTIAL_422, YBR_ICT, YBR_RCT have a look at :
    // ftp://medical.nema.org/medical/dicom/final/sup61_ft.pdf
@@ -508,17 +523,17 @@ void PixelConvert::ConvertYcBcRPlanesToRGBPixels()
    //
    int l        = XSize * YSize;
    int nbFrames = ZSize;
-                                                                                
+
    uint8_t* a = copyDecompressed;
    uint8_t* b = copyDecompressed + l;
    uint8_t* c = copyDecompressed + l + l;
    double R, G, B;
-                                                                                
+
    /// \todo : Replace by the 'well known' integer computation
    ///         counterpart. Refer to
    ///            http://lestourtereaux.free.fr/papers/data/yuvrgb.pdf
    ///         for code optimisation.
-                                                                                
+
    for ( int i = 0; i < nbFrames; i++ )
    {
       for ( int j = 0; j < l; j++ )
@@ -526,14 +541,14 @@ void PixelConvert::ConvertYcBcRPlanesToRGBPixels()
          R = 1.164 *(*a-16) + 1.596 *(*c -128) + 0.5;
          G = 1.164 *(*a-16) - 0.813 *(*c -128) - 0.392 *(*b -128) + 0.5;
          B = 1.164 *(*a-16) + 2.017 *(*b -128) + 0.5;
-                                                                                
+
          if (R < 0.0)   R = 0.0;
          if (G < 0.0)   G = 0.0;
          if (B < 0.0)   B = 0.0;
          if (R > 255.0) R = 255.0;
          if (G > 255.0) G = 255.0;
          if (B > 255.0) B = 255.0;
-                                                                                
+
          *(localDecompressed++) = (uint8_t)R;
          *(localDecompressed++) = (uint8_t)G;
          *(localDecompressed++) = (uint8_t)B;
@@ -554,13 +569,13 @@ void PixelConvert::ConvertRGBPlanesToRGBPixels()
    uint8_t* localDecompressed = Decompressed;
    uint8_t* copyDecompressed = new uint8_t[ DecompressedSize ];
    memmove( copyDecompressed, localDecompressed, DecompressedSize );
-                                                                                
+
    int l = XSize * YSize * ZSize;
-                                                                                
+
    uint8_t* a = copyDecompressed;
    uint8_t* b = copyDecompressed + l;
    uint8_t* c = copyDecompressed + l + l;
-                                                                                
+
    for (int j = 0; j < l; j++)
    {
       *(localDecompressed++) = *(a++);
@@ -570,41 +585,57 @@ void PixelConvert::ConvertRGBPlanesToRGBPixels()
    delete[] copyDecompressed;
 }
 
-bool PixelConvert::ReadAndDecompressPixelData( FILE* fp )
+bool PixelConvert::ReadAndDecompressPixelData( std::ifstream* fp )
 {
-   ComputeDecompressedImageDataSize();
-   if ( HasLUT )
-      DecompressedSize *= 3;
+   ComputeDecompressedAndRGBSizes();
    AllocateDecompressed();
    //////////////////////////////////////////////////
    //// First stage: get our hands on the Pixel Data.
    if ( !fp )
    {
-     dbg.Verbose( 0, "PixelConvert::ReadAndDecompressPixelData: "
-                     "unavailable file pointer." );
+      dbg.Verbose( 0, "PixelConvert::ReadAndDecompressPixelData: "
+                      "unavailable file pointer." );
       return false;
    }
-                                                                                
-   if ( fseek( fp, PixelOffset, SEEK_SET ) == -1 )
+
+   fp->seekg( PixelOffset, std::ios_base::beg );
+   if( fp->fail() || fp->eof()) //Fp->gcount() == 1
    {
-     dbg.Verbose( 0, "PixelConvert::ReadAndDecompressPixelData: "
-                     "unable to find PixelOffset in file." );
+      dbg.Verbose( 0, "PixelConvert::ReadAndDecompressPixelData: "
+                      "unable to find PixelOffset in file." );
       return false;
    }
-                                                                                
+
    //////////////////////////////////////////////////
-   //// Second stage: read from disk dans uncompress.
+   //// Second stage: read from disk dans decompress.
    if ( BitsAllocated == 12 )
    {
       ReadAndDecompress12BitsTo16Bits( fp);
    }
-   else if ( IsUncompressed )
+   else if ( IsDecompressed )
    {
-      size_t ItemRead = fread( Decompressed, PixelDataLength, 1, fp );
-      if ( ItemRead != 1 )
+      // This problem can be found when some obvious informations are found
+      // after the field containing the image datas. In this case, these
+      // bad datas are added to the size of the image (in the PixelDataLength
+      // variable). But DecompressedSize is the right size of the image !
+      if( PixelDataLength != DecompressedSize)
       {
          dbg.Verbose( 0, "PixelConvert::ReadAndDecompressPixelData: "
-                         "reading of uncompressed pixel data failed." );
+                      "Mismatch between PixelConvert and DecompressedSize." );
+      }
+      if( PixelDataLength > DecompressedSize)
+      {
+         fp->read( (char*)Decompressed, DecompressedSize);
+      }
+      else
+      {
+         fp->read( (char*)Decompressed, PixelDataLength);
+      }
+
+      if ( fp->fail() || fp->eof())//Fp->gcount() == 1
+      {
+         dbg.Verbose( 0, "PixelConvert::ReadAndDecompressPixelData: "
+                         "reading of decompressed pixel data failed." );
          return false;
       }
    } 
@@ -695,19 +726,26 @@ void PixelConvert::ConvertHandleColor()
          // [Planar 1] AND [Photo C]
          ConvertRGBPlanesToRGBPixels();
       }
+      return;
    }
                                                                                 
-   // When planarConf is 0, pixels are allready in RGB
+   // When planarConf is 0, and RLELossless (forbidden by Dicom norm)
+   // pixels need to be RGB-fied anyway
+   if (IsRLELossless)
+   {
+     ConvertRGBPlanesToRGBPixels();
+   }
+   // In *normal *case, when planarConf is 0, pixels are already in RGB
 }
 
 /**
  * \brief Predicate to know wether the image[s] (once decompressed) is RGB.
- * \note See comments of \ref HandleColor
+ * \note See comments of \ref ConvertHandleColor
  */
 bool PixelConvert::IsDecompressedRGB()
 {
    if (   IsMonochrome
-       || ( PlanarConfiguration == 2 )
+       || PlanarConfiguration == 2
        || IsPaletteColor )
    {
       return false;
@@ -715,7 +753,7 @@ bool PixelConvert::IsDecompressedRGB()
    return true;
 }
 
-void PixelConvert::ComputeDecompressedImageDataSize()
+void PixelConvert::ComputeDecompressedAndRGBSizes()
 {
    int bitsAllocated = BitsAllocated;
    // Number of "Bits Allocated" is fixed to 16 when it's 12, since
@@ -726,9 +764,367 @@ void PixelConvert::ComputeDecompressedImageDataSize()
       bitsAllocated = 16;
    }
                                                                                 
-   DecompressedSize = XSize * YSize * ZSize
-                    * ( bitsAllocated / 8 )
-                    * SamplesPerPixel;
+   DecompressedSize =  XSize * YSize * ZSize
+                     * ( bitsAllocated / 8 )
+                     * SamplesPerPixel;
+   if ( HasLUT )
+   {
+      RGBSize = 3 * DecompressedSize;
+   }
+
+}
+
+void PixelConvert::GrabInformationsFromHeader( Header* header )
+{
+   // Just in case some access to a Header element requires disk access.
+   // Note: gdcmDocument::Fp is leaved open after OpenFile.
+   std::ifstream* fp = header->OpenFile();
+   // Number of Bits Allocated for storing a Pixel is defaulted to 16
+   // when absent from the header.
+   BitsAllocated = header->GetBitsAllocated();
+   if ( BitsAllocated == 0 )
+   {
+      BitsAllocated = 16;
+   }
+
+   // Number of "Bits Stored" defaulted to number of "Bits Allocated"
+   // when absent from the header.
+   BitsStored = header->GetBitsStored();
+   if ( BitsStored == 0 )
+   {
+      BitsStored = BitsAllocated;
+   }
+
+   // High Bit Position
+   HighBitPosition = header->GetHighBitPosition();
+   if ( HighBitPosition == 0 )
+   {
+      HighBitPosition = BitsAllocated - 1;
+   }
+
+   XSize = header->GetXSize();
+   YSize = header->GetYSize();
+   ZSize = header->GetZSize();
+   SamplesPerPixel = header->GetSamplesPerPixel();
+   PixelSize = header->GetPixelSize();
+   PixelSign = header->IsSignedPixelData();
+   SwapCode  = header->GetSwapCode();
+   TransferSyntaxType ts = header->GetTransferSyntax();
+   IsDecompressed =
+        ( ! header->IsDicomV3() )
+     || ts == ImplicitVRLittleEndian
+     || ts == ImplicitVRLittleEndianDLXGE
+     || ts == ExplicitVRLittleEndian
+     || ts == ExplicitVRBigEndian
+     || ts == DeflatedExplicitVRLittleEndian;
+   IsJPEG2000     = header->IsJPEG2000();
+   IsJPEGLossless = header->IsJPEGLossless();
+   IsRLELossless  =  ( ts == RLELossless );
+   PixelOffset     = header->GetPixelOffset();
+   PixelDataLength = header->GetPixelAreaLength();
+   RLEInfo  = header->GetRLEInfo();
+   JPEGInfo = header->GetJPEGInfo();
+                                                                             
+   PlanarConfiguration = header->GetPlanarConfiguration();
+   IsMonochrome = header->IsMonochrome();
+   IsPaletteColor = header->IsPaletteColor();
+   IsYBRFull = header->IsYBRFull();
+
+   /////////////////////////////////////////////////////////////////
+   // LUT section:
+   HasLUT = header->HasLUT();
+   if ( HasLUT )
+   {
+      LutRedDescriptor   = header->GetEntryByNumber( 0x0028, 0x1101 );
+      LutGreenDescriptor = header->GetEntryByNumber( 0x0028, 0x1102 );
+      LutBlueDescriptor  = header->GetEntryByNumber( 0x0028, 0x1103 );
+   
+      // Depending on the value of Document::MAX_SIZE_LOAD_ELEMENT_VALUE
+      // [ refer to invocation of Document::SetMaxSizeLoadEntry() in
+      // Document::Document() ], the loading of the value (content) of a
+      // [Bin|Val]Entry occurence migth have been hindered (read simply NOT
+      // loaded). Hence, we first try to obtain the LUTs data from the header
+      // and when this fails we read the LUTs data directely from disk.
+      /// \todo Reading a [Bin|Val]Entry directly from disk is a kludge.
+      ///       We should NOT bypass the [Bin|Val]Entry class. Instead
+      ///       an access to an UNLOADED content of a [Bin|Val]Entry occurence
+      ///       (e.g. BinEntry::GetBinArea()) should force disk access from
+      ///       within the [Bin|Val]Entry class itself. The only problem
+      ///       is that the [Bin|Val]Entry is unaware of the FILE* is was
+      ///       parsed from. Fix that. FIXME.
+   
+      ////// Red round:
+      LutRedData = (uint8_t*)header->GetEntryBinAreaByNumber( 0x0028, 0x1201 );
+      if ( ! LutRedData )
+      {
+         // Read the Lut Data from disk
+         DocEntry* lutRedDataEntry = header->GetDocEntryByNumber( 0x0028,
+                                                                  0x1201 );
+         LutRedData = new uint8_t[ lutRedDataEntry->GetLength() ];
+         fp->seekg(  lutRedDataEntry->GetOffset() ,std::ios_base::beg );
+         fp->read( (char*)LutRedData, (size_t)lutRedDataEntry->GetLength());
+         if ( fp->fail() || fp->eof())//Fp->gcount() == 1
+         {
+            dbg.Verbose(0, "PixelConvert::GrabInformationsFromHeader: "
+                            "unable to read red LUT data" );
+            return;
+         }
+      }
+
+      ////// Green round:
+      LutGreenData = (uint8_t*)header->GetEntryBinAreaByNumber(0x0028, 0x1202 );
+      if ( ! LutGreenData)
+      {
+         // Read the Lut Data from disk
+         DocEntry* lutGreenDataEntry = header->GetDocEntryByNumber( 0x0028,
+                                                                    0x1202 );
+         LutGreenData = new uint8_t[ lutGreenDataEntry->GetLength() ];
+         fp->seekg( lutGreenDataEntry->GetOffset() , std::ios_base::beg );
+         fp->read( (char*)LutGreenData, (size_t)lutGreenDataEntry->GetLength() );
+         if ( fp->fail() || fp->eof())//Fp->gcount() == 1
+         {
+            dbg.Verbose(0, "PixelConvert::GrabInformationsFromHeader: "
+                           "unable to read green LUT data" );
+            return;
+         }
+      }
+
+      ////// Blue round:
+      LutBlueData = (uint8_t*)header->GetEntryBinAreaByNumber( 0x0028, 0x1203 );
+      if ( ! LutBlueData )
+      {
+         // Read the Lut Data from disk
+         DocEntry* lutBlueDataEntry  = header->GetDocEntryByNumber( 0x0028,
+                                                                    0x1203 );
+         LutBlueData = new uint8_t[ lutBlueDataEntry->GetLength() ];
+         fp->seekg(  lutBlueDataEntry->GetOffset() , std::ios_base::beg );
+         fp->read( (char*)LutBlueData, (size_t)lutBlueDataEntry->GetLength() );
+         if ( fp->fail() || fp->eof())//Fp->gcount() == 1
+         {
+            dbg.Verbose(0, "PixelConvert::GrabInformationsFromHeader: "
+                           "unable to read blue LUT data" );
+            return;
+         }
+      }
+   }
+
+   if(fp) header->CloseFile();
+}
+
+/**
+ * \brief Build Red/Green/Blue/Alpha LUT from Header
+ *         when (0028,0004),Photometric Interpretation = [PALETTE COLOR ]
+ *          and (0028,1101),(0028,1102),(0028,1102)
+ *            - xxx Palette Color Lookup Table Descriptor - are found
+ *          and (0028,1201),(0028,1202),(0028,1202)
+ *            - xxx Palette Color Lookup Table Data - are found
+ * \warning does NOT deal with :
+ *   0028 1100 Gray Lookup Table Descriptor (Retired)
+ *   0028 1221 Segmented Red Palette Color Lookup Table Data
+ *   0028 1222 Segmented Green Palette Color Lookup Table Data
+ *   0028 1223 Segmented Blue Palette Color Lookup Table Data
+ *   no known Dicom reader deals with them :-(
+ * @return a RGBA Lookup Table
+ */
+void PixelConvert::BuildLUTRGBA()
+{
+   if ( LutRGBA )
+   {
+      return;
+   }
+   // Not so easy : see
+   // http://www.barre.nom.fr/medical/dicom2/limitations.html#Color%20Lookup%20Tables
+                                                                                
+   if ( ! IsPaletteColor )
+   {
+      return;
+   }
+                                                                                
+   if (   LutRedDescriptor   == GDCM_UNFOUND
+       || LutGreenDescriptor == GDCM_UNFOUND
+       || LutBlueDescriptor  == GDCM_UNFOUND )
+   {
+      return;
+   }
+
+   ////////////////////////////////////////////
+   // Extract the info from the LUT descriptors
+   int lengthR;   // Red LUT length in Bytes
+   int debR;      // Subscript of the first Lut Value
+   int nbitsR;    // Lut item size (in Bits)
+   int nbRead = sscanf( LutRedDescriptor.c_str(),
+                        "%d\\%d\\%d",
+                        &lengthR, &debR, &nbitsR );
+   if( nbRead != 3 )
+   {
+      dbg.Verbose(0, "PixelConvert::BuildLUTRGBA: wrong red LUT descriptor");
+   }
+                                                                                
+   int lengthG;  // Green LUT length in Bytes
+   int debG;     // Subscript of the first Lut Value
+   int nbitsG;   // Lut item size (in Bits)
+   nbRead = sscanf( LutGreenDescriptor.c_str(),
+                    "%d\\%d\\%d",
+                    &lengthG, &debG, &nbitsG );
+   if( nbRead != 3 )
+   {
+      dbg.Verbose(0, "PixelConvert::BuildLUTRGBA: wrong green LUT descriptor");
+   }
+                                                                                
+   int lengthB;  // Blue LUT length in Bytes
+   int debB;     // Subscript of the first Lut Value
+   int nbitsB;   // Lut item size (in Bits)
+   nbRead = sscanf( LutRedDescriptor.c_str(),
+                    "%d\\%d\\%d",
+                    &lengthB, &debB, &nbitsB );
+   if( nbRead != 3 )
+   {
+      dbg.Verbose(0, "PixelConvert::BuildLUTRGBA: wrong blue LUT descriptor");
+   }
+                                                                                
+   ////////////////////////////////////////////////////////
+   if ( ( ! LutRedData ) || ( ! LutGreenData ) || ( ! LutBlueData ) )
+   {
+      return;
+   }
+
+   ////////////////////////////////////////////////
+   // forge the 4 * 8 Bits Red/Green/Blue/Alpha LUT
+   LutRGBA = new uint8_t[ 1024 ]; // 256 * 4 (R, G, B, Alpha)
+   if ( !LutRGBA )
+   {
+      return;
+   }
+   memset( LutRGBA, 0, 1024 );
+                                                                                
+   int mult;
+   if ( ( nbitsR == 16 ) && ( BitsAllocated == 8 ) )
+   {
+      // when LUT item size is different than pixel size
+      mult = 2; // high byte must be = low byte
+   }
+   else
+   {
+      // See PS 3.3-2003 C.11.1.1.2 p 619
+      mult = 1;
+   }
+                                                                                
+   // if we get a black image, let's just remove the '+1'
+   // from 'i*mult+1' and check again
+   // if it works, we shall have to check the 3 Palettes
+   // to see which byte is ==0 (first one, or second one)
+   // and fix the code
+   // We give up the checking to avoid some (useless ?)overhead
+   // (optimistic asumption)
+   int i;
+   uint8_t* a = LutRGBA + 0;
+   for( i=0; i < lengthR; ++i )
+   {
+      *a = LutRedData[i*mult+1];
+      a += 4;
+   }
+                                                                                
+   a = LutRGBA + 1;
+   for( i=0; i < lengthG; ++i)
+   {
+      *a = LutGreenData[i*mult+1];
+      a += 4;
+   }
+                                                                                
+   a = LutRGBA + 2;
+   for(i=0; i < lengthB; ++i)
+   {
+      *a = LutBlueData[i*mult+1];
+      a += 4;
+   }
+                                                                                
+   a = LutRGBA + 3;
+   for(i=0; i < 256; ++i)
+   {
+      *a = 1; // Alpha component
+      a += 4;
+   }
+}
+
+/**
+ * \brief Build the RGB image from the Decompressed imagage and the LUTs.
+ */
+bool PixelConvert::BuildRGBImage()
+{
+   if ( RGB )
+   {
+      // The job is already done.
+      return true;
+   }
+
+   if ( ! Decompressed )
+   {
+      // The job can't be done
+      return false;
+   }
+
+   BuildLUTRGBA();
+   if ( ! LutRGBA )
+   {
+      // The job can't be done
+      return false;
+   }
+                                                                                
+   // Build RGB Pixels
+   AllocateRGB();
+   uint8_t* localRGB = RGB;
+   for (size_t i = 0; i < DecompressedSize; ++i )
+   {
+      int j  = Decompressed[i] * 4;
+      *localRGB++ = LutRGBA[j];
+      *localRGB++ = LutRGBA[j+1];
+      *localRGB++ = LutRGBA[j+2];
+   }
+   return true;
+}
+
+/**
+ * \brief        Print self.
+ * @param indent Indentation string to be prepended during printing.
+ * @param os     Stream to print to.
+ */
+void PixelConvert::Print( std::string indent, std::ostream &os )
+{
+   os << indent
+      << "--- Pixel information -------------------------"
+      << std::endl;
+   os << indent
+      << "Pixel Data: offset " << PixelOffset
+      << " x" << std::hex << PixelOffset << std::dec
+      << "   length " << PixelDataLength
+      << " x" << std::hex << PixelDataLength << std::dec
+      << std::endl;
+
+   if ( IsRLELossless )
+   {
+      if ( RLEInfo )
+      {
+         RLEInfo->Print( indent, os );
+      }
+      else
+      {
+         dbg.Verbose(0, "PixelConvert::Print: set as RLE file "
+                        "but NO RLEinfo present.");
+      }
+   }
+
+   if ( IsJPEG2000 || IsJPEGLossless )
+   {
+      if ( JPEGInfo )
+      {
+         JPEGInfo->Print( indent, os );
+      }
+      else
+      {
+         dbg.Verbose(0, "PixelConvert::Print: set as JPEG file "
+                        "but NO JPEGinfo present.");
+      }
+   }
 }
 
 } // end namespace gdcm