L_DicomSetKeepPixelDataIntactFlag

#include "Ltdic.h"

L_LTDIC_API L_VOID L_DicomSetKeepPixelDataIntactFlag(hDS, bSet)

HDICOMDS hDS;

/* a DICOM handle */

L_BOOL bSet;

/* flag */

Enables or disables the pre-processing of image data when a function that gets a bitmap from a Pixel Data element is called.

Parameter

Description

hDS

A DICOM handle to the data set.

bSet

Flag the indicates whether to enable or disable the pre-processing of image data when a function that gets a bitmap from a Pixel Data element is called. Possible values are:

 

Value

Meaning

 

TRUE

Do not pre-process the image data.

 

FALSE

Pre-process the image data.

Returns

None.

Comments

When a function that gets a bitmap from a data set is called, such as L_DicomGetImage or L_DicomGetImageList, LEADTOOLS may pre-process the image data in the bitmap handle for optimal display. Call the L_DicomGetKeepPixelDataIntactFlag function to determine whether LEADTOOLS will pre-process the image data. By default LEADTOOLS pre-processes the image data.

Calling the L_DicomSetKeepPixelDataIntactFlag function with bSet set to TRUE stops LEADTOOLS from pre-processing the image data in the bitmap handle. Please note that this may result in unexpected behavior when a LEADTOOLS display or image processing function is called for that bitmap handle.

Required DLLs and Libraries

LTDIC

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64

See Also

Functions:

L_DicomGetKeepPixelDataIntactFlag, L_DicomGetImage, L_DicomGetImageList

Topics:

Working with Data Sets

Example

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName


L_INT DicomSetKeepPixelDataIntactFlagExample(L_VOID)
{
   L_UINT16 nRet;
   pDICOMELEMENT pElement;
   HDICOMDS hDS = L_DicomCreateDS(NULL);

   // Load a Data Set
   nRet = L_DicomLoadDS(hDS, MAKE_IMAGE_PATH(TEXT("Image1.dcm")), 0);
   if (nRet != DICOM_SUCCESS)
   {
      L_DicomFreeDS(hDS);
      return nRet;
   }

   if (L_DicomGetKeepPixelDataIntactFlag(hDS) == FALSE)
   {
      L_TCHAR* pszMessage;
      pszMessage = TEXT("Would you like to keep the pixel data unchanged?\nIf you choose Yes, then the resulting bitmap data will represent exactly what appears inside the DICOM file, but may not display properly. If you choose No, then the resulting bitmap data may not be identical to what appears inside the DICOM file, but will display properly."); 
      if (MessageBox(NULL, pszMessage, TEXT("Test"), MB_YESNO) == IDYES)
         L_DicomSetKeepPixelDataIntactFlag(hDS, TRUE);
   }

   pElement = L_DicomFindFirstElement(hDS, NULL, TAG_PIXEL_DATA, FALSE);
   if (pElement)
   {
      BITMAPHANDLE Bitmap;
      nRet = L_DicomGetImage(hDS, pElement, &Bitmap, sizeof(BITMAPHANDLE), 0, 0, ORDER_BGR, 0, NULL, NULL);
      if (nRet != DICOM_SUCCESS)
      {
         L_DicomFreeDS(hDS);
         return nRet;
      }

      // ...

      L_FreeBitmap(&Bitmap);
   }

   L_DicomFreeDS(hDS);
   return DICOM_SUCCESS;
}