DicomObjects.NET.8.48 Documentation
DicomObjects Namespace / DicomDataSet Class / Export Method / Export(String,String,Object) Method

The name of the file to export

The type of export operation to perform

The quality factor to be used. This is a generic compression quality depending on the Transfer Syntax used. This can be an integer that specifies the value stored in the System.Drawing.Imaging.EncoderParameter object for Bitmap export. This value for JPEG Baseline and JPEG Extended compression represents an integer between 0 – 100. This tells DicomObjects to set up the compressor to try to achieve the quality in percentage (higher quality value towards 100 means better quality and lower compression ratio). And for JPEG-LS Lossy and JPEG2000 Lossy compression this value is actually the desired compression ratio, i.e. if you set the quality value to 10, it tells DicomObjects to try to achieve compression ratio of 10. The actual compression ratio achieved will not be exactly the same as specified by quality value but close enough. The actual compression ratio is calculated based on the original data size and the compressed data size before it is added to “Lossy Image Compression Ratio” tag of the image. For Video compression, this value directly corresponds to the BitsPerSecond of the compressed video.







Export(String,String,Object) Method
Copy the image data to an external file format, with control of FileName, Format and Quality
Syntax
'Declaration
 
Public Overloads Sub Export( _
   ByVal FileName As System.String, _
   Optional ByVal Format As System.String, _
   Optional ByVal Quality As System.Object _
) 
 
'Usage
 
Dim instance As DicomDataSet
Dim FileName As System.String
Dim Format As System.String
Dim Quality As System.Object
 
instance.Export(FileName, Format, Quality)

Parameters

FileName

The name of the file to export

Format

The type of export operation to perform

Quality

The quality factor to be used. This is a generic compression quality depending on the Transfer Syntax used. This can be an integer that specifies the value stored in the System.Drawing.Imaging.EncoderParameter object for Bitmap export. This value for JPEG Baseline and JPEG Extended compression represents an integer between 0 – 100. This tells DicomObjects to set up the compressor to try to achieve the quality in percentage (higher quality value towards 100 means better quality and lower compression ratio). And for JPEG-LS Lossy and JPEG2000 Lossy compression this value is actually the desired compression ratio, i.e. if you set the quality value to 10, it tells DicomObjects to try to achieve compression ratio of 10. The actual compression ratio achieved will not be exactly the same as specified by quality value but close enough. The actual compression ratio is calculated based on the original data size and the compressed data size before it is added to “Lossy Image Compression Ratio” tag of the image. For Video compression, this value directly corresponds to the BitsPerSecond of the compressed video.

Remarks

Any of the formats supported via Image.Save(...) or via internal codecs are supported

Requirements

Target Platforms: .NET CLR 4.8 or higher

See Also