Struct Quad

Source

pub struct Quad<T = i32, const N: usize = 2>(/* private fields */);

Expand description

A Quad or quadrilateral, a four-sided polygon.

Quad is similar to Rect but the angles between edges are not constrained to 90 degrees.

Please see the module-level documentation for examples.

Implementations§

Source §

impl<T, const N: usize> Quad<T, N>

Source

pub fn new<P1, P2, P3, P4>(p1: P1, p2: P2, p3: P3, p4: P4) -> Self
where P1: Into<Point<T, N>>, P2: Into<Point<T, N>>, P3: Into<Point<T, N>>, P4: Into<Point<T, N>>,

Constructs a Quad with the given Points.

use pix_engine::prelude::*;
let quad = Quad::new([10, 20], [30, 10], [20, 25], [15, 15]);
assert_eq!(quad.p1().coords(), [10, 20]);
assert_eq!(quad.p2().coords(), [30, 10]);
assert_eq!(quad.p3().coords(), [20, 25]);
assert_eq!(quad.p4().coords(), [15, 15]);

Source §

impl<T> Quad<T>

Source

pub const fn from_xy( x1: T, y1: T, x2: T, y2: T, x3: T, y3: T, x4: T, y4: T, ) -> Self

Constructs a Quad from individual x/y coordinates.

Source §

impl<T: Copy> Quad<T>

Source

pub fn coords(&self) -> [T; 8]

Returns Quad coordinates as [x1, y1, x2, y2, x3, y3, x4, y4].

§Example

let quad = Quad::new([10, 20], [30, 10], [20, 25], [15, 15]);
assert_eq!(quad.coords(), [10, 20, 30, 10, 20, 25, 15, 15]);

Source §

impl<T> Quad<T, 3>

Source

pub const fn from_xyz( x1: T, y1: T, z1: T, x2: T, y2: T, z2: T, x3: T, y3: T, z3: T, x4: T, y4: T, z4: T, ) -> Self

Constructs a Quad from individual x/y/z coordinates.

Source §

impl<T: Copy> Quad<T, 3>

Source

pub fn coords(&self) -> [T; 12]

Returns Quad coordinates as [x1, y1, z1, x2, y2, z2, x3, y3, z3, x4, y4, z4].

§Example

let quad = Quad::new([10, 20, 5], [30, 10, 5], [20, 25, 5], [15, 15, 5]);
assert_eq!(quad.coords(), [10, 20, 5, 30, 10, 5, 20, 25, 5, 15, 15, 5]);

Source §

impl<T: Copy, const N: usize> Quad<T, N>

Source

pub fn p1(&self) -> Point<T, N>

Returns the first point of the quad.

Source

pub fn set_p1(&mut self, p: P)
where P: Into<Point<T, N>>,

Sets the first point of the quad.

Source

pub fn p2(&self) -> Point<T, N>

Returns the second point of the quad.

Source

pub fn set_p2(&mut self, p: P)
where P: Into<Point<T, N>>,

Sets the second point of the quad.

Source

pub fn p3(&self) -> Point<T, N>

Returns the third point of the quad.

Source

pub fn set_p3(&mut self, p: P)
where P: Into<Point<T, N>>,

Sets the third point of the quad.

Source

pub fn p4(&self) -> Point<T, N>

Returns the fourth point of the quad.

Source

pub fn set_p4(&mut self, p: P)
where P: Into<Point<T, N>>,

Sets the fourth point of the quad.

Source

pub fn points(&self) -> [Point<T, N>; 4]

Returns Quad points as [Point<T, N>; 4].

§Example

let quad = Quad::new([10, 20], [30, 10], [20, 25], [15, 15]);
assert_eq!(quad.points(), [
    point!(10, 20),
    point!(30, 10),
    point!(20, 25),
    point!(15, 15)
]);

Source

pub fn points_mut(&mut self) -> &mut [Point<T, N>; 4]

Returns Quad points as a mutable slice &mut [Point<T, N>; 4].

§Example

let mut quad = Quad::new([10, 20], [30, 10], [20, 25], [15, 15]);
for p in quad.points_mut() {
    *p += 5;
}
assert_eq!(quad.points(), [
    point!(15, 25),
    point!(35, 15),
    point!(25, 30),
    point!(20, 20)
]);

Source

pub fn to_vec(self) -> Vec<Point<T, N>>

Returns Quad points as a Vec.

§Example

let quad = Quad::new([10, 20], [30, 10], [20, 25], [15, 15]);
assert_eq!(quad.to_vec(), vec![
    point!(10, 20),
    point!(30, 10),
    point!(20, 25),
    point!(15, 15)
]);