1ba7429371
# Objective Provide a starting point for #3951, or a partial solution. Providing a few comment blocks to discuss, and hopefully find better one in the process. ## Solution Since I am pretty new to pretty much anything in this context, I figured I'd just start with a draft for some file level doc blocks. For some of them I found more relevant details (or at least things I considered interessting), for some others there is less. ## Changelog - Moved some existing comments from main() functions in the 2d examples to the file header level - Wrote some more comment blocks for most other 2d examples TODO: - [x] 2d/sprite_sheet, wasnt able to come up with something good yet - [x] all other example groups... Also: Please let me know if the commit style is okay, or to verbose. I could certainly squash these things, or add more details if needed. I also hope its okay to raise this PR this early, with just a few files changed. Took me long enough and I dont wanted to let it go to waste because I lost motivation to do the whole thing. Additionally I am somewhat uncertain over the style and contents of the commets. So let me know what you thing please.
53 lines
1.6 KiB
Rust
53 lines
1.6 KiB
Rust
//! Shows how to create systems that run every fixed timestep, rather than every tick.
|
|
|
|
use bevy::{
|
|
core::{FixedTimestep, FixedTimesteps},
|
|
prelude::*,
|
|
};
|
|
|
|
const LABEL: &str = "my_fixed_timestep";
|
|
|
|
#[derive(Debug, Hash, PartialEq, Eq, Clone, StageLabel)]
|
|
struct FixedUpdateStage;
|
|
|
|
fn main() {
|
|
App::new()
|
|
.add_plugins(DefaultPlugins)
|
|
// this system will run once every update (it should match your screen's refresh rate)
|
|
.add_system(frame_update)
|
|
// add a new stage that runs twice a second
|
|
.add_stage_after(
|
|
CoreStage::Update,
|
|
FixedUpdateStage,
|
|
SystemStage::parallel()
|
|
.with_run_criteria(
|
|
FixedTimestep::step(0.5)
|
|
// labels are optional. they provide a way to access the current
|
|
// FixedTimestep state from within a system
|
|
.with_label(LABEL),
|
|
)
|
|
.with_system(fixed_update),
|
|
)
|
|
.run();
|
|
}
|
|
|
|
fn frame_update(mut last_time: Local<f64>, time: Res<Time>) {
|
|
info!("update: {}", time.seconds_since_startup() - *last_time);
|
|
*last_time = time.seconds_since_startup();
|
|
}
|
|
|
|
fn fixed_update(mut last_time: Local<f64>, time: Res<Time>, fixed_timesteps: Res<FixedTimesteps>) {
|
|
info!(
|
|
"fixed_update: {}",
|
|
time.seconds_since_startup() - *last_time,
|
|
);
|
|
|
|
let fixed_timestep = fixed_timesteps.get(LABEL).unwrap();
|
|
info!(
|
|
" overstep_percentage: {}",
|
|
fixed_timestep.overstep_percentage()
|
|
);
|
|
|
|
*last_time = time.seconds_since_startup();
|
|
}
|