LDicomDS::DeleteModalityLUT

#include "ltdic.h"

L_UINT16 LDicomDS::DeleteModalityLUT(uFrameIndex, uFlags)

L_UINT32 uFrameIndex;	/* index value */
L_UINT uFlags;	/* reserved for future use */

Deletes all the elements that describe the Modality LUT.

Parameter	Description
uFrameIndex	A zero-based index that identifies the frame number of in the dataset. If the dataset does not support Multi-frames, this parameter is ignored.
uFlags	Default is 0. [0x008] DICOM_SETIMAGE_MFG_OVERWRITE_SHARED If set, existing Frame VOI LUT Sequence items under the Shared Functional Groups Sequence will be deleted. If this flag is not included, Shared Functional Groups Sequence elements are unchanged.

Returns

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

Comments

This function will delete all the elements defined under the Modality LUT Module.

If the DICOM dataset has a Multi-frame Functional Groups module, the Modality LUT information will be found in the Pixel Value Transformation Sequence. The Pixel Value Transformation Sequence will be under an item in either:

(5200,9229) Shared Functional Groups Sequence
(5200,9230) Per-frame Functional Groups Sequence

If the Pixel Value Transformation Sequence is found under the Per-frame Functional Groups Sequence, parameter uFrameIndex must be set to the correct frame number so that the proper Pixel Value Transformation Sequence is removed.

If the Pixel Value Transformation Sequence is found under the Shared Functional Groups Sequence, parameter uFrameIndex is ignored. However, the DICOM_SETIMAGE_MFG_OVERWRITE_SHARED flag must be included to remove the Pixel Value Transformation Sequence.

The specific elements deleted are shown below:

(0028,9145) Pixel Value Transformation Sequence child elements

Tag	Name
(0028,1052)	Rescale Intercept
(0028,1053)	Rescale Slope
(0028,1054)	Rescale Type

For a detailed discussion of Multi-frame Functional Groups and how the DICOM_SET_IMAGE_MFG flags are used, refer to Multi-frame Functional Groups.

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

Functions:	LDicomDS::GetModalityLUTAttributes, LDicomDS::GetModalityLUTData, LDicomDS::SetModalityLUT, Class Members
Topics:	LUT Encoding Overview
	LUT Encoding: Modality LUT
	How to Disable the Automatic Loading of the default DICOM IOD Table