Engine API Reference - v2.12.2
    Preparing search index...

    Class Texture

    Represents a texture, which is typically an image composed of pixels (texels). Textures are fundamental resources for rendering graphical objects. They are commonly used by Materials and sampled in Shaders (usually fragment shaders) to define the visual appearance of a 3D model's surface. Beyond storing color images, textures can hold various data types like normal maps, environment maps (cubemaps), or custom data for shader computations. Key properties control how the texture data is sampled, including filtering modes and coordinate wrapping.

    Note on HDR texture format support:

    1. As textures:

    2. As renderable textures that can be used as color buffers in a RenderTarget:

    Index

    Constructors

    constructor

    Properties

    _invalid _lockedLevel _lockedMode _numLevels _numLevelsRequested _storage id name

    Accessors

    addressU addressV addressW anisotropy array arrayLength compareFunc compareOnRead cubemap depth flipY format height magFilter minFilter mipmaps numLevels pot srgb storage volume width

    Methods

    destroy getSource lock setSource unlock upload

    Constructors

    • Create a new Texture instance.

      Parameters

      Returns Texture

      // Create a 8x8x24-bit texture
      const texture = new pc.Texture(graphicsDevice, {
          width: 8,
          height: 8,
          format: pc.PIXELFORMAT_RGB8
      });

      // Fill the texture with a gradient
      const pixels = texture.lock();
      const count = 0;
      for (let i = 0; i < 8; i++) {
          for (let j = 0; j < 8; j++) {
              pixels[count++] = i * 32;
              pixels[count++] = j * 32;
              pixels[count++] = 255;
          }
      }
      texture.unlock();

    Properties

    Protected_invalid

    _invalid: boolean = false

    Protected_lockedLevel

    _lockedLevel: number = -1

    Protected_lockedMode

    _lockedMode: number = TEXTURELOCK_NONE

    Protected_numLevels

    _numLevels: number = 0

    Protected_numLevelsRequested

    _numLevelsRequested: undefined | number

    Protected_storage

    _storage: boolean = false
    id: number = ...
    name: string

    The name of the texture.

    Accessors

    • get anisotropy(): number

      Gets the integer value specifying the level of anisotropy to apply to the texture.

      Returns number

    • set anisotropy(v: number): void

      Sets the integer value specifying the level of anisotropy to apply to the texture. The value ranges from 1 (no anisotropic filtering) to the maximum anisotropy supported by the graphics device (see GraphicsDevice#maxAnisotropy).

      Parameters

      • v: number

      Returns void

    • get arrayLength(): number

      Returns the number of textures inside this texture if this is a 2D array texture or 0 otherwise.

      Returns number

    • get flipY(): boolean

      Gets whether the texture should be flipped in the Y-direction.

      Returns boolean

    • set flipY(flipY: boolean): void

      Sets whether the texture should be flipped in the Y-direction. Only affects textures with a source that is an image, canvas or video element. Does not affect cubemaps, compressed textures or textures set from raw pixel data. Defaults to true.

      Parameters

      • flipY: boolean

      Returns void

    • get srgb(): boolean

      Returns true if the texture is stored in an sRGB format, meaning it will be converted to linear space when sampled. Returns false if the texture is stored in a linear format.

      Returns boolean

    Methods

    • Get the pixel data of the texture. If this is a cubemap then an array of 6 images will be returned otherwise a single image.

      Parameters

      • OptionalmipLevel: number = 0

        A non-negative integer specifying the image level of detail. Defaults to 0, which represents the base image source. A level value of N, that is greater than 0, represents the image source for the Nth mipmap reduction level.

      Returns HTMLImageElement

      The source image of this texture. Can be null if source not assigned for specific image level.

    • Locks a miplevel of the texture, returning a typed array to be filled with pixel data.

      Parameters

      • Optionaloptions: { face?: number; level?: number; mode?: number } = {}

        Optional options object. Valid properties are as follows:

        • Optionalface?: number

          If the texture is a cubemap, this is the index of the face to lock.

        • Optionallevel?: number

          The mip level to lock with 0 being the top level. Defaults to 0.

        • Optionalmode?: number

          The lock mode. Can be:

      Returns
          | Uint8Array<ArrayBufferLike>
          | Uint16Array<ArrayBufferLike>
          | Uint32Array<ArrayBufferLike>
          | Float32Array<ArrayBufferLike>

      A typed array containing the pixel data of the locked mip level.

    • Forces a reupload of the textures pixel data to graphics memory. Ordinarily, this function is called by internally by setSource and unlock. However, it still needs to be called explicitly in the case where an HTMLVideoElement is set as the source of the texture. Normally, this is done once every frame before video textured geometry is rendered.

      Returns void

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Accessors
    Methods