Click or drag to resize
GammaTransferEffect Class
Alters the colors of an image by applying a per-channel gamma transfer function.
Inheritance Hierarchy
SystemObject
  Microsoft.Graphics.Canvas.EffectsGammaTransferEffect

Namespace:  Microsoft.Graphics.Canvas.Effects
Assembly:  Microsoft.Graphics.Canvas (in Microsoft.Graphics.Canvas.dll) Version: 0.0.0.0
Syntax
C#
public sealed class GammaTransferEffect : ICanvasEffect, 
	IGraphicsEffect, IGraphicsEffectSource, ICanvasImage, IDisposable

The GammaTransferEffect type exposes the following members.

Constructors
  NameDescription
Public methodGammaTransferEffect
Initializes a new instance of the GammaTransferEffect class.
Top
Properties
  NameDescription
Public propertyAlphaAmplitude
Scales the alpha channel. Default value 1.
Public propertyAlphaDisable
Disables the alpha channel transfer function. Default value false.
Public propertyAlphaExponent
Alpha channel color adjustment exponent. Default value 1.
Public propertyAlphaOffset
Offsets the alpha channel. Default value 0.
Public propertyBlueAmplitude
Scales the blue channel. Default value 1.
Public propertyBlueDisable
Disables the blue channel transfer function. Default value false.
Public propertyBlueExponent
Blue channel color adjustment exponent. Default value 1.
Public propertyBlueOffset
Offsets the blue channel. Default value 0.
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 propertyClampOutput
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.
Public propertyGreenAmplitude
Scales the green channel. Default value 1.
Public propertyGreenDisable
Disables the green channel transfer function. Default value false.
Public propertyGreenExponent
Green channel color adjustment exponent. Default value 1.
Public propertyGreenOffset
Offsets the green channel. Default value 0.
Public propertyName
Attaches a user-defined name string to the effect.
Public propertyRedAmplitude
Scales the red channel. Default value 1.
Public propertyRedDisable
Disables the red channel transfer function. Default value false.
Public propertyRedExponent
Red channel color adjustment exponent. Default value 1.
Public propertyRedOffset
Offsets the red channel. Default value 0.
Public propertySource
Gets or sets the input source for GammaTransfer effect.
Top
Methods
  NameDescription
Public methodDispose
Releases all resources used by the effect.
Public methodGetBounds(ICanvasResourceCreator)
Retrieves the bounds of this GammaTransferEffect.
Public methodGetBounds(ICanvasResourceCreator, Matrix3x2)
Retrieves the bounds of this GammaTransferEffect.
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.
Top
Remarks

The 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