Struct embedded_graphics::prelude::Point

pub struct Point {
    pub x: i32,
    pub y: i32,
}

2D point.

A point can be used to define the position of a graphics object. For example, a Rectangle may be defined that has its top left corner at (-1, -2). To specify the size of an object Size should be used instead.

Nalgebra support can be enabled with the nalgebra_support feature. This implements From<Vector2<N>> and From<&Vector2<N>> where N is Scalar + Into<i32>. This allows use of Nalgebra's Vector2 with embedded-graphics where i8, i16, i32, u16 or u8 is used for value storage.

Examples

Create a Point from two integers

use embedded_graphics::geometry::Point;

// Create a coord using the `new` constructor method
let p = Point::new(10, 20);

Create a Point from a Nalgebra Vector2

Be sure to enable the nalgebra_support feature to get Nalgebra integration.

use embedded_graphics::geometry::Point;
use nalgebra::Vector2;

let n_coord = Vector2::new(10i32, 20);

assert_eq!(Point::from(n_coord), Point::new(10, 20));

Convert a Vector2<u8> into a Point

Be sure to enable the nalgebra_support feature to get Nalgebra integration.

Smaller unsigned types that can be converted to i32 are also supported in conversions.

use embedded_graphics::geometry::Point;
use nalgebra::Vector2;
let n_coord = Vector2::new(10u8, 20);

assert_eq!(Point::from(n_coord), Point::new(10, 20));

Fields

x: i32

The x coordinate.

y: i32

The y coordinate.

Methods

impl Point

pub const fn new(x: i32, y: i32) -> Self

Creates a point from X and Y coordinates.

pub const fn zero() -> Self

Creates a point with X and Y equal to zero.

pub fn abs(self) -> Self

Remove the sign from a coordinate

let point = Point::new(-5, -10);

assert_eq!(point.abs(), Point::new(5, 10));

Trait Implementations

impl Add<Point> for Point

type Output = Point

The resulting type after applying the + operator.

fn add(self, other: Point) -> Point

Performs the + operation.

impl Add<Size> for Point

type Output = Point

The resulting type after applying the + operator.

fn add(self, other: Size) -> Point

Offsets a point by adding a size.

Panics

This function will panic if width or height are too large to be represented as an i32 and debug assertions are enabled.

impl AddAssign<Point> for Point

fn add_assign(&mut self, other: Point)

Performs the += operation.

impl AddAssign<Size> for Point

fn add_assign(&mut self, other: Size)

Offsets a point by adding a size.

Panics

This function will panic if width or height are too large to be represented as an i32 and debug assertions are enabled.

impl Clone for Point

fn clone(&self) -> Point

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Point

impl Debug for Point

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

Formats the value using the given formatter.

impl Default for Point

fn default() -> Point

Returns the "default value" for a type.

impl Eq for Point

impl<'_> From<&'_ [i32; 2]> for Point

fn from(other: &[i32; 2]) -> Self

Performs the conversion.

impl<'_, N> From<&'_ Matrix<N, U2, U1, <DefaultAllocator as Allocator<N, U2, U1>>::Buffer>> for Point where
    N: Into<i32> + Scalar, 

fn from(other: &Vector2<N>) -> Self

Performs the conversion.

impl<'_> From<&'_ Point> for (i32, i32)

fn from(other: &Point) -> (i32, i32)

Performs the conversion.

impl From<[i32; 2]> for Point

fn from(other: [i32; 2]) -> Self

Performs the conversion.

impl From<(i32, i32)> for Point

fn from(other: (i32, i32)) -> Self

Performs the conversion.

impl<N> From<Matrix<N, U2, U1, <DefaultAllocator as Allocator<N, U2, U1>>::Buffer>> for Point where
    N: Into<i32> + Scalar, 

fn from(other: Vector2<N>) -> Self

Performs the conversion.

impl From<Point> for (i32, i32)

fn from(other: Point) -> (i32, i32)

Performs the conversion.

impl Index<usize> for Point

type Output = i32

The returned type after indexing.

fn index(&self, idx: usize) -> &i32

Performs the indexing (container[index]) operation.

impl Neg for Point

type Output = Point

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl PartialEq<Point> for Point

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

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

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

This method tests for !=.

impl StructuralEq for Point

impl StructuralPartialEq for Point

impl Sub<Point> for Point

type Output = Point

The resulting type after applying the - operator.

fn sub(self, other: Point) -> Point

Performs the - operation.

impl Sub<Size> for Point

type Output = Point

The resulting type after applying the - operator.

fn sub(self, other: Size) -> Point

Offsets a point by subtracting a size.

Panics

This function will panic if width or height are too large to be represented as an i32 and debug assertions are enabled.

impl SubAssign<Point> for Point

fn sub_assign(&mut self, other: Point)

Performs the -= operation.

impl SubAssign<Size> for Point

fn sub_assign(&mut self, other: Size)

Offsets a point by subtracting a size.

Panics

This function will panic if width or height are too large to be represented as an i32 and debug assertions are enabled.