←Select platform

GetImage Method

Summary

Gets an image from a DICOM object with the preferred compression options.

Syntax

C++

public byte[] GetImage( 
   string sopInstanceUID, 
   int frameNumber, 
   int imageWidth, 
   int imageHeight, 
   string mimeType, 
   int bitsPerPixel, 
   int qualityFactor, 
   string extraData 
)

  
Public Function GetImage( _ 
   ByVal sopInstanceUID As String, _ 
   ByVal frameNumber As Integer, _ 
   ByVal imageWidth As Integer, _ 
   ByVal imageHeight As Integer, _ 
   ByVal mimeType As String, _ 
   ByVal bitsPerPixel As Integer, _ 
   ByVal qualityFactor As Integer, _ 
   ByVal extraData As String _ 
) As Byte()

public: 
array<byte>^ GetImage(  
   String^ sopInstanceUID, 
   int frameNumber, 
   int imageWidth, 
   int imageHeight, 
   String^ mimeType, 
   int bitsPerPixel, 
   int qualityFactor, 
   String^ extraData 
)

Parameters

sopInstanceUID
The SOP Instance UID of the DICOM object.

frameNumber
A 1-based number of the frame you want to retrieve from the image. Pass 0 to get a representative frame and -1 to get the complete image with all frames.

imageWidth
The width, in pixels, of the image. The returned image can have a different width(to preserve scale ratio). Pass 0 to keep the original width.

imageHeight
The height, in pixels, of the image. The returned image can have a different height(to preserve scale ratio). Pass 0 to keep the original height.

mimeType
A System.String representing the file format and compression of the image. Check the Leadtools.Dicom.Services.DataTypes.SupportedImageFormat class for supported file formats and compression.

bitsPerPixel
Resulting image's pixel depth. Note that not all bits per pixel are available to all image formats. If bitsPerPixel is 0, the image will be stored using the original or closest bits/pixel value supported by that format.

qualityFactor
The quality factor (Q factor) is a number that determines the degree of loss in the compression process. Use 0 for Lossless compression or you can set a value from 2 to 255, where 2 is the highest quality and 255 is the most compression.

extraData
User custom data.

Return Value

A buffer containing the image file (e.g. JPEG, TIFF).

Remarks

NOTE: When the mime type is set to ("application/gzip"), and the image is 12-bit/16-bit grayscale, a specially formatted result will be returned. The data will be compressed XML data, where the compression is of gzip data format, which uses an industry standard algorithm for lossless file compression and decompression. You may use the Microsoft System.IO.Compression.GZipStream class to decompress this buffer.

The XML text is ASCII encoded, with the following structure:

<?xml version='1.0'?> <doc title='_lt_zipped_gray'> <LUT>EBAQE…………BAAA</LUT> <Data>wD+wP…………8AP8A/sD+w</Data> <Width>640</Width> <Height>480</Height> <BitsPerPixel>16</BitsPerPixel> <MinValue>63</MinValue> <MaxValue>1022</MaxValue> </doc> The XML represents an uncompressed Leadtools.RasterImage with the following fields: // original list //

LUT: 16bits/12bits lookup table, each entry is of 3 bytes, Red, Green then Blue components. Please refer to RasterImage.GetLookupTable. //
Data: This is the image buffer (uncompressed), the result of calling RasterImage.GetRow for each row of the image. //
Width: This is the image's width, see RasterImage.Width. //
Height: This is the image's height, see RasterImage.Height. //
BitsPerPixel: This is the image's bits per pixel, see RasterImage.BitsPerPixel. //
MinValue: This is the image's minimum grayscale value, see RasterImage.MinValue. //
MaxValue: This is the image's maximum grayscale value, see RasterImage.MaxValue. //
LUT: 16bits/12bits lookup table, each entry is of 3 bytes, Red, Green then Blue components. Please refer to RasterImage.GetLookupTable.
Data: This is the image buffer (uncompressed), the result of calling RasterImage.GetRow for each row of the image.
Width: This is the image's width, see RasterImage.Width.
Height: This is the image's height, see RasterImage.Height.
BitsPerPixel: This is the image's bits per pixel, see RasterImage.BitsPerPixel.
MinValue: This is the image's minimum grayscale value, see RasterImage.MinValue.
MaxValue: This is the image's maximum grayscale value, see RasterImage.MaxValue.

Requirements

Target Platforms

Reference

DICOMService Class

DICOMService Members

Help Version 19.0.2017.10.27

Leadtools.Dicom.WCF Assembly

Introduction

Getting Started

Namespaces

Leadtools.Dicom.WCF Namespace

Assemblies