import { AbstractMultiResource } from './AbstractMultiResource'; import { TARGETS } from '@pixi/constants'; import type { BaseTexture } from '../BaseTexture'; import type { BaseImageResource } from './BaseImageResource'; import type { Renderer } from '../../Renderer'; import type { GLTexture } from '../GLTexture'; import type { ISize } from '@pixi/math'; /** * A resource that contains a number of sources. * @memberof PIXI */ export class ArrayResource extends AbstractMultiResource { /** * @param source - Number of items in array or the collection * of image URLs to use. Can also be resources, image elements, canvas, etc. * @param options - Options to apply to {@link PIXI.autoDetectResource} * @param {number} [options.width] - Width of the resource * @param {number} [options.height] - Height of the resource */ constructor(source: number | Array, options?: ISize) { const { width, height } = options || {}; let urls; let length: number; if (Array.isArray(source)) { urls = source; length = source.length; } else { length = source; } super(length, { width, height }); if (urls) { this.initFromArray(urls, options); } } /** * Set a baseTexture by ID, * ArrayResource just takes resource from it, nothing more * @param baseTexture * @param index - Zero-based index of resource to set * @returns - Instance for chaining */ addBaseTextureAt(baseTexture: BaseTexture, index: number): this { if (baseTexture.resource) { this.addResourceAt(baseTexture.resource, index); } else { throw new Error('ArrayResource does not support RenderTexture'); } return this; } /** * Add binding * @param baseTexture */ bind(baseTexture: BaseTexture): void { super.bind(baseTexture); baseTexture.target = TARGETS.TEXTURE_2D_ARRAY; } /** * Upload the resources to the GPU. * @param renderer * @param texture * @param glTexture * @returns - whether texture was uploaded */ upload(renderer: Renderer, texture: BaseTexture, glTexture: GLTexture): boolean { const { length, itemDirtyIds, items } = this; const { gl } = renderer; if (glTexture.dirtyId < 0) { gl.texImage3D( gl.TEXTURE_2D_ARRAY, 0, glTexture.internalFormat, this._width, this._height, length, 0, texture.format, glTexture.type, null ); } for (let i = 0; i < length; i++) { const item = items[i]; if (itemDirtyIds[i] < item.dirtyId) { itemDirtyIds[i] = item.dirtyId; if (item.valid) { gl.texSubImage3D( gl.TEXTURE_2D_ARRAY, 0, 0, // xoffset 0, // yoffset i, // zoffset item.resource.width, item.resource.height, 1, texture.format, glTexture.type, (item.resource as BaseImageResource).source ); } } } return true; } }