# Texture3D

> This page describes deprecated components in the legacy luma.gl v8 API.

> `Texture3D` is only available in WebGL 2

3D textures hold basic volumetric textures and can be thought of 3-dimentional arrays with a width, height and depth. They hold image memory of a certain format and size, determined at initialization time. They can be sampled in shaders using the `texture` function with a 3D texture coordinate.

Most texture related functionality is implemented by and documented on the [Texture](/docs/api-reference/gltools/classes/texture) base class. For additional information, see [OpenGL Wiki](https://www.khronos.org/opengl/wiki/Texture).

## Usage

Create a new 3D texture

```typescript
if (Texture3D.isSupported()) {
  texture3D = new Texture3D(gl, {...});
}
```

## Members

- `handle` - The underlying `WebGLTexture`
- `target` - Always `GL.TEXTURE_3D`
- `width` - width of texture
- `height` - height of texture
- `depth` - depth of the texture
- `format` - format of texture

## Methods

`Texture3D` is a subclass of the [Texture](/docs/api-reference/gltools/classes/texture) and [Resource](/docs/api-reference/gltools/classes/resource) classes and inherit all methods and members of those classes. Note that `setSubImageData` is not currently supported for 3D textures.

### Texture3D.isSupported(gl)

Returns true if the context supports creation of `Texture3Ds`.

### constructor

`new Texture3D(gl, {parameters})`;

```
const texture = new Texture3D(gl, {
  width: TEXTURE_DIMENSIONS,
  height: TEXTURE_DIMENSIONS,
  depth: TEXTURE_DIMENSIONS,
  data: textureData,
  format: gl.RED,
  dataFormat: gl.R8
});
```

- `gl` (WebGLRenderingContext) - gl context
- `data`=`null` (\*) - See below.
- `width`=`0` (_Number_) - The width of the texture.
- `height`=`0` (_Number_) - The height of the texture.
- `depth`=`0` (_Number_) - The depth of the texture.
- `mipmaps`=`true` (_Boolean_) - whether to generate mipmaps
- `format` (_enum_, default `GL.RGBA`) - internal format that WebGL should use.
- `type` (_enum_, default is autodeduced from format) - type of pixel data (GL.UNSIGNED_BYTE, GL.FLOAT etc).
- `dataFormat` (_enum_, default is autodeduced from `format`) - internal format that WebGL should use.
- `parameters`=`{}` (object) - texture

## Limits

- The maximum size of a `Texture3D` (width/height/depth) is implementation defined, it can be queried via `GL.MAX_3D_TEXTURE_SIZE` (at least 256).