GammaEffect Class
An effect that modifies the gamma of the result produced by a layer or a view.
NuGet/Assembly: Carmenta.Engine.5.16.2.nupkg (in the CECore assembly)
Syntax
public class GammaEffect : EffectRemarks
 |
Note that some images may already be gamma corrected; in this case performing a second gamma correction may result in an image that looks too bright or washed out.
If raster images already gamma corrected are used then you might want to undo this correction before applying effects and then reapply the gamma correction after the image has been modified to make sure that the effect is applied in linear color space.
For example: If you want to change the brightness of an image that has already been gamma corrected with a exponent of (1.0 / 2.2), then you might want to undo the gamma correction by using the GammaEffect with gamma value (1.0 / 2.2) resulting in an exponent of 2.2 after simplification. After that you apply the BrightnessContrastEffect and then use another GammaEffect with gamma value 2.2 (exponent 1.0 / 2.2) to redo the gamma correction. Often you don't have to do this and the result from using only a BrightnessContrastEffect will be good enough, but if the correctness is important then this kind of usage is recommended.
More information and examples of gamma correction can be found at Understanding gamma correction, published by Cambridge in Colour.
Inheritance Hierarchy
System.Object (not available in C#)
EngineObject
ResourceObject
Effect
GammaEffect
Platforms
Windows, Linux, Android
GammaEffect Members
The GammaEffect type has the following members.
Constructors
| Name | Description |
|---|---|
| GammaEffect | Initializes a new instance of the GammaEffect class. |
Properties
| Name | Description |
|---|---|
| Gamma | Gets or sets the value that will be used in the formula for gamma correction. |
| IsDisposed | Gets a value that tells whether the current GammaEffect has been disposed. Inherited from EngineObject |
| Name | Gets or sets the name of the GammaEffect. Inherited from ResourceObject |
| NativeHandle | Gets the native Carmenta Engine kernel object the current GammaEffect represents. Inherited from EngineObject |
| Strength | Gets or sets the strength of the effect. Inherited from Effect |
| IUserProperties.UserProperties | Gets the AttributeSet that contains the user properties. Inherited from IUserProperties |
Methods
| Name | Description |
|---|---|
| Clone | Creates a copy of an object. Inherited from EngineObject |
| Dispose | Releases the reference to the native Carmenta Engine kernel instance the EngineObject represents. Inherited from EngineObject |
| Equals | Determines whether this instance is equal to another. Inherited from EngineObject |