Struct Rectangle 

pub struct Rectangle<T = f32> {
    pub x: T,
    pub y: T,
    pub width: T,
    pub height: T,
}

An axis-aligned rectangle.

Fields

x: T

X coordinate of the top-left corner.

y: T

Y coordinate of the top-left corner.

width: T

Width of the rectangle.

height: T

Height of the rectangle.

Implementations

impl<T> Rectangle<T>

where T: Default,

pub fn with_size(size: Size<T>) -> Self

Creates a new Rectangle with its top-left corner at the origin and with the provided Size.

impl Rectangle<f32>

pub const INFINITE: Self

A rectangle starting at negative infinity and with infinite width and height.

pub const fn new(top_left: Point, size: Size) -> Self

Creates a new Rectangle with its top-left corner in the given Point and with the provided Size.

pub fn with_radius(radius: f32) -> Self

Creates a new square Rectangle with the center at the origin and with the given radius.

pub fn with_vertices( top_left: Point, top_right: Point, bottom_left: Point, ) -> (Rectangle, Radians)

Creates a new axis-aligned Rectangle from the given vertices; returning the rotation in Radians that must be applied to the axis-aligned Rectangle to obtain the desired result.

pub fn center(&self) -> Point

Returns the Point at the center of the Rectangle.

pub fn center_x(&self) -> f32

Returns the X coordinate of the Point at the center of the Rectangle.

pub fn center_y(&self) -> f32

Returns the Y coordinate of the Point at the center of the Rectangle.

pub fn position(&self) -> Point

Returns the position of the top left corner of the Rectangle.

pub fn size(&self) -> Size

Returns the Size of the Rectangle.

pub fn area(&self) -> f32

Returns the area of the Rectangle.

pub fn contains(&self, point: Point) -> bool

Returns true if the given Point is contained in the Rectangle. Excludes the right and bottom edges.

pub fn distance(&self, point: Point) -> f32

Returns the minimum distance from the given Point to any of the edges of the Rectangle.

pub fn offset(&self, container: &Rectangle) -> Vector

Computes the offset that must be applied to the Rectangle to be placed inside the given container.

pub fn is_within(&self, container: &Rectangle) -> bool

Returns true if the current Rectangle is within the given container. Includes the right and bottom edges.

pub fn intersection(&self, other: &Rectangle<f32>) -> Option<Rectangle<f32>>

Computes the intersection with the given Rectangle.

pub fn intersects(&self, other: &Self) -> bool

Returns whether the Rectangle intersects with the given one.

pub fn union(&self, other: &Self) -> Self

Computes the union with the given Rectangle.

pub fn round(self) -> Self

Rounds the Rectangle coordinates.

pub fn snap(self) -> Option<Rectangle<u32>>

Snaps the Rectangle to unsigned integer coordinates.

pub fn expand(self, padding: impl Into<Padding>) -> Self

Expands the Rectangle a given amount.

pub fn shrink(self, padding: impl Into<Padding>) -> Self

Shrinks the Rectangle a given amount.

pub fn rotate(self, rotation: Radians) -> Self

Rotates the Rectangle and returns the smallest Rectangle containing it.

pub fn zoom(self, zoom: f32) -> Self

Scales the Rectangle without changing its position, effectively “zooming” it.

pub fn anchor( &self, size: Size, align_x: impl Into<Horizontal>, align_y: impl Into<Vertical>, ) -> Point

Returns the top-left position to render an object of the given Size. inside the Rectangle that is anchored to the edge or corner defined by the alignment arguments.

pub fn chord(&self, angle: impl Into<Radians>) -> (Point, Point)

Returns the two endpoints of a chord through the rectangle’s center at the given angle.

The angle is measured clockwise from the negative y-axis, so 0 produces a vertical chord and π/2 a horizontal one. The returned points are (start, end), symmetric about Rectangle::center.

Trait Implementations

impl<T> Add<Vector<T>> for Rectangle<T>

where T: Add<Output = T>,

type Output = Rectangle<T>

The resulting type after applying the + operator.

fn add(self, translation: Vector<T>) -> Self

Performs the + operation.

impl<T> AddAssign<Vector<T>> for Rectangle<T>

where T: AddAssign,

fn add_assign(&mut self, translation: Vector<T>)

Performs the += operation.

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

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

impl<T: Default> Default for Rectangle<T>

fn default() -> Rectangle<T>

Returns the “default value” for a type.

impl From<Rectangle<u32>> for Rectangle<f32>

fn from(rectangle: Rectangle<u32>) -> Rectangle<f32>

Converts to this type from the input type.

impl Mul<Transformation> for Rectangle

type Output = Rectangle

The resulting type after applying the * operator.

fn mul(self, transformation: Transformation) -> Self

Performs the * operation.

impl Mul<f32> for Rectangle<f32>

type Output = Rectangle

The resulting type after applying the * operator.

fn mul(self, scale: f32) -> Self

Performs the * operation.

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

fn eq(&self, other: &Rectangle<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<T> Sub<Vector<T>> for Rectangle<T>

where T: Sub<Output = T>,

type Output = Rectangle<T>

The resulting type after applying the - operator.

fn sub(self, translation: Vector<T>) -> Self

Performs the - operation.

impl<T> SubAssign<Vector<T>> for Rectangle<T>

where T: SubAssign,

fn sub_assign(&mut self, translation: Vector<T>)

Performs the -= operation.

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

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

impl<T> StructuralPartialEq for Rectangle<T>