Skip to content

Hugo-Dz/spritefusion-pixel-snapper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sprite Fusion Pixel Snapper

A tool to snap pixels to a perfect grid. Designed to fix messy and inconsistent pixel art generated by AI.

Pixel Snapper

Why ?

Current AI image models can't understand grid-based pixel art.

  • Pixel are inconsistent in size and position.
  • The grid resolution can drift over time.
  • Colors are not tied to a strict palette.

With Pixel Snapper:

  • ✅ Pixel are snapped to a perfect grid.
  • ✅ The grid resolution is consistent and can be scaled to pixel resolution.
  • ✅ Colors are tied to a strict, quantized palette.

Perfect for

  • AI generated pixel art that needs to be snapped to a grid.
  • Procedural 2D art that doesn't fit a grid like tilemaps or isometric maps.
  • 2D game assets and 3D textures that need to be perfectly scalable.

Details

Pixel Snapper preserves as much details as possible like dithering.


Desktop Application

Desktop

A standalone build of Pixel Snapper coming with these features:

  • Fast batch processing
  • 100% offline desktop app
  • One-time purchase, yours forever!
  • Free lifetime updates
  • Works on Mac, Linux, and Windows

Download the desktop application

Build from source

Requires Rust installed on your machine.

💻 CLI

git clone https://github.com/Hugo-Dz/spritefusion-pixel-snapper.git
cd spritefusion-pixel-snapper
cargo run input.png output.png

The command accepts an optional k-colors argument:

cargo run input.png output.png 16

Use a directory as the input path to process a batch.

cargo run sprites/batch_inputs sprites/batch_outputs 16

You can also override the auto-detected pixel size with --pixel-size:

cargo run input.png output.png --pixel-size 8
cargo run sprites/batch_inputs sprites/batch_outputs 16 --pixel-size 8

This is useful when the auto-detection doesn't match the expected grid size. The value must be between 1 and half the smallest image dimension.

🌐 Web (WASM)

git clone https://github.com/Hugo-Dz/spritefusion-pixel-snapper.git
cd spritefusion-pixel-snapper

Build the WASM module:

wasm-pack build --target web --out-dir pkg --release

Then use the WASM module in your project:

import init, { process_image } from "./pkg/spritefusion_pixel_snapper.js";

await init();

// process_image(inputBytes, kColors?, pixelSizeOverride?)
const outputBytes = process_image(inputBytes, 16);

Pass null for any optional argument you want to leave on its default behavior.

Acknowledgments

Pixel Snapper is a Sprite Fusion project. Sprite Fusion is a free, web-based tilemap editor for game developers supporting a wide range of engines including Unity, Godot, Defold, and GB Studio.

Sprite Fusion

License

MIT License Hugo Duprez

About

A tool to snap pixels to a perfect grid. Designed to fix messy and inconsistent pixel art generated by AI.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages