grid-pixelator

DEPRECATED: This package is no longer maintained. Please use [adaptive-pixelizer]

AdaptivePixelizer

AdaptivePixelizer is a simple GUI tool to pixelate images by averaging colors within a user-defined grid. It's designed for easily converting high-resolution pixel art or photos into a low-resolution, dot-art style.

Features

• Interactive Grid Editing: Manually add, delete, and move grid lines directly on the image using mouse clicks and drags.
  • Shift + Left Click: Add vertical line
  • Shift + Right Click: Add horizontal line
  • Ctrl + Click: Delete line under cursor
  • Drag line: Move line
  • Delete/Backspace: Delete line under cursor
• Zoom and Pan: Easily navigate large images. (Mouse wheel, Alt+Drag)
• Multiple Color Averaging Methods: Choose between Average, Median, or Mode color calculation for pixelation.
• Real-time Preview: See the pixelated result instantly (can be toggled on/off).
• Undo/Redo: Supports undo/redo for grid modifications.
• Simple Interface: Lightweight and easy to use.

Installation

You can install AdaptivePixelizer using pip:

pip install grid-pixelator

Optional Dependencies:

For potentially faster median color calculation, NumPy is recommended:

pip install grid-pixelator[numpy]

or just "pip install numpy" separately

Usage

• Launch the application by typing the following command in your terminal:

  grid-pixelator

• Click "画像ファイルを開く" (Open Image File) to load an image.

• Adjust the grid lines on the left panel (original image):

  • Use the initial grid spinboxes, or
  • Use Shift+Click, Ctrl+Click, Drag, or Delete/Backspace key as described in Features.

• Select the desired color calculation method (Average, Median, Mode).

• The pixelated preview will update automatically on the right panel (if "プレビュー自動更新" is checked). Click "プレビュー更新 / 実行" to manually update.

• Once satisfied, save the processed image using "ファイル" > "名前を付けて保存...".

Requirements

• Python 3.8 or later
• PyQt6
• Pillow
• NumPy (Optional, recommended for Median calculation)
• OS: Primarily tested on macOS, should work on Windows/Linux.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing / Issues