Class DataArrayTexture

Creates an array of textures directly from raw data, width and height and depth

Example

This creates a[name] where each texture has a different color.
// create a buffer with color data
const width = 512;
const height = 512;
const depth = 100;
const size = width * height;
const data = new Uint8Array(4 * size * depth);
for (let i = 0; i & lt; depth; i++) {
    const color = new THREE.Color(Math.random(), Math.random(), Math.random());
    const r = Math.floor(color.r * 255);
    const g = Math.floor(color.g * 255);
    const b = Math.floor(color.b * 255);
    for (let j = 0; j & lt; size; j++) {
        const stride = (i * size + j) * 4;
        data[stride] = r;
        data[stride + 1] = g;
        data[stride + 2] = b;
        data[stride + 3] = 255;
    }
}
// used the buffer to create a [name]
const texture = new THREE.DataArrayTexture(data, width, height, depth);
texture.needsUpdate = true;

See

Example: WebGL2 / materials / texture2darray
Example: WebGL2 / rendertarget / texture2darray
Official Documentation
Source

Hierarchy (view full)

Texture
- DataArrayTexture

Constructors

constructor

new DataArrayTexture(data?, width?, height?, depth?): DataArrayTexture
This creates a new THREE.DataArrayTexture | DataArrayTexture object.
Parameters
- Optionaldata: null | BufferSource
  ArrayBufferView of the texture. Default null.
- Optionalwidth: number
  Width of the texture. Default 1.
- Optionalheight: number
  Height of the texture. Default 1.
- Optionaldepth: number
  Depth of the texture. Default 1.
Returns DataArrayTexture
Remarks
The interpretation of the data depends on format and type.
Overrides Texture.constructor
- Defined in node_modules/@types/three/src/textures/DataArrayTexture.d.ts:110

Properties

`Static`DEFAULT_ANISOTROPY

DEFAULT_ANISOTROPY: number

The Global default value for .anisotropy.

Default Value

1.

`Static`DEFAULT_IMAGE

DEFAULT_IMAGE: any

The Global default value for .image.

Default Value

null.

`Static`DEFAULT_MAPPING

DEFAULT_MAPPING: Mapping

The Global default value for .mapping.

Default Value

THREE.UVMapping

`Readonly`isDataArrayTexture

isDataArrayTexture: true

Read-only flag to check if a given object is of type DataArrayTexture.

Remarks

This is a constant value

Default Value

true

magFilter

magFilter: MagnificationTextureFilter

Default Value

THREE.NearestFilter

minFilter

minFilter: MinificationTextureFilter

Default Value

THREE.NearestFilter

wrapR

wrapR: boolean

Default Value

THREE.ClampToEdgeWrapping

generateMipmaps

generateMipmaps: boolean

Default Value

false

flipY

flipY: boolean

Default Value

false

unpackAlignment

unpackAlignment: number

Default Value

1

layerUpdates

layerUpdates: Set<number>

A set of all layers which need to be updated in the texture. See DataArrayTexture.addLayerUpdate.

`Readonly`isTexture

isTexture: true

Read-only flag to check if a given object is of type Texture.

Remarks

This is a constant value

Default Value

true

`Readonly`id

id: number

Unique number for this Texture instance.

Remarks

Note that ids are assigned in chronological order: 1, 2, 3, ..., incrementing by one for each new object.

uuid

uuid: string

UUID of this object instance.

Remarks

This gets automatically assigned and shouldn't be edited.

name

name: string

Optional name of the object

Remarks

