loadImages

A function that loads an array of images. Primarily intended for loading:

• an array of images for a WebGL TEXTURE_2D_ARRAY or TEXTURE_3D textures
• an array of images representing mip levels of a single WebGL TEXTURE_2D texture or one TEXTURE_CUBE face.

Usage

Loading an array of images

import '@loaders.gl/polyfills'; // only needed for Node.js support
import {loadImageArray} from `@loaders.gl/images`;

const images = await loadImageArray(count, ({index}) => `filename-${index}`);

for (const image of images) {
  ...
}

import '@loaders.gl/polyfills'; // only needed for Node.js support
import {loadImageArray} from `@loaders.gl/images`;

const images = await loadImageArray(count,  ({index}) => `filename-${index}`, {
  mipLevels: 'auto'
});

for (const imageArray of images) {
  for (const lodImage of imageArray) {
    ...
  }
}

getUrl Callback Parameters

the getUrl callback will be called for each image with the following parameters:

Note: In addition to these values, all options passed in to loadImageArray are also available in the getUrl method.

loadImageArray(count : Number | String, getUrl : ({index}) => String, options? : Object) : image[] | image[][]

Parameters:

• count: Number of images to load.
• getUrl: A function that generates the url for each image, it is called for each image with the index of that image.
• options: Supports the same options as ImageLoader.

Returns

• an array of images (or array of arrays of mip images)

Options

Accepts the same options as ImageLoader, and

Number of mip level images to load: Use 0 to indicate a single image with no mips. Supplying the string 'auto' will infer the mipLevel from the size of the lod=0 image.

Remarks

• Returned images can be passed directly to WebGL texture methods. See ImageLoader for details about the type of the returned images.