Public Sub InsertImage( _
   ByVal element As DicomElement, _
   ByVal image As RasterImage, _
   ByVal index As Integer, _
   ByVal compression As DicomImageCompressionType, _
   ByVal photometric As DicomImagePhotometricInterpretationType, _
   ByVal bitsPerPixel As Integer, _
   ByVal qualityFactor As Integer, _
   ByVal flags As DicomSetImageFlags _
) 

Visual Basic (Usage)

Copy Code

Dim instance As DicomDataSet Dim element As DicomElement Dim image As RasterImage Dim index As Integer Dim compression As DicomImageCompressionType Dim photometric As DicomImagePhotometricInterpretationType Dim bitsPerPixel As Integer Dim qualityFactor As Integer Dim flags As DicomSetImageFlags   instance.InsertImage(element, image, index, compression, photometric, bitsPerPixel, qualityFactor, flags)

public void InsertImage( 
   DicomElement element,
   RasterImage image,
   int index,
   DicomImageCompressionType compression,
   DicomImagePhotometricInterpretationType photometric,
   int bitsPerPixel,
   int qualityFactor,
   DicomSetImageFlags flags
)

public:
void InsertImage( 
   DicomElement^ element,
   RasterImage image,
   int index,
   DicomImageCompressionType compression,
   DicomImagePhotometricInterpretationType photometric,
   int bitsPerPixel,
   int qualityFactor,
   DicomSetImageFlags flags
) 

Parameters

element

An item in the Data Set.

image

Image to insert.

index

The zero-based index at which the image should be inserted.

compression

The type of compression to use.

photometric

Photometric constant.

bitsPerPixel

Value that represents the resulting image pixel depth. Possible values are:

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.

qualityFactor

The quality factor (Q factor) is a number that determines the degree of loss in the compression process. You can set a value from 2 to 255, where 2 is the highest quality and 255 is the most compression.

flags

Flags that control the behaviour of this method.

If the DICOM file is DicomClassType.BasicDirectory, the file may contain more than one Pixel Data Element. In this case you must specify in element the Pixel Data Element in which to insert the image.

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

For more options when using the JPEG 2000 compression, refer to DicomDataSet.Jpeg2000Options.

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

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

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

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

Reference