KHR_texture_transform adds offset, rotation, and scale to TextureInfo properties.

Affine UV transforms are useful for reducing the number of textures the GPU must load, improving performance when used in techniques like texture atlases. UV transforms cannot be animated at this time.

Properties:

Example

The TextureTransform class provides a single ExtensionProperty type, Transform, which may be attached to any TextureInfo instance. For example:

import { TextureTransform } from '@gltf-transform/extensions';

// Create an Extension attached to the Document.
const transformExtension = document.createExtension(TextureTransform)
    .setRequired(true);

// Create a reusable Transform.
const transform = transformExtension.createTransform()
    .setScale([100, 100]);

// Apply the Transform to a Material's baseColorTexture.
document.createMaterial()
    .setBaseColorTexture(myTexture)
    .getBaseColorTextureInfo()
    .setExtension('KHR_texture_transform', transform);

Hierarchy

  • Extension
    • TextureTransform

Properties

extensionName: "KHR_texture_transform" = ...

Methods

  • dispose(): void
  • Disables and removes the extension from the Document.

  • isRequired(): boolean
  • Indicates to the client whether it is OK to load the asset when this extension is not recognized. Optional extensions are generally preferred, if there is not a good reason to require a client to completely fail when an extension isn't known.

  • Indicates to the client whether it is OK to load the asset when this extension is not recognized. Optional extensions are generally preferred, if there is not a good reason to require a client to completely fail when an extension isn't known.

Function symbol, f(📦) → 📦, where the argument and output are a box labeled 'glTF'.

Made by Don McCurdy TypeDoc documentation Copyright 2021 under MIT license