ColorCorrectionEffect
Adjusts color-related properties of the rendered world like saturation, tint, brightness, and contrast.
Memory category | Instances |
---|
Member index 4
Removed member index 1
History | Member | |
---|---|---|
631 | TonemapperPreset: TonemapperPreset |
Description
The ColorCorrectionEffect can be used to adjust several color-related properties at once: Saturation, TintColor, Brightness and Contrast. It's useful for fine-tuning the visual aesthetic of a world or communicating status effects to the player. Multiple ColorCorrectionEffect objects can be applied at once and they will compose their effects together.
Like other post-processing effects, ColorCorrectionEffect will only work while Enabled and when parented to Lighting or Workspace.CurrentCamera. Also, it may render differently depending on your Studio settings (see the Quality Level settings in Rendering → Performance).
For more details on this effect and others, see Post-Processing Effects.
History 19
- 631 Remove TonemapperPreset
- 629 Add TonemapperPreset
- 553 Change Default of TintColor from to Color3(1, 1, 1)
- 553 Change Default of Saturation from to 0
- 553 Change Default of Contrast from to 0
- 553 Change Default of Brightness from to 0
- 486 Change ThreadSafety of TintColor from ReadOnly to ReadSafe
- 486 Change ThreadSafety of Saturation from ReadOnly to ReadSafe
- 486 Change ThreadSafety of Contrast from ReadOnly to ReadSafe
- 486 Change ThreadSafety of Brightness from ReadOnly to ReadSafe
- 462 Change ThreadSafety of TintColor from to ReadOnly
- 462 Change ThreadSafety of Saturation from to ReadOnly
- 462 Change ThreadSafety of Contrast from to ReadOnly
- 462 Change ThreadSafety of Brightness from to ReadOnly
- 243 Add TintColor
- 243 Add Saturation
- 243 Add Contrast
- 243 Add Brightness
- 243 Add ColorCorrectionEffect
Members 4
Brightness
Type | Default | |
---|---|---|
float | 0 |
Brightness determines by how much the colors of pixels will be shifted. A value of -1 will cause all pixels to be completely black while a value of 1 will cause them to be white.
Thread safety | ReadSafe |
---|---|
Category | State |
Loaded/Saved | true |
History 4
- 553 Change Default of Brightness from to 0
- 486 Change ThreadSafety of Brightness from ReadOnly to ReadSafe
- 462 Change ThreadSafety of Brightness from to ReadOnly
- 243 Add Brightness
Contrast
Type | Default | |
---|---|---|
float | 0 |
Contrast determines the separation between the dark and light colors. Values less than 0 have reduced contrast while values greater than 0 have increased contrast.
Thread safety | ReadSafe |
---|---|
Category | State |
Loaded/Saved | true |
Saturation
Type | Default | |
---|---|---|
float | 0 |
Saturation determines the change in intensity of pixel colors. Values above 1 will cause colors to be more vivid while values below 0 will make colors more dull, eventually reaching full desaturation at -1.
Thread safety | ReadSafe |
---|---|
Category | State |
Loaded/Saved | true |
History 4
- 553 Change Default of Saturation from to 0
- 486 Change ThreadSafety of Saturation from ReadOnly to ReadSafe
- 462 Change ThreadSafety of Saturation from to ReadOnly
- 243 Add Saturation
TintColor
Type | Default | |
---|---|---|
Color3 | 1, 1, 1 |
Determines by what factors the RGB channels of pixel colors are scaled.
The effect is multiplicative, so changing this to [255, 0, 0]
(red)
would cause the green and blue channels to be multiplied by 0.
Thread safety | ReadSafe |
---|---|
Category | State |
Loaded/Saved | true |
Removed members 1
TonemapperPreset
Type | Default | |
---|---|---|
TonemapperPreset | Default |
Thread safety | ReadSafe |
---|---|
Category | State |
Loaded/Saved | true |
History 2
- 631 Remove TonemapperPreset
- 629 Add TonemapperPreset