Struct SavedAssetBuilder 

pub struct SavedAssetBuilder<'a> { /* private fields */ }

A builder for creating SavedAsset instances (for use with asset saving).

This is commonly used in tandem with save_using_saver.

Implementations

impl<'a> SavedAssetBuilder<'a>

pub fn new(asset_server: AssetServer, asset_path: AssetPath<'static>) -> Self

Creates a new builder for the given asset_path and using the asset_server to back its handles.

pub fn add_labeled_asset_with_new_handle<'b: 'a, A: Asset>( &mut self, label: impl Into<CowArc<'b, str>>, asset: SavedAsset<'a, 'a, A>, ) -> Handle<A>

Adds a labeled asset, creates a handle for it, and returns the handle (for use in creating an asset).

This is primarily used when constructing a new asset to be saved. Since assets commonly store handles to their subassets, this function returns a handle that can be stored in your root asset.

If you already have a root asset instance (which already contains a subasset handle), use Self::add_labeled_asset_with_existing_handle instead.

pub fn add_labeled_asset_with_existing_handle<'b: 'a, A: Asset>( &mut self, label: impl Into<CowArc<'b, str>>, asset: SavedAsset<'a, 'a, A>, handle: Handle<A>, )

Adds a labeled asset with a pre-existing handle.

This is primarily used when attempting to save a (root) asset that you already have an instance of. Since this root asset instance already must have its fields populated (including any subasset handles), this function allows you to record the subasset that should be associated with that handle.

If you do not have a root asset instance (you’re creating one from scratch), use Self::add_labeled_asset_with_new_handle instead.

pub fn add_labeled_asset_with_new_handle_erased<'b: 'a>( &mut self, label: impl Into<CowArc<'b, str>>, asset: ErasedSavedAsset<'a, 'a>, ) -> UntypedHandle

Same as Self::add_labeled_asset_with_new_handle, but type-erased to allow for dynamic types.

pub fn add_labeled_asset_with_existing_handle_erased<'b: 'a>( &mut self, label: impl Into<CowArc<'b, str>>, asset: ErasedSavedAsset<'a, 'a>, handle: UntypedHandle, )

Same as Self::add_labeled_asset_with_existing_handle, but type-erased to allow for dynamic types.

pub fn build<'b, A: Asset>(self, asset: &'b A) -> SavedAsset<'b, 'b, A>

where 'a: 'b,

Creates the final saved asset from this builder.