pub struct Archetype { /* private fields */ }
Expand description
Metadata for a single archetype within a World
.
For more information, see the module level documentation.
Implementations§
§impl Archetype
impl Archetype
pub fn id(&self) -> ArchetypeId
pub fn id(&self) -> ArchetypeId
Fetches the ID for the archetype.
pub fn entities(&self) -> &[ArchetypeEntity]
pub fn entities(&self) -> &[ArchetypeEntity]
Fetches the entities contained in this archetype.
pub fn table_components(&self) -> impl Iterator<Item = ComponentId>
pub fn table_components(&self) -> impl Iterator<Item = ComponentId>
Gets an iterator of all of the components stored in Table
s.
All of the IDs are unique.
pub fn sparse_set_components(&self) -> impl Iterator<Item = ComponentId>
pub fn sparse_set_components(&self) -> impl Iterator<Item = ComponentId>
Gets an iterator of all of the components stored in ComponentSparseSet
s.
All of the IDs are unique.
pub fn components(&self) -> impl Iterator<Item = ComponentId>
pub fn components(&self) -> impl Iterator<Item = ComponentId>
Gets an iterator of all of the components in the archetype.
All of the IDs are unique.
pub fn component_count(&self) -> usize
pub fn component_count(&self) -> usize
Returns the total number of components in the archetype
pub fn edges(&self) -> &Edges
pub fn edges(&self) -> &Edges
Fetches a immutable reference to the archetype’s Edges
, a cache of
archetypal relationships.
pub fn entity_table_row(&self, row: ArchetypeRow) -> TableRow
pub fn entity_table_row(&self, row: ArchetypeRow) -> TableRow
Fetches the row in the Table
where the components for the entity at index
is stored.
An entity’s archetype row can be fetched from EntityLocation::archetype_row
, which
can be retrieved from Entities::get
.
§Panics
This function will panic if index >= self.len()
.
pub fn contains(&self, component_id: ComponentId) -> bool
pub fn contains(&self, component_id: ComponentId) -> bool
Checks if the archetype contains a specific component. This runs in O(1)
time.
pub fn get_storage_type(&self, component_id: ComponentId) -> Option<StorageType>
pub fn get_storage_type(&self, component_id: ComponentId) -> Option<StorageType>
Gets the type of storage where a component in the archetype can be found.
Returns None
if the component is not part of the archetype.
This runs in O(1)
time.
pub fn get_archetype_component_id(
&self,
component_id: ComponentId
) -> Option<ArchetypeComponentId>
pub fn get_archetype_component_id( &self, component_id: ComponentId ) -> Option<ArchetypeComponentId>
Fetches the corresponding ArchetypeComponentId
for a component in the archetype.
Returns None
if the component is not part of the archetype.
This runs in O(1)
time.
Trait Implementations§
§impl QueryData for &Archetype
impl QueryData for &Archetype
SAFETY: Self
is the same as Self::ReadOnly
§type ReadOnly = &Archetype
type ReadOnly = &Archetype
QueryData
, which satisfies the ReadOnlyQueryData
trait.§impl WorldQuery for &Archetype
impl WorldQuery for &Archetype
SAFETY:
update_component_access
and update_archetype_component_access
do nothing.
This is sound because fetch
does not access components.
§type Item<'w> = &'w Archetype
type Item<'w> = &'w Archetype
WorldQuery
For QueryData
this will be the item returned by the query.
For QueryFilter
this will be either ()
, or a bool
indicating whether the entity should be included
or a tuple of such things.§type Fetch<'w> = (&'w Entities, &'w Archetypes)
type Fetch<'w> = (&'w Entities, &'w Archetypes)
WorldQuery
to fetch Self::Item
§type State = ()
type State = ()
Self::Fetch
. This will be cached inside QueryState
,
so it is best to move as much data / computation here as possible to reduce the cost of
constructing Self::Fetch
.§fn shrink<'wlong, 'wshort>(
item: <&Archetype as WorldQuery>::Item<'wlong>
) -> <&Archetype as WorldQuery>::Item<'wshort>where
'wlong: 'wshort,
fn shrink<'wlong, 'wshort>(
item: <&Archetype as WorldQuery>::Item<'wlong>
) -> <&Archetype as WorldQuery>::Item<'wshort>where
'wlong: 'wshort,
§unsafe fn init_fetch<'w>(
world: UnsafeWorldCell<'w>,
_state: &<&Archetype as WorldQuery>::State,
_last_run: Tick,
_this_run: Tick
) -> <&Archetype as WorldQuery>::Fetch<'w>
unsafe fn init_fetch<'w>( world: UnsafeWorldCell<'w>, _state: &<&Archetype as WorldQuery>::State, _last_run: Tick, _this_run: Tick ) -> <&Archetype as WorldQuery>::Fetch<'w>
§const IS_DENSE: bool = true
const IS_DENSE: bool = true
WorldQuery::set_table
must be used before
WorldQuery::fetch
can be called for iterators. If this returns false,
WorldQuery::set_archetype
must be used before WorldQuery::fetch
can be called for
iterators.§unsafe fn set_archetype<'w>(
_fetch: &mut <&Archetype as WorldQuery>::Fetch<'w>,
_state: &<&Archetype as WorldQuery>::State,
_archetype: &'w Archetype,
_table: &Table
)
unsafe fn set_archetype<'w>( _fetch: &mut <&Archetype as WorldQuery>::Fetch<'w>, _state: &<&Archetype as WorldQuery>::State, _archetype: &'w Archetype, _table: &Table )
Archetype
. This will always be called on
archetypes that match this WorldQuery
. Read more§unsafe fn set_table<'w>(
_fetch: &mut <&Archetype as WorldQuery>::Fetch<'w>,
_state: &<&Archetype as WorldQuery>::State,
_table: &'w Table
)
unsafe fn set_table<'w>( _fetch: &mut <&Archetype as WorldQuery>::Fetch<'w>, _state: &<&Archetype as WorldQuery>::State, _table: &'w Table )
Table
. This will always be called on tables
that match this WorldQuery
. Read more§unsafe fn fetch<'w>(
fetch: &mut <&Archetype as WorldQuery>::Fetch<'w>,
entity: Entity,
_table_row: TableRow
) -> <&Archetype as WorldQuery>::Item<'w>
unsafe fn fetch<'w>( fetch: &mut <&Archetype as WorldQuery>::Fetch<'w>, entity: Entity, _table_row: TableRow ) -> <&Archetype as WorldQuery>::Item<'w>
Self::Item
for either the given entity
in the current Table
,
or for the given entity
in the current Archetype
. This must always be called after
WorldQuery::set_table
with a table_row
in the range of the current Table
or after
WorldQuery::set_archetype
with a entity
in the current archetype. Read more§fn update_component_access(
_state: &<&Archetype as WorldQuery>::State,
_access: &mut FilteredAccess<ComponentId>
)
fn update_component_access( _state: &<&Archetype as WorldQuery>::State, _access: &mut FilteredAccess<ComponentId> )
§fn init_state(_world: &mut World)
fn init_state(_world: &mut World)
State
for this WorldQuery
type.§fn matches_component_set(
_state: &<&Archetype as WorldQuery>::State,
_set_contains_id: &impl Fn(ComponentId) -> bool
) -> bool
fn matches_component_set( _state: &<&Archetype as WorldQuery>::State, _set_contains_id: &impl Fn(ComponentId) -> bool ) -> bool
§fn set_access(_state: &mut Self::State, _access: &FilteredAccess<ComponentId>)
fn set_access(_state: &mut Self::State, _access: &FilteredAccess<ComponentId>)
FilteredEntityRef
or FilteredEntityMut
. Read moreimpl ReadOnlyQueryData for &Archetype
SAFETY: access is read only
Auto Trait Implementations§
impl Freeze for Archetype
impl RefUnwindSafe for Archetype
impl Send for Archetype
impl Sync for Archetype
impl Unpin for Archetype
impl UnwindSafe for Archetype
Blanket Implementations§
§impl<T, U> AsBindGroupShaderType<U> for T
impl<T, U> AsBindGroupShaderType<U> for T
§fn as_bind_group_shader_type(&self, _images: &RenderAssets<GpuImage>) -> U
fn as_bind_group_shader_type(&self, _images: &RenderAssets<GpuImage>) -> U
T
ShaderType
for self
. When used in AsBindGroup
derives, it is safe to assume that all images in self
exist.source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.§impl<T> DowncastSync for T
impl<T> DowncastSync for T
§impl<S> FromSample<S> for S
impl<S> FromSample<S> for S
fn from_sample_(s: S) -> S
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more