WmpBitmapEncoder.AlphaDataDiscardLevel Property

Definition

Namespace:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

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

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

public byte AlphaDataDiscardLevel { get; set; }

member this.AlphaDataDiscardLevel : byte with get, set

Public Property AlphaDataDiscardLevel As Byte

Property Value

Byte

The level of alpha data to discard when encoding the image. The value range is 0 (no data discarded) to 4 (alpha channel completely 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.
4	The alpha channel is completely discarded. The pixel format is changed to reflect the removal of the alpha channel.

Exceptions

ArgumentOutOfRangeException

The value given is not between 0 and 4.

Remarks

This property has an effect only if CompressedDomainTranscode is set to true and the image contains either a planar or interleaved alpha channel; otherwise, it is ignored.