WmpBitmapEncoder.ImageDataDiscardLevel Property

Reference

Definition

Namespace:: System.Windows.Media.Imaging

Assembly:: PresentationCore.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the level of image data to discard during a compressed domain transcode.

public:
 property System::Byte ImageDataDiscardLevel { System::Byte get(); void set(System::Byte value); };

public byte ImageDataDiscardLevel { get; set; }

member this.ImageDataDiscardLevel : byte with get, set

Public Property ImageDataDiscardLevel As Byte

Property Value

Byte

The level of image data to discard during a compressed domain encoding of the image. The value range is 0 (no data discarded) to 3 (HighPass and LowPass discarded). The default is 1.

Value	Description
0	No image frequency data is discarded.
1	FlexBits are discarded. The image quality of the image is reduced without changing the effective resolution of the image.
2	HighPass frequency data band is discarded. The image's effective resolution is reduced by a factor of 4 in both dimensions.
3	HighPass and LowPass frequency data bands are discarded. The image's effective resolution is reduced by a factor of 16 in both dimensions.

Exceptions

ArgumentOutOfRangeException

The value given is not between 0 and 3.

Remarks

This property has an effect only if CompressedDomainTranscode is set to true; otherwise, it is ignored.

Applies to