Cena
Mudança entre cenas. O pedido é diferido: o mundo é substituído depois dos scripts do frame atual, por isso pode chamá-lo de qualquer hook. A aplicação runtime trata os pedidos; outros hosts podem não tratar. Uma mudança de cena remove todas as entidades, por isso guarde em `caffeine.session` os dados de que precisa.
Namespace: caffeine.scene · Dryad prefix: caffeine_scene_
load#
Lua: caffeine.scene.load · Dryad: caffeine_scene_load
load(path)
Pede ao host para carregar uma cena, substituindo a atual. Um ficheiro em falta ou ilegível é reportado e a cena atual mantém-se.
| Parâmetros | Tipo | Descrição |
|---|---|---|
path | string | Ficheiro de cena, relativo à raiz do projeto ou absoluto. |
Devolve: nada
Exemplo
if caffeine.session.get("coins") >= 10 then caffeine.scene.load("scenes/win.scene") end
reload#
Lua: caffeine.scene.reload · Dryad: caffeine_scene_reload
reload()
Recarrega a cena atual do disco, repondo o seu estado guardado.
Devolve: nada
Exemplo
caffeine.scene.reload() -- restart the level
current#
Lua: caffeine.scene.current · Dryad: caffeine_scene_current
current() -> string
Devolve a cena carregada.
Devolve: string. O caminho da cena carregada tal como foi dado ao host (vazio se desconhecido).
Exemplo
caffeine.debug.log(caffeine.scene.current())
isLoading#
Lua: caffeine.scene.isLoading · Dryad: caffeine_scene_is_loading
isLoading() -> boolean
Indica se há uma mudança de cena à espera de acontecer.
Devolve: boolean. true depois de load ou reload serem pedidos e antes de o host os tratar.
Exemplo
if caffeine.scene.isLoading() then return end