pyscanline 0.1.3

A Python-based library that recreates a retro-futuristic style

Scanline Effects in Python

A Python-based library that recreates a retro-futuristic "scanline" style. It allows you to apply scanlines to:

• Static images (PNG, JPEG, etc.)
• Animated GIFs (frame-by-frame processing)

Note: This project is inspired by the R scanline package's approach to scanline effects. However, the results may differ slightly due to underlying implementations in Pillow, NumPy, and ImageIO.

Features

• Static image processing via scanline():
  • Resizes the image to a specified vertical resolution.
  • Applies customizable alpha-based scanline patterns, color mapping, borders, and optional noise.
• GIF animation processing via scanline_gif():
  • Reads each GIF frame, flattens cumulatively (like R’s image_flatten), then applies the scanline effect.
  • Returns all frames plus per-frame durations, which can be saved as a new GIF.
• Matplotlib figure support:
  • Export plots to in-memory PNG and pass them into scanline() to produce stylized visualizations.

Showcase

Original	Scanlined

Installation

pip install pyscanline

Quick Start

from pyscanline import scanline
# Apply the scanline effect
result_img = scanline("input.png", n_scanlines=60)
# Save the result
result_img.save("ouput.png")

See the examples directory for more usage scenarios.

License

GPLv3 License. See LICENSE for details.

---

Enjoy creating retro-futuristic scanlines for your images and animations!