/gimp-plugin-pixel-art-scalers

Gimp plugin for scaling / rescaling images with Pixel Art Scaler algorithms such as hqx, xbr and scalex

Primary LanguageCGNU General Public License v3.0GPL-3.0

Gimp Pixel Art Scalers Plugin

GIMP plugin for rescaling images using Pixel Art Scalers

These scalers are able to resize graphics in a way that avoids both bluring and pixelation, while also preserving the look and feel of the image. They are commonly used for upscaling pixel art from console games when run in an emulator. They can be useful in other realms too.

Download compiled executables here:

See instructions below for where to install the binary

Supported image scalers:

  • HQX (hq2x, hq3x, hq4x)
  • XBR (xbr2x, xbr3x, xbr4x)
  • ScaleX (scale2x, scale3x, scale4x)

GIMP Image Editor using Pixel Art Scalers Plugin

Options:

  • Force semi-transparent pixels to fully opaque / transparent (edge aliasing)
  • Suppress colors from alpha-hidden pixels (can sometimes cause discoloration at the edges)
  • Tiled and transparent temporary border options to improve scaling in special cases

Hints:

  • The plugin is located in : Menu -> Filter -> Render -> Pixel Art Scalers
  • You can resize the plugin dialog for a larger preview window
  • Currently it only operates on RGB and RGBA images

Acknowledgement:


Install folder & path locations

Copy the "plugin-pixel-art-scalers"(.exe) binary to your GIMP plugin folder. The location will depend on your GIMP version and Operating System.

Plug-in folder locations: 
(where 2.x is your gimp version. example: ~/.gimp-2.8/plug-ins)

  * Linux: ~/.gimp-2.x/plug-ins
  * Windows: %APPDATA%\GIMP\2.x\plug-ins  or  C:\Program Files\GIMP 2\lib\gimp\2.0\plug-ins
  * macOS / OSX: $HOME/Library/Application Support/GIMP/2.x/plug-ins

Build instructions

Native compile on Linux:

If GIMP & build tools not yet installed:
(example for debian/ubuntu/mint)
 * sudo apt install gimp
 * sudo apt install build-essential
 * sudo apt install libgimp2.0-dev

Then:
* cd gimp-plugin-pixel-art-scalers
* make

Install on macOS using homebrew

(Formula courtesy of @ryan-robeson.)

1. Run: brew install ryan-robeson/gimp/pixel-art-scalers
2. Then add the new plugin folder to GIMP's settings