Struct leafwing_input_manager::action_state::ActionStateDriver

pub struct ActionStateDriver<A: Actionlike> {
    pub action: A,
    pub entity: Entity,
}

A component that allows the attached entity to drive the ActionState of the associated entity

Examples

By default, update_action_state_from_interaction uses this component in order to connect bevy::ui buttons to the corresponding ActionState.

use bevy::prelude::*;
use leafwing_input_manager::prelude::*;

#[derive(Actionlike, Clone, Copy)]
enum DanceDance {
    Left,
    Right,
    Up,
    Down,
}

// Spawn entity to track dance inputs
let mut world = World::new();
let dance_tracker = world
    .spawn()
    .insert(ActionState::<DanceDance>::default())
    .id();

// Spawn a button, which is wired up to the dance tracker
// When used with InputManagerPlugin<DanceDance>, this button will press the DanceDance::Left action when it is pressed.
world
    .spawn()
    .insert_bundle(ButtonBundle::default())
    // This component links the button to the entity with the `ActionState` component
    .insert(ActionStateDriver {
        action: DanceDance::Left,
        entity: dance_tracker,
    });

Writing your own systems that use the ActionStateDriver component is easy, although this should be reserved for cases where the entity whose value you want to check is distinct from the entity whose ActionState you want to set. Check the source code of update_action_state_from_interaction for an example of how this is done.

Fields

action: A

The action triggered by this entity

entity: Entity

The entity whose action state should be updated

Trait Implementations

impl<A: Clone + Actionlike> Clone for ActionStateDriver<A>

fn clone(&self) -> ActionStateDriver<A>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<A: Actionlike> Component for ActionStateDriver<A>where
    Self: Send + Sync + 'static,

type Storage = TableStorage

impl<A: Hash + Actionlike> Hash for ActionStateDriver<A>

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl<A: PartialEq + Actionlike> PartialEq<ActionStateDriver<A>> for ActionStateDriver<A>

fn eq(&self, other: &ActionStateDriver<A>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<A: Copy + Actionlike> Copy for ActionStateDriver<A>

impl<A: Eq + Actionlike> Eq for ActionStateDriver<A>

impl<A: Actionlike> StructuralEq for ActionStateDriver<A>

impl<A: Actionlike> StructuralPartialEq for ActionStateDriver<A>