舞台
舞台Stage 是各种图形、精灵的载体,所有可见物体必须添加到舞台或其子角色中,才会被渲染出来。舞台的概念类似于游戏中的界面,例如一个游戏可能有开始界面、游戏界面、结束界面,每个界面都可以用一个舞台来表示。

舞台的创建

角色只有添加到舞台上以后才会显示在画面上,所以舞台实际上是所有角色的父角色,它也具有普通角色的属性与方法。
// 创建舞台
StagePtr myStage = new Stage;
// 添加一个角色到舞台上
myStage->AddChild(actor1);
// 将一个角色从舞台上移除
myStage->RemoveChild(actor1);
// 将所有名称为 'actor2' 的角色移除
myStage->RemoveChildren("actor2");
舞台可以和普通角色一样监听事件、执行定时任务等。

舞台的进入与退出

舞台的进入与退出是由 导演Director 决定的,使用导演的 EnterStage 方法切换舞台
// 切换到 myStage 舞台
Director::GetInstance().EnterStage(myStage);
重载舞台的 OnEnterOnExit 函数,可以在舞台进入和退出时执行特定的函数
class MyStage : public kiwano::Stage
{
public:
void OnEnter() { KGE_LOG("进入了MyStage!"); }
void OnExit() { KGE_LOG("退出了MyStage!"); }
};
导演可以储存一个舞台栈,具体请查阅 舞台的切换

舞台的过度动画

导演可以在切换舞台时使用一些过渡动画,具体请查阅 舞台的切换过渡动画
Last modified 3mo ago
Copy link
On this page
舞台的创建
舞台的进入与退出
舞台的过度动画