SceneManager:changeScene
Available since: Gideros 2020.2
Class: SceneManager
Description
Transitions between two scenes. <syntaxhighlight lang="lua"> SceneManager:changeScene(scene, duration, transition, easing) </source>
Values
scene (string) the name of the scene to transition to
duration (number) transition duration in seconds
transition (constant) transition type
easing (constant) easing type
Examples
Simple example <syntaxhighlight lang="lua"> scenemanager:changeScene("level1", 2, SceneManager.moveFromRight, easing.outBack) </source>
Change scene with extra parameters <syntaxhighlight lang="lua"> -- initialise scene manager local sceneManager = SceneManager.new { ['blankscene'] = BlankScene, ['cutscenescene'] = CutsceneScene, } stage:addChild(sceneManager)
-- load font local fontName = 'consolas18' local fontText = string.format('font/%s.txt', fontName) local fontImage = string.format('font/%s.png', fontName) local smallFont = Font.new(fontText, fontImage, true)
-- initialise gamestate local gamestate = { cutsceneId = 1, }
-- begin demo sceneManager:changeScene('blankscene') sceneManager:changeScene('cutscenescene', 1, SceneManager.fade, easing.linear, { userData = { sceneManager = sceneManager, gamestate = gamestate, font = smallFont, }, } )
-- then in cutscenescene class CutsceneScene = Core.class(Sprite)
function CutsceneScene:init(params) -- copy existing systems and objects for k,v in pairs(params) do self[k] = v end
-- load cutscene local gamestate = self.gamestate local cutsceneId = gamestate.cutsceneId
-- initialise name text field local nameText = TextField.new(self.font, ' ') -- ... end </source>