LDicomDS::GetPaletteColorLUTData

#include "ltdic.h"

L_UINT16 LDicomDS::GetPaletteColorLUTData(pLUTData, uDataSize, PaletteColorLUTType, uFlags)

Retrieves red, green or blue "Palette Color Lookup Table Data".

Returns

Comments

This function will retrieve the data for the "Red", "Green" or "Blue" "Palette Color Lookup Table".

If the data is segmented, then this function will decode the data before coping it to the buffer pointed to by pLUTData.

Before calling this function you will need to call LDicomDS::GetPaletteColorLUTAttributes to see if a "Palette Color Lookup Table" exists in the DICOM dataset. If you are trying to retrieve the "Red Palette Color Lookup Table Data" you must allocate a buffer with a size greater or equal to pPaletteColorLUTAttributes->RedLUTDescriptor.uNumberOfEntries, where pPaletteColorLUTAttributes is the "Palette Color Lookup Table" attributes" structure returned by the LDicomDS::GetPaletteColorLUTAttributes function. If you are trying to retrieve the "Green Palette Color Lookup Table Data" you must allocate a buffer with a size greater or equal to pPaletteColorLUTAttributes-> GreenLUTDescriptor.uNumberOfEntries. And, if you are trying to retrieve the "Blue Palette Color Lookup Table Data" you must allocate a buffer with a size greater or equal to pPaletteColorLUTAttributes->BlueLUTDescriptor.uNumberOfEntries.

Required DLLs and Libraries

Platforms

Win32, x64

L_INT LDicomDS_GetPaletteColorLUTDataExample(LDicomDS    &InDS,//Input dataset 
L_UINT16*   pLUTDataBuffer,//Buffer which will hold the data 
L_UINT      uInputBufferSize//Buffer size 
) 
{ 
   L_INT nRet; 
   // Structure that will hold Palette Color LUT attributes 
   DICOMPALCOLORLUTATTRIBS PaletteColorLUTAttributes = {0}; 
   // Sanity Check 
   if(pLUTDataBuffer== NULL) 
   { 
      return DICOM_ERROR_NULL_PTR; 
   } 
   if(uInputBufferSize == 0) 
   { 
      return DICOM_ERROR_PARAMETER; 
   } 
   memset(pLUTDataBuffer,0,uInputBufferSize); 
   // Get "Palette Color Lookup Table" attributes 
   nRet = InDS.GetPaletteColorLUTAttributes (  &PaletteColorLUTAttributes, 
   sizeof(DICOMPALCOLORLUTATTRIBS), 
   0); 
   if(nRet != DICOM_SUCCESS) 
   { 
      return nRet; 
   } 
   // The buffer should be big enough to hold the data! 
   if(!(uInputBufferSize >= PaletteColorLUTAttributes.RedLUTDescriptor.uNumberOfEntries)) 
   { 
      return DICOM_ERROR_PARAMETER; 
   } 
   // Retrieve "Red Palette Color Lookup Table Data" 
   // This function will automatically decode the LUT data 
   // if it was segmented 
   return InDS.GetPaletteColorLUTData ( pLUTDataBuffer, 
   uInputBufferSize, 
   DICOMPALETTECOLORLUTTYPE_RED, 
   0); 
}