Struct embedded_graphics::primitives::triangle::Triangle

pub struct Triangle<C: PixelColor> {
    pub p1: Coord,
    pub p2: Coord,
    pub p3: Coord,
    pub style: Style<C>,
}

Triangle primitive

Examples

The macro examples make for more concise code.

Create some triangles with different styles

use embedded_graphics::prelude::*;
use embedded_graphics::primitives::Triangle;

// Default triangle with no styling
let t1 = Triangle::new(Coord::new(10, 20), Coord::new(30, 40), Coord::new(50, 60));

// Triangle with styled stroke from (50, 20) to (60, 35)
let t2 = Triangle::new(Coord::new(50, 20), Coord::new(60, 35), Coord::new(70, 80))
    .stroke(Some(5u8));

// Triangle with translation applied
let t3 = Triangle::new(Coord::new(50, 20), Coord::new(60, 35), Coord::new(70, 80))
    .translate(Coord::new(65, 35));

display.draw(t1);
display.draw(t2);
display.draw(t3);

Fields

p1: Coord

First point of the triangle

p2: Coord

Second point of the triangle

p3: Coord

Third point of the triangle

style: Style<C>

Object style

Methods

impl<C> Triangle<C> where
    C: PixelColor, 

pub fn new(p1: Coord, p2: Coord, p3: Coord) -> Self

Create a new triangle with a given style

Trait Implementations

impl<C: Clone + PixelColor> Clone for Triangle<C>

fn clone(&self) -> Triangle<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C: Copy + PixelColor> Copy for Triangle<C>

impl<C: Debug + PixelColor> Debug for Triangle<C>

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

Formats the value using the given formatter.

impl<C> Dimensions for Triangle<C> where
    C: PixelColor, 

fn top_left(&self) -> Coord

Get the top left corner of the bounding box for an object

fn bottom_right(&self) -> Coord

Get the bottom right corner of the bounding box for an object

fn size(&self) -> UnsignedCoord

Get the width and height for an object

impl<C> Drawable for Triangle<C> where
    C: PixelColor, 

impl<C> IntoIterator for Triangle<C> where
    C: PixelColor, 

type Item = Pixel<C>

The type of the elements being iterated over.

type IntoIter = TriangleIterator<C>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, C> IntoIterator for &'a Triangle<C> where
    C: PixelColor, 

type Item = Pixel<C>

The type of the elements being iterated over.

type IntoIter = TriangleIterator<C>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<C> Primitive for Triangle<C> where
    C: PixelColor, 

impl<C> Transform for Triangle<C> where
    C: PixelColor, 

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

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

let tri = Triangle::new(Coord::new(5, 10), Coord::new(15, 20), Coord::new(8, 15))
let moved = tri.translate(Coord::new(10, 10));

assert_eq!(moved.p1, Coord::new(15, 20));
assert_eq!(moved.p2, Coord::new(25, 30));
assert_eq!(moved.p3, Coord::new(18, 25));

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

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

let mut tri = Triangle::new(Coord::new(5, 10), Coord::new(15, 20), Coord::new(10, 15))
tri.translate_mut(Coord::new(10, 10));

assert_eq!(tri.p1, Coord::new(15, 20));
assert_eq!(tri.p2, Coord::new(25, 30));
assert_eq!(tri.p3, Coord::new(20, 25));

impl<C> WithStyle<C> for Triangle<C> where
    C: PixelColor, 

fn style(self, style: Style<C>) -> Self

Add a complete style to the object

fn stroke(self, color: Option<C>) -> Self

Set the stroke colour for the object

fn stroke_width(self, width: u8) -> Self

Set the stroke width for the object

fn fill(self, color: Option<C>) -> Self

Set the fill property of the object's style