DicomJpeg2000Options Structure

Summary

The DicomJpeg2000Options structure provides information for JPEG 2000 compression options.

Syntax

C++

public struct DicomJpeg2000Options

Public Structure DicomJpeg2000Options  
   Inherits System.ValueType

public value class DicomJpeg2000Options : public System.ValueType

Remarks

The resulting stream size / compression ratio can be determined in several ways. Depending on the value set in the CompressionControl property, the user can set the size of the target JPEG 2000 stream, the actual compression ratio to use during compression or the quality factor to use during compression. If CompressionControl is set to Ratio, then the compression to use is based on the compression ratio in the CompressionRatio property. If CompressionControl is set to TargetSize, the compression to use is based on the desired target stream size in the TargetFileSize property. If CompressionControl is set to QualityFactor, then compression is used based on the quality factor passed to any of the methods which can be used to replace or insert image(s) in the Pixel Data Element.
The UseSopMarker and the UseEphMarker indicate whether to include markers at the "Start of Packet" and "End of Packet Header". These markers help detect file corruption during transmission.
There are two types of quantization for lossy compression, Scalar Derived Quantization and Scalar Expounded Quantization. In Scalar Derived Quantization mantissa and exponent values for the LL Subband only are signaled. The mantissa and exponent for the other subbands are derived from the mantissa and exponent signaled for the LL subband.
In Scalar Expounded Quantization, the mantissa and exponent values for each subband are signaled.
The quantization step size for a subband is determined based on the following equation, where R = bpp for the subband: Quantization Step = (2 (R - Exponent) ) * [1 + (Mantissa / 2048)]
The values of the ImageAreaHorizontalOffset , ImageAreaVerticalOffset, ReferenceTileWidth, ReferenceTileHeight, TileHorizontalOffset and TileVerticalOffset class properties are used to create tiles within the image. Arbitrary tile sizes are allowed. All tiles are the same size, except for the border tiles. Each tile can be compressed individually. This can decrease memory usage while the program is running, but can also generate artifacts at the edges of the tiles. Artifacts generally increase as the size of the tile decreases. By default, there is one tile that contains the entire image.