avian_pickup 0.5.0

A plugin for implementing picking up dynamic rigid bodies in Avian physics for the Bevy engine. Modeled after Half Life 2's gravity gun.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

use crate::prelude::*;
use avian3d::math::{Scalar, TAU};

pub(super) fn plugin(_app: &mut App) {}

#[derive(Debug, Copy, Clone, Component)]
pub(crate) struct ShadowParams {
    /// Global target position of the held prop
    pub(crate) target_position: Vec3,
    /// Global target rotation of the held prop
    pub(crate) target_rotation: Quat,
    pub(crate) max_angular: Scalar,
    pub(crate) max_speed: Scalar,
}

impl Default for ShadowParams {
    fn default() -> Self {
        Self {
            target_position: Vec3::ZERO,
            target_rotation: Quat::IDENTITY,
            // the following two are tuned by hand
            max_angular: TAU * 2.0,
            max_speed: 10.0,
        }
    }
}

/// Cache for accumulating errors when holding an object.
/// When this reaches a critical value, the object will be dropped.
#[derive(Debug, Copy, Clone, Component)]
pub(crate) struct HoldError {
    /// Time until error starts accumulating
    pub(crate) error_time: f32,
    /// The distance between the object and the target position
    pub(crate) error: f32,
}

impl HoldError {
    pub(crate) fn reset(&mut self) {
        *self = Self::default();
    }
}

impl Default for HoldError {
    fn default() -> Self {
        Self {
            // 1 second until error starts accumulating
            error_time: -1.0,
            error: 0.0,
        }
    }
}