Attention: Here be dragons (unstable version)

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Redot.

Checking the stable version of the documentation...

Texture2DArray

Inherits: ImageTextureLayered < TextureLayered < Texture < Resource < RefCounted < Object

A single texture resource which consists of multiple, separate images. Each image has the same dimensions and number of mipmap levels.

Description

A Texture2DArray is different from a Texture3D: The Texture2DArray does not support trilinear interpolation between the Images, i.e. no blending. See also Cubemap and CubemapArray, which are texture arrays with specialized cubemap functions.

A Texture2DArray is also different from an AtlasTexture: In a Texture2DArray, all images are treated separately. In an atlas, the regions (i.e. the single images) can be of different sizes. Furthermore, you usually need to add a padding around the regions, to prevent accidental UV mapping to more than one region. The same goes for mipmapping: Mipmap chains are handled separately for each layer. In an atlas, the slicing has to be done manually in the fragment shader.

To create such a texture file yourself, reimport your image files using the Redot Editor import presets.

Methods

Resource

create_placeholder() const

---

Method Descriptions

Resource create_placeholder() const 🔗

Creates a placeholder version of this resource (PlaceholderTexture2DArray).