Skip to main content

CompressedTextureLoader

From-v3.0

Loader for compressed textures in the PVR file format

LoaderCharacteristic
File FormatPVR, DDS, KTX
File Extension.dds, .pvr, .ktx, .ktx2
File TypeBinary
Data FormatArray of compressed image data objects
Supported APIsload, parse

Usage

import {CompressedTextureLoader} from '@loaders.gl/textures';
import {load} from '@loaders.gl/core';

const mipLevels = await load(url, CompressedTextureLoader);
for (const image of mipLevels) {
...
}

Data Format

Returns an array of image data objects representing mip levels.

{compressed: true, format, width, height, data: ..., levelSize}

Options

OptionTypeDefaultDescription
compressed-texture.useBasisBooleanfalseUse BasisLoader to decode KTX2 texture

Basis loader

From v3.1 BasisLoader supports decoding KTX2 format. Applying BasisLoader for KTX2 files can possibly give results when internal ktx parser can't parse an image for some reason.