(doesn't need to be unique).

Default Value

""

source

source: Source

The data definition of a texture. A reference to the data source can be shared across textures.
This is often useful in context of spritesheets where multiple textures render the same data
but with different Texture transformations.

mipmaps

mipmaps: any[]

Array of user-specified mipmaps

Default Value

[]

mapping

mapping: AnyMapping

How the image is applied to the object.

Remarks

All Texture types except THREE.CubeTexture expect the values be THREE.Mapping

See

Texture Constants

Default Value

value of THREE.Texture.DEFAULT_MAPPING

channel

channel: number

Lets you select the uv attribute to map the texture to. 0 for uv, 1 for uv1, 2 for uv2 and 3 for
uv3.

wrapS

wrapS: Wrapping

This defines how the Texture is wrapped horizontally and corresponds to U in UV mapping.

Remarks

for WEBGL1 - tiling of images in textures only functions if image dimensions are powers of two
(2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, 2048, ...) in terms of pixels.
Individual dimensions need not be equal, but each must be a power of two. This is a limitation of WebGL1, not three.js.
WEBGL2 does not have this limitation.

See

Default Value

THREE.ClampToEdgeWrapping

wrapT

wrapT: Wrapping

This defines how the Texture is wrapped vertically and corresponds to V in UV mapping.

Remarks

See

Default Value

THREE.ClampToEdgeWrapping

anisotropy

anisotropy: number

The number of samples taken along the axis through the pixel that has the highest density of texels.

Remarks

A higher value gives a less blurry result than a basic mipmap, at the cost of more Texture samples being used.

Default

value of THREE.Texture.DEFAULT_ANISOTROPY. That is normally 1.

format

format: AnyPixelFormat

These define how elements of a 2D texture, or texels, are read by shaders.

Remarks

All Texture types except THREE.DepthTexture and THREE.CompressedPixelFormat expect the values be THREE.PixelFormat

See

Texture Constants
THREE.PixelFormat

Default Value

THREE.RGBAFormat.

type

type: TextureDataType

This must correspond to the .format.

Remarks

THREE.UnsignedByteType, is the type most used by Texture formats.

See

Texture Constants
THREE.TextureDataType

Default Value

THREE.UnsignedByteType

internalFormat

internalFormat: null | PixelFormatGPU

The GPU Pixel Format allows the developer to specify how the data is going to be stored on the GPU.

Remarks

Compatible only with WebGL2RenderingContext | WebGL 2 Rendering Context.

See

Texture Constants

Default Value

The default value is obtained using a combination of .format and .type.

matrix

matrix: Matrix3

The uv-transform matrix for the texture.

Remarks

When .matrixAutoUpdate property is true.
Will be updated by the renderer from the properties:

See

.matrixAutoUpdate

Default Value

new THREE.Matrix3()

matrixAutoUpdate

matrixAutoUpdate: boolean

Whether is to update the texture's uv-transform .matrix.

Remarks

Set this to false if you are specifying the uv-transform matrix directly.

See

.matrix

Default Value

true

offset

offset: Vector2

How much a single repetition of the texture is offset from the beginning, in each direction U and V.

Remarks

Typical range is 0.0 to 1.0.

Default Value

new THREE.Vector2(0, 0)

repeat

repeat: Vector2

How many times the texture is repeated across the surface, in each direction U and V.

Remarks

If repeat is set greater than 1 in either direction, the corresponding Wrap parameter should
also be set to THREE.RepeatWrapping or THREE.MirroredRepeatWrapping to achieve the desired tiling effect.

See

wrapS
wrapT

Default Value

new THREE.Vector2( 1, 1 )

center

center: Vector2

The point around which rotation occurs.

Remarks

A value of (0.5, 0.5) corresponds to the center of the texture.

Default Value

new THREE.Vector2( 0, 0 ), lower left.

rotation

rotation: number

How much the texture is rotated around the center point, in radians.

Remarks

Positive values are counter-clockwise.

Default Value

0

premultiplyAlpha

premultiplyAlpha: boolean

If set to true, the alpha channel, if present, is multiplied into the color channels when the texture is uploaded to the GPU.

Remarks

Note that this property has no effect for ImageBitmap.
You need to configure on bitmap creation instead. See THREE.ImageBitmapLoader | ImageBitmapLoader.

See

THREE.ImageBitmapLoader | ImageBitmapLoader.

Default Value

false

colorSpace

colorSpace: ColorSpace

The Textures | {@link Texture constants} page for details of other color spaces.

Remarks

Textures containing color data should be annotated with THREE.SRGBColorSpace or
THREE.LinearSRGBColorSpace.

See

Texture Constants
THREE.TextureDataType

Default Value

THREE.NoColorSpace

isRenderTargetTexture

isRenderTargetTexture: boolean

Indicates whether a texture belongs to a render target or not

Default Value

false

userData

userData: Record<string, any>

An object that can be used to store custom data about the texture.

Remarks

It should not hold references to functions as these will not be cloned.

Default Value

{}

version

version: number

This starts at 0 and counts how many times .needsUpdate is set to true.

Remarks

Expects a Integer

Default Value

0

pmremVersion

pmremVersion: number

Indicates whether this texture should be processed by PMREMGenerator or not (only relevant for render target
textures)

onUpdate

onUpdate: (() => void)

A callback function, called when the texture is updated (e.g., when needsUpdate has been set to true and then the texture is used).

Accessors

image

get image(): Texture3DImageData
Overridden with a record type holding data, width and height and depth.

Returns Texture3DImageData
Overrides Texture.image
- Defined in node_modules/@types/three/src/textures/DataArrayTexture.d.ts:50
set image(data): void
An image object, typically created using the THREE.TextureLoader.load | TextureLoader.load() method.
Parameters
- data: Texture3DImageData
Returns void
Remarks
This can be any image (e.g., PNG, JPG, GIF, DDS) or video (e.g., MP4, OGG/OGV) type supported by three.js.
Overrides Texture.image
- Defined in node_modules/@types/three/src/textures/DataArrayTexture.d.ts:51

needsUpdate

set needsUpdate(value): void
Set this to true to trigger an update next time the texture is used. Particularly important for setting the wrap mode.
Parameters
- value: boolean
Returns void
Inherited from Texture.needsUpdate
- Defined in node_modules/@types/three/src/textures/Texture.d.ts:365

needsPMREMUpdate

set needsPMREMUpdate(value): void
Indicates whether this texture should be processed by THREE.PMREMGenerator or not.
Parameters
- value: boolean
Returns void
Remarks
Only relevant for render target textures.

Default Value
false
Inherited from Texture.needsPMREMUpdate
- Defined in node_modules/@types/three/src/textures/Texture.d.ts:372

Methods

addLayerUpdate

addLayerUpdate(layerIndex): void
Describes that a specific layer of the texture needs to be updated. Normally when Texture.needsUpdate is
set to true, the entire compressed texture array is sent to the GPU. Marking specific layers will only transmit
subsets of all mipmaps associated with a specific depth in the array which is often much more performant.
Parameters
- layerIndex: number
Returns void
- Defined in node_modules/@types/three/src/textures/DataArrayTexture.d.ts:117

clearLayoutUpdates

clearLayoutUpdates(): void
Resets the layer updates registry. See DataArrayTexture.addLayerUpdate.

Returns void
- Defined in node_modules/@types/three/src/textures/DataArrayTexture.d.ts:122

transformUv

transformUv(uv): Vector2
Transform the UV based on the value of this texture's
.offset,
.repeat,
.wrapS,
.wrapT and
.flipY properties.
Parameters
- uv: Vector2
Returns Vector2
Inherited from Texture.transformUv
- Defined in node_modules/@types/three/src/textures/Texture.d.ts:406

updateMatrix

updateMatrix(): void
Update the texture's UV-transform .matrix from the texture properties
.offset,
.repeat,
.rotation and
.center.

Returns void
Inherited from Texture.updateMatrix
- Defined in node_modules/@types/three/src/textures/Texture.d.ts:415

clone

clone(): this
Make copy of the texture

Returns this
Remarks
Note this is not a "deep copy", the image is shared
Inherited from Texture.clone
- Defined in node_modules/@types/three/src/textures/Texture.d.ts:424

copy

copy(source): this
Parameters
- source: Texture
Returns this
Inherited from Texture.copy
- Defined in node_modules/@types/three/src/textures/Texture.d.ts:426

toJSON

toJSON(meta?): {}
Convert the texture to three.js JSON Object/Scene format.
Parameters
- Optionalmeta: string | {}
  Optional object containing metadata.
Returns {}
Inherited from Texture.toJSON
- Defined in node_modules/@types/three/src/textures/Texture.d.ts:432

dispose

dispose(): void
Frees the GPU-related resources allocated by this instance

Returns void
Remarks
Call this method whenever this instance is no longer used in your app.
Inherited from Texture.dispose
- Defined in node_modules/@types/three/src/textures/Texture.d.ts:438

addEventListener

addEventListener<T>(type, listener): void
Adds a listener to an event type.
Type Parameters
- T extends "dispose"
Parameters
- type: T
  The type of event to listen to.
- listener: EventListener<{
  dispose: {};
  }[T], T, DataArrayTexture>
  The function that gets called when the event is fired.
Returns void
Inherited from Texture.addEventListener
- Defined in node_modules/@types/three/src/core/EventDispatcher.d.ts:52
addEventListener<T>(type, listener): void
Type Parameters
- T extends string
Parameters
- type: T
- listener: EventListener<{}, T, DataArrayTexture>
Returns void
Inherited from Texture.addEventListener
- Defined in node_modules/@types/three/src/core/EventDispatcher.d.ts:56

hasEventListener

hasEventListener<T>(type, listener): boolean
Checks if listener is added to an event type.
Type Parameters
- T extends "dispose"
Parameters
- type: T
  The type of event to listen to.
- listener: EventListener<{
  dispose: {};
  }[T], T, DataArrayTexture>
  The function that gets called when the event is fired.
Returns boolean
Inherited from Texture.hasEventListener
- Defined in node_modules/@types/three/src/core/EventDispatcher.d.ts:63
hasEventListener<T>(type, listener): boolean
Type Parameters
- T extends string
Parameters
- type: T
- listener: EventListener<{}, T, DataArrayTexture>
Returns boolean
Inherited from Texture.hasEventListener
- Defined in node_modules/@types/three/src/core/EventDispatcher.d.ts:67

removeEventListener

removeEventListener<T>(type, listener): void
Removes a listener from an event type.
Type Parameters
- T extends "dispose"
Parameters
- type: T
  The type of the listener that gets removed.
- listener: EventListener<{
  dispose: {};
  }[T], T, DataArrayTexture>
  The listener function that gets removed.
Returns void
Inherited from Texture.removeEventListener
- Defined in node_modules/@types/three/src/core/EventDispatcher.d.ts:74
removeEventListener<T>(type, listener): void
Type Parameters
- T extends string
Parameters
- type: T
- listener: EventListener<{}, T, DataArrayTexture>
Returns void
Inherited from Texture.removeEventListener
- Defined in node_modules/@types/three/src/core/EventDispatcher.d.ts:78

dispatchEvent

dispatchEvent<T>(event): void
Fire an event type.
Type Parameters
- T extends "dispose"
Parameters
- event: BaseEvent<T> & {
  dispose: {};
  }[T]
  The event that gets fired.
Returns void
Inherited from Texture.dispatchEvent
- Defined in node_modules/@types/three/src/core/EventDispatcher.d.ts:84

Class DataArrayTexture

Example

See

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns DataArrayTexture

Remarks

Properties

StaticDEFAULT_ANISOTROPY

Default Value

StaticDEFAULT_IMAGE

Default Value

StaticDEFAULT_MAPPING

Default Value

ReadonlyisDataArrayTexture

Remarks

Default Value

magFilter

Default Value

minFilter

Default Value

wrapR

Default Value

generateMipmaps

Default Value

flipY

Default Value

unpackAlignment

Default Value

layerUpdates

ReadonlyisTexture

Remarks

Default Value

Readonlyid

Remarks

uuid

Remarks

name

Remarks

Default Value

source

mipmaps

Default Value

mapping

Remarks

See

Default Value

channel

wrapS

Remarks

See

Default Value

wrapT

Remarks

See

Default Value

anisotropy

Remarks

Default

format

Remarks

See

Default Value

type

Remarks

See

Default Value

internalFormat

Remarks

See

Default Value

matrix

Remarks

`Static`DEFAULT_ANISOTROPY

`Static`DEFAULT_IMAGE

`Static`DEFAULT_MAPPING

`Readonly`isDataArrayTexture

`Readonly`isTexture

`Readonly`id