pub struct RoundedRectangle {
    pub rectangle: Rectangle,
    pub corners: CornerRadii,
}
Expand description

Rounded rectangle primitive.

Creates a rectangle with rounded corners. Corners can be circular or elliptical in shape, and each corner may have a separate radius applied to it. To create a rounded rectangle with the same radius for each corner, use the with_equal_corners method.

Rounded rectangles with different radii for each corner can be created by passing a CornerRadii configuration struct to the new method.

§Overlapping corners

It is possible to create a RoundedRectangle with corner radii too large to be contained within its edges. When this happens, the corner radii will be confined to fit within the rounded rectangle before use by other parts of embedded-graphics.

This is similar but not identical to how the CSS specification works as it relies on floating point calculations.

§Examples

§Create a uniform rounded rectangle

This example creates a rounded rectangle 50px wide by 60px tall. Using with_equal_corners, all corners are given the same 10px circular radius. The rectangle is drawn using a solid green fill with a 5px red stroke.

use embedded_graphics::{
    pixelcolor::Rgb565,
    prelude::*,
    primitives::{Rectangle, RoundedRectangle, PrimitiveStyle, PrimitiveStyleBuilder},
};

let style = PrimitiveStyleBuilder::new()
    .stroke_width(5)
    .stroke_color(Rgb565::RED)
    .fill_color(Rgb565::GREEN)
    .build();

RoundedRectangle::with_equal_corners(
    Rectangle::new(Point::new(5, 5), Size::new(40, 50)),
    Size::new(10, 10),
)
.into_styled(style)
.draw(&mut display)?;

§Different corner radii

This example creates a rounded rectangle 50px wide by 60px tall. Each corner is given a distinct radius in the x and y direction by creating a CornerRadii object and passing that to RoundedRectangle::new.

use embedded_graphics::{
    pixelcolor::Rgb565,
    prelude::*,
    primitives::{CornerRadiiBuilder, Rectangle, RoundedRectangle, PrimitiveStyle, PrimitiveStyleBuilder},
};

let style = PrimitiveStyleBuilder::new()
    .stroke_width(5)
    .stroke_color(Rgb565::RED)
    .fill_color(Rgb565::GREEN)
    .build();

let radii = CornerRadiiBuilder::new()
    .top_left(Size::new(5, 6))
    .top_right(Size::new(7, 8))
    .bottom_right(Size::new(9, 10))
    .bottom_left(Size::new(11, 12))
    .build();

RoundedRectangle::new(Rectangle::new(Point::new(5, 5), Size::new(40, 50)), radii)
    .into_styled(style)
    .draw(&mut display)?;

§Using CornerRadiiBuilder

This example creates a rounded rectangle 50px wide by 60px tall. Corner radii are set using the CornerRadiiBuilder builder.

use embedded_graphics::{
    pixelcolor::Rgb565,
    prelude::*,
    primitives::{CornerRadii, CornerRadiiBuilder, Rectangle, RoundedRectangle, PrimitiveStyle, PrimitiveStyleBuilder},
};

let style = PrimitiveStyleBuilder::new()
    .stroke_width(5)
    .stroke_color(Rgb565::RED)
    .fill_color(Rgb565::GREEN)
    .build();

let radii = CornerRadiiBuilder::new()
    // Set the top left and top right corner radii to 10 x 20px
    .top(Size::new(10, 20))
    // Set the bottom right corner radius to 5 x 8px
    .bottom_right(Size::new(5, 8))
    .build();

RoundedRectangle::new(Rectangle::new(Point::new(5, 5), Size::new(40, 50)), radii)
    .into_styled(style)
    .draw(&mut display)?;

Fields§

§rectangle: Rectangle

The base rectangle

§corners: CornerRadii

The radius of each corner

Implementations§

source§

impl RoundedRectangle

source

pub const fn new(rectangle: Rectangle, corners: CornerRadii) -> Self

Creates a new rounded rectangle with the given corner radii.

The size and position of the rounded rectangle is determined by the given base rectangle.

source

pub const fn with_equal_corners( rectangle: Rectangle, corner_radius: Size, ) -> Self

Creates a new rounded rectangle with equal corner radius for all corners.

The size and position of the rounded rectangle is determined by the given base rectangle.

source

pub fn confine_radii(&self) -> Self

Return the rounded rectangle with confined corner radii.

This method will return a rounded rectangle of the same width and height, but with all corner radii confined to fit within its base rectangle.

Calling this method is not necessary when using operations provided by embedded-graphics (.into_styled(), .contains(), etc) as these confine the corner radii internally.

§Examples
§Confine corner radii that are too large

This example creates a rounded rectangle 50px x 60px in size. Each corner is set to an equal radius of 40px x 40px. Each edge of the rectangle would thus need to be at least 80px long to contain all corner radii completely. By using confine_radii, the corner radii are reduced to 25px x 25px so that they fit within the 50px x 60px base rectangle.

use embedded_graphics::{
    geometry::{Point, Size},
    primitives::{CornerRadii, CornerRadiiBuilder, Rectangle, RoundedRectangle},
};

let radii = CornerRadiiBuilder::new().all(Size::new(40, 40)).build();

let base_rectangle = Rectangle::new(Point::zero(), Size::new(50, 60));

let rounded_rectangle = RoundedRectangle::new(base_rectangle, radii);

let confined = rounded_rectangle.confine_radii();

assert_eq!(
    confined.corners,
    CornerRadii {
        top_left: Size::new(25, 25),
        top_right: Size::new(25, 25),
        bottom_right: Size::new(25, 25),
        bottom_left: Size::new(25, 25),
    }
);

Trait Implementations§

source§

impl Clone for RoundedRectangle

source§

