Inkplate 5v2 MicroPython - Drawing graphics

Inkplate 5v2 can draw geometric shapes anywhere on its 1280 x 720 px canvas. Shapes can be filled or hollow.

---

Drawing shapes

The example below draws basic shapes in black-white display mode.

ℹ️

To use grayscale mode instead, change the constructor value and pass a numeric value from 0 to 7 in place of inkplate.BLACK.

from inkplate5v2 import Inkplate

inkplate = Inkplate(Inkplate.INKPLATE_1BIT)
inkplate.begin()
inkplate.clear_display()
inkplate.display()

inkplate.draw_pixel(100, 100, inkplate.BLACK)
inkplate.draw_rect(50, 50, 75, 75, inkplate.BLACK)
inkplate.draw_circle(200, 200, 30, inkplate.BLACK)
inkplate.fill_circle(300, 300, 30, inkplate.BLACK)
inkplate.draw_fast_hline(20, 100, 50, inkplate.BLACK)
inkplate.draw_fast_vline(100, 20, 50, inkplate.BLACK)
inkplate.draw_line(100, 100, 400, 400, inkplate.BLACK)
inkplate.draw_round_rect(100, 10, 100, 100, 10, inkplate.BLACK)
inkplate.fill_round_rect(10, 100, 100, 100, 10, inkplate.BLACK)
inkplate.draw_triangle(300, 100, 400, 150, 400, 100, inkplate.BLACK)

inkplate.display()

inkplate.draw_pixel()

Set a single pixel in the frame buffer.

Function parameters:

Type	Name	Description
Number	x	X coordinate.
Number	y	Y coordinate.
Const	color	Color constant (BLACK or WHITE in BW mode).

inkplate.draw_rect()

Draw an unfilled rectangle outline.

Function parameters:

Type	Name	Description
Number	x	Left X.
Number	y	Top Y.
Number	w	Width in pixels.
Number	h	Height in pixels.
Const	color	Outline color.

inkplate.draw_circle()

Draw an unfilled circle.

Function parameters:

Type	Name	Description
Number	x	Center X.
Number	y	Center Y.
Number	r	Radius in pixels.
Const	color	Outline color.

inkplate.fill_circle()

Draw a filled circle.

Function parameters:

Type	Name	Description
Number	x	Center X.
Number	y	Center Y.
Number	r	Radius in pixels.
Const	color	Fill color.

inkplate.draw_fast_hline()

Draw a horizontal line quickly.

Function parameters:

Type	Name	Description
Number	x	Start X.
Number	y	Y position.
Number	w	Line width in pixels.
Const	color	Line color.

inkplate.draw_fast_vline()

Draw a vertical line quickly.

Function parameters:

Type	Name	Description
Number	x	X position.
Number	y	Start Y.
Number	h	Line height in pixels.
Const	color	Line color.

inkplate.draw_line()

Draw a line from one point to another.

Function parameters:

Type	Name	Description
Number	x0	Start X.
Number	y0	Start Y.
Number	x1	End X.
Number	y1	End Y.
Const	color	Line color.

inkplate.draw_round_rect()

Draw an unfilled rectangle with rounded corners.

Function parameters:

Type	Name	Description
Number	x	Left X.
Number	y	Top Y.
Number	q	Width in pixels.
Number	h	Height in pixels.
Number	r	Corner radius in pixels.
Const	color	Outline color.

inkplate.fill_round_rect()

Draw a filled rectangle with rounded corners.

Function parameters:

Type	Name	Description
Number	x	Left X.
Number	y	Top Y.
Number	q	Width in pixels.
Number	h	Height in pixels.
Number	r	Corner radius in pixels.
Const	color	Fill color.

inkplate.draw_triangle()

Draw a triangle outline using three vertices.

Function parameters:

Type	Name	Description
Number	x0	Vertex A X.
Number	y0	Vertex A Y.
Number	x1	Vertex B X.
Number	y1	Vertex B Y.
Number	x2	Vertex C X.
Number	y2	Vertex C Y.
Const	color	Outline color.

Simple predefined shapes.

---

Full examples

basic_bw.py

Draw basic black and white shapes on the display.

basic_grayscale.py

Draw different shades of gray using grayscale mode.