mirror of
https://github.com/visgl/luma.gl.git
synced 2025-12-08 17:36:19 +00:00
f05c63a0aa
* Docs: Fix hyperlinks * Update website link generation * Replace website links with actual file path
53 lines
1.6 KiB
Markdown
53 lines
1.6 KiB
Markdown
# Texture2DArray (WebGL2)
|
|
|
|
A `Texture2DArray` holds a array of textures of the same size and format. The entire array can be passed to the shader which uses an extra texture coordinate to sample from. A core feature of `Texture2DArray`s is that the entire array can passed as a single uniform to and accessed in a GLSL shader.
|
|
|
|
Texture arrays can be used as texture atlases if all textures are of the same size and format.
|
|
|
|
Most texture related functionality is implemented by and documented on the [Texture](/docs/api-reference/webgl/texture.md) base class. For additional information, see [OpenGL Wiki](https://www.khronos.org/opengl/wiki/Texture).
|
|
|
|
|
|
## Usage
|
|
|
|
Create a new texture array
|
|
```js
|
|
if (Texture2DArray.isSupported()) {
|
|
textureArray = new Texture2DArray(gl, {...});
|
|
}
|
|
```
|
|
|
|
|
|
## Members
|
|
|
|
* `handle` - The underlying `WebGLTexture`
|
|
* `target` - Always `GL.TEXTURE_2D_ARRAY`
|
|
* `depth` - the number of textures in the array
|
|
* `width` - width of the textures
|
|
* `height` - height of the textures
|
|
* `format` - format of the textures
|
|
|
|
|
|
## Methods
|
|
|
|
`Texture2DArray` is a subclass of the [Texture](/docs/api-reference/webgl/texture.md) and [Resource](/docs/api-reference/webgl/resource.md) classes and inherit all methods and members of those classes.
|
|
|
|
|
|
### Texture2DArray.isSupported(gl)
|
|
|
|
Returns true if the context supports creation of `Texture2DArrays`.
|
|
|
|
|
|
### constructor
|
|
|
|
`new Texture2DArray(gl, {parameters})`;
|
|
|
|
|
|
## Limits
|
|
|
|
* `GL.MAX_ARRAY_TEXTURE_LAYERS` - The maximum number of textures in the array (at least 256).
|
|
|
|
|
|
## Remarks
|
|
|
|
* The maximum number of textures in the array is implementation defined, it can be queried via `GL.MAX_ARRAY_TEXTURE_LAYERS` (at least 256).
|