Repolode
Hugo-Dz

Hugo-Dz/spritefusion-pixel-snapper

一款基于 Rust 的工具,可将 AI 生成的杂乱像素画校正到规整的像素网格并统一调色板。

Star
3,287
Fork
205
未关闭 Issue
0
最近提交
3个月前

这是什么?

Pixel Snapper 用于修正像素大小不一、网格位置漂移或颜色不符合严格调色板的像素画。这类问题在 AI 图像模型生成的图片中很常见,因为这些模型通常无法直接生成规整的网格像素画。

工具会将像素吸附到统一网格上,可指定调色板颜色数量(默认 16 色)或提供自定义十六进制调色板,也可手动覆盖自动检测的像素尺寸。支持处理单个文件,也支持按目录批量处理。除独立的原生 CLI(可通过 Homebrew 或 Cargo 安装)外,还提供 WebAssembly 模块,便于在网页项目中调用。

项目使用 Rust 编写,采用 MIT 许可证发布。

核心功能

  • 01将不规则像素吸附到统一网格上。
  • 02可配置输出的调色板颜色数量。
  • 03支持自定义十六进制调色板,严格控制颜色。
  • 04支持整个目录的批量处理。
  • 05提供 WebAssembly 版本,可在浏览器和 JavaScript 中使用。

适用场景

  • 在游戏中使用前,清理 AI 生成的精灵图。
  • 让瓦片地图或等距地图素材的像素保持一致。
  • 将图片转换为固定调色板,用于复古风格项目。
  • 批量规范化一个文件夹中的 2D 游戏素材。

快速上手

  1. 1

    使用 Homebrew 安装命令行工具

    brew install Hugo-Dz/tap/spritefusion-pixel-snapper
  2. 2

    或使用 Cargo 安装(需要 Rust)

    cargo install spritefusion-pixel-snapper
  3. 3

    将图片量化为 16 色调色板

    spritefusion-pixel-snapper input.png output.png 16

使用前须知

  • 使用 Cargo 安装需要 Rust 工具链;也可改用 Brew 安装。

标签

常见问题

spritefusion-pixel-snapper 是什么?
一款基于 Rust 的工具,可将 AI 生成的杂乱像素画校正到规整的像素网格并统一调色板。 Pixel Snapper 用于修正像素大小不一、网格位置漂移或颜色不符合严格调色板的像素画。这类问题在 AI 图像模型生成的图片中很常见,因为这些模型通常无法直接生成规整的网格像素画。
spritefusion-pixel-snapper 可以免费使用吗?用的什么许可证?
spritefusion-pixel-snapper 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
spritefusion-pixel-snapper 还在维护吗?
半年内有更新。spritefusion-pixel-snapper 最近一次提交是在 2026年7月16日。
spritefusion-pixel-snapper 适合用来做什么?
在游戏中使用前,清理 AI 生成的精灵图。 让瓦片地图或等距地图素材的像素保持一致。 将图片转换为固定调色板,用于复古风格项目。 批量规范化一个文件夹中的 2D 游戏素材。
spritefusion-pixel-snapper 怎么安装和运行?
使用 Homebrew 安装命令行工具: brew install Hugo-Dz/tap/spritefusion-pixel-snapper 或使用 Cargo 安装(需要 Rust): cargo install spritefusion-pixel-snapper 将图片量化为 16 色调色板: spritefusion-pixel-snapper input.png output.png 16
在哪里获取 spritefusion-pixel-snapper?
源代码和安装说明在 GitHub 上:https://github.com/Hugo-Dz/spritefusion-pixel-snapper

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目