SuperAPI AI 工具集

pixel-art

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:将输入图片转换为复古像素画,并可选将其动画化为带年代特效的短循环视频(MP4/GIF)。适用于海报、专辑封面、社交图片、精灵、角色、头像,以及 NES/Game Boy/PICO-8/C64/街机/SNES 等风格需求。

主要能力:内置两个脚本——scripts/pixel_art.py(照片转像素 PNG,采用 Floyd-Steinberg 抖动)与 scripts/pixel_art_video.py(像素 PNG 转动画 MP4,可选 GIF)。两者均可直接运行或作为模块导入。提供 14 种预设(arcade、snes、nes、gameboy、gameboy_pocket、pico8、c64、apple2、teletext、mspaint、mono_green、mono_amber、neon、pastel),并支持 28 个具名调色板(见 references/palettes.md)。预设可覆盖,例如:pixel_art("in.png", "out.png", preset="snes", palette="PICO_8", block=6)。场景特效包括 night、dusk、tavern、indoor、urban、nature、magic、storm、underwater、fire、snow、desert。

使用方式:可用 clarify 先与用户确认风格(最多两次:风格、场景)。命令行示例:python pixel_art.py in.jpg out.png --preset gameboy;python pixel_art.py in.jpg out.png --preset snes --palette PICO_8 --block 6;python pixel_art_video.py out.png out.mp4 --scene night --duration 6 --gif。Python 导入示例:先调用 pixel_art(),如需动画再将结果传给 pixel_art_video()。

依赖与限制:需 Python 3.9+、Pillow;视频需 ffmpeg 在 PATH 中。调色板键区分大小写("NES"、"PICO_8"、"GAMEBOY_ORIGINAL")。极小的源图(宽 <100px)在 8-10px 块下会崩坏,建议先放大。块与调色板参数须为正整数。动画粒子数量按约 640x480 画布调优,大图可能需换种子二次生成。mono_green/mono_amber 强制去色,若保留彩度可能在平滑区域出现条纹。

验证:输出 PNG 存在,具有清晰方块像素且颜色数与预设相符;视频为可被 ffprobe 打开的有效 MP4 且大小非零。具名硬件调色板与程序化动画移植自 pixel-art-studio(MIT)。本介绍未提供收费、价格或具体效果承诺等信息。