1 stable release
1.0.0 | Jul 21, 2024 |
---|
#2040 in Game dev
Used in reactor_core
170KB
4.5K
SLoC
reactor_camera
A camera system for the Bevy. Heavily inspired by the Love2D
plugin STALKER-X.
Features
The primary feature of this plugin is the CameraBundle2D
and CameraStyle
.
CameraStyle
Three Camera Styles are defined:
- Exact
- Deadzone
- Screen By Screen
Exact
A camera with this style will follow the its CameraTarget
exactly. CameraLerp
and CameraLead
have no effect.
Deadzone
A camera with this style will be stationary unless the CameraTarget
leaves the defined Deadzone
.
Once the target has left the deadzone the camera will lerp towards the target based on the value of CameraLerp
(values of 2.0 - 10.0 work best).
If CameraLead
has a value greater than 1.0 then the camera will instead attempt to target a number of world units ahead of the targets motion equal to the provided X and Y values.
Deadzone
is defined in world units and is not effected by the projection scale. In other words, if you zoom in the camera, the value of Deadzone
will not change.
Screen by Screen
A camera with this style will be stationary unless the CameraTarget
leaves the visible screen area.
Once the target has left the current screen the camera will lerp towards the center of the next screen based on the value of CameraLerp
(values of 2.0 - 10.0 work best).
CameraLead
has no effect.
The screen size is based on the current visible screen size, and thus takes into account the various options in bevy's OrthographicProjection
including both Scale
and ScalingMode
.
Usage
Add the crate to your Cargo.toml
, CameraPlugin
to your app, and add CameraBundle2D
to your camera.
NOTE: This plugin relies heavily on reactor_spatial. If you are not using reactor_spatial for your games spatial system, this camera system will not function.
Dependencies
~38–75MB
~1.5M SLoC