Enum bevy_asset::UntypedAssetId

pub enum UntypedAssetId {
    Index {
        type_id: TypeId,
        index: AssetIndex,
    },
    Uuid {
        type_id: TypeId,
        uuid: Uuid,
    },
}

An “untyped” / “generic-less” Asset identifier that behaves much like AssetId, but stores the Asset type information at runtime instead of compile-time. This increases the size of the type, but it enables storing asset ids across asset types together and enables comparisons between them.

Variants

Index

Fields

type_id: TypeId

index: AssetIndex

A small / efficient runtime identifier that can be used to efficiently look up an asset stored in Assets. This is the “default” identifier used for assets. The alternative(s) (ex: UntypedAssetId::Uuid) will only be used if assets are explicitly registered that way.

Uuid

Fields

type_id: TypeId

uuid: Uuid

A stable-across-runs / const asset identifier. This will only be used if an asset is explicitly registered in Assets with one.

Implementations

impl UntypedAssetId

pub fn typed_unchecked<A: Asset>(self) -> AssetId<A>

Converts this to a “typed” AssetId without checking the stored type to see if it matches the target A Asset type. This should only be called if you are absolutely certain the asset type matches the stored type. And even then, you should consider using UntypedAssetId::typed_debug_checked instead.

pub fn typed_debug_checked<A: Asset>(self) -> AssetId<A>

Converts this to a “typed” AssetId. When compiled in debug-mode it will check to see if the stored type matches the target A Asset type. When compiled in release-mode, this check will be skipped.

Panics

Panics if compiled in debug mode and the TypeId of A does not match the stored TypeId.

pub fn typed<A: Asset>(self) -> AssetId<A>

Converts this to a “typed” AssetId.

Panics

Panics if the TypeId of A does not match the stored type id.

pub fn try_typed<A: Asset>( self ) -> Result<AssetId<A>, UntypedAssetIdConversionError>

Try to convert this to a “typed” AssetId.

pub fn type_id(&self) -> TypeId

Returns the stored TypeId of the referenced Asset.

Trait Implementations

impl Clone for UntypedAssetId

fn clone(&self) -> UntypedAssetId

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UntypedAssetId

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

Formats the value using the given formatter.

impl Display for UntypedAssetId

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

Formats the value using the given formatter.

impl<A: Asset> From<&Handle<A>> for UntypedAssetId

fn from(value: &Handle<A>) -> Self

Converts to this type from the input type.

impl From<&UntypedHandle> for UntypedAssetId

fn from(value: &UntypedHandle) -> Self

Converts to this type from the input type.

impl<A: Asset> From<AssetId<A>> for UntypedAssetId

fn from(value: AssetId<A>) -> Self

Converts to this type from the input type.

impl<A: Asset> From<Handle<A>> for UntypedAssetId

fn from(value: Handle<A>) -> Self

Converts to this type from the input type.

impl From<UntypedHandle> for UntypedAssetId

fn from(value: UntypedHandle) -> Self

Converts to this type from the input type.

impl Hash for UntypedAssetId

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<A: Asset> PartialEq<AssetId<A>> for UntypedAssetId

fn eq(&self, other: &AssetId<A>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<A: Asset> PartialEq<UntypedAssetId> for AssetId<A>

fn eq(&self, other: &UntypedAssetId) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for UntypedAssetId

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<A: Asset> PartialOrd<AssetId<A>> for UntypedAssetId

fn partial_cmp(&self, other: &AssetId<A>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<A: Asset> PartialOrd<UntypedAssetId> for AssetId<A>

fn partial_cmp(&self, other: &UntypedAssetId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd for UntypedAssetId

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<A: Asset> TryFrom<UntypedAssetId> for AssetId<A>

type Error = UntypedAssetIdConversionError

The type returned in the event of a conversion error.

fn try_from(value: UntypedAssetId) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for UntypedAssetId

impl Eq for UntypedAssetId