Struct 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 embedded_graphics::geometry::Size;
use nalgebra::Vector2;

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 embedded_graphics::geometry::Size;
use nalgebra::Vector2;

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

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

Fields

width: u32

The width.

height: u32

The height.

Implementations

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

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.

type Output = Point

The resulting type after applying the + operator.

impl Add for Size

type Output = Size

The resulting type after applying the + operator.

fn add(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 for Size

fn add_assign(&mut self, other: Size)

Performs the += operation.

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

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

Formats the value using the given formatter.

impl Default for Size

fn default() -> Size

Returns the “default value” for a type.

impl Div<u32> for Size

type Output = Size

The resulting type after applying the / operator.

fn div(self, rhs: u32) -> Size

Performs the / operation.

impl DivAssign<u32> for Size

fn div_assign(&mut self, rhs: u32)

Performs the /= operation.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

impl From<[u32; 2]> for Size

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

Converts to this type from the input type.

impl From<(u32, u32)> for Size

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

Converts to this type from the input type.

impl From<Size> for [u32; 2]

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

Converts to this type from the input type.

impl From<Size> for (u32, u32)

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

Converts to this type from the input type.

impl Hash for Size

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 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 Mul<u32> for Size

type Output = Size

The resulting type after applying the * operator.

fn mul(self, rhs: u32) -> Size

Performs the * operation.

impl MulAssign<u32> for Size

fn mul_assign(&mut self, rhs: u32)

Performs the *= operation.

impl Ord for Size

fn cmp(&self, other: &Size) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Size

fn eq(&self, other: &Size) -> 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 PartialOrd for Size

fn partial_cmp(&self, other: &Size) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Sub<Size> for Point

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.

type Output = Point

The resulting type after applying the - operator.

impl Sub for Size

type Output = Size

The resulting type after applying the - operator.

fn sub(self, other: Size) -> 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 for Size

fn sub_assign(&mut self, other: Size)

Performs the -= operation.

impl Copy for Size

impl Eq for Size

impl StructuralPartialEq for Size

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 8 bytes