Shader:sendColor

Available since LÖVE 0.10.0
This function is not supported in earlier versions.

Sends one or more colors to a special (uniform) vec3 or vec4 variable inside the shader. The color components must be in the range of [0, 1]. The colors are gamma-corrected if global gamma-correction is enabled.

Uniforms must be marked using the uniform keyword, e.g.

uniform vec4 Color;

The corresponding sendColor call would be

shader:sendColor("Color", {r, g, b, a})


Uniforms can be accessed in both the Vertex and Pixel stages of a shader, as long as the variable is declared in each.

In versions prior to 11.0, color component values were within the range of 0 to 255 instead of 0 to 1.

Function

Synopsis

Shader:sendColor( name, color, ... )

Arguments

string name
The name of the color uniform to send to in the shader.
table color
A table with red, green, blue, and optional alpha color components in the range of [0, 1] to send to the uniform as a vector.
table ...
Additional colors to send in case the uniform is an array. All colors need to be of the same size (e.g. only vec3's).

Returns

Nothing.

See Also

Other Languages