Struct embedded_graphics::geometry::Size

pub struct Size {
    pub width: u32,
    pub height: u32,
}

2D size.

Size is used to define the width and height of an object.

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

Examples

Create a Size from two integers

use embedded_graphics::geometry::Size;

// Create a size using the `new` constructor method
let s = Size::new(10, 20);

Create a Size from a Nalgebra Vector2

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

Any Vector2<N> can be used where N: Into<u32> + nalgebra::Scalar. This includes the primitive types u32, u16 and u8.

use nalgebra::Vector2;
use embedded_graphics::geometry::Size;

assert_eq!(Size::from(Vector2::new(10u32, 20)), Size::new(10u32, 20));
assert_eq!(Size::from(Vector2::new(10u16, 20)), Size::new(10u32, 20));
assert_eq!(Size::from(Vector2::new(10u8, 20)), Size::new(10u32, 20));

.into() can also be used, but may require more type annotations:

use nalgebra::Vector2;
use embedded_graphics::geometry::Size;

let c: Size = Vector2::new(10u32, 20).into();

assert_eq!(c, Size::new(10u32, 20));

Fields

width: u32

The width.

height: u32

The height.

Methods

impl Size

pub const fn new(width: u32, height: u32) -> Self

Creates a size from a width and a height.

pub const fn zero() -> Self

Creates a size with width and height equal to zero.

Trait Implementations

impl Debug for Size

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

Formats the value using the given formatter.

impl PartialEq<Size> for Size

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

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

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

This method tests for !=.

impl Eq for Size

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 Add<Size> for Size

type Output = Size

The resulting type after applying the + operator.

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

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 Sub<Size> for Size

type Output = Size

The resulting type after applying the - operator.

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

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 AddAssign<Size> for Size

fn add_assign(&mut self, other: Size)

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.

impl SubAssign<Size> for Size

fn sub_assign(&mut self, other: Size)

Performs the -= operation.

impl Index<usize> for Size

type Output = u32

The returned type after indexing.

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

Performs the indexing (container[index]) operation.

impl Copy for Size

impl From<(u32, u32)> for Size

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

Performs the conversion.

impl From<[u32; 2]> for Size

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

Performs the conversion.

impl<'_> From<&'_ [u32; 2]> for Size

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

Performs the conversion.

impl From<Size> for (u32, u32)

fn from(other: Size) -> (u32, u32)

Performs the conversion.

impl<'_> From<&'_ Size> for (u32, u32)

fn from(other: &Size) -> (u32, u32)

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

impl Clone for Size

fn clone(&self) -> Size

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for Size

fn default() -> Size

Returns the "default value" for a type.