Menu
Boo引擎的场景系统，负责管理游戏中的所有节点和组件，提供层次化的结构来组织游戏对象，支持2D和3D场景的管理。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
资产管理系统，负责加载和管理游戏资源。
Boo引擎的主命名空间，提供对各个核心模块的访问。所有引擎功能都通过Boo命名空间统一访问。
事件系统，处理引擎和游戏事件的监听与触发。
Boo引擎的核心游戏实例，负责游戏的初始化、更新、渲染和场景管理。作为引擎对外的核心全局实例，提供游戏引擎的全自动运行和用户控制接口。
输入系统，处理鼠标和触控板输入事件。
Based on SOC occupation classification
| name | scene |
| description | Boo引擎的场景系统，负责管理游戏中的所有节点和组件，提供层次化的结构来组织游戏对象，支持2D和3D场景的管理。 |
Scene 系统是 Boo 引擎的核心功能之一，负责管理游戏中的所有节点和组件，提供了一个层次化的结构来组织游戏对象。场景系统支持 2D 和 3D 场景的管理，为游戏开发提供了灵活的场景组织方式。
game->openScene() 切换场景// 构造函数
Scene(const std::string name, const std::string uuid = "");
// 根节点获取（引擎自动创建，无需手动调用 createRoot2D/3D）
Node3D *getRoot3D();
Node2D *getRoot2D();
// 生命周期方法
void update(float deltaTime) override;
void lateUpdate(float deltaTime) override;
void clearNodeFrameFlag() override;
void destroy() override;
// 变换方法（重写自 Node）
void setPosition(float x, float y, float z) override;
void setWorldPosition(float x, float y, float z) override;
void setScale(float x, float y, float z) override;
void setWorldScale(float x, float y, float z) override;
void setEulerAngles(float x, float y, float z) override;
void setRotation(float x, float y, float z, float w) override;
void setWorldRotation(float x, float y, float z, float w) override;
void setActive(bool active) override;
// 组件管理
Component *addComponent(std::string name, std::string uuid = "") override;
// 构造函数
Node(const std::string name, const std::string uuid = "");
// 基本属性
const ENodeLayer getLayer() const;
const std::string& getUuid() const;
void setUuid(const std::string &uuid);
void setName(const std::string &name);
const std::string& getName() const;
int getGroupId() const;
void setGroupId(int groupID);
// 变换操作
virtual void setPosition(float x, float y, float z);
const Vec3 &getPosition();
virtual void setWorldPosition(float x, float y, float z);
const Vec3 &getWorldPosition();
virtual void setRotation(float x, float y, float z, float w);
const Quat &getRotation();
virtual void setWorldRotation(float x, float y, float z, float w);
const Quat &getWorldRotation();
virtual void setScale(float x, float y, float z);
const Vec3 &getScale();
virtual void setWorldScale(float x, float y, float z);
const Vec3 &getWorldScale();
virtual void setEulerAngles(float x, float y, float z);
const Vec3 &getEulerAngles();
const Mat4 &getLocalMatrix();
const Mat4 &getWorldMatrix();
// 变换状态
const bool hasFrameTransformFlag() const;
void setMatrix(const std::array<float, 16>& matrix);
virtual void clearNodeFrameFlag();
// 节点层次结构
void addChild(Node *node);
void removeChild(Node *node);
void removeFromParent();
const std::vector<Node *> &getChildren();
Node *getChildByName(std::string name);
void setParent(Node *parent);
Node *getParent();
void destroyAllChildren();
// 激活状态
virtual void setActive(bool active);
bool getActive() const;
const bool getActiveInHierarchy() const;
// 组件管理
virtual Component *addComponent(std::string name, std::string uuid = "");
Component *getComponent(std::string name);
std::vector<Component *> getComponents();
// 生命周期方法
virtual void update(float deltaTime);
virtual void lateUpdate(float deltaTime);
virtual void destroy();
// 构造函数
Node2D(const std::string name, const std::string uuid = "");
// 2D 特有属性
void setAnchor(float x, float y);
void setSize(float width, float height);
const Vec2 &getAnchor();
const Size &getSize();
const Mat4 &getUIWorldMatrix();
// 变换方法（重写自 Node）
void setPosition(float x, float y, float z) override;
void setWorldPosition(float x, float y, float z) override;
void setScale(float x, float y, float z) override;
void setWorldScale(float x, float y, float z) override;
void setEulerAngles(float x, float y, float z) override;
void setRotation(float x, float y, float z, float w) override;
void setWorldRotation(float x, float y, float z, float w) override;
// 激活状态
void setActive(bool active) override;
// 组件管理
Component *addComponent(std::string name, std::string uuid = "") override;
UIRenderer *getUIRenderer();
// 碰撞检测
bool inHitMask(float x, float y);
bool inHitOnNode(float x, float y);
// 生命周期方法
void update(float deltaTime) override;
void lateUpdate(float deltaTime) override;
void clearNodeFrameFlag() override;
void destroy() override;
// 构造函数
Node3D(const std::string name, const std::string uuid = "");
// 获取世界矩阵逆转置（用于法线变换）
const Mat4& getWorldMatrixIT();
// 获取网格渲染器
MeshRenderer* getMeshRenderer();
// 创建场景
Boo::Scene* scene = new Boo::Scene("MainScene");
// 打开场景（重要：new Scene 后必须紧接着调用此方法）
Boo::game->openScene(scene);
// 注意：根节点由引擎自动创建，不要手动调用 createRoot2D/createRoot3D
// 获取当前场景
Boo::Scene* scene = Boo::game->getScene();
// 获取 2D 根节点
Boo::Node2D* root2D = scene->getRoot2D();
// 创建 2D 节点
Boo::Node2D* uiNode = new Boo::Node2D("UINode");
uiNode->setPosition(100, 100, 0);
uiNode->setSize(200, 100);
uiNode->setAnchor(0.5f, 0.5f);
// 添加到根节点
root2D->addChild(uiNode);
// 获取当前场景
Boo::Scene* scene = Boo::game->getScene();
// 获取 3D 根节点
Boo::Node3D* root3D = scene->getRoot3D();
// 创建 3D 节点
Boo::Node3D* modelNode = new Boo::Node3D("ModelNode");
// 添加到根节点
root3D->addChild(modelNode);
// 创建节点
Boo::Node2D* node = new Boo::Node2D("TransformNode");
// 设置位置
node->setPosition(100, 100, 0);
// 设置旋转（欧拉角）
node->setEulerAngles(0, 0, 45); // 45度旋转
// 设置缩放
node->setScale(2, 2, 1); // 放大2倍
// 获取变换信息
Boo::Vec3 position = node->getPosition();
Boo::Vec3 rotation = node->getEulerAngles();
Boo::Vec3 scale = node->getScale();
std::cout << "Position: " << position.x << ", " << position.y << ", " << position.z << std::endl;
std::cout << "Rotation: " << rotation.x << ", " << rotation.y << ", " << rotation.z << std::endl;
std::cout << "Scale: " << scale.x << ", " << scale.y << ", " << scale.z << std::endl;
// 创建节点
Boo::Node2D* node = new Boo::Node2D("ComponentNode");
// 添加相机组件
Boo::Component* camera = node->addComponent("Camera");
// 添加 UI 精灵组件
Boo::Component* sprite = node->addComponent("UISprite");
// 获取组件
Boo::Component* existingCamera = node->getComponent("Camera");
// 获取所有组件
std::vector<Boo::Component*> components = node->getComponents();
std::cout << "Number of components: " << components.size() << std::endl;
Scene
├── Root2D (Node2D)
│ ├── UI节点1
│ ├── UI节点2
│ └── ...
└── Root3D (Node3D)
├── 3D模型1
├── 3D模型2
└── ...
场景系统是 Boo 引擎的核心功能之一，它提供了一个灵活、高效的方式来组织和管理游戏对象。通过场景系统，开发者可以：
场景系统的设计理念是"层次化管理"，通过树状结构来组织游戏对象，使得游戏开发更加模块化和可维护。
Boo::game->openScene(scene) 来打开场景，否则场景不会被引擎管理和渲染openScene 后自动创建，不要手动调用 createRoot2D/3D