spritefusion-pixel-snapper

一键把 AI 乱像素吸附成规整网格

开源 unknown 图像生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3292

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类图像生成

开发团队Hugo-Dz

所属国家

官网地址https://www.spritefusion.com/pixel-snapper

GitHubhttps://github.com/Hugo-Dz/spritefusion-pixel-snapper

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型game-development,gamedev,image-processing,pixel-art

GitHub 星标★ 3292

30天Star增速

HF 下载量

上线时间2025-11-24 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-21

浏览次数0

项目介绍

spritefusion-pixel-snapper 是一个用 Rust 编写的像素画网格对齐工具，专门解决 AI 生成像素画时常见的像素错位、边缘模糊和网格不统一问题。AI 图像模型往往输出看似像素风但实际像素块大小不一、位置偏移的图像，直接用于游戏素材会显得脏乱。该工具通过分析图像中的像素块分布，推断出最佳网格尺寸，再将每个像素块吸附到规整网格上，输出干净、可直接使用的像素画。核心能力包括自动检测网格间距、按网格重采样颜色、修复不一致的像素块边界，并尽量保留原始配色与轮廓。它提供命令行与图形界面两种使用方式，适合游戏开发者、像素画师在素材后处理阶段快速清理 AI 产物，减少手工逐像素修正的时间。项目以 Rust 实现，性能好、跨平台，星标约 3.3k，处于成长阶段。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

macOS/Linux 且已安装 Homebrew（Brew 方式），或已安装 Rust 工具链（Cargo 方式）
输入图像需为 PNG 或 JPEG 格式，也可传入目录进行批量处理
如需批量处理，准备一个存放输入图片的目录及其对应的输出目录

安装与启动步骤

1用 Brew 安装

macOS/Linux 用户可通过 Homebrew tap 直接安装预编译的 CLI 二进制。
```
brew install Hugo-Dz/tap/spritefusion-pixel-snapper
```
2或用 Cargo 安装

已装 Rust 的用户可用 cargo 从源码编译安装，得到独立的原生命令行程序；两种方式选其一即可。
```
cargo install spritefusion-pixel-snapper
```
3准备输入图片

把需要修复的 AI 像素画放到工作目录，确认是 PNG 或 JPEG；批量处理时先整理成单个目录。
4执行基础转换

按输入输出的顺序传参，颜色数不填时默认 16 色，工具会自动检测像素块尺寸并吸附到网格。
```
spritefusion-pixel-snapper input.png output.png
```
5指定颜色数与调色板

第二个位置参数填色数，--palette 接逗号分隔的六位十六进制颜色，用来自定义严格调色板。
```
spritefusion-pixel-snapper input.png output.png 16 --palette "#000000,#ffffff,#ff0000"
```
6手动覆盖像素尺寸

自动检测不准时用 --pixel-size 指定像素块大小，取值需在 1 到最小图像边长的一半之间。
```
spritefusion-pixel-snapper input.png output.png 16 --pixel-size 4
```
7目录批量处理

输入与输出都传目录路径，即可对整批图片做同样的网格对齐与调色板量化。
```
spritefusion-pixel-snapper ./input_dir ./output_dir
```

关键配置

配置项	必填	说明	示例
`COLOR_COUNT`	否	位置参数，输出调色板的颜色数量，不填默认为 16	`16`
`--pixel-size`	否	覆盖自动检测的像素块大小，取值 1 到最小图像边长的一半	`--pixel-size 4`
`--palette`	否	将输出限制在给定的调色板内，须为逗号分隔的六位十六进制颜色	`--palette "#000000,#ffffff,#ff0000"`

如何确认成功

命令执行结束后没有报错，并在指定路径生成输出 PNG；打开后可用肉眼检查像素块是否已被吸附到均匀网格上。

常见问题

Q：没有安装 Rust 可以用吗？

A：可以。Homebrew 方式安装的是预编译二进制，无需 Rust；也可直接使用官网的在线版或桌面版。

Q：颜色数 COLOR_COUNT 不写会怎样？

A：默认使用 16 色。需要更精细的渐变可调高，需要复古风可调低。

Q：--pixel-size 为什么不能随便填？

A：README 要求该值在 1 到图像最短边一半之间，超出范围可能无法得到有效网格。

Q：--palette 能写三位缩写色值吗？

A：不能，README 明确要求逗号分隔的六位十六进制颜色，如 #ff0000。

Q：能一次处理多张图吗？

A：可以。将输入和输出都替换为目录路径，即按批量模式处理整个目录。

注意事项

README 中 Examples 段落的代码块被截断，请以上方 Usage 语法与参数说明为准，勿臆造额外参数
--palette 必须使用六位十六进制值并以英文逗号分隔，且整体用引号包裹避免被 shell 解析
工具目标是保留细节（如抖动），但颜色会被量化到严格调色板，转换前建议备份原图
不想本地安装可直接用官网的在线版或桌面版

核心亮点

自动推断网格尺寸，无需手动测量像素块间距
针对 AI 生成像素画的错位和模糊做了专门处理，输出可直接用于游戏素材
Rust 实现，处理速度快且提供 GUI 与 CLI 两种入口

不足之处

对非规则像素画或手绘风格图像效果有限，依赖输入本身接近网格化
复杂渐变或半透明边缘在重采样后可能丢失细节

适用场景

游戏开发者批量清理 AI 生成的像素风角色和道具素材
像素画师将 AI 草稿后处理为可编辑的规整像素图
独立游戏素材管线中作为自动化预处理步骤

替代项目

Pixelorama、Aseprite

上一篇：ComfyUi-Untwisting-RoPE

下一篇：没有了！