Class LookupTexture

A 3D lookup texture (LUT).

This texture can be used as-is in a WebGL 2 context. It can also be converted into a 2D texture.

Hierarchy

  • Data3DTexture
    • LookupTexture

Constructors

constructor

Properties

anisotropy center channel colorSpace domainMax domainMin flipY format generateMipmaps id internalFormat isData3DTexture isRenderTargetTexture isTexture magFilter mapping matrix matrixAutoUpdate minFilter mipmaps name offset onUpdate pmremVersion premultiplyAlpha repeat rotation source type unpackAlignment userData uuid version wrapR wrapS wrapT DEFAULT_ANISOTROPY DEFAULT_IMAGE DEFAULT_MAPPING

Accessors

image isLookupTexture3D needsPMREMUpdate needsUpdate

Methods

addEventListener applyLUT clone convertLinearToSRGB convertSRGBToLinear convertToFloat convertToRGBA convertToUint8 copy dispatchEvent dispose hasEventListener removeEventListener scaleUp toDataTexture toJSON transformUv updateMatrix createNeutral from

Constructors

constructor

  • new LookupTexture(data, size): LookupTexture

  • Constructs a cubic 3D lookup texture.

    Parameters

    • data: ArrayBufferView

      The pixel data. The default format is RGBA.

    • size: number

      The sidelength.

    Returns LookupTexture

Properties

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.

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.

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.

colorSpace

colorSpace: ColorSpace

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

Remarks

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

See

Default Value

THREE.NoColorSpace

domainMax

domainMax: Vector3

The upper bounds of the input domain.

domainMin

domainMin: Vector3

The lower bounds of the input domain.

flipY

flipY: boolean

Default Value

false

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

Default Value

THREE.RGBAFormat.

generateMipmaps

generateMipmaps: boolean

Default Value

false

Readonlyid

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.

internalFormat

internalFormat: 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.

ReadonlyisData3DTexture

isData3DTexture: true

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

Remarks

This is a constant value

Default Value

true

isRenderTargetTexture

isRenderTargetTexture: boolean

Indicates whether a texture belongs to a render target or not

Default Value

false

ReadonlyisTexture

isTexture: true

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

Remarks

This is a constant value

Default Value

true

magFilter

magFilter: MagnificationTextureFilter

Default Value

THREE.NearestFilter

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

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

minFilter

minFilter: MinificationTextureFilter

Default Value

THREE.NearestFilter

mipmaps

mipmaps: CompressedTextureMipmap[] | CubeTexture[] | HTMLCanvasElement[]

Array of user-specified mipmaps

Default Value

[]

name

name: string

Optional name of the object

Remarks

(doesn't need to be unique).

Default Value

""

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)

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).

pmremVersion

pmremVersion: number

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

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

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

Default Value

new THREE.Vector2( 1, 1 )

rotation

rotation: number

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

Remarks

Positive values are counter-clockwise.

Default Value

0

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.

type

type: TextureDataType

This must correspond to the .format.

Remarks

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

See

Default Value

THREE.UnsignedByteType

unpackAlignment

unpackAlignment: number

Default Value

1

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

{}

uuid

uuid: string

UUID of this object instance.

Remarks

This gets automatically assigned and shouldn't be edited.

version

version: number

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

Remarks

Expects a Integer

Default Value

0

wrapR

wrapR: Wrapping

Default Value

THREE.ClampToEdgeWrapping

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

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

StaticDEFAULT_ANISOTROPY

DEFAULT_ANISOTROPY: number

The Global default value for .anisotropy.

Default Value

1.

StaticDEFAULT_IMAGE

DEFAULT_IMAGE: any

The Global default value for Texture.image | .image.

Default Value

null.

StaticDEFAULT_MAPPING

DEFAULT_MAPPING: Mapping

The Global default value for .mapping.

Default Value

THREE.UVMapping

Accessors

image

  • get image(): Texture3DImageData

  • Overridden with a record type holding data, width and height and depth.

    Returns Texture3DImageData

  • 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.

isLookupTexture3D

  • get isLookupTexture3D(): boolean

  • Indicates that this is an instance of LookupTexture3D.

    Returns boolean

    Deprecated

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

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

Methods

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, LookupTexture>

      The function that gets called when the event is fired.

    Returns void

applyLUT

clone

  • clone(): this

  • Make copy of the texture

    Returns this

    Remarks

    Note this is not a "deep copy", the image is shared

convertLinearToSRGB

convertSRGBToLinear

convertToFloat

convertToRGBA

  • convertToRGBA(): LookupTexture

  • Converts this LUT into RGBA data.

    Returns LookupTexture

    This texture.

    Deprecated

    LUTs are RGBA by default since three r137.

convertToUint8

  • convertToUint8(): LookupTexture

  • Converts the LUT data into unsigned byte data.

    This is a lossy operation which should only be performed after all other transformations have been applied.

    Returns LookupTexture

    This texture.

copy

  • copy(source): this

  • Parameters

    • source: Texture

    Returns this

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

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.

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, LookupTexture>

      The function that gets called when the event is fired.

    Returns boolean

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, LookupTexture>

      The listener function that gets removed.

    Returns void

scaleUp

  • scaleUp(size, transferData?): Promise<LookupTexture>

  • Scales this LUT up to a given target size using tetrahedral interpolation.

    Parameters

    • size: number

      The target sidelength.

    • OptionaltransferData: boolean

      Extra fast mode. Set to false to keep the original data intact.

    Returns Promise<LookupTexture>

    A promise that resolves with a new LUT upon completion.

toDataTexture

  • toDataTexture(): DataTexture

  • Converts this LUT into a 2D data texture.

    Please note that custom input domains are not carried over to 2D textures.

    Returns DataTexture

    The texture.

toJSON

  • toJSON(meta?): TextureJSON

  • Convert the texture to three.js JSON Object/Scene format.

    Parameters

    • Optionalmeta: string | {}

      Optional object containing metadata.

    Returns TextureJSON

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

updateMatrix

StaticcreateNeutral

  • createNeutral(size): LookupTexture

  • Creates a neutral 3D LUT.

    Parameters

    • size: number

      The sidelength.

    Returns LookupTexture

    A neutral 3D LUT.

Staticfrom

  • from(texture): LookupTexture

  • Creates a new 3D LUT by copying a given LUT.

    Common image-based textures will be converted into 3D data textures.

    Parameters

    • texture: Texture

      The LUT. Assumed to be cubic.

    Returns LookupTexture

    A new 3D LUT.

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods