1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72
//! # Embedded graphics
//!
//! This crate aims to make drawing 2D graphics primitives super easy. It currently supports the
//! following:
//!
//! * [1 bit-per-pixel images](./image/struct.Image1BPP.html)
//! * [8 bits-per-pixel images](./image/struct.Image8BPP.html)
//! * [16 bits-per-pixel images](./image/struct.Image16BPP.html)
//! * [Primitives](./primitives/index.html)
//! * Lines
//! * Rectangles (and squares)
//! * Circles
//! * [Text with multiple fonts](./fonts/index.html#types)
//!
//! A core goal is to do the above without using any buffers; the crate should work without a
//! dynamic memory allocator and without pre-allocating large chunks of memory. To achieve this, it
//! takes an `Iterator` based approach, where pixel values and positions are calculated on the fly,
//! with the minimum of saved state. This allows the consuming application to use far less RAM at
//! little to no performance penalty.
//!
//! To use this crate in a driver, you only need to implement the `Drawing` trait to start drawing
//! things.
//!
//! You can also add your own objects by implementing `IntoIterator<Item = Pixel<C>>` to create an
//! iterator that `Drawable#draw()` can consume.
//!
//! ## Crate features
//!
//! * `nalgebra_support` - use the [Nalgebra](https://crates.io/crates/nalgebra) crate with `no_std`
//! support to use as the `Coord` type. This should allow you to use most Nalgebra methods on
//! objects rendered by embedded_graphics.
#![no_std]
#![deny(missing_docs)]
#![deny(missing_debug_implementations)]
#![deny(missing_copy_implementations)]
#![deny(trivial_casts)]
#![deny(trivial_numeric_casts)]
#![deny(unsafe_code)]
#![deny(unstable_features)]
#![deny(unused_import_braces)]
#![deny(unused_qualifications)]
#[cfg(feature = "nalgebra_support")]
extern crate nalgebra;
pub mod coord;
pub mod dev;
pub mod drawable;
pub mod fonts;
pub mod image;
#[cfg(test)]
pub(crate) mod mock_display;
pub mod pixelcolor;
pub mod prelude;
pub mod primitives;
pub mod style;
pub mod transform;
pub mod unsignedcoord;
use pixelcolor::PixelColor;
/// The main trait of this crate. All graphics objects must implement it.
pub trait Drawing<C>
where
C: PixelColor + Clone,
{
/// Draw an object from an iterator over its pixels
fn draw<T>(&mut self, item_pixels: T)
where
T: Iterator<Item = drawable::Pixel<C>>;
}