Struct bevy_ecs::reflect::ReflectComponent

pub struct ReflectComponent(/* private fields */);

A struct used to operate on reflected Component trait of a type.

A ReflectComponent for type T can be obtained via bevy_reflect::TypeRegistration::data.

Implementations

impl ReflectComponent

pub fn insert( &self, entity: &mut EntityWorldMut<'_>, component: &dyn Reflect, registry: &TypeRegistry )

Insert a reflected Component into the entity like insert().

pub fn apply<'a>( &self, entity: impl Into<EntityMut<'a>>, component: &dyn Reflect )

Uses reflection to set the value of this Component type in the entity to the given value.

Panics

Panics if there is no Component of the given type.

pub fn apply_or_insert( &self, entity: &mut EntityWorldMut<'_>, component: &dyn Reflect, registry: &TypeRegistry )

Uses reflection to set the value of this Component type in the entity to the given value or insert a new one if it does not exist.

pub fn remove(&self, entity: &mut EntityWorldMut<'_>)

Removes this Component type from the entity. Does nothing if it doesn’t exist.

pub fn contains<'a>(&self, entity: impl Into<FilteredEntityRef<'a>>) -> bool

Returns whether entity contains this Component

pub fn reflect<'a>( &self, entity: impl Into<FilteredEntityRef<'a>> ) -> Option<&'a dyn Reflect>

Gets the value of this Component type from the entity as a reflected reference.

pub fn reflect_mut<'a>( &self, entity: impl Into<FilteredEntityMut<'a>> ) -> Option<Mut<'a, dyn Reflect>>

Gets the value of this Component type from the entity as a mutable reflected reference.

pub unsafe fn reflect_unchecked_mut<'a>( &self, entity: UnsafeEntityCell<'a> ) -> Option<Mut<'a, dyn Reflect>>

Safety

This method does not prevent you from having two mutable pointers to the same data, violating Rust’s aliasing rules. To avoid this:

• Only call this method with a UnsafeEntityCell that may be used to mutably access the component on the entity entity
• Don’t call this method more than once in the same scope for a given Component.

pub fn copy( &self, source_world: &World, destination_world: &mut World, source_entity: Entity, destination_entity: Entity, registry: &TypeRegistry )

Gets the value of this Component type from entity from source_world and applies it to the value of this Component type in entity in destination_world.

Panics

Panics if there is no Component of the given type or either entity does not exist.

pub fn new(fns: ReflectComponentFns) -> Self

Create a custom implementation of ReflectComponent.

This is an advanced feature, useful for scripting implementations, that should not be used by most users unless you know what you are doing.

Usually you should derive Reflect and add the #[reflect(Component)] component to generate a ReflectComponent implementation automatically.

See ReflectComponentFns for more information.

pub fn fn_pointers(&self) -> &ReflectComponentFns

The underlying function pointers implementing methods on ReflectComponent.

This is useful when you want to keep track locally of an individual function pointer.

Calling TypeRegistry::get followed by TypeRegistration::data::<ReflectComponent> can be costly if done several times per frame. Consider cloning ReflectComponent and keeping it between frames, cloning a ReflectComponent is very cheap.

If you only need a subset of the methods on ReflectComponent, use fn_pointers to get the underlying ReflectComponentFns and copy the subset of function pointers you care about.

Trait Implementations

impl Clone for ReflectComponent

fn clone(&self) -> ReflectComponent

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C: Component + Reflect> FromType<C> for ReflectComponent

fn from_type() -> Self