love.graphics.getTextureFormats

Available since LÖVE 12.0

It has replaced love.graphics.getImageFormats and love.graphics.getCanvasFormats.

Gets the available pixel formats, and whether each is supported for the given Texture usage configuration.

Function

Synopsis

formats = love.graphics.getTextureFormats( usage )

Arguments

table usage

A table containing fields describing how the pixel formats will be used.

boolean canvas

If true, the returned formats will only be listed as supported if they can be used with a canvas-capable Texture.

boolean readable (nil)

If true, the returned formats will only be listed as supported if they can be used with the readable flag set to true for a Texture using that format, and vice versa if the field is false. When the field is nil, color pixel formats are assumed to be readable and depth/stencil formats are non-readable.

boolean computewrite (false)

If true, the returned formats will only be listed as supported if they can be used with the computewrite flag set to true for a Texture using that format.

Returns

table formats

A table containing PixelFormats as keys, and a boolean indicating whether the format is supported for the given usage configuration as values. Not all systems support all formats.

Examples

Create a canvas with the format 'rgba16f' if it is supported

local formats = love.graphics.getTextureFormats({canvas=true})
if formats.rgba16f then
    canvas = love.graphics.newCanvas(800, 600, {format="rgba16f"} )
else
    -- The 'rgba16f' format isn't supported. We could have some fallback code, or trigger a message telling the user their system is unsupported.
end

See Also

• love.graphics
• PixelFormat
• love.graphics.newCanvas
• love.graphics.newImage
• love.graphics.newTexture
• Texture

Other Languages

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info