Types/Color: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
m (words)
(Clarify default-when-nil vs default-when-present, add opacity as description of alpha channel)
Line 1: Line 1:
Table of red, green, blue, and alpha float values between 0 and 1. All values are optional, default optional value for colors is 0, for alpha 1. Alternatively, values can be from 0-255, they are interpreted as such if at least one value is > 1.<br>
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.<br>
Color allows the short-hand notation of passing an array of exactly 3 or 4 numbers.<br>
Color allows the short-hand notation of passing an array of exactly 3 or 4 numbers.<br>
The game usually expects colors to be in pre-multiplied form (color channels are pre-multiplied by alpha).
The game usually expects colors to be in pre-multiplied form (color channels are pre-multiplied by alpha).

Revision as of 16:28, 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 - transparency 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