BitmapScalingMode BitmapScalingMode BitmapScalingMode BitmapScalingMode Enum

Definition

Specifies which algorithm is used to scale bitmap images.

public enum class BitmapScalingMode
public enum BitmapScalingMode
type BitmapScalingMode = 
Public Enum BitmapScalingMode
Inheritance
BitmapScalingModeBitmapScalingModeBitmapScalingModeBitmapScalingMode

Fields

Fant Fant Fant Fant 2

Use very high quality Fant bitmap scaling, which is slower than all other bitmap scaling modes, but produces higher quality output.

HighQuality HighQuality HighQuality 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.

Linear Linear Linear Linear 1

Use linear bitmap scaling, which is faster than HighQuality mode, but produces lower quality output.

LowQuality LowQuality LowQuality 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.

NearestNeighbor NearestNeighbor NearestNeighbor 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.

Unspecified Unspecified Unspecified Unspecified 0

Use the default bitmap scaling mode, which is Linear.

Examples

The following example shows how to set the 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 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.

Applies to

See Also