76682fdcb7
# Objective One of a few Bevy Asset improvements I would like to make: #11216. Currently asset processing and asset saving are handled by the same trait, `AssetSaver`. This makes it difficult to reuse saving implementations and impossible to have a single "universal" saver for a given asset type. ## Solution This PR splits off the processing portion of `AssetSaver` into `AssetTransformer`, which is responsible for transforming assets. This change involves adding the `LoadTransformAndSave` processor, which utilizes the new API. The `LoadAndSave` still exists since it remains useful in situations where no "transformation" of the asset is done, such as when compressing assets. ## Notes: As an aside, Bikeshedding is welcome on the names. I'm not entirely convinced by `AssetTransformer`, which was chosen mostly because `AssetProcessor` is taken. Additionally, `LoadTransformSave` may be sufficient instead of `LoadTransformAndSave`. --- ## Changelog ### Added - `AssetTransformer` which is responsible for transforming Assets. - `LoadTransformAndSave`, a `Process` implementation. ### Changed - Changed `AssetSaver`'s responsibilities from processing and saving to just saving. - Updated `asset_processing` example to use new API. - Old asset .meta files regenerated with new processor.
21 lines
971 B
Rust
21 lines
971 B
Rust
use crate::{meta::Settings, Asset};
|
|
use serde::{Deserialize, Serialize};
|
|
|
|
/// Transforms an [`Asset`] of a given [`AssetTransformer::AssetInput`] type to an [`Asset`] of [`AssetTransformer::AssetOutput`] type.
|
|
pub trait AssetTransformer: Send + Sync + 'static {
|
|
/// The [`Asset`] type which this [`AssetTransformer`] takes as and input.
|
|
type AssetInput: Asset;
|
|
/// The [`Asset`] type which this [`AssetTransformer`] outputs.
|
|
type AssetOutput: Asset;
|
|
/// The settings type used by this [`AssetTransformer`].
|
|
type Settings: Settings + Default + Serialize + for<'a> Deserialize<'a>;
|
|
/// The type of [error](`std::error::Error`) which could be encountered by this saver.
|
|
type Error: Into<Box<dyn std::error::Error + Send + Sync + 'static>>;
|
|
|
|
fn transform<'a>(
|
|
&'a self,
|
|
asset: Self::AssetInput,
|
|
settings: &'a Self::Settings,
|
|
) -> Result<Self::AssetOutput, Box<dyn std::error::Error + Send + Sync + 'static>>;
|
|
}
|