Struct embedded_graphics_framebuf::FrameBuf

source · [−]

pub struct FrameBuf<C: PixelColor, B: FrameBufferBackend<Color = C>> {
    pub data: B,
    /* private fields */
}

Expand description

Constructs a frame buffer in memory. Lets you define the width(X), height (Y) and pixel type your using in your display (RGB, Monochrome etc.)

Example

use embedded_graphics::{
    mono_font::{ascii::FONT_10X20, MonoTextStyle},
    pixelcolor::Rgb565,
    prelude::*,
    text::Text,
};
use embedded_graphics_framebuf::FrameBuf;

// Create a framebuffer for a 16-Bit 240x135px display
let mut data = [Rgb565::BLACK; 240 * 135];
let mut fbuff = FrameBuf::new(&mut data, 240, 135);

// write "Good luck" into the framebuffer.
Text::new(
    &"Good luck!",
    Point::new(10, 13),
    MonoTextStyle::new(&FONT_10X20, Rgb565::WHITE.into()),
)
.draw(&mut fbuff)
.unwrap();

Fields

data: B

Implementations

source

impl<C: PixelColor, B: FrameBufferBackend<Color = C>> FrameBuf<C, B>

source

pub fn new(data: B, width: usize, height: usize) -> Self

Create a new FrameBuf on top of an existing memory slice.

Panic

Panics if the size of the memory does not match the given width and height.

Example

use embedded_graphics::{pixelcolor::Rgb565, prelude::RgbColor};
use embedded_graphics_framebuf::FrameBuf;
let mut data = [Rgb565::BLACK; 240 * 135];
let mut fbuff = FrameBuf::new(&mut data, 240, 135);

source

pub fn width(&self) -> usize

Get the framebuffers width.

source

pub fn height(&self) -> usize

Get the framebuffers height.

source

pub fn set_color_at(&mut self, p: Point, color: C)

Set a pixel’s color.

source

pub fn get_color_at(&self, p: Point) -> C

Get a pixel’s color.

source

impl<C: PixelColor + Default, B: FrameBufferBackend<Color = C>> FrameBuf<C, B>

source

pub fn reset(&mut self)

Trait Implementations

source

impl<C: PixelColor, B: FrameBufferBackend<Color = C>> DrawTarget for FrameBuf<C, B>

type Color = C

The pixel color type the targetted display supports.

type Error = Infallible

Error type to return when a drawing operation fails. Read more

source

fn draw_iter(&mut self, pixels: I) -> Result<(), Self::Error> where
I: IntoIterator<Item = Pixel<Self::Color>>,

Draw individual pixels to the display without a defined order. Read more

source

fn clear(&mut self, color: Self::Color) -> Result<(), Self::Error>

Fill the entire display with a solid color. Read more

fn fill_contiguous(
 &mut self,
 area: &Rectangle,
 colors: I
) -> Result<(), Self::Error> where
 I: IntoIterator<Item = Self::Color>,

Fill a given area with an iterator providing a contiguous stream of pixel colors. Read more

fn fill_solid(
 &mut self,
 area: &Rectangle,
 color: Self::Color
) -> Result<(), Self::Error>

Fill a given area with a solid color. Read more

source

impl<'a, C: PixelColor, B: FrameBufferBackend<Color = C>> IntoIterator for &'a FrameBuf<C, B>

source

fn into_iter(self) -> Self::IntoIter

Creates an iterator over all Pixels in the frame buffer. Can be used for rendering the framebuffer to the physical display.

Example

use embedded_graphics::{
    draw_target::DrawTarget,
    mock_display::MockDisplay,
    pixelcolor::BinaryColor,
    prelude::{Point, Primitive},
    primitives::{Line, PrimitiveStyle},
    Drawable,
};
use embedded_graphics_framebuf::FrameBuf;
let mut data = [BinaryColor::Off; 12 * 11];
let mut fbuf = FrameBuf::new(&mut data, 12, 11);
let mut display: MockDisplay<BinaryColor> = MockDisplay::new();
Line::new(Point::new(2, 2), Point::new(10, 2))
    .into_styled(PrimitiveStyle::with_stroke(BinaryColor::On, 2))
    .draw(&mut fbuf)
    .unwrap();
display.draw_iter(fbuf.into_iter()).unwrap();