Struct ili9341::Ili9341

pub struct Ili9341<IFACE, RESET> { /* fields omitted */ }

There are two method for drawing to the screen: draw_raw and draw_iter.

In both cases the expected pixel format is rgb565.

The hardware makes it efficient to draw rectangles on the screen.

What happens is the following:

• A drawing window is prepared (with the 2 opposite corner coordinates)
• The starting point for drawint is the top left corner of this window
• Every pair of bytes received is intepreted as a pixel value in rgb565
• As soon as a pixel is received, an internal counter is incremented, and the next word will fill the next pixel (the adjacent on the right, or the first of the next row if the row ended)

Implementations

impl<PinE, IFACE, RESET> Ili9341<IFACE, RESET> where
    IFACE: WriteOnlyDataCommand,
    RESET: OutputPin<Error = PinE>, 

pub fn new<DELAY: DelayMs<u16>>(
    interface: IFACE,
    reset: RESET,
    delay: &mut DELAY
) -> Result<Self, Error<PinE>>

pub fn configure_vertical_scroll(
    &mut self,
    fixed_top_lines: u16,
    fixed_bottom_lines: u16
) -> Result<Scroller, Error<PinE>>

Configures the screen for hardware-accelerated vertical scrolling.

pub fn scroll_vertically(
    &mut self,
    scroller: &mut Scroller,
    num_lines: u16
) -> Result<(), Error<PinE>>

pub fn draw_iter<I: IntoIterator<Item = u16>>(
    &mut self,
    x0: u16,
    y0: u16,
    x1: u16,
    y1: u16,
    data: I
) -> Result<(), Error<PinE>>

Draw a rectangle on the screen, represented by top-left corner (x0, y0) and bottom-right corner (x1, y1).

The border is included.

This method accepts an iterator of rgb565 pixel values.

The iterator is useful to avoid wasting memory by holding a buffer for the whole screen when it is not necessary.

pub fn draw_raw(
    &mut self,
    x0: u16,
    y0: u16,
    x1: u16,
    y1: u16,
    data: &[u16]
) -> Result<(), Error<PinE>>

Draw a rectangle on the screen, represented by top-left corner (x0, y0) and bottom-right corner (x1, y1).

The border is included.

This method accepts a raw buffer of words that will be copied to the screen video memory.

The expected format is rgb565.

pub fn set_orientation(&mut self, mode: Orientation) -> Result<(), Error<PinE>>

Change the orientation of the screen

pub fn width(&self) -> usize

Get the current screen width. It can change based on the current orientation

pub fn height(&self) -> usize

Get the current screen heighth. It can change based on the current orientation

Trait Implementations

impl<PinE, IFACE, RESET> DrawTarget<Rgb565> for Ili9341<IFACE, RESET> where
    IFACE: WriteOnlyDataCommand,
    RESET: OutputPin<Error = PinE>,
    PinE: Debug, 

type Error = Error<PinE>

Error type to return when a drawing operation fails.

fn size(&self) -> Size

Returns the dimensions of the DrawTarget in pixels.

fn draw_pixel(&mut self, pixel: Pixel<Rgb565>) -> Result<(), Self::Error>

Draws a pixel on the display.

fn draw_rectangle(
    &mut self,
    item: &Styled<Rectangle, PrimitiveStyle<Rgb565>>
) -> Result<(), Self::Error>

Draws a styled rectangle primitive.

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

Clears the display with the supplied color.

fn draw_iter<T>(&mut self, item: T) -> Result<(), Self::Error> where
    T: IntoIterator<Item = Pixel<C>>, 

Draws an object from an iterator over its pixels.

fn draw_line(
    &mut self,
    item: &Styled<Line, PrimitiveStyle<C>>
) -> Result<(), Self::Error>

Draws a styled line primitive.

fn draw_triangle(
    &mut self,
    item: &Styled<Triangle, PrimitiveStyle<C>>
) -> Result<(), Self::Error>

Draws a styled triangle primitive.

fn draw_circle(
    &mut self,
    item: &Styled<Circle, PrimitiveStyle<C>>
) -> Result<(), Self::Error>

Draws a styled circle primitive.

fn draw_image<'b, I>(
    &mut self,
    item: &'a Image<'b, I, C>
) -> Result<(), Self::Error> where
    C: PixelColor + From<<C as PixelColor>::Raw>,
    I: ImageDimensions,
    &'b I: IntoPixelIter<C>, 

Draws an image with known size