import { Runner } from '@pixi/runner';
let UID = 0;
/**
* A wrapper for data so that it can be used and uploaded by WebGL
*
* @class
* @memberof PIXI
*/
export class Buffer {
/**
* @param {ArrayBuffer| SharedArrayBuffer|ArrayBufferView} data - the data to store in the buffer.
* @param {boolean} [_static=true] - `true` for static buffer
* @param {boolean} [index=false] - `true` for index buffer
*/
constructor(data, _static = true, index = false) {
/**
* The data in the buffer, as a typed array
*
* @member {ArrayBuffer| SharedArrayBuffer | ArrayBufferView}
*/
this.data = (data || new Float32Array(1));
/**
* A map of renderer IDs to webgl buffer
*
* @private
* @member {object<number, GLBuffer>}
*/
this._glBuffers = {};
this._updateID = 0;
this.index = index;
this.static = _static;
this.id = UID++;
this.disposeRunner = new Runner('disposeBuffer');
}
// TODO could explore flagging only a partial upload?
/**
* flags this buffer as requiring an upload to the GPU
* @param {ArrayBuffer|SharedArrayBuffer|ArrayBufferView} [data] - the data to update in the buffer.
*/
update(data) {
this.data = data || this.data;
this._updateID++;
}
/**
* disposes WebGL resources that are connected to this geometry
*/
dispose() {
this.disposeRunner.emit(this, false);
}
/**
* Destroys the buffer
*/
destroy() {
this.dispose();
this.data = null;
}
/**
* Helper function that creates a buffer based on an array or TypedArray
*
* @static
* @param {ArrayBufferView | number[]} data - the TypedArray that the buffer will store. If this is a regular Array it will be converted to a Float32Array.
* @return {PIXI.Buffer} A new Buffer based on the data provided.
*/
static from(data) {
if (data instanceof Array) {
data = new Float32Array(data);
}
return new Buffer(data);
}
}