vectorio – Lightweight 2D shapes for displays — Adafruit CircuitPython 1 documentation (original) (raw)

The vectorio module provide simple filled drawing primitives for use with displayio.

group = displayio.Group()

palette = displayio.Palette(1) palette[0] = 0x125690

circle = vectorio.Circle(pixel_shader=palette, radius=25, x=70, y=40) group.append(circle)

rectangle = vectorio.Rectangle(pixel_shader=palette, width=40, height=30, x=55, y=45) group.append(rectangle)

points=[(5, 5), (100, 20), (20, 20), (20, 100)] polygon = vectorio.Polygon(pixel_shader=palette, points=points, x=0, y=0) group.append(polygon)

Available on these boards

class vectorio.Circle(pixel_shader: displayio.ColorConverter | displayio.Palette, radius: int, x: int, y: int)

Circle is positioned on screen by its center point.

Parameters:

radius_: int_

The radius of the circle in pixels.

color_index_: int_

The color_index of the circle as 0 based index of the palette.

x_: int_

X position of the center point of the circle in the parent.

y_: int_

Y position of the center point of the circle in the parent.

hidden_: bool_

Hide the circle or not.

location_: Tuple[int, int]_

(X,Y) position of the center point of the circle in the parent.

pixel_shader_: displayio.ColorConverter | displayio.Palette_

The pixel shader of the circle.

class vectorio.Polygon(pixel_shader: displayio.ColorConverter | displayio.Palette, points: List[Tuple[int, int]], x: int, y: int)

Represents a closed shape by ordered vertices. The path will be treated as ‘closed’, the last point will connect to the first point.

Parameters:

points_: List[Tuple[int, int]]_

Vertices for the polygon.

color_index_: int_

The color_index of the polygon as 0 based index of the palette.

x_: int_

X position of the 0,0 origin in the points list.

y_: int_

Y position of the 0,0 origin in the points list.

hidden_: bool_

Hide the polygon or not.

location_: Tuple[int, int]_

(X,Y) position of the 0,0 origin in the points list.

pixel_shader_: displayio.ColorConverter | displayio.Palette_

The pixel shader of the polygon.

class vectorio.Rectangle(pixel_shader: displayio.ColorConverter | displayio.Palette, width: int, height: int, x: int, y: int)

Represents a rectangle by defining its bounds

Parameters:

width_: int_

The width of the rectangle in pixels.

height_: int_

The height of the rectangle in pixels.

color_index_: int_

The color_index of the rectangle in 1 based index of the palette.

x_: int_

X position of the top left corner of the rectangle in the parent.

y_: int_

Y position of the top left corner of the rectangle in the parent.

hidden_: bool_

Hide the rectangle or not.

location_: Tuple[int, int]_

(X,Y) position of the top left corner of the rectangle in the parent.

pixel_shader_: displayio.ColorConverter | displayio.Palette_

The pixel shader of the rectangle.