InsertBitmapListValue method (ILEADDicomDS)

VB.NET example

C# example

Visual Basic example

Visual C++ 6.0 example

 

Syntax

short InsertBitmapListValue (long hBitmapList, long lIndex, long lCompression, long lPhotometric, short nBitsPerPixel, short nQFactor, long lFlags);

Overview

Refer to Working with Data Sets.

Remarks

This method inserts the images in the BitmapList property into the Pixel Data Element.

As an example, if you wish to insert 50 images starting with the 50th frame in the Pixel Data, call this function with lIndex set to 49 (the 50th frame in a zero-based index) and the 50 frames you wish to insert in hBitmapList.

Most DICOM files will only have one Data Element of type TAG_PIXEL_DATA. Therefore, in most instances the CurrentElement property can be NULL, since the method will automatically replace the images of the only Pixel Data Element in the file. If the CurrentElement property is not NULL, it must contain the Pixel Data Element itself.

If the DICOM file is CLASS_BASIC_DIRECTORY, the file may contain more than one Pixel Data Element. In this case you must specify in the CurrentElement property the Pixel Data Element in which the images will be replaced.

If you wish to replace only one image within the Pixel Data Element, you must use DeleteBitmapValue method and InsertBitmapValue method.

For more options when using the JPEG 2000 compression, refer to the J2KOptions property.

This function will either insert, delete or update one or more of the following elements:

Tag

Name

(7FE0,0010)

Pixel Data

(0002,0010)

Transfer Syntax UID

(0028,0101)

Bits Stored

(0028,0100)

Bits Allocated

(0028,0102)

High Bit

(0028,0103)

Pixel Representation

(0028,0010)

Rows

(0028,0011)

Columns

(0028,0002)

Samples per Pixel

(0028,0006)

Planar Configuration

(0028,0004)

Photometric Interpretation

(0028,0106)

Smallest Image Pixel Value

(0028,0107)

Largest Image Pixel Value

(0028,1101)

Red Palette Color Lookup Table Descriptor

(0028,1102)

Green Palette Color Lookup Table Descriptor

(0028,1103)

Blue Palette Color Lookup Table Descriptor

(0028,1201)

Red Palette Color Lookup Table Data

(0028,1202)

Green Palette Color Lookup Table Data

(0028,1203)

Blue Palette Color Lookup Table Data

(0028,1199)

Palette Color Lookup Table UID

(0028,1052)

Rescale Intercept

(0028,1053)

Rescale Slope

(0028,1054)

Rescale Type

(0028,1221)

Segmented Red Palette Color Lookup Table Data

(0028,1222)

Segmented Green Palette Color Lookup Table Data

(0028,1223)

Segmented Blue Palette Color Lookup Table Data

(0028,3010)

VOI LUT Sequence

(0028,1050)

Window Center

(0028,1051)

Window Width

(0028,1055)

Window Center & Width Explanation

(0028,0008)

Number of Frames

(0054,0070)

Time Slot Vector

This function is indifferent to the pixel data restrictions imposed by the various DICOM IOD classes, for example this function will allow the user to insert a colored image into a "Digital X-Ray Image Storage" dataset.

This function will always insert a "Number of Frames" (0028, 0008) element and set its value.

See Also

Elements:

GetBitmapValue method, GetBitmapListValue method, SetBitmapValue method, InsertBitmapListValue method, SetBitmapValue method, DeleteBitmapValue method

Topics:

Data Sets: Getting and Setting Data Element Values