角色
角色Actor是游戏画面里的一个个元素,例如Sprite精灵TextActor文字角色都是一种角色,角色控制了一个游戏对象如何渲染、更新、执行动画等。

角色的方法和属性

  • 修改角色位置
actor->SetPosition(Point(50, 50));
  • 修改角色旋转角度
actor->SetRotation(180);
  • 将角色放大到 2 倍
actor->SetScale(2);
  • 设置角色透明度
actor->SetOpacity(0.5);
  • 获取角色大小
float width = actor->GetWidth();
float height = actor->GetHeight();
Size size = actor->GetSize();
  • 隐藏角色
actor->SetVisible(false);
角色使用 锚点Anchor 来对齐,锚点是指角色的原点位置,修改锚点可以让角色变为中点对齐或任意点对齐
// 获取舞台宽度和高度
float width = stage->GetWidth();
float height = stage->GetHeight();
// 设置角色位置为舞台宽度和高度的一半,此时角色的左上角位于舞台中心
actor->SetPosition(width / 2, height / 2);
// 修改锚点,让角色改为中心对齐,此时角色的中心位置位于舞台中心
actor->SetAnchor(0.5, 0.5);
角色可以有自己的名称,用来快速获取父角色下的某个特定子角色
// 设置子角色名称
child->SetName("child actor");
// 从父角色中移除名称为 'child actor' 的角色
parent->RemoveChildren("child actor");

角色的关系

一个角色可以有多个子角色,但只能有一个父角色,通过 AddChildRemoveChildRemoveFromParent 来添加或删除角色
ActorPtr parent = new Actor;
ActorPtr child = new Actor;
parent->AddChild(child);
子角色会继承父角色的一部分属性,例如位置、透明度、旋转角度等,所以子角色的位置、透明度都是相对于父角色来说的
// 父角色的位置设为 x=10, y=10
parent->SetPosition(Point(10, 10));
// 子角色的位置设为 x=20, y=20,但实际显示在画面的位置为 x=30, y=30
child->SetPosition(Point(20, 20));
使用 GetParent 方法可以获取父角色
ActorPtr parent = actor->GetParent();
角色被添加到舞台上后,可以使用 GetStage 获取角色所在舞台
StagePtr stage = actor->GetStage();

角色动画

角色是执行动画的单位,使用 AddActionPauseAllActionsResumeAllActionsStopAllActions 方法来添加、暂停、继续、停止动画
// 让角色执行一个旋转动画,在1秒内旋转到60度
actor->AddAction(Tween::RotateTo(1_sec, 60));
// 停止角色的所有动画
actor->StopAllActions();

事件监听

角色是事件分发与监听的单位,使用 AddListenerRemoveListener 等方法来添加、删除事件监听器
// 添加一个鼠标按下事件的监听器
actor->AddListener<MouseDownEvent>("mouse down", [](Event*) { KGE_LOG("鼠标按下"); });
// 移除所有名称为 'mouse down' 的监听器
actor->RemoveListeners("mouse down");

定时任务

角色可以通过 AddTask 来完成一些固定时间间隔的任务
// 定时器执行的回调函数
auto callback = [](Task* t, Duration dt) { KGE_LOG("任务名称:", t->GetName(), ",时间间隔为:", dt.ToString()); };
// 添加定时器,每隔 0.5 秒执行一次 callback 函数
actor->AddTask("my task", callback, 0.5_sec);
// 根据任务名称启动、停止、移除任务
actor->StartTasks("my task");
actor->StopTasks("my task");
actor->RemoveTasks("my task");

角色的调试

如果角色的显示不正常或行为不正常,也许角色边界渲染会帮助到你,开启边界渲染功能可以让你直观地看到角色的大小和边界
// 让导演开启角色边界渲染功能
Director::GetInstance().SetRenderBorderEnabled(true);
// 打开角色的边界渲染
actor->ShowBorder(true);
Last modified 3mo ago
Copy link
On this page
角色的方法和属性
角色的关系
角色动画
事件监听
定时任务
角色的调试