lib.printing

 1import drawBot
 2from lib import layout, easing
 3
 4
 5def drawPerforationCircles(
 6    container: tuple,
 7    radius: float = 2,
 8    spacing: float = 80,
 9    count: int = 2,
10    align: tuple[layout.AlignX, layout.AlignY] = ("left", "center"),
11) -> tuple:
12    """
13    Draw a series of perforation circles within a container.
14
15    Args:
16        container: The container coordinates (x, y, w, h).
17        radius: The diameter of each circle in mm. Defaults to 2.
18        spacing: The spacing between circles (center to center) in mm. Defaults to 80.
19        count: The number of circles to draw. Defaults to 2.
20        align: The alignment of the series within the container. Defaults to ("left", "center").
21
22    Returns:
23        The coordinates of the area occupied by the perforation circles.
24    """
25    radius = layout.mm(radius)
26    spacing = layout.mm(spacing)
27    spacing -= radius  # adjust spacing to be center to center
28
29    perfDimensions = radius, radius * count + spacing * (count - 1)
30    perfCoords = layout.align(container, perfDimensions, align)
31    x, y, w, h = perfCoords
32
33    def getPos(locationY):
34        posY = y + h - radius if locationY == "top" else y
35        return x, posY
36
37    startPos, endPos = [getPos(positionY) for positionY in ["top", "bottom"]]
38    positions = easing.interpolate(
39        start=startPos, stop=endPos, steps=count, func=easing.linear
40    )
41
42    for [posX, posY] in positions:
43        drawBot.oval(posX, posY, radius, radius)
44
45    return perfCoords