BitmapScalingMode Enum
Definition
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.
Specifies which algorithm is used to scale bitmap images.
public enum class BitmapScalingModepublic enum BitmapScalingModetype BitmapScalingMode = Public Enum BitmapScalingMode- Inheritance
Fields
| Name | Value | Description |
|---|---|---|
| Unspecified | 0 | Use the default bitmap scaling mode, which is Linear. |
| Linear | 1 | Use linear bitmap scaling, which is faster than HighQuality mode, but produces lower quality output. |
| LowQuality | 1 | 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. |
| Fant | 2 | Use very high quality Fant bitmap scaling, which is slower than all other bitmap scaling modes, but produces higher quality output. |
| HighQuality | 2 | 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. |
| NearestNeighbor | 3 | 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. |
Examples
The following example shows how to use the RenderOptions.SetBitmapScalingMode method to set the bitmap scale mode to LowQuality for an image object:
// Set the bitmap scaling mode for the image to render faster.
RenderOptions.SetBitmapScalingMode(MyImage, BitmapScalingMode.LowQuality);
' Set the bitmap scaling mode for the image to render faster.
RenderOptions.SetBitmapScalingMode(MyImage, BitmapScalingMode.LowQuality)
Remarks
When animating the scale of any bitmap, the default high-quality image resampling 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 RenderOptions.BitmapScalingMode property to LowQuality, you can create a smoother animation when scaling a bitmap.
