PaintMaskAnimator

English | 日本語

公式サイト — ダウンロード・更新履歴・過去のバージョン・ヘルプ

アニメーションの仕上げ（彩色）のためのペイント / マスクアニメーションツールです。 略称は PMAn（ピーマン）。

ダウンロード

Releases から最新版を ダウンロードしてください。

OS	ファイル	対応
Windows	PaintMaskAnimator-Setup-<版>.exe	64 ビット版 Windows
macOS	PaintMaskAnimator-<版>-macOS.dmg	Apple Silicon（M1 以降）。Intel Mac は非対応

インストール後は、アプリ内の更新確認から新しい版を取得できます。 0.6.4 以前を使っている場合はアプリ内の更新が届かないため、一度だけ Releases から 入れ直してください。

主な機能

• フレームとレイヤーによるペイント・マスクアニメーションの編集、タイムライン、 オニオンスキン、トゥイーン
• 使用色パネル：色を親子付け・タグ・フォルダーで整理し、置換・統合・減色ができる
• カラーチャート（.pmag）で色の親子関係を管理し、現在の画像へ適用
• 読み込み：画像・連番、PSD、CLIP STUDIO のアニメーション（.clip）、 タイムシート（XDTS / TDTS）、タイムリマップの貼り付け
• 書き出し：PNG / TGA 連番＋CSV、PSD、MP4、XDTS、カットフォルダー （セル画像とタイムシートをまとめて書き出し）
• 自動保存とクラッシュからの復元、パネル配置のカスタマイズ、ライト / ダークテーマ
• 表示言語：日本語・英語（編集 › 環境設定… › 一般。macOS ではアプリ名のメニュー。既定は OS の言語）
• Python スクリプトによるアクションの追加（下記）

プロジェクトファイル（.pman）の形式は FORMAT.md にまとめています。

塗り済みの絵に元の線画を追加するには、自動塗り › 線画カットフォルダーを初期状態として読み込む… を選びます。A/A0001.png のようなPNG／TGAをレイヤー名とセル番号で対応付けるため、 タイムシートは不要です。今の絵とタイムラインは維持し、一致しないセルは変更しません。 線画は現在のセルと同じ画像サイズが必要です。1回のUndoで戻せ、プロジェクトに保存できます。

クリスタのファイルから追加する場合は、自動塗り › CLIPの線画を初期状態として読み込む… を選びます。.clip内のアニメーションフォルダー名とセル番号で対応付け、未配置セルの 初期状態も読み込みます。現在の絵とタイムラインは維持します。

ソースから実行する

Python 3.10 以上が必要です。

pip install -r requirements.txt
python PaintMaskAnimator.py        # または python -m paintmaskanimator

必須の依存は PySide6、PySide6-QtAds、numpy です。Pillow と psd-tools を入れると、 PSD などの読み込み・書き出しが有効になります。

開発時の起動にはRust拡張が必須です。Rustのツールチェーンを用意し、 pip install ./nativeでインストールしてください（配布版には同梱しています）。 対応範囲はCLIP読み込みを参照してください。

自動塗りの任意のGPU支援と速度の計測方法は、 自動塗りの処理と計測を参照してください。

Python アクション

アクションパネルには、Python スクリプトでボタンを追加できます。タブ左端の ☰ › スクリプトを編集 でアプリ内エディタが開きます。

def register_actions(panel, window):
    panel.add_action(
        "my.unique.action",
        "My Action",
        lambda: window.status_bar.showMessage("Done", 3000),
        tooltip="Optional help text",
    )

API リファレンスと組み込みアクションの一覧は docs/actions.md、 サンプルは examples/actions/hello_status.py に あります。アクションは通常の Python コードとして実行されるので、信頼できる提供元の ものだけを入れてください。

開発に参加する

開発環境の準備、提出前のチェック、翻訳、リリース手順は CONTRIBUTING.md にまとめています。

テストカバレッジは カバレッジレポート で行ごとに確認できます。 機能検証マップ もあわせて公開しています。 どちらも main への push 時に CI が更新するので、プルリクエストの内容は まだ反映されていません。その場合は Actions のラン画面のサマリに出る数値か、 feature-map-<sha> アーティファクトを参照してください。 ほかの入口は 公式サイトの開発者向けページ にまとめています。

pip install -e ".[dev,full]"
python scripts/preflight.py

コードは paintmaskanimator/ 以下の Python パッケージです。 リポジトリ直下の PaintMaskAnimator.py は起動用の薄いランチャーです。

モジュール	役割
document.py	プロジェクト状態モデル（フレーム / レイヤー / カーソル）
imaging.py、geometry.py、colors.py、color_ops.py	Qt に依存しないアルゴリズム
project_io.py	プロジェクトファイルの保存・読み込み
canvas.py、timeline.py、toolpanel.py、main_window.py など	UI（PySide6 ウィジェット）
main_window_<topic>.py	機能ごとのコントローラ（window.export など）
i18n.py	翻訳の読み込みと tr()

構造グラフを更新する

公式サイトの 構造グラフ は、 Understand-Anything で作った .ua/ を 表示しています。グラフは CI では作らず、構造が変わったときに手元の Claude Code で 作り直してコミットします。

1. リポジトリの main で Claude Code を起動し、次を実行します。言語（日本語）は .ua/config.json に保存済みなので、指定は不要です。前回からの差分だけを解析します。

   /understand
   

2. .ua/ をコミットして main に push します。作業用のファイルは .gitignore で 除いてあります。push すると公式サイトのグラフも置き換わります。

   git add .ua
   git commit -m "chore(understand): 構造グラフを更新"
   git push
   

初めての環境での準備、全部作り直すとき、プラグインを更新したときの手順は docs/knowledge-graph.md を参照してください。

プロジェクトの由来

PaintMaskAnimator は、小嶋慶祐が v0.5 まで単独で 開発しました。v0.5 以降は、小嶋慶祐と上甲愛士の 2 名で共同開発しています。

当初から一貫している狙いは次のとおりです。

• アニメーション仕上げソフトの新しい選択肢
• 動画作業にも対応できる描画能力
• CLIP STUDIO PAINT のような操作感を持つタイムライン

ライセンス

Apache License 2.0 のもとで配布しています。帰属表示は NOTICE を参照してください。

• 商用・非商用を問わず、利用・改変・再配布ができます。改変版をクローズドソースの 製品として配布することもできます。求められるのは、ライセンス表記と NOTICE の 保持、変更点の明示です（第4条）。
• 本ソフトウェアで作った作品（画像・アニメーション・プロジェクトファイル）は あなたのものです。ライセンスは作品には及びません。
• 商標の使用は許諾していません（第6条）。「PaintMaskAnimator」と「PMAn」は、 派生物の名称には使わないでください。
• PySide6（LGPLv3）や Qt Advanced Docking System（LGPL-2.1）などを同梱しています。 配布物やパッケージングを変える場合は、 THIRD_PARTY_LICENSES.md の「LGPL compliance」節を 確認してください。
• 貢献は Apache License 2.0 の条件で提供されたものとみなします（第5条）。 CLA は不要です。