WmpBitmapEncoder.ImageDataDiscardLevel Property

Definition

Namespace:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

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.