Type Function Library composer.* Return value none Revision Release 2023.3686 Keywords composer, scene, remove, removeScene See also composer.removeHidden() composer.getSceneName
This function removes the specified scene (or optionally recycles it). A destroy event is first dispatched to the scene.
To recycle the scene instead of removing it entirely, you may set the
shouldRecycle parameter to
true — this means that the scene's
self.view display group will be removed, but its scene object will remain in memory. This may improve loading time if you access the scene frequently. If
shouldRecycle is omitted or set to
false (default), the scene will be removed entirely, including its scene object.
composer.removeScene( sceneName [, shouldRecycle] )
String. The name of the scene to recycle or remove. For instance, if you want to recycle or remove
"scene1" as this parameter.
Boolean. If the scene should be recycled, but not removed entirely, set this parameter to
true. Default is
-- Completely remove the scene, including its scene object composer.removeScene( "scene1" )
-- Recycle the scene (its view is removed but its scene object remains in memory) composer.removeScene( "scene1", true )