Bevy Cursor

![Latest Version] ![Bevy Tracking] ![Doc Status] ![Build Status]

Bevy Cursor is a [bevy] plugin to track informations about the cursor.

The following cursor informations are available via the [CursorInfo] resource:

• The entity id of the window on which the cursor is currently;
• The entity if of the camera on which the cursor is currently;
• The position of the cursor on the window (logical position);
• The 2D world position of the cursor (if the feature 2d is enabled);
• The [ray] emitted by the cursor through the camera (if the feature 3d is enabled);

Example

```rust ,norun use bevy::prelude::*; use bevycursor::prelude::*;

fn main() { App::new() .addplugins((DefaultPlugins, CursorInfoPlugin)) .addsystems(Startup, setup) .addsystems(Update, printcursor_position) .run(); }

fn setup(mut commands: Commands) { // A camera is required to compute the world position of the cursor commands.spawn(Camera2dBundle::default()); }

fn printcursorposition(cursor: Res) { if let Some(position) = cursor.position() { info!("Cursor position: {position:?}"); } else { info!("The cursor is not in any window"); } } ```

Features

• 2d opt-in the computation of the world position of the cursor.
• 3d opt-in the computation of the [ray] emitted by the cursor through the camera (disabled by default).

Bevy compatible version

| bevy | bevy_cursor | | ---- | ----------- | | 0.11 | 0.1 |