leafwing_input_manager::user_input::gamepad

Struct GamepadVirtualDPad

pub struct GamepadVirtualDPad { /* private fields */ }

Expand description

A virtual dual-axis control constructed from four GamepadButtonTypes. Each button represents a specific direction (up, down, left, right), functioning similarly to a directional pad (D-pad) on both X and Y axes, and offering intermediate diagonals by means of two-button combinations.

By default, it reads from any connected gamepad. Use the InputMap::set_gamepad for specific ones.

§Value Processing

You can customize how the values are processed using a pipeline of processors. See WithDualAxisProcessingPipelineExt for details.

The raw axis values are determined based on the state of the associated buttons:

-1.0 if only the negative button is currently pressed (Down/Left).
1.0 if only the positive button is currently pressed (Up/Right).
0.0 if neither button is pressed, or both are pressed simultaneously.

use bevy::prelude::*;
use bevy::input::InputPlugin;
use leafwing_input_manager::prelude::*;

let mut app = App::new();
app.add_plugins(InputPlugin);

// Define a virtual D-pad using the physical D-pad buttons
let input = GamepadVirtualDPad::DPAD;

// Pressing a D-pad button activates the corresponding axis
GamepadButtonType::DPadUp.press(app.world_mut());
app.update();
assert_eq!(app.read_axis_values(input), [0.0, 1.0]);

// You can configure a processing pipeline (e.g., doubling the Y value)
let doubled = GamepadVirtualDPad::DPAD.sensitivity_y(2.0);
assert_eq!(app.read_axis_values(doubled), [0.0, 2.0]);

Struct GamepadVirtualDPadCopy item path

§Value Processing

Implementations§

impl GamepadVirtualDPad

pub const DPAD: Self = _

pub const ACTION_PAD: Self = _

pub const fn new( up: GamepadButtonType, down: GamepadButtonType, left: GamepadButtonType, right: GamepadButtonType, ) -> Self

Trait Implementations§

impl Clone for GamepadVirtualDPad

fn clone(&self) -> GamepadVirtualDPad

fn clone_from(&mut self, source: &Self)

impl Debug for GamepadVirtualDPad

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl<'de> Deserialize<'de> for GamepadVirtualDPad

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

impl DualAxislike for GamepadVirtualDPad

fn axis_pair(&self, input_store: &CentralInputStore, gamepad: Gamepad) -> Vec2

fn set_axis_pair_as_gamepad( &self, world: &mut World, value: Vec2, gamepad: Option<Gamepad>, )

fn set_axis_pair(&self, world: &mut World, value: Vec2)

impl FromReflect for GamepadVirtualDPadwhere Self: Any + Send + Sync, GamepadButtonType: FromReflect + TypePath + RegisterForReflection, Vec<DualAxisProcessor>: FromReflect + TypePath + RegisterForReflection,

fn from_reflect(reflect: &dyn Reflect) -> Option<Self>

fn take_from_reflect( reflect: Box<dyn Reflect>, ) -> Result<Self, Box<dyn Reflect>>

impl GetTypeRegistration for GamepadVirtualDPadwhere Self: Any + Send + Sync, GamepadButtonType: FromReflect + TypePath + RegisterForReflection, Vec<DualAxisProcessor>: FromReflect + TypePath + RegisterForReflection,

fn get_type_registration() -> TypeRegistration

fn register_type_dependencies(registry: &mut TypeRegistry)

impl Hash for GamepadVirtualDPad

fn hash<__H: Hasher>(&self, state: &mut __H)

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

impl PartialEq for GamepadVirtualDPad

fn eq(&self, other: &GamepadVirtualDPad) -> bool

fn ne(&self, other: &Rhs) -> bool

impl Reflect for GamepadVirtualDPadwhere Self: Any + Send + Sync, GamepadButtonType: FromReflect + TypePath + RegisterForReflection, Vec<DualAxisProcessor>: FromReflect + TypePath + RegisterForReflection,

fn get_represented_type_info(&self) -> Option<&'static TypeInfo>

fn into_any(self: Box<Self>) -> Box<dyn Any>

fn as_any(&self) -> &dyn Any

fn as_any_mut(&mut self) -> &mut dyn Any

fn into_reflect(self: Box<Self>) -> Box<dyn Reflect>

fn as_reflect(&self) -> &dyn Reflect

fn as_reflect_mut(&mut self) -> &mut dyn Reflect

fn clone_value(&self) -> Box<dyn Reflect>

fn set(&mut self, value: Box<dyn Reflect>) -> Result<(), Box<dyn Reflect>>

