Menu
Boo引擎的场景系统，负责管理游戏中的所有节点和组件，提供层次化的结构来组织游戏对象，支持2D和3D场景的管理。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
资产管理系统，负责加载和管理游戏资源。
Boo引擎的主命名空间，提供对各个核心模块的访问。所有引擎功能都通过Boo命名空间统一访问。
事件系统，处理引擎和游戏事件的监听与触发。
Boo引擎的核心游戏实例，负责游戏的初始化、更新、渲染和场景管理。作为引擎对外的核心全局实例，提供游戏引擎的全自动运行和用户控制接口。
输入系统，处理鼠标和触控板输入事件。
| 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