TextureType

Available since LÖVE 0.11.0

This enum is not supported in earlier versions.

Types of textures (2D, cubemap, etc.)

Constants

2d

Regular 2D texture with width and height.

array

Several same-size 2D textures organized into a single object. Similar to a texture atlas / sprite sheet, but avoids sprite bleeding and other issues.

cube

Cubemap texture with 6 faces. Requires a custom shader (and Shader:send) to use. Sampling from a cube texture in a shader takes a 3D direction vector instead of a texture coordinate.

volume

3D texture with width, height, and depth. Requires a custom shader to use. Volume textures can have texture filtering applied along the 3rd axis.

Notes

Array textures can be rendered with love.graphics.drawLayer, with love.graphics.draw and a Quad via Quad:setLayer, or by sending it to a custom Shader. When getting the pixels of a layer of an Array Texture in a shader, a third texture coordinate component is used to choose which layer to get.

When using a custom Shader, each texture type has a different name for its GLSL type.

• Image (or sampler2D) is a 2D texture.
• ArrayImage (or sampler2DArray) is an array texture.
• CubeImage (or samplerCube) is a cubemap texture.
• VolumeImage (or sampler3D) is a volume texture.

The Texel shader function can be used to sample from all types of textures in a shader. Texel is recommended instead of texture2D, textureCube etc., because the latter do not work across all versions of GLSL supported by LÖVE, whereas Texel does (GLSL 3 removed texture2D and added a generic texture function).

Each texture type has a different maximum size on a user's system. Use love.graphics.getSystemLimits to check.

Not all texture types are supported by all systems. love.graphics.getTextureTypes can check for support.

2D and cube texture types are supported everywhere. Array textures require a system that supports OpenGL 3 or OpenGL ES 3. Volume / 3D textures require a system that supports OpenGL 2 or OpenGL ES 3.

See Also

• love.graphics
• Texture
• Texture:getTextureType
• love.graphics.newImage
• love.graphics.newArrayImage
• love.graphics.newCubeImage
• love.graphics.newVolumeImage
• love.graphics.newCanvas
• love.graphics.drawLayer

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