fn try_apply(&mut self, value: &dyn Reflect) -> Result<(), ApplyError>

fn reflect_kind(&self) -> ReflectKind

fn reflect_ref(&self) -> ReflectRef<'_>

fn reflect_mut(&mut self) -> ReflectMut<'_>

fn reflect_owned(self: Box<Self>) -> ReflectOwned

fn reflect_partial_eq(&self, value: &dyn Reflect) -> Option<bool>

fn apply(&mut self, value: &(dyn Reflect + 'static))

fn reflect_hash(&self) -> Option<u64>

fn debug(&self, f: &mut Formatter<'_>) -> Result<(), Error>

fn serializable(&self) -> Option<Serializable<'_>>

fn is_dynamic(&self) -> bool

impl<'de> RegisterTypeTag<'de, dyn DualAxislike> for GamepadVirtualDPad

fn register_typetag(registry: &mut InfallibleMapRegistry<dyn DualAxislike>)

impl Serialize for GamepadVirtualDPad

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where __S: Serializer,

impl Struct for GamepadVirtualDPadwhere Self: Any + Send + Sync, GamepadButtonType: FromReflect + TypePath + RegisterForReflection, Vec<DualAxisProcessor>: FromReflect + TypePath + RegisterForReflection,

fn field(&self, name: &str) -> Option<&dyn Reflect>

fn field_mut(&mut self, name: &str) -> Option<&mut dyn Reflect>

fn field_at(&self, index: usize) -> Option<&dyn Reflect>

fn field_at_mut(&mut self, index: usize) -> Option<&mut dyn Reflect>

fn name_at(&self, index: usize) -> Option<&str>

fn field_len(&self) -> usize

fn iter_fields(&self) -> FieldIter<'_>

fn clone_dynamic(&self) -> DynamicStruct

impl TypePath for GamepadVirtualDPadwhere Self: Any + Send + Sync,

fn type_path() -> &'static str

fn short_type_path() -> &'static str

fn type_ident() -> Option<&'static str>

fn crate_name() -> Option<&'static str>

fn module_path() -> Option<&'static str>

impl Typed for GamepadVirtualDPadwhere Self: Any + Send + Sync, GamepadButtonType: FromReflect + TypePath + RegisterForReflection, Vec<DualAxisProcessor>: FromReflect + TypePath + RegisterForReflection,

fn type_info() -> &'static TypeInfo

impl UserInput for GamepadVirtualDPad

fn kind(&self) -> InputControlKind

fn decompose(&self) -> BasicInputs

impl WithDualAxisProcessingPipelineExt for GamepadVirtualDPad

fn reset_processing_pipeline(self) -> Self

fn replace_processing_pipeline( self, processor: impl IntoIterator<Item = DualAxisProcessor>, ) -> Self

fn with_processor(self, processor: impl Into<DualAxisProcessor>) -> Self

Struct GamepadVirtualDPad

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
where __D: Deserializer<'de>,

impl FromReflect for GamepadVirtualDPad
where Self: Any + Send + Sync, GamepadButtonType: FromReflect + TypePath + RegisterForReflection, Vec<DualAxisProcessor>: FromReflect + TypePath + RegisterForReflection,

impl GetTypeRegistration for GamepadVirtualDPad
where Self: Any + Send + Sync, GamepadButtonType: FromReflect + TypePath + RegisterForReflection, Vec<DualAxisProcessor>: FromReflect + TypePath + RegisterForReflection,

fn hash<H: Hasher>(&self, state: &mut H)

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

impl Reflect for GamepadVirtualDPad
where Self: Any + Send + Sync, GamepadButtonType: FromReflect + TypePath + RegisterForReflection, Vec<DualAxisProcessor>: FromReflect + TypePath + RegisterForReflection,

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
where S: Serializer,

impl Struct for GamepadVirtualDPad
where Self: Any + Send + Sync, GamepadButtonType: FromReflect + TypePath + RegisterForReflection, Vec<DualAxisProcessor>: FromReflect + TypePath + RegisterForReflection,

impl TypePath for GamepadVirtualDPad
where Self: Any + Send + Sync,

impl Typed for GamepadVirtualDPad
where Self: Any + Send + Sync, GamepadButtonType: FromReflect + TypePath + RegisterForReflection, Vec<DualAxisProcessor>: FromReflect + TypePath + RegisterForReflection,

impl<T> Any for T
where T: 'static + ?Sized,

impl<T, U> AsBindGroupShaderType<U> for T
where U: ShaderType, &'a T: for<'a> Into<U>,

impl<T> Borrow<T> for T
where T: ?Sized,