SaveImage Method

In This Topic

Description

Save an image to a file, field or stream asynchronously

Syntax

Visual Basic
Public Sub SaveImage( _ ByVal Image As DicomImage, _ ByVal Destination As Variant, _ ByVal isPart10 As Boolean, _ Optional ByVal TransferSyntax As Variant, _ Optional ByVal Quality As Variant _ )

Visual Basic

Public Sub SaveImage( _
   ByVal Image As DicomImage, _
   ByVal Destination As Variant, _
   ByVal isPart10 As Boolean, _
   Optional ByVal TransferSyntax As Variant, _
   Optional ByVal Quality As Variant _
)

Parameters

Image: The image to be saved
Destination: The file, field or stream to which the image is to be Written.
isPart10: If TRUE, a blank 128 byte header, DICM marker, and meta-header are written at the start of the field.
If FALSE, the field is written in the unofficial, but common format, with no header, and using the little-endian implicit VR transfer syntax.
TransferSyntax: Specifies the full UID of the transfer syntax used when Part 10 format is specified. If omitted, the little-endian explicit VR transfer syntax is used. For details of the currently supported syntaxes, see the conformance entry.
Quality: The quality factor to be used.

Remarks

Destination must one of the following types of Variant:

A String The image is saved to the filename given
An object supporting IStream The image is saved to the stream (as for WriteStream)
An ADO, DAO or RDO field object The image is saved to the field (as for WriteField)
This method differs from the other DicomConnection methods in that it makes no use of an association. It is, nonetheless, included here, as it uses the same model of asynchronous operation, with completion being signaled via the ActionComplete event.
This method is designed for use by multi-tasking servers, preventing the delays to other requests that could otherwise be caused by the processing of a storage request.