| GammaTransferEffect Class |
Alters the colors of an image by applying a per-channel gamma transfer function.
Inheritance HierarchySystemObject
Microsoft.Graphics.Canvas.EffectsGammaTransferEffect
Microsoft.Graphics.Canvas.EffectsGammaTransferEffect
Namespace: Microsoft.Graphics.Canvas.Effects
Assembly: Microsoft.Graphics.Canvas (in Microsoft.Graphics.Canvas.dll) Version: 0.0.0.0
SyntaxC#
public sealed class GammaTransferEffect : ICanvasEffect, IGraphicsEffect, IGraphicsEffectSource, ICanvasImage, IDisposable
The GammaTransferEffect type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | GammaTransferEffect | Initializes a new instance of the GammaTransferEffect class. |
Properties| Name | Description | |
|---|---|---|
 | AlphaAmplitude | Scales the alpha channel. Default value 1. |
| AlphaDisable | Disables the alpha channel transfer function. Default value false. |
| AlphaExponent | Alpha channel color adjustment exponent. Default value 1. |
| AlphaOffset | Offsets the alpha channel. Default value 0. |
| BlueAmplitude | Scales the blue channel. Default value 1. |
| BlueDisable | Disables the blue channel transfer function. Default value false. |
| BlueExponent | Blue channel color adjustment exponent. Default value 1. |
| BlueOffset | Offsets the blue channel. Default value 0. |
| BufferPrecision | Specifies what precision to use for intermediate buffers when drawing this effect. |
| CacheOutput | Enables caching the output from drawing this effect. |
| ClampOutput | If set, the effect clamps color values to between 0 and 1 before passing
them on to the next effect in the graph. If false, the effect will not clamp
values, although subsequent effects or the output surface may later clamp if
they are not of high enough precision. Default value false. |
| GreenAmplitude | Scales the green channel. Default value 1. |
| GreenDisable | Disables the green channel transfer function. Default value false. |
| GreenExponent | Green channel color adjustment exponent. Default value 1. |
| GreenOffset | Offsets the green channel. Default value 0. |
| Name | Attaches a user-defined name string to the effect. |
| RedAmplitude | Scales the red channel. Default value 1. |
| RedDisable | Disables the red channel transfer function. Default value false. |
| RedExponent | Red channel color adjustment exponent. Default value 1. |
| RedOffset | Offsets the red channel. Default value 0. |
| Source | Gets or sets the input source for GammaTransfer effect. |
Methods| Name | Description | |
|---|---|---|
| Dispose | Releases all resources used by the effect. |
| GetBounds(ICanvasResourceCreator) | Retrieves the bounds of this GammaTransferEffect. |
| GetBounds(ICanvasResourceCreator, Matrix3x2) | Retrieves the bounds of this GammaTransferEffect. |
| GetInvalidRectangles | Queries what regions of the effect output have changed since it was last drawn. |
 | GetRequiredSourceRectangle | Queries what part of an effect source image is needed to draw an output region. |
| GetRequiredSourceRectangles | Queries what parts of the effect source images are needed to draw an output region. |
| InvalidateSourceRectangle | Notifies the effect that one of its source images has changed. |
RemarksThe gamma transfer function is evaluated separately for each color channel:
result = pow(input, exponent) * amplitude + offset
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 transfer function applied, and finally the result converted back to premultiplied format.
This Windows Runtime type corresponds to the D2D Gamma transfer effect.
See Also