new Destroy()
The Destroy component is responsible for destroying a Game Object.
- Source code: gameobjects/components/Destroy.js (Line 12)
Public Properties
-
[readonly] destroyPhase : boolean
-
As a Game Object runs through its destroy method this flag is set to true,
and can be checked in any sub-systems or plugins it is being destroyed from.- Source code: gameobjects/components/Destroy.js (Line 22)
Public Methods
-
destroy(destroyChildren, destroyTexture)
-
Destroys the Game Object. This removes it from its parent group, destroys the input, event and animation handlers if present
and nulls its reference togame
, freeing it up for garbage collection.If this Game Object has the Events component it will also dispatch the
onDestroy
event.You can optionally also destroy the BaseTexture this Game Object is using. Be careful if you've
more than one Game Object sharing the same BaseTexture.Parameters
Name Type Argument Default Description destroyChildren
boolean <optional>
true Should every child of this object have its destroy method called as well?
destroyTexture
boolean <optional>
false Destroy the BaseTexture this Game Object is using? Note that if another Game Object is sharing the same BaseTexture it will invalidate it.
- Source code: gameobjects/components/Destroy.js (Line 37)