Struct pixels_graphics_lib::prelude::Graphics

pub struct Graphics<'buffer> {
    pub custom_font: HashMap<u8, CustomLetter, BuildHasherDefault<FnvHasher>>,
    /* private fields */
}

Fields

custom_font: HashMap<u8, CustomLetter, BuildHasherDefault<FnvHasher>>

Allows you to replace any supported ASCII with a custom glyph To replace ‘a’ with ‘█’ for 4x5 fonts (such as Standard4x5) write

graphics.custom_font.insert(chr_to_code('a'), CustomLetter { _4x5: [true; 20], ..CustomLetter::default });

Characters are replaced on a size basis, so if _4x4 is provided then all _4x4 fonts will draw this custom character

Whitespace isn’t supported and is skipped when drawing

Note: A-Za-z0-9!@$%^&*(),./;'\\[]<>?:\"{}_+~#…¤£¥¢✓|€ are valid for text::chr_to_code

Implementations

impl Graphics<'_>

pub fn index(&self, x: usize, y: usize) -> usize

Convert an x,y coord to idx for use with self.pixels

pub fn width(&self) -> usize

pub fn height(&self) -> usize

pub fn is_on_screen(&self, point: Coord) -> bool

impl Graphics<'_>

pub fn get_translate(&self) -> Coord

Get the canvas offset in pixels

pub fn set_translate(&mut self, new_value: Coord) -> Coord

Set the canvas offset in pixels

All drawing commands will be offset by this value

Returns

The previous translate value

pub fn with_translate<F>(&mut self, set: Coord, method: F)

where F: Fn(&mut Graphics<'_>),

pub fn update_translate(&mut self, delta: Coord)

Adds delta to the current canvas offset

pub fn copy_to_image(&self) -> Image

Copy entire pixels array to an image

pub fn get_px_for_char( col: usize, row: usize, font: &PixelFont ) -> (usize, usize)

Get top left pixel coord for letter col row

pub fn draw_image_unchecked<P>(&mut self, xy: P, image: &Image)

where P: Into<Coord>,

Draw an image at x, y as fast as possible If the image may draw outside the window you must use [draw_image] instead Ignores clipping and translation for opaque images

pub fn draw_image<P>(&mut self, xy: P, image: &Image)

where P: Into<Coord>,

Draw an image at x, y If the image definitely will draw inside the window you can use [draw_image_unchecked] instead

pub fn draw_indexed_image<P>(&mut self, xy: P, image: &IndexedImage)

where P: Into<Coord>,

Draw an indexed image at x, y

pub fn draw_wrapped_image<P>(&mut self, xy: P, image: &IndexedWrapper)

where P: Into<Coord>,

pub fn draw_animated_image<P>(&mut self, xy: P, image: &AnimatedIndexedImage)

where P: Into<Coord>,

Draw an animated image at x, y

pub fn draw_arc( &mut self, center: Coord, angle_start: isize, angle_end: isize, radius: usize, close: bool, color: Color )

pub fn draw_line<P1, P2>(&mut self, start: P1, end: P2, color: Color)

where P1: Into<Coord>, P2: Into<Coord>,

pub fn draw_offset<T, P>(&mut self, xy: P, renderable: &dyn Renderable<T>)

where P: Into<Coord>,

Draw renderable offset by [xy]

pub fn draw<T>(&mut self, renderable: &dyn Renderable<T>)

Draw renderable

pub fn get_pixel( &mut self, x: isize, y: isize, use_translate: bool ) -> Option<Color>

Get the RGB values for a pixel Alpha will always be 255

If use_translate is true than the x,y will be updated with self.translate

Although the method takes &mut self it doesn’t mutate anything

pub fn clear(&mut self, color: Color)

Sets every pixel to the same color, this ignores translate and clip

pub fn clear_aware(&mut self, color: Color)

Sets every pixel to the same color, same as [clear] but this follows translate and clip

pub fn draw_letter( &mut self, pos: (isize, isize), chr: char, font: PixelFont, color: Color )

Draw a letter at pos

pub fn draw_ascii_letter( &mut self, pos: (isize, isize), code: u8, font: PixelFont, color: Color )

pub fn draw_ascii<P, F>(&mut self, text: &[Vec<u8>], pos: P, format: F)

where P: Into<TextPos>, F: Into<TextFormat>,

Should only be used by Text::render text param must already be corrected wrapped

pub fn draw_text<P, F>(&mut self, text: &str, pos: P, format: F)

where P: Into<TextPos>, F: Into<TextFormat>,

pub fn draw_rect<R>(&mut self, rect: R, draw_type: DrawType)

where R: Into<Rect>,

pub fn draw_circle<C>(&mut self, circle: C, draw_type: DrawType)

where C: Into<Circle>,

pub fn draw_polygon<P>(&mut self, polygon: P, draw_type: DrawType)

where P: Into<Polygon>,

pub fn draw_triangle<T>(&mut self, triangle: T, draw_type: DrawType)

where T: Into<Triangle>,

pub fn draw_ellipse<E>(&mut self, ellipse: E, draw_type: DrawType)

where E: Into<Ellipse>,

pub fn set_pixel(&mut self, x: isize, y: isize, color: Color)

Update a pixel color, using [set_pixel] or [blend_pixel] depending on whether colors alpha is 255 or not

If the alpha is 0 the call is does nothing

impl<'buffer> Graphics<'_>

pub fn new( buffer: &'buffer mut [u8], width: usize, height: usize ) -> Result<Graphics<'buffer>, GraphicsError>

buffer needs to be width * height * 4 long

pub fn new_unchecked( buffer: &'buffer mut [u8], width: usize, height: usize ) -> Graphics<'buffer>

impl Graphics<'_>

pub fn set_clip(&mut self, clip: Clip)

pub fn clip(&self) -> &Clip

pub fn clip_mut(&mut self) -> &mut Clip