用途:把任意图片转成复古像素画,并可进一步生成带时代风格特效(雨、萤火虫、雪、余烬等)的短 MP4 或 GIF 动画。
主要能力:附带两个脚本——scripts/pixel_art.py 负责照片转像素 PNG(Floyd-Steinberg 抖动),scripts/pixel_art_video.py 负责像素 PNG 转动画 MP4(可选 GIF)。预设可对齐硬件调色板(NES、Game Boy、PICO-8 等),也可用自适应 N 色量化模拟街机/SNES 风格。预设目录含 arcade、snes、nes、gameboy、gameboy_pocket、pico8、c64、apple2、teletext、mspaint、mono_green、mono_amber、neon、pastel 等;命名调色板位于 scripts/palettes.py,共 28 种,可用 palette 参数覆盖。视频场景含 night、dusk、tavern、indoor、urban、nature、magic、storm、underwater、fire、snow、desert。
使用方式:可导入或直接运行。CLI 示例: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 导入需将 scripts 目录加入 sys.path,再调用 pixel_art() 与 pixel_art_video()。生成前建议先用 clarify 确认风格与场景,每轮最多调用两次。
适用场景:海报、专辑封面、社交帖、精灵图、角色、头像等。
限制:需 Python 3.9+、Pillow,视频还需 PATH 中的 ffmpeg。调色板键区分大小写;小于 100px 宽的源图在 8-10px 块下会崩坏,需先放大;block 与 palette 须为正整数;动画粒子数按约 640x480 画布调优;mono_green/mono_amber 会强制去饱和。命名调色板与动画循环移植自 pixel-art-studio(MIT)。