README.md

bevy_map_camera

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

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::{CameraBundle, 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,
) {
        commands.spawn(CameraBundle::new_with_transform(LookTransform::new(
        Vec3 {
            x: 1.,
            y: 2.5,
            z: 5.0,
        },
        Vec3::ZERO,
        Vec3::Y,
    )));
}

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

Compatible Bevy versions

The main branch is compatible with the latest Bevy release.

bevy_map_camera	bevy
0.1	0.14