phaser/src/gameobjects/DisplayList.js

200 lines
5.2 KiB
JavaScript
Raw Normal View History

2018-02-12 16:01:20 +00:00
/**
* @author Richard Davey <rich@photonstorm.com>
2020-01-15 12:07:09 +00:00
* @copyright 2020 Photon Storm Ltd.
2019-05-10 15:15:04 +00:00
* @license {@link https://opensource.org/licenses/MIT|MIT License}
2018-02-12 16:01:20 +00:00
*/
2018-01-16 19:49:13 +00:00
var Class = require('../utils/Class');
var List = require('../structs/List');
var PluginCache = require('../plugins/PluginCache');
2019-01-18 13:41:43 +00:00
var SceneEvents = require('../scene/events');
2018-01-16 19:49:13 +00:00
var StableSort = require('../utils/array/StableSort');
2016-12-07 01:40:56 +00:00
2018-02-12 21:54:51 +00:00
/**
* @classdesc
* The Display List plugin.
*
* Display Lists belong to a Scene and maintain the list of Game Objects to render every frame.
*
* Some of these Game Objects may also be part of the Scene's [Update List]{@link Phaser.GameObjects.UpdateList}, for updating.
2018-02-12 21:54:51 +00:00
*
* @class DisplayList
2018-03-30 12:43:58 +00:00
* @extends Phaser.Structs.List.<Phaser.GameObjects.GameObject>
2018-10-10 09:49:13 +00:00
* @memberof Phaser.GameObjects
2018-02-12 21:54:51 +00:00
* @constructor
* @since 3.0.0
*
* @param {Phaser.Scene} scene - The Scene that this Display List belongs to.
2018-02-12 21:54:51 +00:00
*/
var DisplayList = new Class({
2016-12-07 01:40:56 +00:00
Extends: List,
initialize:
2016-12-07 01:40:56 +00:00
function DisplayList (scene)
{
List.call(this, scene);
2016-12-07 01:40:56 +00:00
2018-02-12 21:54:51 +00:00
/**
* The flag the determines whether Game Objects should be sorted when `depthSort()` is called.
2018-02-12 21:54:51 +00:00
*
* @name Phaser.GameObjects.DisplayList#sortChildrenFlag
* @type {boolean}
* @default false
* @since 3.0.0
*/
this.sortChildrenFlag = false;
2018-02-12 21:54:51 +00:00
/**
* The Scene that this Display List belongs to.
2018-02-12 21:54:51 +00:00
*
* @name Phaser.GameObjects.DisplayList#scene
* @type {Phaser.Scene}
* @since 3.0.0
*/
this.scene = scene;
2016-12-07 01:40:56 +00:00
2018-02-12 21:54:51 +00:00
/**
* The Scene's Systems.
2018-02-12 21:54:51 +00:00
*
* @name Phaser.GameObjects.DisplayList#systems
* @type {Phaser.Scenes.Systems}
* @since 3.0.0
*/
this.systems = scene.sys;
2019-01-18 13:41:43 +00:00
scene.sys.events.once(SceneEvents.BOOT, this.boot, this);
scene.sys.events.on(SceneEvents.START, this.start, this);
},
/**
* This method is called automatically, only once, when the Scene is first created.
* Do not invoke it directly.
*
* @method Phaser.GameObjects.DisplayList#boot
* @private
* @since 3.5.1
*/
boot: function ()
{
2019-01-18 13:41:43 +00:00
this.systems.events.once(SceneEvents.DESTROY, this.destroy, this);
},
2018-02-12 21:54:51 +00:00
/**
* This method is called automatically by the Scene when it is starting up.
* It is responsible for creating local systems, properties and listening for Scene events.
* Do not invoke it directly.
2018-02-12 21:54:51 +00:00
*
* @method Phaser.GameObjects.DisplayList#start
* @private
* @since 3.5.0
2018-02-12 21:54:51 +00:00
*/
start: function ()
{
2019-01-18 13:41:43 +00:00
this.systems.events.once(SceneEvents.SHUTDOWN, this.shutdown, this);
},
2018-02-12 21:54:51 +00:00
/**
* Force a sort of the display list on the next call to depthSort.
*
* @method Phaser.GameObjects.DisplayList#queueDepthSort
* @since 3.0.0
*/
queueDepthSort: function ()
{
this.sortChildrenFlag = true;
},
2018-02-12 21:54:51 +00:00
/**
* Immediately sorts the display list if the flag is set.
*
* @method Phaser.GameObjects.DisplayList#depthSort
* @since 3.0.0
*/
depthSort: function ()
{
if (this.sortChildrenFlag)
{
StableSort.inplace(this.list, this.sortByDepth);
this.sortChildrenFlag = false;
}
},
2018-02-12 21:54:51 +00:00
/**
* Compare the depth of two Game Objects.
2018-02-12 21:54:51 +00:00
*
* @method Phaser.GameObjects.DisplayList#sortByDepth
* @since 3.0.0
*
* @param {Phaser.GameObjects.GameObject} childA - The first Game Object.
* @param {Phaser.GameObjects.GameObject} childB - The second Game Object.
2018-02-12 21:54:51 +00:00
*
* @return {integer} The difference between the depths of each Game Object.
2018-02-12 21:54:51 +00:00
*/
sortByDepth: function (childA, childB)
2016-12-07 01:40:56 +00:00
{
return childA._depth - childB._depth;
2016-12-07 01:40:56 +00:00
},
2018-02-12 21:54:51 +00:00
/**
* Returns an array which contains all objects currently on the Display List.
* This is a reference to the main list array, not a copy of it, so be careful not to modify it.
*
* @method Phaser.GameObjects.DisplayList#getChildren
* @since 3.12.0
*
* @return {Phaser.GameObjects.GameObject[]} The group members.
*/
getChildren: function ()
{
return this.list;
},
/**
* The Scene that owns this plugin is shutting down.
* We need to kill and reset all internal properties as well as stop listening to Scene events.
*
* @method Phaser.GameObjects.DisplayList#shutdown
* @private
* @since 3.0.0
*/
shutdown: function ()
{
var i = this.list.length;
while (i--)
{
this.list[i].destroy(true);
}
this.list.length = 0;
2019-01-18 13:41:43 +00:00
this.systems.events.off(SceneEvents.SHUTDOWN, this.shutdown, this);
},
/**
* The Scene that owns this plugin is being destroyed.
* We need to shutdown and then kill off all external references.
*
* @method Phaser.GameObjects.DisplayList#destroy
* @private
* @since 3.0.0
*/
destroy: function ()
{
this.shutdown();
2019-01-18 13:41:43 +00:00
this.scene.sys.events.off(SceneEvents.START, this.start, this);
this.scene = null;
this.systems = null;
2016-12-07 01:40:56 +00:00
}
});
PluginCache.register('DisplayList', DisplayList, 'displayList');
module.exports = DisplayList;