Struct TransformHierarchy 

pub struct TransformHierarchy;

变换层次工具

提供管理变换层次关系的便捷方法。

Implementations

impl TransformHierarchy

pub fn set_parent( commands: &mut Commands<'_, '_>, child: Entity, parent: Entity, )

设置父子关系

建立两个实体之间的父子关系，并更新相关组件。

参数

• commands: 命令缓冲区
• child: 子实体
• parent: 父实体

示例

use anvilkit_ecs::prelude::*;
 
fn setup_hierarchy(mut commands: Commands) {
    let parent = commands.spawn((
        Transform::default(),
        GlobalTransform::default(),
    )).id();
     
    let child = commands.spawn((
        Transform::default(),
        GlobalTransform::default(),
    )).id();
     
    TransformHierarchy::set_parent(&mut commands, child, parent);
}

pub fn remove_parent(commands: &mut Commands<'_, '_>, child: Entity)

移除父子关系

断开子实体与其父实体的关系。

参数

• commands: 命令缓冲区
• child: 子实体

示例

use anvilkit_ecs::prelude::*;
 
fn remove_from_parent(mut commands: Commands, child_entity: Entity) {
    TransformHierarchy::remove_parent(&mut commands, child_entity);
}

pub fn get_ancestors(world: &World, entity: Entity) -> Vec<Entity>

获取实体的所有祖先

返回从实体到根实体的所有祖先实体列表。

参数

• world: 世界引用
• entity: 起始实体

返回

祖先实体列表，从直接父实体到根实体

pub fn get_descendants(world: &World, entity: Entity) -> Vec<Entity>

获取实体的所有后代

递归获取实体的所有子实体和后代实体。

参数

• world: 世界引用
• entity: 起始实体

返回

所有后代实体列表