love.graphics.isGammaCorrect

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

Gets whether gamma-correct rendering is supported and enabled. It can be enabled by setting t.gammacorrect = true in love.conf.

Not all devices support gamma-correct rendering, in which case it will be automatically disabled and this function will return false. It is supported on desktop systems which have graphics cards that are capable of using OpenGL 3 / DirectX 10, and iOS devices that can use OpenGL ES 3.

Function

Synopsis

gammacorrect = love.graphics.isGammaCorrect( )

Arguments

None.

Returns

boolean gammacorrect: True if gamma-correct rendering is supported and was enabled in love.conf, false otherwise.

Notes

When gamma-correct rendering is enabled, many functions and objects perform automatic color conversion between sRGB and linear RGB in order for blending and shader math to be mathematically correct (which they aren't if it's not enabled.)

The colors passed into love.graphics.setColor, love.graphics.clear, and Shader:sendColor will automatically be converted from sRGB to linear RGB.

The colors set in SpriteBatches, text with per-character colors, ParticleSystems, points with per-point colors, standard Meshes, and custom Meshes which use the "VertexColor" attribute name will automatically be converted from sRGB to linear RGB when those objects are drawn.

Images will have their colors automatically converted from sRGB to linear RGB when drawing them (and when getting their pixels in a Shader), unless the flag linear = true is set when creating the Image.

Everything drawn to the screen will be blended in linear RGB and then the result will be converted to sRGB for display.

Canvases which use the "normal" or "srgb" CanvasFormat will have their content blended in linear RGB and the result will be stored in the canvas in sRGB, when drawing to them. When the Canvas itself is drawn, its pixel colors will be converted from sRGB to linear RGB in the same manner as Images. Keeping the canvas pixel data stored as sRGB allows for better precision (less banding) for darker colors compared to "rgba8".

Because most conversions are automatically handled, your own code doesn't need to worry about sRGB and linear RGB color conversions when gamma-correct rendering is enabled, except in a couple cases:

If a Mesh with custom vertex attributes is used and one of the attributes is meant to be used as a color in a Shader, and the attribute isn't named "VertexColor".

If a Shader is used which has uniform / extern variables or other variables that are meant to be used as colors, and Shader:sendColor isn't used.

In both cases, love.math.gammaToLinear can be used to convert color values to linear RGB in Lua code, or the gammaCorrectColor (or unGammaCorrectColor if necessary) shader functions can be used inside shader code. Those shader functions only do conversions if gamma-correct rendering is actually enabled. The LOVE_GAMMA_CORRECT shader preprocessor define will be set if so.

Read more about gamma-correct rendering here, here, and here.

love.graphics.isGammaCorrect