bevy/examples/stress_tests
Trashtalk217 d1bd46d45e
Deprecate get_or_spawn (#15652)
# Objective

After merging retained rendering world #15320, we now have a good way of
creating a link between worlds (*HIYAA intensifies*). This means that
`get_or_spawn` is no longer necessary for that function. Entity should
be opaque as the warning above `get_or_spawn` says. This is also part of
#15459.

I'm deprecating `get_or_spawn_batch` in a different PR in order to keep
the PR small in size.

## Solution

Deprecate `get_or_spawn` and replace it with `get_entity` in most
contexts. If it's possible to query `&RenderEntity`, then the entity is
synced and `render_entity.id()` is initialized in the render world.

## Migration Guide

If you are given an `Entity` and you want to do something with it, use
`Commands.entity(...)` or `World.entity(...)`. If instead you want to
spawn something use `Commands.spawn(...)` or `World.spawn(...)`. If you
are not sure if an entity exists, you can always use `get_entity` and
match on the `Option<...>` that is returned.

---------

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
2024-10-07 16:08:22 +00:00
..
bevymark.rs Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
many_animated_sprites.rs Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
many_buttons.rs Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
many_cubes.rs Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
many_foxes.rs Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
many_gizmos.rs Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
many_glyphs.rs Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
many_lights.rs Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
many_sprites.rs Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
README.md Add a stress test profile (#6901) 2022-12-20 15:59:41 +00:00
text_pipeline.rs Migrate cameras to required components (#15641) 2024-10-05 01:59:52 +00:00
transform_hierarchy.rs Deprecate get_or_spawn (#15652) 2024-10-07 16:08:22 +00:00
warning_string.txt Added performance warning when running stress test examples in debug mode (#5029) 2022-07-13 19:13:46 +00:00

Stress tests

These examples are used to stress test Bevy's performance in various ways. These should be run with the "stress-test" profile to accurately represent performance in production, otherwise they will run in cargo's default "dev" profile which is very slow.

Example Command

cargo run --profile stress-test --example <EXAMPLE>