Types/Color: Difference between revisions
Jump to navigation
Jump to search
(Clarify default-when-nil vs default-when-present, add opacity as description of alpha channel) |
m (transparency -> opacity in letter descriptions) |
||
Line 12: | Line 12: | ||
| b || [optional, default 0] blue value || [[Types/float|float]] | | b || [optional, default 0] blue value || [[Types/float|float]] | ||
|- | |- | ||
| a || [optional, default 1] alpha value - | | a || [optional, default 1] alpha value - opacity || [[Types/float|float]] | ||
|} | |} | ||
Revision as of 16:34, 3 August 2021
Table of red, green, blue, and alpha (opacity) float values between 0 and 1. When color is nil, the default tint is {1, 1, 1, 1}. When there is a table, all values are optional. The default optional value for colors is 0, for alpha 1 (fully opaque). Alternatively, values can be from 0-255, they are interpreted as such if at least one value is > 1.
Color allows the short-hand notation of passing an array of exactly 3 or 4 numbers.
The game usually expects colors to be in pre-multiplied form (color channels are pre-multiplied by alpha).
name | meaning | type |
---|---|---|
r | [optional, default 0] red value | float |
g | [optional, default 0] green value | float |
b | [optional, default 0] blue value | float |
a | [optional, default 1] alpha value - opacity | float |
Examples
color = {r=1, g=0, b=0, a=0.5} -- red color = {r=1, a=0.5} -- the same red, omitting 0 colors color = {1, 0, 0, 0.5} -- also the same red color = {0, 0, 1} -- blue color = {} -- black