GetBitmapListValue method (ILEADDicomDS)

VB.NET example

C# example

Visual Basic example

Visual C++ 6.0 example

Delphi example

 

 

Syntax

short GetBitmapListValue ( long lIndex, long lCount, short nBitsPerPixel, short nOrder, long lFlags );

Overview

Refer to Working with Data Sets.

Remarks

Updates the BitmapList property with the image list associated with the Pixel Data Element specified by the CurrentElement property. If the CurrentElement property is NULL, this method updates the BitmapList property with all the images present in the Data Set.

As an example, if you wish to load 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 nCount set to 50.

For a table of possible Compression, Photometric, BitsPerPixel, and Quality Factor combinations, refer to Compression Table.

 

If DICOM_GETIMAGE_ALLOW_RANGE_EXPANSION is set in lFlags, consider the
following example:

If the dataset has the following attributes:

Bits allocated 16
Bits stored 12
Pixel Range 0 - +4095
Pixel Representation is unsigned (0)
Photometric Interpretation is MONOCHROME2
Rescale Slope 1
Rescale Intercept -1024

After applying the rescale slope and the intercept:

Output minimum pixel value = (0 * 1 +(-1024)) = -1024
Output maximum pixel value = (4095 * 1 + (-1024)) = 3071

The new pixel value range (–1024 to 3071) can’t be represented with the current bits stored (12 bits), which can represent values in the range (–2048 to 2048). In this case the function will change the high bit inside the bitmap handle to be 12 instead of 11 (bits stored becomes 13), which can represent values in the range (–8192 to 8191). Please note that the function won’t be able to update the high bit and/or low bit if the number of bits stored was already equal to the number of bits allocated.

 

See Also

Elements:

BitmapList property, SetBitmapListValue method

Topics:

Data Sets: Getting and Setting Data Element Values