hqx 1.0

The hqx upscaling algorithm in Python

hqx (high quality scale) is a family of pixel art scaling algorithms that work by detecting differences between pixels in the YUV colorspace.

hq2x scales an image by 2x, hq3x by 3x, and hq4x by 4x.

This is a Python port of hqx, unoptimized. It is not intended to be used for videos or scenarios where low latency is required. Right now, it only supports RGB, not RGBA (no transparency support).

---

Table of contents

• 📦 Installation
• 🛠 Usage
• 📰 Changelog
• 📜 License

---

📦 Installation

hqx is available on PyPi. It requires a Python version of at least 3.10.0. It depends on Pillow.

To install hqx with pip, run:

python -m pip install hqx

---

🛠 Usage

You can either use hqx.hqx_scale, hqx.hq2x, hqx.hq3x, or hqx.hq4x.

import hqx
import PIL.Image

image: PIL.Image.Image = PIL.Image.open(...)
x2:    PIL.Image.Image = hqx.hq2x(image)
x3:    PIL.Image.Image = hqx.hq3x(image)
x4:    PIL.Image.Image = hqx.hq4x(image)

# x2 == hqx.hqx_scale(image, 2))
# x3 == hqx.hqx_scale(image, 3))
# x4 == hqx.hqx_scale(image, 4))

---

📰 Changelog

The changelog is at CHANGELOG.md.

---

📜 License

hqx (python) is licensed under the Lesser GNU Public License v2.1 (LGPL-2.1).