Typographic Art

Create art using text characters, curved labels, and text-along-path effects.

ASCII Art from Images

Map brightness to characters from a density string:

chars = " .:-=+*#%@"

for cell in scene.grid:
    idx = int(cell.brightness * (len(chars) - 1))
    char = chars[idx]
    if char != " ":
        cell.add_text(char, at="center", font_size=0.90, color="#ffffff", font_family="monospace")

Dense characters for bright areas, sparse for dark — classic ASCII art.

Text Along Curves

Warp multiple text lines along curves with different curvatures:

curve = cell.add_curve(start=(0.05, 0.2), end=(0.95, 0.25), curvature=0.4, ...)
cell.add_text("Create beautiful art with code", along=curve, font_size=0.05, color=colors.primary)

Three phrases flowing along curves with different curvatures and colors.

Letter Mosaic

Replace dots with repeated characters from a word:

word = "MONSTER"
for i, cell in enumerate(scene.grid):
    char = word[i % len(word)]
    size = 0.60 + cell.brightness * 0.35
    cell.add_text(char, at="center", font_size=size, color=cell.color, bold=True)

The word "MONSTER" repeats across the grid, sized by brightness and colored by the image.

Combined: Dot Art with Title Overlay

Layer dot art with text overlays using merged CellGroups:

# Dot art layer
for cell in scene.grid:
    cell.add_dot(radius=cell.brightness * 0.42, color=cell.color, opacity=0.6)

# Title overlay
title = scene.grid.merge((0, 0), (2, scene.grid.cols - 1))
title.add_fill(color="#000000", opacity=0.6)
title.add_text("MONA LISA", at="center", font_size=0.50, color="#ffffff", bold=True)

Dot art portrait with semi-transparent title and subtitle bars.