Struct bevy::input::touch::Touch

pub struct Touch { /* private fields */ }

A touch input.

Usage

It is used to store the position and force of a touch input and also the id of the finger. The data of the touch input comes from the TouchInput event and is being stored inside of the Touches bevy resource.

Implementations

impl Touch

pub fn delta(&self) -> Vec2

The delta of the current position and the previous_position.

pub fn distance(&self) -> Vec2

The distance of the start_position and the current position.

pub fn id(&self) -> u64

Returns the id of the touch.

Examples found in repository

examples/input/touch_input.rs (line 16)

fn touch_system(touches: Res<Touches>) {
    for touch in touches.iter_just_pressed() {
        info!(
            "just pressed touch with id: {:?}, at: {:?}",
            touch.id(),
            touch.position()
        );
    }

    for touch in touches.iter_just_released() {
        info!(
            "just released touch with id: {:?}, at: {:?}",
            touch.id(),
            touch.position()
        );
    }

    for touch in touches.iter_just_canceled() {
        info!("canceled touch with id: {:?}", touch.id());
    }

    // you can also iterate all current touches and retrieve their state like this:
    for touch in touches.iter() {
        info!("active touch: {:?}", touch);
        info!("  just_pressed: {}", touches.just_pressed(touch.id()));
    }
}

pub fn start_position(&self) -> Vec2

Returns the start_position of the touch.

pub fn start_force(&self) -> Option<ForceTouch>

Returns the start_force of the touch.

pub fn previous_position(&self) -> Vec2

Returns the previous_position of the touch.

pub fn previous_force(&self) -> Option<ForceTouch>

Returns the previous_force of the touch.

pub fn position(&self) -> Vec2

Returns the current position of the touch.

Examples found in repository

examples/input/touch_input.rs (line 17)

fn touch_system(touches: Res<Touches>) {
    for touch in touches.iter_just_pressed() {
        info!(
            "just pressed touch with id: {:?}, at: {:?}",
            touch.id(),
            touch.position()
        );
    }

    for touch in touches.iter_just_released() {
        info!(
            "just released touch with id: {:?}, at: {:?}",
            touch.id(),
            touch.position()
        );
    }

    for touch in touches.iter_just_canceled() {
        info!("canceled touch with id: {:?}", touch.id());
    }

    // you can also iterate all current touches and retrieve their state like this:
    for touch in touches.iter() {
        info!("active touch: {:?}", touch);
        info!("  just_pressed: {}", touches.just_pressed(touch.id()));
    }
}

pub fn force(&self) -> Option<ForceTouch>

Returns the current force of the touch.

Trait Implementations

impl Clone for Touch

fn clone(&self) -> Touch

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Touch

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

Formats the value using the given formatter.

impl From<&TouchInput> for Touch

fn from(input: &TouchInput) -> Touch

Converts to this type from the input type.

impl Copy for Touch