Struct buffer_graphics_lib::Graphics

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

Fields

custom_font: FnvHashMap<u8, CustomLetter>

Allows you to replace any ASCII with a custom glyph To replace ‘a’ with ‘█’ write

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

Note: case is ignored

Note: a-z 0-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: Fn(&mut Graphics<'_>)>( &mut self, set: Coord, method: F )

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(x: usize, y: usize, size: TextSize) -> (usize, usize)

Get top left pixel coord for letter px coord

pub fn get_text_size(text: &str, width: usize, size: TextSize) -> (usize, usize)

Get width and height for string

Arguments

• text - The string to be measured
• width - The line width in characters
• size - The text size to use when measuring

Returns

The width and height of the string in pixels

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

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: Into<Coord>>(&mut self, xy: P, image: &Image)

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: Into<Coord>>( &mut self, xy: P, image: &IndexedImage )

Draw an indexed image at x, y

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

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: Into<Coord>, P2: Into<Coord>>( &mut self, start: P1, end: P2, color: Color )

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

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, size: TextSize, color: Color )

Draw a letter at pos

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

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

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

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

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

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

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

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

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

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>

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