fn clone(&self) -> RoundedRectangle

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl ContainsPoint for RoundedRectangle

source§

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

Returns true if the given point is inside the shape.
source§

impl Debug for RoundedRectangle

source§

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

Formats the value using the given formatter. Read more
source§

impl Dimensions for RoundedRectangle

source§

fn bounding_box(&self) -> Rectangle

Returns the bounding box.
source§

impl Hash for RoundedRectangle

source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl OffsetOutline for RoundedRectangle

source§

fn offset(&self, offset: i32) -> Self

Offsets the outline of the shape. Read more
source§

impl Ord for RoundedRectangle

source§

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

This method returns an Ordering between self and other. Read more
1.21.0 · source§

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

Compares and returns the maximum of two values. Read more
1.21.0 · source§

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

Compares and returns the minimum of two values. Read more
1.50.0 · source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized + PartialOrd,

Restrict a value to a certain interval. Read more
source§

impl PartialEq for RoundedRectangle

source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

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

impl PartialOrd for RoundedRectangle

source§

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

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · source§

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

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · source§

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

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · source§

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

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · source§

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

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

impl PointsIter for RoundedRectangle

§

type Iter = Points

Iterator over all points inside the primitive.
source§

fn points(&self) -> Self::Iter

Returns an iterator over all points inside the primitive.
source§

impl Primitive for RoundedRectangle

source§

fn into_styled<S>(self, style: S) -> Styled<Self, S>
where Self: Sized,

Converts this primitive into a Styled.
source§

impl<C: PixelColor> StyledDimensions<PrimitiveStyle<C>> for RoundedRectangle

source§

fn styled_bounding_box(&self, style: &PrimitiveStyle<C>) -> Rectangle

Returns the bounding box using the given style.
source§

impl<C: PixelColor> StyledDrawable<PrimitiveStyle<C>> for RoundedRectangle

§

type Color = C

Color type.
§

type Output = ()

Output type.
source§

fn draw_styled<D>( &self, style: &PrimitiveStyle<C>, target: &mut D, ) -> Result<Self::Output, D::Error>
where D: DrawTarget<Color = C>,

Draws the primitive using the given style.
source§

impl Transform for RoundedRectangle

source§

fn translate(&self, by: Point) -> Self

Translate the rounded rectangle from its current position to a new position by (x, y) pixels, returning a new RoundedRectangle. For a mutating transform, see translate_mut.

use embedded_graphics::primitives::{Rectangle, RoundedRectangle};

let original = RoundedRectangle::with_equal_corners(
    Rectangle::new(Point::new(5, 10), Size::new(20, 30)),
    Size::new(10, 15),
);
let moved = original.translate(Point::new(10, 12));

assert_eq!(original.bounding_box().top_left, Point::new(5, 10));
assert_eq!(moved.bounding_box().top_left, Point::new(15, 22));
source§

fn translate_mut(&mut self, by: Point) -> &mut Self

Translate the rounded rectangle from its current position to a new position by (x, y) pixels.

use embedded_graphics::primitives::{Rectangle, RoundedRectangle};

let mut shape = RoundedRectangle::with_equal_corners(
    Rectangle::new(Point::new(5, 10), Size::new(20, 30)),
    Size::new(10, 15),
);

shape.translate_mut(Point::new(10, 12));

assert_eq!(shape.bounding_box().top_left, Point::new(15, 22));
source§

impl Copy for RoundedRectangle

source§

impl Eq for RoundedRectangle

source§

impl StructuralPartialEq for RoundedRectangle

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Az for T

source§

fn az<Dst>(self) -> Dst
where T: Cast<Dst>,

Casts the value.
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<Src, Dst> CastFrom<Src> for Dst
where Src: Cast<Dst>,

source§

fn cast_from(src: Src) -> Dst

Casts the value.
source§

impl<T> CheckedAs for T

source§

fn checked_as<Dst>(self) -> Option<Dst>
where T: CheckedCast<Dst>,

Casts the value.
source§

impl<Src, Dst> CheckedCastFrom<Src> for Dst
where Src: CheckedCast<Dst>,

source§

fn checked_cast_from(src: Src) -> Option<Dst>

Casts the value.
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

default unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> CloneToUninit for T
where T: Copy,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> OverflowingAs for T

source§

fn overflowing_as<Dst>(self) -> (Dst, bool)
where T: OverflowingCast<Dst>,

Casts the value.
source§

impl<Src, Dst> OverflowingCastFrom<Src> for Dst
where Src: OverflowingCast<Dst>,

source§

fn overflowing_cast_from(src: Src) -> (Dst, bool)

Casts the value.
source§

impl<T> SaturatingAs for T

source§

fn saturating_as<Dst>(self) -> Dst
where T: SaturatingCast<Dst>,

Casts the value.
source§

impl<Src, Dst> SaturatingCastFrom<Src> for Dst
where Src: SaturatingCast<Dst>,

source§

fn saturating_cast_from(src: Src) -> Dst

Casts the value.
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> UnwrappedAs for T

source§

fn unwrapped_as<Dst>(self) -> Dst
where T: UnwrappedCast<Dst>,

Casts the value.
source§

impl<Src, Dst> UnwrappedCastFrom<Src> for Dst
where Src: UnwrappedCast<Dst>,

source§

fn unwrapped_cast_from(src: Src) -> Dst

Casts the value.
source§

impl<T> WrappingAs for T

source§

fn wrapping_as<Dst>(self) -> Dst
where T: WrappingCast<Dst>,

Casts the value.
source§

impl<Src, Dst> WrappingCastFrom<Src> for Dst
where Src: WrappingCast<Dst>,

source§

fn wrapping_cast_from(src: Src) -> Dst

Casts the value.