Click or drag to resize
ContrastEffect Class
Increases or decreases the contrast of an image.
Inheritance Hierarchy

Namespace:  Microsoft.Graphics.Canvas.Effects
Assembly:  Microsoft.Graphics.Canvas (in Microsoft.Graphics.Canvas.dll) Version:
public sealed class ContrastEffect : ICanvasEffect, 
	IGraphicsEffect, IGraphicsEffectSource, ICanvasImage, IDisposable

The ContrastEffect type exposes the following members.

Public methodContrastEffect
Initializes a new instance of the ContrastEffect class.
Public propertyBufferPrecision
Specifies what precision to use for intermediate buffers when drawing this effect.
Public propertyCacheOutput
Enables caching the output from drawing this effect.
Public propertyClampSource
Indicates whether to clamp input values to 0-1 range before contrast adjustment. Default value false.
Public propertyContrast
Amount by which to adjust the contrast of the image. Default value 0, range -1 to 1.
Public propertyName
Attaches a user-defined name string to the effect.
Public propertySource
Gets or sets the input source for Contrast effect.
Public methodDispose
Releases all resources used by the effect.
Public methodGetBounds(ICanvasResourceCreator)
Retrieves the bounds of this ContrastEffect.
Public methodGetBounds(ICanvasResourceCreator, Matrix3x2)
Retrieves the bounds of this ContrastEffect.
Public methodGetInvalidRectangles
Queries what regions of the effect output have changed since it was last drawn.
Public methodCode exampleGetRequiredSourceRectangle
Queries what part of an effect source image is needed to draw an output region.
Public methodGetRequiredSourceRectangles
Queries what parts of the effect source images are needed to draw an output region.
Public methodInvalidateSourceRectangle
Notifies the effect that one of its source images has changed.

The contrast function modifies each color channel value using two piecewise quadratic polynomials that meet with slope continuity at the point (0.5, 0.5).

Contrast diagram

Effect inputs and outputs are assumed to be in premultiplied alpha format, but this effect operates internally on straight alpha data, so its input values will be unpremultiplied, then the contrast adjustment applied, and finally the result converted back to premultiplied format.

This Windows Runtime type corresponds to the D2D Contrast effect.

See Also