logo
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

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.

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.

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

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Returns true if the given point is inside the shape.

Formats the value using the given formatter. Read more

Returns the bounding box.

Feeds this value into the given Hasher. Read more

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

Offsets the outline of the shape. Read more

This method returns an Ordering between self and other. Read more

Compares and returns the maximum of two values. Read more

Compares and returns the minimum of two values. Read more

Restrict a value to a certain interval. Read more

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

This method tests for !=.

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

This method tests less than (for self and other) and is used by the < operator. Read more

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

This method tests greater than (for self and other) and is used by the > operator. Read more

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

Iterator over all points inside the primitive.

Returns an iterator over all points inside the primitive.

Converts this primitive into a Styled.

Returns the bounding box using the given style.

Color type.

Output type.

Draws the primitive using the given style.

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));

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));

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Casts the value.

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Casts the value.

Casts the value.

Casts the value.

Returns the argument unchanged.

Calls U::from(self).

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

Casts the value.

OverflowingCasts the value.

Casts the value.

Casts the value.

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.

Casts the value.

UnwrappedCasts the value.

Casts the value.

WrappingCasts the value.