L_DicomGetModalityLUTData

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomGetModalityLUTData(hDS, pLUTData, uDataSize, uFlags)

HDICOMDS hDS;	a DICOM handle
L_UINT16 *pLUTData;	pointer to the target buffer
L_UINT uDataSize;	size of the target buffer
L_UINT uFlags;	reserved for future use

Retrieves "LUT Data" for a "Modality LUT Sequence".

Parameter	Description
hDS	A DICOM handle.
pLUTData	Pointer to the buffer to be updated with the "LUT Data". You must allocate the buffer before calling this function, and the buffer must be large enough to hold the "LUT Data".
uDataSize	Size of the buffer pointed to by pLUTData.
uFlags	Reserved for future use. Pass 0.

Returns

DICOM_SUCCESS	The function was successful.
>0	An error occurred. Refer to Return Codes.

Comments

This function will retrieve the "LUT Data" (0028,3006) under the "Modality LUT Sequence" (0028,3000).

Before calling this function you must call L_DicomGetModalityLUTAttributes and check the pModalityLUTAttributes->bIsModalityLUTSequence flag to see if a "Modality LUT Sequence" exists in the DICOM dataset or not. If the sequence exists, then you must allocate a buffer with a size greater or equal to pModalityLUTAttributes->LUTDescriptor.uNumberOfEntries and then call this function to retrieve the LUT data.

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, Linux.

Example

This example will retrieve the LUT Data (0028,3006) under the Modality LUT Sequence (0028,3000)

L_INT DicomGetModalityLUTDataExample( 
HDICOMDS hDicomDS, 
L_UINT16* pLUTDataBuffer, 
L_UINT uInputBufferSize) 
{ 
   // Structure that will hold modality LUT attributes 
   DICOMMLUTATTRIBS ModalityLUTAttributes= {0}; 
   L_UINT16 uRet; 
   // Sanity Check 
   if((hDicomDS == NULL) || (pLUTDataBuffer== NULL)) 
      return DICOM_ERROR_NULL_PTR; 
   if(uInputBufferSize == 0) 
      return DICOM_ERROR_PARAMETER; 
   memset(pLUTDataBuffer,0,uInputBufferSize); 
   // Get modality LUT attributes 
   uRet = L_DicomGetModalityLUTAttributes(hDicomDS, 0, &ModalityLUTAttributes, sizeof(DICOMMLUTATTRIBS), 0); 
   if(uRet != DICOM_SUCCESS) 
      return uRet; 
   // If there is no modality LUT sequence 
   // then there is no data ! 
   if(!ModalityLUTAttributes.bIsModalityLUTSequence) 
      return DICOM_ERROR_MODALITY_LUT_MISSING; 
   // The buffer should be big enough to hold the data! 
   if(!(uInputBufferSize >= ModalityLUTAttributes.LUTDescriptor.uNumberOfEntries)) 
      return DICOM_ERROR_PARAMETER; 
   // Retrieve the LUT Data (0028,3006) 
   return L_DicomGetModalityLUTData(hDicomDS, pLUTDataBuffer, uInputBufferSize, 0); 
}

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help

Introduction

Version History

Getting Started

Features of LEADTOOLS DICOM

Redistributables/Files To Be Included With Your Application

Functions:	L_DicomGetModalityLUTAttributes, L_DicomSetModalityLUT, L_DicomDeleteModalityLUT, L_ApplyModalityLUT
Topics:	LUT Encoding Overview
	LUT Encoding: Modality LUT