Struct SpatialBundle 

pub struct SpatialBundle {
    pub name: Name,
    pub transform: Transform,
    pub global_transform: GlobalTransform,
    pub visibility: Visibility,
    pub layer: Layer,
}

空间实体 Bundle

包含空间变换和可见性信息，适用于需要位置和渲染的实体。

包含组件

• Name: 实体名称
• Transform: 本地变换
• GlobalTransform: 全局变换
• Visibility: 可见性
• Layer: 渲染层级

示例

use anvilkit_ecs::prelude::*;
 
let mut world = World::new();
 
// 直接创建
let entity = world.spawn(SpatialBundle {
    name: Name::new("空间实体"),
    transform: Transform::from_translation(Vec3::new(1.0, 2.0, 3.0)),
    global_transform: GlobalTransform::default(),
    visibility: Visibility::Visible,
    layer: Layer::new(1),
}).id();
 
// 使用构建器
let entity2 = world.spawn(
    SpatialBundle::new("移动实体")
        .with_position(Vec3::new(5.0, 0.0, 0.0))
        .with_layer(2)
).id();

Fields

name: Name

实体名称

transform: Transform

本地变换

global_transform: GlobalTransform

全局变换

visibility: Visibility

可见性

layer: Layer

渲染层级

Implementations

impl SpatialBundle

pub fn new(name: impl Into<String>) -> SpatialBundle

创建新的空间实体 Bundle

参数

• name: 实体名称

示例

use anvilkit_ecs::bundle::SpatialBundle;
 
let bundle = SpatialBundle::new("空间实体");

pub fn with_position(self, position: Vec3) -> SpatialBundle

设置位置

参数

• position: 世界坐标位置

示例

use anvilkit_ecs::prelude::*;
 
let bundle = SpatialBundle::new("实体")
    .with_position(Vec3::new(1.0, 2.0, 3.0));

pub fn with_rotation(self, rotation: Quat) -> SpatialBundle

设置旋转

参数

• rotation: 四元数旋转

示例

use anvilkit_ecs::prelude::*;
 
let bundle = SpatialBundle::new("实体")
    .with_rotation(Quat::from_rotation_y(std::f32::consts::PI));

pub fn with_scale(self, scale: Vec3) -> SpatialBundle

设置缩放

参数

• scale: 缩放向量

示例

use anvilkit_ecs::prelude::*;
 
let bundle = SpatialBundle::new("实体")
    .with_scale(Vec3::splat(2.0));

pub fn with_transform(self, transform: Transform) -> SpatialBundle

设置变换

参数

• transform: 完整的变换

示例

use anvilkit_ecs::prelude::*;
 
let transform = Transform::from_translation(Vec3::new(1.0, 0.0, 0.0));
let bundle = SpatialBundle::new("实体")
    .with_transform(transform);

pub fn with_visibility(self, visibility: Visibility) -> SpatialBundle

设置可见性

参数

• visibility: 可见性状态

示例

use anvilkit_ecs::prelude::*;
 
let bundle = SpatialBundle::new("实体")
    .with_visibility(Visibility::Hidden);

pub fn with_layer(self, layer: i32) -> SpatialBundle

设置渲染层级

参数

• layer: 层级数值

示例

use anvilkit_ecs::prelude::*;
 
let bundle = SpatialBundle::new("实体")
    .with_layer(5);

Trait Implementations

impl Bundle for SpatialBundle

fn get_component_ids( components: &Components, ids: &mut impl FnMut(Option<ComponentId>), )

Gets this Bundle’s component ids. This will be None if the component has not been registered.

impl Clone for SpatialBundle

fn clone(&self) -> SpatialBundle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SpatialBundle

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for SpatialBundle

fn default() -> SpatialBundle

Returns the “default value” for a type.

impl DynamicBundle for SpatialBundle