Pixel Snap — アップスケール済みピクセルアート復元プラグイン
概要
pixel-snap は、AIや手動でアップスケールされたピクセルアート(アイコンやゲームスプライトなど)を、元の“クリーンな”ピクセルアートへと復元するClaude Codeプラグインです。入力画像を解析してピクセルグリッドのサイズを自動検出し、各セル内の代表色をモード(最頻色)で決定。アイコン用に背景除去・トリミング・センタリングを行う「icon mode」と、画像全体の構成を維持する「scene mode」をサポートします。最終出力はニアレストネイバーでスケールされ、シャープな見た目を維持します。(300字程度)
リポジトリの統計情報
- スター数: 2
- フォーク数: 0
- ウォッチャー数: 2
- コミット数: 4
- ファイル数: 5
- メインの言語: JavaScript
主な特徴
- グリッドサイズをエッジ信号の自己相関で自動推定
- 各セルの代表色をモード(最頻色)で抽出しノイズを低減
- icon mode(背景削除・トリミング・センタリング)と scene mode(全体保持)を提供
- ニアレストネイバー出力でピクセルの輪郭を維持
技術的なポイント
pixel-snap の核は「低レベルな画像信号解析」と「統計的な色選択」にあります。まず画像のエッジ(輝度差や色差)を検出し、水平・垂直方向のエッジ信号を自己相関(autocorrelation)することで繰り返し周期を推定し、ピクセルグリッドのサイズを決定します。従来のヒューリスティックなスケール推定より安定し、アップスケールで生じた歪みやアンチエイリアスを吸収できます。
次に、グリッドごとにセル内のピクセル色を集計し、平均ではなくモード(最頻色)を採用して代表色を選びます。平均化は境界の混色を生みやすいため、モード選択により本来のパレット色(限られた色数のピクセルアート特有の色)を復元しやすくなります。さらに、透明や近似背景色の扱いを分岐させることで、icon modeでは背景除去と余白のトリミング・センタリングを自動化し、UI用のアイコンを得やすくしています。一方 scene mode では画像全体の構図を保持し、不要なトリミングを抑制します。
出力段階ではニアレストネイバー(最近傍補間)を用いて拡大し、ピクセルの直線的な輪郭を保持します。プラグイン化により Claude Code 上で簡単に呼び出せ、マーケットプレイスからインストールしてワークフローに組み込めます。インストール例: /plugin marketplace add DreamC0der-AI/pixel-snap /plugin install pixel-snap@dreamcoder-… (技術的特徴や実装の要点を700字程度で説明)
プロジェクトの構成
主要なファイルとディレクトリ:
- .claude-plugin: dir — Claude Code プラグイン定義やメタ情報が格納される想定のディレクトリ
- README.md: file — プロジェクト概要とインストール手順、機能説明
- package.json: file — 依存関係とスクリプト(Node/JavaScript パッケージ設定)
- pixel-art-snap.js: file — コア処理(グリッド検出、色抽出、出力整形)を実装するメインスクリプト
- skills: dir — Claude向けの操作やコマンドを定義するスキル(プラグインの振る舞いを表す)
ファイル構成はシンプルで、プラグイン本体とメタ情報に集中。pixel-art-snap.js がアルゴリズムの中心で、外部依存は最小限に抑えられている想定です。
まとめ
アップスケールで崩れたピクセルアートを自動復元する、実用性の高いClaudeプラグインです。(約50字)
リポジトリ情報:
- 名前: pixel-snap
- 説明: Claude Code plugin: Convert upscaled pixel art images back to clean, sharp pixel art
- スター数: 2
- 言語: JavaScript
- URL: https://github.com/DreamC0der-AI/pixel-snap
- オーナー: DreamC0der-AI
- アバター: https://avatars.githubusercontent.com/u/264568006?v=4
READMEの抜粋:
pixel-snap
A Claude Code plugin that converts upscaled pixel art images back to clean, sharp pixel art.
What it does
- Auto-detects grid size via autocorrelation of edge signals
- Extracts true pixel colors using mode-based selection
- Supports icon mode (remove background, crop, center) and scene mode (preserve full image)
- Outputs crisp, nearest-neighbor scaled results
Install
/plugin marketplace add DreamC0der-AI/pixel-snap /plugin install pixel-snap@dreamcoder-…