9 releases (breaking)
0.9.0 | Jul 13, 2023 |
---|---|
0.8.0 | Mar 9, 2023 |
0.7.0 | Nov 14, 2022 |
0.6.1 | Aug 27, 2022 |
0.2.0 | Jan 9, 2022 |
#73 in Game dev
1,177 downloads per month
Used in 7 crates
29KB
281 lines
bevy_pancam
A 2d-camera plugin for bevy that works with orthographic cameras.
The motivation is that this could be used for something like a map editor for a 2d game.
Controls
Behaves similarly to common online map applications:
- Click and drag to move the camera
- Scroll to zoom
Usage
Add the plugin to your app
App::new()
.add_plugins((DefaultPlugins, PanCamPlugin::default()))
.run();
Add the component to an orthographic camera:
commands.spawn(Camera2dBundle::default())
.insert(PanCam::default());
This is enough to get going with sensible defaults.
Alternatively, set the fields of the PanCam
component to customize behavior:
commands.spawn(Camera2dBundle::default())
.insert(PanCam {
grab_buttons: vec![MouseButton::Left, MouseButton::Middle], // which buttons should drag the camera
enabled: true, // when false, controls are disabled. See toggle example.
zoom_to_cursor: true, // whether to zoom towards the mouse or the center of the screen
min_scale: 1., // prevent the camera from zooming too far in
max_scale: Some(40.), // prevent the camera from zooming too far out
});
See the simple
and toggle
examples.
Cargo features
bevy_egui
makes pancam cameras not react when the mouse or keyboard focus is on widgets created withbevy_egui
Bevy Version Support
The main
branch targets the latest bevy release.
I intend to support the main
branch of Bevy in the bevy-main
branch.
bevy | bevy_pancam |
---|---|
0.11 | 0.9, main |
0.10 | 0.8 |
0.9 | 0.7, |
0.8 | 0.5, 0.6 |
0.7 | 0.3, 0.4 |
0.6 | 0.2 |
0.5 | 0.1 |
License
bevy_pancam
is dual-licensed under either
- MIT License (./LICENSE-MIT or http://opensource.org/licenses/MIT)
- Apache License, Version 2.0 (./LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
at your option.
Contributions
PRs welcome!
Dependencies
~24–67MB
~1M SLoC