overlay-arrows-and-more 0.5.1

Overlay

Overlay(transparency=0.0, frequency=None)

Main class for creating overlay windows.

Parameters:

• transparency (float): Transparency level (0.0 = opaque, 1.0 = fully transparent)

• frequency (float): Auto-refresh frequency in Hz (optional)

Methods:

• add(**kwargs): Add a graphical element to the overlay

• refresh(): Update the overlay display

• clear_all(): Remove all graphical elements

• quit(): Close the overlay and clean up resources

Shape (Enum)

Available shapes for drawing:

Shape.rectangle: Rectangular shape Shape.ellipse: Elliptical/circular shape Shape.arrow: Arrow shape Shape.triangle: Triangular shape Shape.image: Image/icon

Brush (Enum)

Fill patterns for shapes:

• Brush.solid: Solid color fill

• Brush.b_diagonal: 45° upward diagonal lines

• Brush.cross: Horizontal and vertical crosshatch

• Brush.diag_cross: 45° crosshatch

• Brush.f_diagonal: 45° downward diagonal lines

• Brush.horizontal: Horizontal lines

• Brush.vertical: Vertical lines

Element Properties

When adding elements with add(), you can use these properties:

Position and Size

• x, y: Position coordinates

• width, height: Element dimensions

Appearance

• color: Outline color as RGB tuple (r, g, b)

• thickness: Line thickness (0 for filled shapes)

• brush: Fill pattern (Brush enum)

• brush_color: Fill color as RGB tuple

• angle: Rotation angle in degrees

• center_of_rotation: Rotation center as tuple (x, y)

Text Properties

• text: Text content

• text_color: Text color as RGB tuple

• text_bg_color: Text background color

• font_size: Font size in pixels

• font_name: Font family name

• text_format: Text alignment flags

Special Properties

• geometry: Shape type (Shape enum)

• xyrgb_array: Vertex data for triangles

• hicon: Icon handle for images

Recording Indicator

import overlay_arrows_and_more as overlay
import time

# Create overlay
rec_overlay = overlay.Overlay()

# Blinking recording indicator
for i in range(20):  # Blink 20 times
    rec_overlay.clear_all()

    # Show red dot on even iterations (blinking effect)
    if i % 2 == 0:
        rec_overlay.add(
            geometry=overlay.Shape.ellipse,
            x=50, y=50,
            width=20, height=20,
            brush=overlay.Brush.solid,
            brush_color=(255, 0, 0),
            thickness=0
        )

    # Recording text (always visible)
    rec_overlay.add(
        x=80, y=50,
        width=100, height=20,
        text="REC",
        text_color=(255, 0, 0),
        text_bg_color=(255, 255, 254),
        font_size=16
    )

    rec_overlay.refresh()
    time.sleep(0.5)  # Half second intervals

rec_overlay.quit()

Highlighted Area

import overlay_arrows_and_more as overlay
import time

# Create transparent overlay
highlight_overlay = overlay.Overlay(transparency=0.7)

# Highlight rectangle
highlight_overlay.add(
    geometry=overlay.Shape.rectangle,
    x=200, y=150,
    width=400, height=300,
    thickness=5,
    color=(0, 255, 0),
    brush=overlay.Brush.solid,
    brush_color=(0, 255, 0)
)

# Instruction text
highlight_overlay.add(
    x=220, y=170,
    width=360, height=50,
    text="Click here to continue",
    text_color=(255, 255, 255),
    text_bg_color=(0, 0, 0),
    font_size=18
)

highlight_overlay.refresh()
time.sleep(5)
highlight_overlay.quit()

Animated Elements

import overlay_arrows_and_more as overlay
import time

# Create auto-refreshing overlay
animated_overlay = overlay.Overlay(transparency=0.3, frequency=30)

# Animate a rotating arrow
for i in range(360):
    animated_overlay.clear_all()
    animated_overlay.add(
        geometry=overlay.Shape.arrow,
        x=400, y=300,
        thickness=8,
        color=(0, 0, 255),
        angle=i,
        center_of_rotation=(20, 10)
    )
    time.sleep(1/30)  # 30 FPS

animated_overlay.quit()

load_png

load_png(filename, size_x, size_y)

Load a PNG image for use in overlays.

Parameters:

• filename: Path to PNG file

• size_x, size_y: Desired icon dimensions

Returns: Icon handle for use with hicon property

load_ico

load_ico(filename, size_x, size_y)

Load an ICO file for use in overlays.

Parameters:

• filename: Path to ICO file

• size_x, size_y: Desired icon dimensions

Returns: Icon handle for use with hicon property