L_DicomDeleteWindow

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomDeleteWindow(hDS, uFrameIndex, uFlags)

HDICOMDS hDS;

/* a DICOM handle */

L_UINT32 uFrameIndex;

/* index value */

L_UINT uFlags;

/* reserved for future use */

Deletes all the elements that describe window center and window width.

Parameter

Description

hDS

A DICOM handle.

uFrameIndex

A zero-based index that identifies the frame number in the dataset.  If the dataset does not support Multi-frames, this parameter is ignored.

uFlags

 0 -- Default

[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 the following elements:

Window Center (0028,1050)

Window Width (0028,1051)

Window Center & Width Explanation (0028,1055)

If the DICOM dataset has a Multi-frame Functional Groups module, the Window information will be found in the Frame VOI LUT Sequence.   The  Frame VOI LUT Sequence will be under an item in either:

(5200,9229) Shared Functional Groups Sequence

(5200,9230) Per-frame Functional Groups Sequence

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

If the  Frame VOI LUT 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  Frame VOI LUT Sequence.

The specific elements deleted are shown below:

(0028,9132) Frame VOI LUT Sequence Child Elements

Tag

Name

(0028,1050)

Window Center

(0028,1051)

Window Width

(0028,1055)

Window Center & Width Explanation

For a detailed discussion on Multi-frame Functional Groups and how the DICOM_SET_IMAGE_MFG flags are used, see the topic 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

See Also

Functions:

L_DicomGetWindowCount, L_DicomGetVOILUTCount, L_DicomGetWindow, L_DicomSetWindow, L_DicomGetVOILUT, L_DicomSetVOILUT, L_DicomGetVOILUTData, L_DicomDeleteVOILUT

Topics:

LUT Encoding Overview

 

LUT Encoding: VOI LUT

Example

For an example, refer to L_DicomSetWindow.