Struct shape_core::Rectangle

#[repr(C)]
pub struct Rectangle<T> {
    pub min: Point<T>,
    pub max: Point<T>,
}

A non-rotated rectangle, used to represent AABB collision boxes.

Notice

The constructor will not check the legality of the parameters, it is possible that two points coincide, or the side length is negative

Examples

let rect = Rectangle::new(0.0, 0.0, 1.0, 1.0);

Fields

min: Point<T>

origin x points of the rectangle

max: Point<T>

origin y points of the rectangle

Implementations

impl<T> Rectangle<T>

Constructors for rectangle_2d

pub fn new(x: T, y: T, width: T, height: T) -> Selfwhere T: Clone + Add<Output = T>,

Create a rectangle_2d from 4 properties

Notice

The constructor will not check the legality of the parameters, call [is_valid] to ensure that the rectangle_2d is legal.

Examples

let rect = Rectangle::new(0.0, 0.0, 1.0, 1.0);

pub fn from_origin<P>(origin: P, width: T, height: T) -> Selfwhere T: Clone + Add<Output = T>, P: Into<Point<T>>,

Create a rectangle_2d from origin and 2 properties

Notice

The constructor will not check the legality of the parameters, call [is_valid] to ensure that the rectangle_2d is legal.

Examples

let rect = Rectangle::from_origin((0.0, 0.0), 1.0, 1.0);

pub fn from_center<P>(center: P, width: T, height: T) -> Selfwhere T: Clone + One + Add<Output = T> + Sub<Output = T> + Div<Output = T>, P: Into<Point<T>>,

Create a rectangle_2d from center and 2 properties

Notice

The constructor will not check the legality of the parameters, call [is_valid] to ensure that the rectangle_2d is legal.

Examples

let rect = Rectangle::from_center((0.0, 0.0), 1.0, 1.0);

pub fn from_min_max<P1, P2>(min: P1, max: P2) -> Rectangle<T>where P1: Into<Point<T>>, P2: Into<Point<T>>,

Create a rectangle_2d from two diagonal points.

Notice

The constructor will not check the legality of the parameters, it is possible that two points coincide, or the side length is negative

Examples

let rect = Rectangle::from_min_max((0.0, 0.0), (1.0, 1.0));

impl<T> Rectangle<T>

pub fn width(&self) -> Twhere T: Clone + Sub<Output = T>,

Get the width of the rectangle

Examples

let rect = Rectangle::new(0.0, 0.0, 1.0, 1.0);
assert_eq!(rect.width(), 1.0);

pub fn height(&self) -> Twhere T: Clone + Sub<Output = T>,

Get the height of the rectangle

Examples

let rect = Rectangle::new(0.0, 0.0, 1.0, 1.0);
assert_eq!(rect.height(), 1.0);

pub fn origin(&self) -> Point<T>where T: Clone,

Get the origin of the rectangle

Examples

let rect = Rectangle::from_center((0.0, 0.0), 1.0, 1.0);
assert_eq!(rect.origin(), Point::new(-0.5, -0.5));

pub fn center(&self) -> Point<T>where T: Clone + One + Add<Output = T> + Sub<Output = T> + Div<Output = T>,

Get the center point of the rectangle

Examples

let rect = Rectangle::new(0.0, 0.0, 1.0, 1.0);
assert_eq!(rect.center(), Point::new(0.5, 0.5));

pub fn ref_inner(&self) -> Rectangle<&T>

Move reference to the inner value

pub fn contains(&self, point: &Point<T>) -> boolwhere T: Clone + PartialOrd,

pub fn overlaps(&self, other: &Rectangle<T>) -> boolwhere T: Clone + PartialOrd,

pub fn area(&self) -> Twhere T: Clone + Mul<Output = T> + Sub<Output = T>,

Trait Implementations

impl<T: Clone> Clone for Rectangle<T>

fn clone(&self) -> Rectangle<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Rectangle<T>where T: Debug,

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for Rectangle<T>where T: Deserialize<'de>,

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

Deserialize this value from the given Serde deserializer.

impl<T: Display> Display for Rectangle<T>

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

Formats the value using the given formatter.

impl<T: Hash> Hash for Rectangle<T>

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: PartialEq> PartialEq<Rectangle<T>> for Rectangle<T>

fn eq(&self, other: &Rectangle<T>) -> 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<T> Serialize for Rectangle<T>where T: Serialize,

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

Serialize this value into the given Serde serializer.

impl<T> Shape2D for Rectangle<T>where T: Signed + Clone + PartialOrd,

fn is_valid(&self) -> bool

A valid rectangle means it has a positive area.

Examples

let rect = Rectangle::new(0.0, 0.0, 1.0, 1.0);
assert!(rect.is_valid());

fn boundary(&self) -> Rectangle<Self::Value>

SAFETY

It may return a zero area rectangle if shape is not valid.

It never returns a rectangle with negative area.

Examples

let rect = Rectangle::new(0.0, 0.0, -1.0, -1.0);
assert_eq!(rect.boundary(), Rectangle::new(-1.0, -1.0, 0.0, 0.0));

fn vertices(&self, _: usize) -> impl Iterator<Item = Point<Self::Value>> + '_

Returns four vertices counterclockwise in the ↑Y coordinate system

fn edges(&self, _: usize) -> impl Iterator<Item = Line<Self::Value>> + '_

Returns four edges counterclockwise in the ↑Y coordinate system

type Value = T

The value type of the shape.

fn normalize(&mut self) -> bool

Returns true if the shape successfully normalized.

impl<T: Copy> Copy for Rectangle<T>

impl<T: Eq> Eq for Rectangle<T>

impl<T> StructuralEq for Rectangle<T>

impl<T> StructuralPartialEq for Rectangle<T>