Struct DirectNestedLoader

pub struct DirectNestedLoader<'ctx, 'builder, 'reader> { /* private fields */ }

A builder for directly loading nested assets inside a LoadContext.

Lifetimes

• ctx: the lifetime of the associated [AssetServer] reference
• builder: the lifetime of the temporary builder structs
• reader: the lifetime of the Reader reference used to read the asset data

Implementations

impl<'ctx: 'reader, 'builder, 'reader> DirectNestedLoader<'ctx, 'builder, 'reader>

pub fn with_reader(self, reader: &'builder mut Reader<'reader>) -> Self

Specify the reader to use to read the asset data.

pub fn untyped(self) -> UntypedDirectNestedLoader<'ctx, 'builder, 'reader>

Load the asset without providing static type information.

If you need to specify the type of asset, but cannot do it statically, use .with_asset_type_id().

pub async fn load<'p, A: Asset>( self, path: impl Into<AssetPath<'p>>, ) -> Result<LoadedAsset<A>, LoadDirectError>

Loads the asset at the given path directly. This is an async function that will wait until the asset is fully loaded before returning. Use this if you need the value of another asset in order to load the current asset. For example, if you are deriving a new asset from the referenced asset, or you are building a collection of assets. This will add the path as a “load dependency”.

If the current loader is used in a Process “asset preprocessor”, such as a LoadTransformAndSave preprocessor, changing a “load dependency” will result in re-processing of the asset.