Crate bevy_map_camera

Source
Expand description

§bevy_map_camera

docs.rs crates.io

A 3D camera controller inspired by Google Maps, f4maps and Charge Finder.

bevy_map_camera example

Based upon LookTransform, LookAngles and Orbital Camera Controller from smooth-bevy-cameras.

§Features

  • Orbital camera
  • Zoom towards pointer
  • Grab pan
    • Configurable height
  • Camera target follows XZ-plane
  • Support for Perspective and Orthographic projection
  • Smoothed movement
  • Customizable keyboard/mouse controls
  • Touch support
    • One finger pan
    • Two finger rotate
    • Pinch to zoom
  • Supports Easing though bevy_easings, part of default features.
    • Implemented for LookTransform
  • Supports Tweening through bevy_tweening, requires bevy_tweening feature.
    • Lenses
      • LookTransformLens
      • GrabHeightLens

§Quick Start

use bevy::prelude::*;

use bevy_map_cam::{MapCamera, LookTransform, MapCameraPlugin};

fn main() {
    let mut app = App::new();
    app.add_plugins(DefaultPlugins);
    app.add_plugins(MapCameraPlugin::default());

    app.add_systems(Startup, setup);
    app.run();
}

fn setup(
    mut commands: Commands,
    mut meshes: ResMut<Assets<Mesh>>,
    mut materials: ResMut<Assets<StandardMaterial>>,
) {
    // plane
    commands.spawn((
        Mesh3d(meshes.add(Plane3d::default().mesh().size(10., 10.))),
        MeshMaterial3d(materials.add(Color::from(DARK_GREEN))),
    ));

    // Camera
    commands.spawn(MapCamera);
}

Check out the projection example to see how to change between Perspective and Orthographic.

§Compatible Bevy versions

bevy_map_camerabevy
0.30.16
0.20.15
0.10.14

Re-exports§

pub use controller::CameraController;
pub use controller::CameraControllerSettings;
pub use look_transform::LookTransform;

Modules§

controller
inputs
look_angles
look_transform

Structs§

MapCamera
MapCameraPlugin
Orbital camera plugin

Enums§

CameraChange