Struct bevy::math::Dir2

pub struct Dir2(/* private fields */);

A normalized vector pointing in a direction in 2D space

Implementations

impl Dir2

pub const X: Dir2 = _

A unit vector pointing along the positive X axis.

pub const Y: Dir2 = _

A unit vector pointing along the positive Y axis.

pub const NEG_X: Dir2 = _

A unit vector pointing along the negative X axis.

pub const NEG_Y: Dir2 = _

A unit vector pointing along the negative Y axis.

pub fn new(value: Vec2) -> Result<Dir2, InvalidDirectionError>

Create a direction from a finite, nonzero Vec2.

Returns Err(InvalidDirectionError) if the length of the given vector is zero (or very close to zero), infinite, or NaN.

pub fn new_unchecked(value: Vec2) -> Dir2

Create a Dir2 from a Vec2 that is already normalized.

Warning

value must be normalized, i.e its length must be 1.0.

Examples found in repository

examples/2d/bounding_2d.rs (line 308)

fn get_and_draw_ray(gizmos: &mut Gizmos, time: &Time) -> RayCast2d {
    let ray = Vec2::new(time.elapsed_seconds().cos(), time.elapsed_seconds().sin());
    let dist = 150. + (0.5 * time.elapsed_seconds()).sin().abs() * 500.;

    let aabb_ray = Ray2d {
        origin: ray * 250.,
        direction: Dir2::new_unchecked(-ray),
    };
    let ray_cast = RayCast2d::from_ray(aabb_ray, dist - 20.);

    draw_ray(gizmos, &ray_cast);
    ray_cast
}

pub fn new_and_length(value: Vec2) -> Result<(Dir2, f32), InvalidDirectionError>

Create a direction from a finite, nonzero Vec2, also returning its original length.

Returns Err(InvalidDirectionError) if the length of the given vector is zero (or very close to zero), infinite, or NaN.

pub fn from_xy(x: f32, y: f32) -> Result<Dir2, InvalidDirectionError>

Create a direction from its x and y components.

Returns Err(InvalidDirectionError) if the length of the vector formed by the components is zero (or very close to zero), infinite, or NaN.

Examples found in repository

examples/2d/bounding_2d.rs (line 241)

fn setup(mut commands: Commands, loader: Res<AssetServer>) {
    commands.spawn(Camera2dBundle::default());
    commands.spawn((
        SpatialBundle {
            transform: Transform::from_xyz(-OFFSET_X, OFFSET_Y, 0.),
            ..default()
        },
        Shape::Circle(Circle::new(45.)),
        DesiredVolume::Aabb,
        Intersects::default(),
    ));

    commands.spawn((
        SpatialBundle {
            transform: Transform::from_xyz(0., OFFSET_Y, 0.),
            ..default()
        },
        Shape::Rectangle(Rectangle::new(80., 80.)),
        Spin,
        DesiredVolume::Circle,
        Intersects::default(),
    ));

    commands.spawn((
        SpatialBundle {
            transform: Transform::from_xyz(OFFSET_X, OFFSET_Y, 0.),
            ..default()
        },
        Shape::Triangle(Triangle2d::new(
            Vec2::new(-40., -40.),
            Vec2::new(-20., 40.),
            Vec2::new(40., 50.),
        )),
        Spin,
        DesiredVolume::Aabb,
        Intersects::default(),
    ));

    commands.spawn((
        SpatialBundle {
            transform: Transform::from_xyz(-OFFSET_X, -OFFSET_Y, 0.),
            ..default()
        },
        Shape::Line(Segment2d::new(Dir2::from_xy(1., 0.3).unwrap(), 90.)),
        Spin,
        DesiredVolume::Circle,
        Intersects::default(),
    ));

    commands.spawn((
        SpatialBundle {
            transform: Transform::from_xyz(0., -OFFSET_Y, 0.),
            ..default()
        },
        Shape::Capsule(Capsule2d::new(25., 50.)),
        Spin,
        DesiredVolume::Aabb,
        Intersects::default(),
    ));

    commands.spawn((
        SpatialBundle {
            transform: Transform::from_xyz(OFFSET_X, -OFFSET_Y, 0.),
            ..default()
        },
        Shape::Polygon(RegularPolygon::new(50., 6)),
        Spin,
        DesiredVolume::Circle,
        Intersects::default(),
    ));

    commands.spawn(
        TextBundle::from_section(
            "",
            TextStyle {
                font: loader.load("fonts/FiraMono-Medium.ttf"),
                font_size: 26.0,
                ..default()
            },
        )
        .with_style(Style {
            position_type: PositionType::Absolute,
            bottom: Val::Px(10.0),
            left: Val::Px(10.0),
            ..default()
        }),
    );
}

pub const fn as_vec2(&self) -> Vec2

Returns the inner Vec2

Methods from Deref<Target = Vec2>

pub const ZERO: Vec2 = _

pub const ONE: Vec2 = _

pub const NEG_ONE: Vec2 = _

pub const MIN: Vec2 = _

pub const MAX: Vec2 = _

pub const NAN: Vec2 = _

pub const INFINITY: Vec2 = _

pub const NEG_INFINITY: Vec2 = _

pub const X: Vec2 = _

pub const Y: Vec2 = _

pub const NEG_X: Vec2 = _

pub const NEG_Y: Vec2 = _

pub const AXES: [Vec2; 2] = _

pub fn to_array(&self) -> [f32; 2]

[x, y]

pub fn as_dvec2(&self) -> DVec2

Casts all elements of self to f64.

