dmyyy / bevy_panorbit_camera

A simple pan and orbit camera for the Bevy game engine

Bevy Pan/Orbit Camera

What Is This?

Bevy Pan/Orbit Camera provides orbit camera controls for Bevy Engine, designed with simplicity and flexibility in mind. Use it to quickly prototype, experiment, for model viewers, and more!

Default controls:

• Left Mouse - Orbit
• Right Mouse - Pan
• Scroll Wheel - Zoom

Touch controls:

• One finger - Orbit
• Two fingers - Pan
• Pinch - Zoom

Features:

• Orbiting, panning and zooming
• Smooth motion
• Works with orthographic camera projection in addition to perspective
• Customisable controls, sensitivity, and more
• Touch support
  • Currently 'beta' - please report any issues!
• Works with multiple viewports and/or windows
• Easy to control manually, e.g. for keyboard control or animation
• Can control cameras that render to a texture

Quick Start

Add the plugin:

.add_plugins(PanOrbitCameraPlugin)

Add PanOrbitCamera to a camera:

commands.spawn((
    Camera3dBundle {
        transform: Transform::from_translation(Vec3::new(0.0, 1.5, 5.0)),
        ..default()
    },
    PanOrbitCamera::default(),
));

This will set up a camera with good defaults.

Check out the advanced example to see all the possible configuration options.

What are alpha and beta?

Think of this camera as rotating around a point, and always pointing at that point (the focus). The sideways rotation, i.e. the longitudinal rotation, is alpha, and the latitudinal rotation is beta. Both are measured in radians. If alpha and beta are both 0.0, then the camera will be looking directly forwards (-Z direction). Increasing alpha will rotate around the focus to the right, and increasing beta will move the camera up and over the focus.

Cargo Features

• bevy_egui: makes PanOrbitCamera ignore input when interacting with egui widgets/windows

Version Compatibility

bevy	bevy_panorbit_camera
0.12	0.9-0.11
0.11	0.6-0.8
0.10	0.1-0.5

Credits

• Bevy Cheat Book: For providing an example that I started from
• babylon.js: I referenced their arc rotate camera for some of this
• bevy_pancam: For the egui-related code

License

All code in this repository 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. This means you can select the license you prefer! This dual-licensing approach is the de-facto standard in the Rust ecosystem and there are very good reasons to include both.