Leadtools.Dicom Namespace > DicomDataSet Class > GetImages Method : GetImages(DicomElement,Int32,Int32,Int32,RasterByteOrder,DicomGetImageFlags) Method |
Value | Meaning |
---|---|
0 | Keep the original file's pixel depth (do not convert). |
1 to 8 | Use the specified bits per pixel in the resulting image. |
12 | Use 12 bits per pixel in the resulting image. |
16 | Use 16 bits per pixel in the resulting image. |
24 | Use 24 bits per pixel in the resulting image. |
32 | Use 32 bits per pixel in the resulting image. |
public RasterImage GetImages( DicomElement element, int index, int count, int bitsPerPixel, RasterByteOrder order, DicomGetImageFlags flags )
'Declaration Public Overloads Function GetImages( _ ByVal element As DicomElement, _ ByVal index As Integer, _ ByVal count As Integer, _ ByVal bitsPerPixel As Integer, _ ByVal order As RasterByteOrder, _ ByVal flags As DicomGetImageFlags _ ) As RasterImage
'Usage Dim instance As DicomDataSet Dim element As DicomElement Dim index As Integer Dim count As Integer Dim bitsPerPixel As Integer Dim order As RasterByteOrder Dim flags As DicomGetImageFlags Dim value As RasterImage value = instance.GetImages(element, index, count, bitsPerPixel, order, flags)
public RasterImage GetImages( DicomElement element, int index, int count, int bitsPerPixel, RasterByteOrder order, DicomGetImageFlags flags )
public RasterImage getImages(DicomElement element, int index, int count, int bitsPerPixel, int order, DicomGetImageFlags flags)
function Leadtools.Dicom.DicomDataSet.GetImages(DicomElement,Int32,Int32,Int32,RasterByteOrder,DicomGetImageFlags)( element , index , count , bitsPerPixel , order , flags )
public: RasterImage^ GetImages( DicomElement^ element, int index, int count, int bitsPerPixel, RasterByteOrder order, DicomGetImageFlags flags )
Value | Meaning |
---|---|
0 | Keep the original file's pixel depth (do not convert). |
1 to 8 | Use the specified bits per pixel in the resulting image. |
12 | Use 12 bits per pixel in the resulting image. |
16 | Use 16 bits per pixel in the resulting image. |
24 | Use 24 bits per pixel in the resulting image. |
32 | Use 32 bits per pixel in the resulting image. |
If element is null, you can retrieve all images within the Data Set. To do this you must call GetImageCount with the element parameter set to null to determine the number of images in the Data Set and then set the count parameter in GetImages(DicomElement,Int32,Int32,Int32,RasterByteOrder,DicomGetImageFlags) to this value.
If DicomGetImageFlags.AllowRangeExpansion is set in flags, consider the following example:
If the Data Set 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) cannot be represented with the current bits stored (12 bits), which can represent values in the range (-2048 to 2048). In this case the method will change the high bit inside the image object to be 12 instead of 11 (bits stored becomes 13), which can represent values in the range (-8192 to 8191).
Please note that the method will not 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.
If the DICOM dataset has a Multi-frame Functional Groups module, some VOI LUT information will be read from the corresponding Frame VOI LUT Sequence, and some Modality LUT information will be read from the corresponding Pixel Value Transformation Sequence.Tag | Name |
(0028,1050) | Window Center |
(0028,1051) | Window Width |
(0028,1055) | Window Center & Width Explanation |
Tag | Name |
(0028,1052) | Rescale Intercept |
(0028,1053) | Rescale Slope |
(0028,1054) | Rescale Type |