pub fn as_i16vec2(&self) -> I16Vec2

Casts all elements of self to i16.

pub fn as_u16vec2(&self) -> U16Vec2

Casts all elements of self to u16.

pub fn as_ivec2(&self) -> IVec2

Casts all elements of self to i32.

pub fn as_uvec2(&self) -> UVec2

Casts all elements of self to u32.

pub fn as_i64vec2(&self) -> I64Vec2

Casts all elements of self to i64.

pub fn as_u64vec2(&self) -> U64Vec2

Casts all elements of self to u64.

Trait Implementations

impl Clone for Dir2

fn clone(&self) -> Dir2

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Dir2

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

Formats the value using the given formatter.

impl Deref for Dir2

type Target = Vec2

The resulting type after dereferencing.

fn deref(&self) -> &<Dir2 as Deref>::Target

Dereferences the value.

impl<'de> Deserialize<'de> for Dir2

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Dir2> for Vec2

fn from(value: Dir2) -> Vec2

Converts to this type from the input type.

impl FromReflect for Dir2

where Dir2: Any + Send + Sync,

fn from_reflect(reflect: &(dyn Reflect + 'static)) -> Option<Dir2>

Constructs a concrete instance of Self from a reflected value.

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

Attempts to downcast the given value to Self using, constructing the value using from_reflect if that fails.

impl FromRng for Dir2

fn from_rng<R>(rng: &mut R) -> Self

where R: Rng + ?Sized,

Construct a value of this type uniformly at random using rng as the source of randomness.

impl GetTypeRegistration for Dir2

where Dir2: Any + Send + Sync,

fn get_type_registration() -> TypeRegistration

Returns the default TypeRegistration for this type.

fn register_type_dependencies(registry: &mut TypeRegistry)

Registers other types needed by this type.

impl<'w, 's, Config, Clear> GizmoPrimitive2d<Dir2> for Gizmos<'w, 's, Config, Clear>

where Config: GizmoConfigGroup, Clear: 'static + Send + Sync,

type Output<'a> = () where Gizmos<'w, 's, Config, Clear>: 'a

The output of primitive_2d. This is a builder to set non-default values.

fn primitive_2d( &mut self, primitive: Dir2, position: Vec2, angle: f32, color: impl Into<Color> ) -> <Gizmos<'w, 's, Config, Clear> as GizmoPrimitive2d<Dir2>>::Output<'_>

Renders a 2D primitive with its associated details.

impl Mul<Dir2> for Rotation2d

fn mul(self, direction: Dir2) -> <Rotation2d as Mul<Dir2>>::Output

Rotates the Dir2 using a Rotation2d.

type Output = Dir2

The resulting type after applying the * operator.

impl Mul<Dir2> for f32

type Output = Vec2

The resulting type after applying the * operator.

fn mul(self, rhs: Dir2) -> <f32 as Mul<Dir2>>::Output

Performs the * operation.

impl Mul<f32> for Dir2

type Output = Vec2

The resulting type after applying the * operator.

fn mul(self, rhs: f32) -> <Dir2 as Mul<f32>>::Output

Performs the * operation.

impl Neg for Dir2

type Output = Dir2

The resulting type after applying the - operator.

fn neg(self) -> <Dir2 as Neg>::Output

Performs the unary - operation.

impl PartialEq for Dir2

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

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

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 Reflect for Dir2

where Dir2: Any + Send + Sync,

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

Returns the TypeInfo of the type represented by this value.

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

Returns the value as a Box<dyn Any>.

fn as_any(&self) -> &(dyn Any + 'static)

Returns the value as a &dyn Any.

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Returns the value as a &mut dyn Any.

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

Casts this type to a boxed reflected value.

fn as_reflect(&self) -> &(dyn Reflect + 'static)

Casts this type to a reflected value.

fn as_reflect_mut(&mut self) -> &mut (dyn Reflect + 'static)

Casts this type to a mutable reflected value.

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

Clones the value as a Reflect trait object.

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

Applies a reflected value to this value.

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

Performs a type-checked assignment of a reflected value to this value.

fn reflect_kind(&self) -> ReflectKind

Returns a zero-sized enumeration of “kinds” of type.

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

Returns an immutable enumeration of “kinds” of type.

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

Returns a mutable enumeration of “kinds” of type.

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

Returns an owned enumeration of “kinds” of type.

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

Returns a “partial equality” comparison result.

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

Debug formatter for the value.

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

Returns a hash of the value (which includes the type).

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

Returns a serializable version of the value.

fn is_dynamic(&self) -> bool

Indicates whether or not this type is a dynamic type.

impl Serialize for Dir2

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<Vec2> for Dir2

type Error = InvalidDirectionError

The type returned in the event of a conversion error.

fn try_from(value: Vec2) -> Result<Dir2, <Dir2 as TryFrom<Vec2>>::Error>

Performs the conversion.

impl TypePath for Dir2

where Dir2: Any + Send + Sync,

fn type_path() -> &'static str

Returns the fully qualified path of the underlying type.

fn short_type_path() -> &'static str

Returns a short, pretty-print enabled path to the type.

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

Returns the name of the type, or None if it is anonymous.

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

Returns the name of the crate the type is in, or None if it is anonymous.

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

Returns the path to the module the type is in, or None if it is anonymous.

impl Typed for Dir2

where Dir2: Any + Send + Sync,

fn type_info() -> &'static TypeInfo

Returns the compile-time info for the underlying type.

impl Copy for Dir2

impl Primitive2d for Dir2

impl StructuralPartialEq for Dir2