325 lines
16 KiB
JavaScript
325 lines
16 KiB
JavaScript
import { Matrix, utils, MASK_TYPES } from "@pixi/core";
|
|
import { DisplayObject } from "./DisplayObject.mjs";
|
|
const tempMatrix = new Matrix();
|
|
function sortChildren(a, b) {
|
|
return a.zIndex === b.zIndex ? a._lastSortedIndex - b._lastSortedIndex : a.zIndex - b.zIndex;
|
|
}
|
|
const _Container = class _Container2 extends DisplayObject {
|
|
constructor() {
|
|
super(), this.children = [], this.sortableChildren = _Container2.defaultSortableChildren, this.sortDirty = !1;
|
|
}
|
|
/**
|
|
* Overridable method that can be used by Container subclasses whenever the children array is modified.
|
|
* @param _length
|
|
*/
|
|
onChildrenChange(_length) {
|
|
}
|
|
/**
|
|
* Adds one or more children to the container.
|
|
*
|
|
* Multiple items can be added like so: `myContainer.addChild(thingOne, thingTwo, thingThree)`
|
|
* @param {...PIXI.DisplayObject} children - The DisplayObject(s) to add to the container
|
|
* @returns {PIXI.DisplayObject} - The first child that was added.
|
|
*/
|
|
addChild(...children) {
|
|
if (children.length > 1)
|
|
for (let i = 0; i < children.length; i++)
|
|
this.addChild(children[i]);
|
|
else {
|
|
const child = children[0];
|
|
child.parent && child.parent.removeChild(child), child.parent = this, this.sortDirty = !0, child.transform._parentID = -1, this.children.push(child), this._boundsID++, this.onChildrenChange(this.children.length - 1), this.emit("childAdded", child, this, this.children.length - 1), child.emit("added", this);
|
|
}
|
|
return children[0];
|
|
}
|
|
/**
|
|
* Adds a child to the container at a specified index. If the index is out of bounds an error will be thrown.
|
|
* If the child is already in this container, it will be moved to the specified index.
|
|
* @param {PIXI.DisplayObject} child - The child to add.
|
|
* @param {number} index - The absolute index where the child will be positioned at the end of the operation.
|
|
* @returns {PIXI.DisplayObject} The child that was added.
|
|
*/
|
|
addChildAt(child, index) {
|
|
if (index < 0 || index > this.children.length)
|
|
throw new Error(`${child}addChildAt: The index ${index} supplied is out of bounds ${this.children.length}`);
|
|
return child.parent && child.parent.removeChild(child), child.parent = this, this.sortDirty = !0, child.transform._parentID = -1, this.children.splice(index, 0, child), this._boundsID++, this.onChildrenChange(index), child.emit("added", this), this.emit("childAdded", child, this, index), child;
|
|
}
|
|
/**
|
|
* Swaps the position of 2 Display Objects within this container.
|
|
* @param child - First display object to swap
|
|
* @param child2 - Second display object to swap
|
|
*/
|
|
swapChildren(child, child2) {
|
|
if (child === child2)
|
|
return;
|
|
const index1 = this.getChildIndex(child), index2 = this.getChildIndex(child2);
|
|
this.children[index1] = child2, this.children[index2] = child, this.onChildrenChange(index1 < index2 ? index1 : index2);
|
|
}
|
|
/**
|
|
* Returns the index position of a child DisplayObject instance
|
|
* @param child - The DisplayObject instance to identify
|
|
* @returns - The index position of the child display object to identify
|
|
*/
|
|
getChildIndex(child) {
|
|
const index = this.children.indexOf(child);
|
|
if (index === -1)
|
|
throw new Error("The supplied DisplayObject must be a child of the caller");
|
|
return index;
|
|
}
|
|
/**
|
|
* Changes the position of an existing child in the display object container
|
|
* @param child - The child DisplayObject instance for which you want to change the index number
|
|
* @param index - The resulting index number for the child display object
|
|
*/
|
|
setChildIndex(child, index) {
|
|
if (index < 0 || index >= this.children.length)
|
|
throw new Error(`The index ${index} supplied is out of bounds ${this.children.length}`);
|
|
const currentIndex = this.getChildIndex(child);
|
|
utils.removeItems(this.children, currentIndex, 1), this.children.splice(index, 0, child), this.onChildrenChange(index);
|
|
}
|
|
/**
|
|
* Returns the child at the specified index
|
|
* @param index - The index to get the child at
|
|
* @returns - The child at the given index, if any.
|
|
*/
|
|
getChildAt(index) {
|
|
if (index < 0 || index >= this.children.length)
|
|
throw new Error(`getChildAt: Index (${index}) does not exist.`);
|
|
return this.children[index];
|
|
}
|
|
/**
|
|
* Removes one or more children from the container.
|
|
* @param {...PIXI.DisplayObject} children - The DisplayObject(s) to remove
|
|
* @returns {PIXI.DisplayObject} The first child that was removed.
|
|
*/
|
|
removeChild(...children) {
|
|
if (children.length > 1)
|
|
for (let i = 0; i < children.length; i++)
|
|
this.removeChild(children[i]);
|
|
else {
|
|
const child = children[0], index = this.children.indexOf(child);
|
|
if (index === -1)
|
|
return null;
|
|
child.parent = null, child.transform._parentID = -1, utils.removeItems(this.children, index, 1), this._boundsID++, this.onChildrenChange(index), child.emit("removed", this), this.emit("childRemoved", child, this, index);
|
|
}
|
|
return children[0];
|
|
}
|
|
/**
|
|
* Removes a child from the specified index position.
|
|
* @param index - The index to get the child from
|
|
* @returns The child that was removed.
|
|
*/
|
|
removeChildAt(index) {
|
|
const child = this.getChildAt(index);
|
|
return child.parent = null, child.transform._parentID = -1, utils.removeItems(this.children, index, 1), this._boundsID++, this.onChildrenChange(index), child.emit("removed", this), this.emit("childRemoved", child, this, index), child;
|
|
}
|
|
/**
|
|
* Removes all children from this container that are within the begin and end indexes.
|
|
* @param beginIndex - The beginning position.
|
|
* @param endIndex - The ending position. Default value is size of the container.
|
|
* @returns - List of removed children
|
|
*/
|
|
removeChildren(beginIndex = 0, endIndex = this.children.length) {
|
|
const begin = beginIndex, end = endIndex, range = end - begin;
|
|
let removed;
|
|
if (range > 0 && range <= end) {
|
|
removed = this.children.splice(begin, range);
|
|
for (let i = 0; i < removed.length; ++i)
|
|
removed[i].parent = null, removed[i].transform && (removed[i].transform._parentID = -1);
|
|
this._boundsID++, this.onChildrenChange(beginIndex);
|
|
for (let i = 0; i < removed.length; ++i)
|
|
removed[i].emit("removed", this), this.emit("childRemoved", removed[i], this, i);
|
|
return removed;
|
|
} else if (range === 0 && this.children.length === 0)
|
|
return [];
|
|
throw new RangeError("removeChildren: numeric values are outside the acceptable range.");
|
|
}
|
|
/** Sorts children by zIndex. Previous order is maintained for 2 children with the same zIndex. */
|
|
sortChildren() {
|
|
let sortRequired = !1;
|
|
for (let i = 0, j = this.children.length; i < j; ++i) {
|
|
const child = this.children[i];
|
|
child._lastSortedIndex = i, !sortRequired && child.zIndex !== 0 && (sortRequired = !0);
|
|
}
|
|
sortRequired && this.children.length > 1 && this.children.sort(sortChildren), this.sortDirty = !1;
|
|
}
|
|
/** Updates the transform on all children of this container for rendering. */
|
|
updateTransform() {
|
|
this.sortableChildren && this.sortDirty && this.sortChildren(), this._boundsID++, this.transform.updateTransform(this.parent.transform), this.worldAlpha = this.alpha * this.parent.worldAlpha;
|
|
for (let i = 0, j = this.children.length; i < j; ++i) {
|
|
const child = this.children[i];
|
|
child.visible && child.updateTransform();
|
|
}
|
|
}
|
|
/**
|
|
* Recalculates the bounds of the container.
|
|
*
|
|
* This implementation will automatically fit the children's bounds into the calculation. Each child's bounds
|
|
* is limited to its mask's bounds or filterArea, if any is applied.
|
|
*/
|
|
calculateBounds() {
|
|
this._bounds.clear(), this._calculateBounds();
|
|
for (let i = 0; i < this.children.length; i++) {
|
|
const child = this.children[i];
|
|
if (!(!child.visible || !child.renderable))
|
|
if (child.calculateBounds(), child._mask) {
|
|
const maskObject = child._mask.isMaskData ? child._mask.maskObject : child._mask;
|
|
maskObject ? (maskObject.calculateBounds(), this._bounds.addBoundsMask(child._bounds, maskObject._bounds)) : this._bounds.addBounds(child._bounds);
|
|
} else
|
|
child.filterArea ? this._bounds.addBoundsArea(child._bounds, child.filterArea) : this._bounds.addBounds(child._bounds);
|
|
}
|
|
this._bounds.updateID = this._boundsID;
|
|
}
|
|
/**
|
|
* Retrieves the local bounds of the displayObject as a rectangle object.
|
|
*
|
|
* Calling `getLocalBounds` may invalidate the `_bounds` of the whole subtree below. If using it inside a render()
|
|
* call, it is advised to call `getBounds()` immediately after to recalculate the world bounds of the subtree.
|
|
* @param rect - Optional rectangle to store the result of the bounds calculation.
|
|
* @param skipChildrenUpdate - Setting to `true` will stop re-calculation of children transforms,
|
|
* it was default behaviour of pixi 4.0-5.2 and caused many problems to users.
|
|
* @returns - The rectangular bounding area.
|
|
*/
|
|
getLocalBounds(rect, skipChildrenUpdate = !1) {
|
|
const result = super.getLocalBounds(rect);
|
|
if (!skipChildrenUpdate)
|
|
for (let i = 0, j = this.children.length; i < j; ++i) {
|
|
const child = this.children[i];
|
|
child.visible && child.updateTransform();
|
|
}
|
|
return result;
|
|
}
|
|
/**
|
|
* Recalculates the content bounds of this object. This should be overriden to
|
|
* calculate the bounds of this specific object (not including children).
|
|
* @protected
|
|
*/
|
|
_calculateBounds() {
|
|
}
|
|
/**
|
|
* Renders this object and its children with culling.
|
|
* @protected
|
|
* @param {PIXI.Renderer} renderer - The renderer
|
|
*/
|
|
_renderWithCulling(renderer) {
|
|
const sourceFrame = renderer.renderTexture.sourceFrame;
|
|
if (!(sourceFrame.width > 0 && sourceFrame.height > 0))
|
|
return;
|
|
let bounds, transform;
|
|
this.cullArea ? (bounds = this.cullArea, transform = this.worldTransform) : this._render !== _Container2.prototype._render && (bounds = this.getBounds(!0));
|
|
const projectionTransform = renderer.projection.transform;
|
|
if (projectionTransform && (transform ? (transform = tempMatrix.copyFrom(transform), transform.prepend(projectionTransform)) : transform = projectionTransform), bounds && sourceFrame.intersects(bounds, transform))
|
|
this._render(renderer);
|
|
else if (this.cullArea)
|
|
return;
|
|
for (let i = 0, j = this.children.length; i < j; ++i) {
|
|
const child = this.children[i], childCullable = child.cullable;
|
|
child.cullable = childCullable || !this.cullArea, child.render(renderer), child.cullable = childCullable;
|
|
}
|
|
}
|
|
/**
|
|
* Renders the object using the WebGL renderer.
|
|
*
|
|
* The [_render]{@link PIXI.Container#_render} method is be overriden for rendering the contents of the
|
|
* container itself. This `render` method will invoke it, and also invoke the `render` methods of all
|
|
* children afterward.
|
|
*
|
|
* If `renderable` or `visible` is false or if `worldAlpha` is not positive or if `cullable` is true and
|
|
* the bounds of this object are out of frame, this implementation will entirely skip rendering.
|
|
* See {@link PIXI.DisplayObject} for choosing between `renderable` or `visible`. Generally,
|
|
* setting alpha to zero is not recommended for purely skipping rendering.
|
|
*
|
|
* When your scene becomes large (especially when it is larger than can be viewed in a single screen), it is
|
|
* advised to employ **culling** to automatically skip rendering objects outside of the current screen.
|
|
* See [cullable]{@link PIXI.DisplayObject#cullable} and [cullArea]{@link PIXI.DisplayObject#cullArea}.
|
|
* Other culling methods might be better suited for a large number static objects; see
|
|
* [@pixi-essentials/cull]{@link https://www.npmjs.com/package/@pixi-essentials/cull} and
|
|
* [pixi-cull]{@link https://www.npmjs.com/package/pixi-cull}.
|
|
*
|
|
* The [renderAdvanced]{@link PIXI.Container#renderAdvanced} method is internally used when when masking or
|
|
* filtering is applied on a container. This does, however, break batching and can affect performance when
|
|
* masking and filtering is applied extensively throughout the scene graph.
|
|
* @param renderer - The renderer
|
|
*/
|
|
render(renderer) {
|
|
if (!(!this.visible || this.worldAlpha <= 0 || !this.renderable))
|
|
if (this._mask || this.filters?.length)
|
|
this.renderAdvanced(renderer);
|
|
else if (this.cullable)
|
|
this._renderWithCulling(renderer);
|
|
else {
|
|
this._render(renderer);
|
|
for (let i = 0, j = this.children.length; i < j; ++i)
|
|
this.children[i].render(renderer);
|
|
}
|
|
}
|
|
/**
|
|
* Render the object using the WebGL renderer and advanced features.
|
|
* @param renderer - The renderer
|
|
*/
|
|
renderAdvanced(renderer) {
|
|
const filters = this.filters, mask = this._mask;
|
|
if (filters) {
|
|
this._enabledFilters || (this._enabledFilters = []), this._enabledFilters.length = 0;
|
|
for (let i = 0; i < filters.length; i++)
|
|
filters[i].enabled && this._enabledFilters.push(filters[i]);
|
|
}
|
|
const flush = filters && this._enabledFilters?.length || mask && (!mask.isMaskData || mask.enabled && (mask.autoDetect || mask.type !== MASK_TYPES.NONE));
|
|
if (flush && renderer.batch.flush(), filters && this._enabledFilters?.length && renderer.filter.push(this, this._enabledFilters), mask && renderer.mask.push(this, this._mask), this.cullable)
|
|
this._renderWithCulling(renderer);
|
|
else {
|
|
this._render(renderer);
|
|
for (let i = 0, j = this.children.length; i < j; ++i)
|
|
this.children[i].render(renderer);
|
|
}
|
|
flush && renderer.batch.flush(), mask && renderer.mask.pop(this), filters && this._enabledFilters?.length && renderer.filter.pop();
|
|
}
|
|
/**
|
|
* To be overridden by the subclasses.
|
|
* @param _renderer - The renderer
|
|
*/
|
|
_render(_renderer) {
|
|
}
|
|
/**
|
|
* Removes all internal references and listeners as well as removes children from the display list.
|
|
* Do not use a Container after calling `destroy`.
|
|
* @param options - Options parameter. A boolean will act as if all options
|
|
* have been set to that value
|
|
* @param {boolean} [options.children=false] - if set to true, all the children will have their destroy
|
|
* method called as well. 'options' will be passed on to those calls.
|
|
* @param {boolean} [options.texture=false] - Only used for child Sprites if options.children is set to true
|
|
* Should it destroy the texture of the child sprite
|
|
* @param {boolean} [options.baseTexture=false] - Only used for child Sprites if options.children is set to true
|
|
* Should it destroy the base texture of the child sprite
|
|
*/
|
|
destroy(options) {
|
|
super.destroy(), this.sortDirty = !1;
|
|
const destroyChildren = typeof options == "boolean" ? options : options?.children, oldChildren = this.removeChildren(0, this.children.length);
|
|
if (destroyChildren)
|
|
for (let i = 0; i < oldChildren.length; ++i)
|
|
oldChildren[i].destroy(options);
|
|
}
|
|
/** The width of the Container, setting this will actually modify the scale to achieve the value set. */
|
|
get width() {
|
|
return this.scale.x * this.getLocalBounds().width;
|
|
}
|
|
set width(value) {
|
|
const width = this.getLocalBounds().width;
|
|
width !== 0 ? this.scale.x = value / width : this.scale.x = 1, this._width = value;
|
|
}
|
|
/** The height of the Container, setting this will actually modify the scale to achieve the value set. */
|
|
get height() {
|
|
return this.scale.y * this.getLocalBounds().height;
|
|
}
|
|
set height(value) {
|
|
const height = this.getLocalBounds().height;
|
|
height !== 0 ? this.scale.y = value / height : this.scale.y = 1, this._height = value;
|
|
}
|
|
};
|
|
_Container.defaultSortableChildren = !1;
|
|
let Container = _Container;
|
|
Container.prototype.containerUpdateTransform = Container.prototype.updateTransform;
|
|
export {
|
|
Container
|
|
};
|
|
//# sourceMappingURL=Container.mjs.map
|