Pixel Art

時代ごとの色数でドット絵を作ります（NES、Game Boy、PICO-8）。

skill の情報

参考: SKILL.md 全文

Pixel Art

どんな画像でも懐かしい雰囲気のドット絵に変え、さらに時代に合った演出（雨、蛍、雪、火の粉）を 付けた短い MP4 や GIF に動かすこともできます。

この skill には 2 つのスクリプトが付いています。

• scripts/pixel_art.py — 写真からドット絵の PNG へ（Floyd-Steinberg のディザリング）
• scripts/pixel_art_video.py — ドット絵の PNG から動く MP4 へ（GIF も任意で出せます）

どちらも読み込んで使うことも、そのまま実行することもできます。時代どおりの色を出したいときは 用意された設定がハードウェアの色数（NES、Game Boy、PICO-8 など）に合わせてくれますし、 アーケードや SNES 風にしたいときは中身に合わせた N 色への減色も使えます。

こんなときに使います

• 元画像から懐かしいドット絵にしたいとき
• NES／Game Boy／PICO-8／C64／アーケード／SNES 風にしてほしいと言われたとき
• 短くループする動き（雨の場面、夜空、雪など）がほしいとき
• ポスター、アルバムのジャケット、SNS 投稿、スプライト、キャラクター、アイコン画像

進め方

作る前に、どの作風にするかを相手に確かめてください。設定が違えば出来上がりも大きく変わり、 作り直しは手間がかかります。

ステップ 1 — 作風を提示する

代表的な設定を 4 つ挙げて clarify を呼びます。相手の言葉に合わせて選んでください — 14 個すべてを並べてはいけません。

相手の意図がはっきりしないときの既定の一覧です。

clarify(
    question="Which pixel-art style do you want?",
    choices=[
        "arcade — bold, chunky 80s cabinet feel (16 colors, 8px)",
        "nes — Nintendo 8-bit hardware palette (54 colors, 8px)",
        "gameboy — 4-shade green Game Boy DMG",
        "snes — cleaner 16-bit look (32 colors, 4px)",
    ],
)

相手がすでに時代を口にしているとき（例:「80 年代のアーケード」「ゲームボーイ」）は clarify を飛ばして、そのまま合う設定を使ってください。

ステップ 2 — 動きを提示する（任意）

相手が動画や GIF を求めているとき、あるいは動きが付いたほうが良さそうなときは、 どの場面にするかを尋ねます。

clarify(
    question="Want to animate it? Pick a scene or skip.",
    choices=[
        "night — stars + fireflies + leaves",
        "urban — rain + neon pulse",
        "snow — falling snowflakes",
        "skip — just the image",
    ],
)

clarify を続けて 3 回以上呼んではいけません。作風で 1 回、動きを付けるなら場面で 1 回までです。 相手が最初のメッセージで作風も場面もはっきり指定しているなら、clarify はまったく使いません。

ステップ 3 — 生成する

まず pixel_art() を実行し、動きを求められていれば、その結果に続けて pixel_art_video() を呼びます。

用意された設定の一覧

名前の付いた色の組は scripts/palettes.py にあります（全 28 種類の一覧は references/palettes.md を参照してください）。どの設定も上書きできます。

pixel_art("in.png", "out.png", preset="snes", palette="PICO_8", block=6)

場面の一覧（動画用）

呼び出し方

Python（読み込んで使う）

sys.path.insert(0, "/home/teknium/.hermes/skills/creative/pixel-art/scripts")
from pixel_art import pixel_art
from pixel_art_video import pixel_art_video

# 1. Convert to pixel art
pixel_art("/path/to/photo.jpg", "/tmp/pixel.png", preset="nes")

# 2. Animate (optional)
pixel_art_video(
    "/tmp/pixel.png",
    "/tmp/pixel.mp4",
    scene="night",
    duration=6,
    fps=15,
    seed=42,
    export_gif=True,
)

CLI

cd /home/teknium/.hermes/skills/creative/pixel-art/scripts

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

この処理順にしている理由

ドット絵への変換:

1. コントラスト・彩度・シャープネスを持ち上げます（色数が少ないほど強めに）
2. 減色の前にポスタリゼーションをかけ、明暗の面を単純にします
3. Image.NEAREST で block の分だけ縮小します（境目のはっきりしたドット、補間なし）
4. Floyd-Steinberg のディザリングで減色します。相手は中身に合わせた N 色か、

名前の付いたハードウェアの色の組のどちらかです

1. Image.NEAREST で元の大きさへ戻します

縮小のあとに減色することで、ディザリングが最終的なドットの升目とそろいます。先に減色すると、 どうせ消える細部に誤差拡散をむだ遣いすることになります。

動画の重ね合わせ:

• 1 コマごとに元の絵を写します（背景は動きません）
• コマごとに状態を持たない粒子の描画を重ねます（演出ごとに関数 1 つ）
• ffmpeg の libx264 -pix_fmt yuv420p -crf 18 で書き出します
• GIF は任意で palettegen と paletteuse を使って出します

必要なもの

• Python 3.9 以上
• Pillow（pip install Pillow）
• PATH の通った ffmpeg（動画のときだけ必要です — Hermes のインストール用パッケージがこれを入れます）

つまずきやすいところ

• 色の組の名前は大文字と小文字を区別します（"NES"、"PICO_8"、"GAMEBOY_ORIGINAL"）。
• とても小さい元画像（横幅 <100px）は、8〜10px のブロックだとつぶれます。小さすぎるときは

先に元画像を拡大してください。

• block や palette に小数を渡すと減色が壊れます — 正の整数のままにしてください。
• 動きの粒子の数は 640x480 くらいの画面に合わせてあります。とても大きい画像では、

種を変えてもう一度かけ、密度を上げたくなるかもしれません。

• mono_green と mono_amber は color=0.0（彩度を落とす）を強制します。ここを上書きして

色みを残すと、2 色の組ではなめらかな面に縞が出ることがあります。

• clarify の繰り返し: 1 ターンにつき 2 回まで（作風、それから場面）。相手に選ばせ続けないでください。

確かめ方

• 指定した場所に PNG ができている
• その設定のブロックの大きさで、四角いドットの升目がはっきり見える
• 色数が設定どおりになっている（目で見るか、Image.open(p).getcolors() を実行して確かめます）
• 動画が正しい MP4 になっている（ffprobe で開けて、大きさが 0 でない）

出典

名前の付いたハードウェアの色の組と、pixel_art_video.py にある手続き的な動きのループは pixel-art-studio（MIT）から移植したものです。 詳しくは、この skill のディレクトリにある ATTRIBUTION.md を参照してください。