Updated: July 2008
Specifies which algorithm is used to scale bitmap images.
Namespace:
System.Windows.Media
Assembly:
PresentationCore (in PresentationCore.dll)
'Usage
Dim instance As BitmapScalingMode
'Declaration
Public Enumeration BitmapScalingMode
<object property="enumerationMemberName" .../>
| Member name | Description |
|---|
| Unspecified | Use the default bitmap scaling mode, which is Fant. |
| LowQuality | Use bilinear bitmap scaling, which is faster than HighQuality mode, but produces lower quality output. The LowQuality mode is the same as the Linear mode. |
| HighQuality | Use high quality bitmap scaling, which is slower than LowQuality mode, but produces higher quality output. The HighQuality mode is the same as the Fant mode. |
| Linear | Use linear bitmap scaling, which is faster than HighQuality mode, but produces lower quality output. |
| Fant | Use very high quality Fant bitmap scaling, which is slower than all other bitmap scaling modes, but produces higher quality output. |
| NearestNeighbor | Use nearest-neighbor bitmap scaling, which provides performance benefits over LowQuality mode when the software rasterizer is used. This mode is often used to magnify a bitmap. |
When animating the scale of any bitmap, the default high-quality image re-sampling algorithm can sometimes consume sufficient system resources to cause frame rate degradation. This frame rate degradation can cause animations to skip frames or stutter. By setting the BitmapScalingMode property of the RenderOptions object to LowQuality you can create a smoother animation when scaling a bitmap.
The following example shows how to set the BitmapScalingMode for an image object.
// Set the bitmap scaling mode for the image to render faster.
RenderOptions.SetBitmapScalingMode(MyImage, BitmapScalingMode.LowQuality);
Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
.NET Framework
Supported in: 3.5, 3.0
Reference
Date | History | Reason |
|---|
July 2008
| Added entries for new Fant, Linear, and NearestNeighbor enumerations. |
SP1 feature change.
|