mirror of
https://github.com/bevyengine/bevy
synced 2024-12-24 03:53:06 +00:00
7d40e3ec87
# Objective Continue migration of bevy APIs to required components, following guidance of https://hackmd.io/@bevy/required_components/ ## Solution - Make `Sprite` require `Transform` and `Visibility` and `SyncToRenderWorld` - move image and texture atlas handles into `Sprite` - deprecate `SpriteBundle` - remove engine uses of `SpriteBundle` ## Testing ran cargo tests on bevy_sprite and tested several sprite examples. --- ## Migration Guide Replace all uses of `SpriteBundle` with `Sprite`. There are several new convenience constructors: `Sprite::from_image`, `Sprite::from_atlas_image`, `Sprite::from_color`. WARNING: use of `Handle<Image>` and `TextureAtlas` as components on sprite entities will NO LONGER WORK. Use the fields on `Sprite` instead. I would have removed the `Component` impls from `TextureAtlas` and `Handle<Image>` except it is still used within ui. We should fix this moving forward with the migration.
46 lines
1.5 KiB
Rust
46 lines
1.5 KiB
Rust
//! An example of registering an extra asset source, and loading assets from it.
|
|
//! This asset source exists in addition to the default asset source.
|
|
|
|
use bevy::{
|
|
asset::{
|
|
io::{AssetSourceBuilder, AssetSourceId},
|
|
AssetPath,
|
|
},
|
|
prelude::*,
|
|
};
|
|
use std::path::Path;
|
|
|
|
fn main() {
|
|
App::new()
|
|
// Add an extra asset source with the name "example_files" to
|
|
// AssetSourceBuilders.
|
|
//
|
|
// This must be done before AssetPlugin finalizes building assets.
|
|
.register_asset_source(
|
|
"example_files",
|
|
AssetSourceBuilder::platform_default("examples/asset/files", None),
|
|
)
|
|
// DefaultPlugins contains AssetPlugin so it must be added to our App
|
|
// after inserting our new asset source.
|
|
.add_plugins(DefaultPlugins)
|
|
.add_systems(Startup, setup)
|
|
.run();
|
|
}
|
|
|
|
fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
|
|
commands.spawn(Camera2d);
|
|
|
|
// Now we can load the asset using our new asset source.
|
|
//
|
|
// The actual file path relative to workspace root is
|
|
// "examples/asset/files/bevy_pixel_light.png".
|
|
let path = Path::new("bevy_pixel_light.png");
|
|
let source = AssetSourceId::from("example_files");
|
|
let asset_path = AssetPath::from_path(path).with_source(source);
|
|
|
|
// You could also parse this URL-like string representation for the asset
|
|
// path.
|
|
assert_eq!(asset_path, "example_files://bevy_pixel_light.png".into());
|
|
|
|
commands.spawn(Sprite::from_image(asset_server.load(asset_path)));
|
|
}
|