painterly-25d

agent
Security Audit
Pass
Health Pass
  • License — License: GPL-3.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 10 GitHub stars
Code Pass
  • Code scan — Scanned 11 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Free Blender add-on: any 3D scene → hand-painted 2.5D in one click. Oil, watercolour, crayon, pencil, anime cel + Shuffle. AI-agent ready. Free with credit to @KanaWorks_AI.

README.md

Painterly 2.5D は、Blender のシーンをボタンひとつで「手描きの絵」に変える、無料の Blender アドオンです。光と影の境目にだけ筆のタッチを入れるトゥーン、2コマ打ちでゆらゆら揺れる手描きの輪郭線、油絵のような仕上げのフィルターを、どんなシーンにもまとめてかけます。

油絵・ガッシュ・水彩・クレヨン・色鉛筆・アニメ塗りの6つの画材から選べて、シャッフルを押すたびに筆の向きや色合いが変わるので、同じシーンでも毎回ちがう一枚になります。インストールから適用まで、AI エージェントに一言で頼むこともできます。

同じシーンの適用前(左)と適用後(右)
同じシーン、同じカメラ。左が普通のレンダリング、右が Painterly 2.5D。

✨ 特長


ワンクリック
EEVEE、マテリアル、輪郭線、コンポジターまで一括で設定

画材は6種類
油絵・ガッシュ・水彩・クレヨン・色鉛筆・アニメ塗り

シャッフル
押すたびに筆の向き・色むら・影の色・線の色・紙が変わる

AIにおまかせ
エージェントに一言。インストール、適用、プレビューまで自動
  • どんなシーンでも動く: マテリアルのないオブジェクトには自動でマテリアルを作り(頂点カラーも保持)、ライトがなければキーライトを足します。Diffuse・Emission・画像だけ・ノードグループのマテリアルも元の色を引き継ぎ、ガラスや半透明の面はそのまま残します。コレクションインスタンスにも対応しています。
  • 大きさに合わせて自動調整: オブジェクトの大きさとカメラの距離から、筆のタッチ・深度フォグ・線のフェードを決めます。10cm の小物でも 50m の建物でも同じ見た目になります。
  • 線にモデルの色: 輪郭線を、それぞれのモデルの色を暗くした色で描けます(黒一色にもできます)。
  • プリセット5種: ブルーアワーの夜、ゴールデンアワー、パステルスイーツ、絵本の昼、クリーン/プロダクト。画材と組み合わせて使えます。
  • 元に戻せる: 「絵画風を解除」で元のマテリアル、コンポジター、表示設定に戻ります。値はシェーダーの中で読むので、アドオンがない環境でも同じ見た目でレンダリングできます。
  • UI は日本語・英語・簡体中国語: Blender の「インターフェイス › 翻訳」の設定に従います。

🎨 ギャラリー

画材6種

同じモデル、同じライト。画材だけを切り替えました。

油絵、ガッシュ、水彩、クレヨン、色鉛筆、アニメ塗り

シャッフル

押すたびに、筆の向き、色のゆらぎ、影の色、線の色、紙の色がプリセットと画材の範囲でランダムに変わります。番号を覚えておけば、同じ見た目をいつでも再現できます。

同じモデルの4つのバリエーション

どんなモデルにも

CC0 のモデル、Blender 標準のスザンヌ、作者が用意したモデルに、ボタン1回で適用しました。

6つのモデル

3つのレイヤー

元の3D → トゥーンと筆のタッチ → 手描きの輪郭線 → 油絵風の仕上げ

🧭 しくみ

flowchart LR
    M["あなたのシーン<br/>どんなモデル・マテリアルでも"] --> T["トゥーン<br/>明暗の境目に筆のタッチ<br/>色のゆらぎ"]
    T --> O["輪郭線<br/>反転ハル · 2コマ打ち<br/>モデルの色"]
    O --> P["仕上げ<br/>桑原フィルタ · にじみ · 紙<br/>網点・斜線"]
    P --> R["手描きの 2.5D"]
  1. トゥーン: Diffuse → Shader to RGB で明暗を取り、キーライトの強さで割ってセル分けします。明暗の境目の近くでだけ、ボロノイの筆タッチで法線を揺らし、タッチごとに色相・彩度・明度を少しずつずらします。
  2. 輪郭線: ジオメトリノードの反転ハルで、画面上で一定の太さの線を作ります。ノイズで途切れさせ、2コマごとに描き直します。
  3. 仕上げ: コンポジターで、深度フォグ → 2段の桑原フィルタ(線は保護)→ にじみの縁・顔料の粒状感 → 網点や斜線 → ブルーム → 紙の質感 → 粒子 → グレーディング。ピクセル単位の値は解像度に合わせて自動で変わります。

🚀 はじめかた

AI エージェントに頼む(おすすめ)

Claude Code や Codex のような、パソコンを操作できる AI エージェントにこう送るだけです。

https://github.com/kanaworksai-hue/painterly-25d の AGENTS.md に従って Painterly 2.5D をインストールして、私の Blender シーンを手描きの絵っぽくして。

そのあとは、プレビューを見ながら一言で直せます。

  • 「水彩にして」
  • 「夕焼けの雰囲気で」
  • 「別のパターンも見せて」
  • 「筆のタッチを大きく」
  • 「線をもっと細く」

自分でインストールする

必要なもの: Blender 5.0 以降(Blender 5.2 で動作確認済み)、レンダーエンジンは EEVEE。

  1. Releases から painterly_25d-x.y.z.zip をダウンロード(解凍しないでください)
  2. Blender → 編集 → プリファレンス → エクステンションを入手 → 右上の ⌄ → ディスクからインストール… → zip を選択

Install from Disk

使い方

  1. シーンを開く(モデルやマテリアルは何でも OK)
  2. 3D ビューで N キー → Painterly タブ
  3. Make It Painterly(ワンクリックで絵画風に)
  4. プリセットと画材を選ぶ。迷ったら シャッフル
  5. 「トゥーン&筆タッチ」「アウトライン」「ポストエフェクト」で微調整して、F12 でレンダリング

Blender の Painterly 2.5D パネル

🎛️ 調整できること

メインパネル
項目 内容
プリセット 色と雰囲気(夜・夕焼け・パステル・昼・クリーン)
画材 塗り方(油絵・ガッシュ・水彩・クレヨン・色鉛筆・アニメ塗り)
バリエーション / シャッフル 筆の向き・色のゆらぎ・影の色・線の色・紙をランダムに変える番号。0 でオフ
選択中のオブジェクトのみ 選んだものだけに適用(初期設定はシーン全体)
キーライトがなければ追加 ライトが1つもないとき、カメラ側からのサンを追加(解除で削除)
シーンのスケールに合わせる 筆タッチ・フォグ・線のフェードを大きさとカメラ距離から設定
絵画風を解除 元のマテリアル・コンポジター・表示設定に戻す
画材
画材 仕上がり
油絵(初期設定) 明暗の境目に厚い筆のタッチ。桑原フィルタで油彩らしく
ガッシュ 不透明でマットな平塗り、やわらかい縁
水彩 透明感のある塗り。縁に顔料がたまり、輪郭がにじみ、紙に顔料が沈む
クレヨン ワックスのような筆跡、紙の凹凸が白く抜け、影に斜線
色鉛筆 軽いタッチとクロスハッチングの影
アニメ塗り くっきりしたセル塗りと線。絵の具の質感なし

画材は「塗り方」の値だけを変え、プリセットは「色と雰囲気」の値だけを変えるので、自由に組み合わせられます。

おもな細かい設定
グループ 項目
筆タッチ 強さ・細かさ・伸び・ゆがみ・向き・明暗境界の幅・シード
色のばらつき 色のゆらぎ(タッチごと)・色むら(大きな斑)
アウトライン 太さ・線の色・線にモデルの色を使う・手描きのゆらぎ・2コマ打ち
画材 にじみの縁・にじみのゆらぎ・顔料の粒状感・紙の凹凸
影の模様 網点 / 斜線 / クロスハッチング・量・間隔・色
フィルム 紙の質感・ブルーム・ハレーション・粒子・色収差・周辺減光・グレーディング

オブジェクトごとに、しきい値・影の明るさ・筆タッチ・発光・線の太さを上書きすることもできます(オブジェクトプロパティ)。

❓ FAQ

Cycles でも使えますか?

使えません。EEVEE 専用の「Shader to RGB」ノードを使っているため、EEVEE でレンダリングしてください。Make It Painterly を押すと EEVEE に切り替わります。

筆のタッチが大きすぎる・小さすぎます。

カメラを動かしたり、シーンの大きさを変えたりしたあとは「シーンに合わせる」を押してから、「筆タッチの細かさ」(1m あたりの数)で調整してください。

全部明るくて影が出ません。

明るいワールドや HDRI は補助光が強いので、「環境光の補正」を上げてください。

元のマテリアルはどうなりますか?

トゥーンのノードグループを差し込み、元のつながりを覚えておきます。「絵画風を解除」で元どおりになります。アドオンが自動で作ったマテリアルやライトも削除されます。

作った画像や動画は商用で使えますか?

はい。Painterly 2.5D で作ったレンダリング画像や動画は、あなたの作品として自由に使えます。GPL が適用されるのはアドオン本体のコードで、それを使って作った作品には及びません(使ったモデルやテクスチャのライセンスには従ってください)。クレジットは必要ありませんが、Made with Painterly 2.5D by @KanaWorks_AI と入れてもらえると嬉しいです。

📝 クレジット表記

Painterly 2.5D は無料で、商用でも使えます。

アドオンを再配布・改変・同梱するとき(フォーク、改変版、移植版、パックや製品への同梱など。有償・無償を問いません)は、次の表記をアドオンの説明文とドキュメントにそのまま残すことが必須です(GPL-3.0 第7条(b)に基づく追加条項。詳しくは NOTICE.md)。

Painterly 2.5D by KanaWorks_AI (@KanaWorks_AI) — https://github.com/kanaworksai-hue/painterly-25d

作った画像や動画にはクレジットは必要ありません。よければ投稿文や概要欄に入れてもらえると嬉しいです。

Made with Painterly 2.5D by @KanaWorks_AI

⭐ Star で応援する

Painterly 2.5D を気に入ったら、リポジトリのページの右上にある ⭐ Star を押してもらえると嬉しいです。無料で、1秒で終わります。

  • もっと多くの人に届く: Star が増えると GitHub で見つけてもらいやすくなります。
  • アップデートの励みになる: 新しい画材やプリセットを作り続ける力になります。

ほかにも、バグや欲しい機能を Issue で教えてもらったり、作品を X で @KanaWorks_AI をつけて見せてもらえたりすると、とても励みになります。

🧩 KanaWorks のアドオン

同じ作者の、無料・オープンソースの Blender アドオンです。どれも AI エージェントに一言で頼めます。

Painterly 2.5D
Painterly 2.5D(このページ)
3D を手描きの絵に。油絵・水彩・クレヨン・アニメ塗り
Harappa
Harappa
アニメ背景の原っぱ・木・空に、池・滝・天気までワンクリックで
Senga Sketch
Senga Sketch
3D をペンで描いた線画に。ハッチング・鉛筆・銅版画・トーン
KiraPaint
KiraPaint
3D をキラキラの絵画風 2.5D に。砕いたダイヤのツヤと星の光
MochiToon
MochiToon
3D をかわいいマンガ風に。色つきの影、ハートや星の網点

🛠️ 開発

# ヘッドレステスト(調整していない汎用シーンで全機能を確認)
blender -b --factory-startup --python tests/test_generic.py

# 配布用の zip を dist/ に作成
BLENDER=blender ./build.sh
painterly_25d/
  __init__.py      設定、プリセット・画材・バリエーション、オペレーター、パネル
  toon.py          トゥーンのシェーダーノードグループ(筆タッチ、色のゆらぎ、影の色)
  outline.py       ジオメトリノードの輪郭線と、モデルの色を使う線のマテリアル
  post.py          コンポジター(桑原、にじみ、網点・斜線、紙、グレーディング)
  autosetup.py     どんなシーンでも動かすための自動設定(マテリアル、ライト、スケール)
  translations.py  日本語・簡体中国語の UI
agent/painterly_agent.py  AI エージェント用のコマンドライン

📄 ライセンスとクレジット

  • このアドオン: Copyright © 2026 東京AI映像合同会社。GPL-3.0-or-later で公開しています(再配布時のクレジット表記を求める追加条項付き。NOTICE.md)。
  • ブランド: KanaWorks_AI の名称、ロゴ、キャラクター Kana の権利は東京AI映像合同会社に帰属し、GPL の対象外です。詳しくは docs/brand を見てください。
  • Blender コミュニティで公開されている NPR の解説(Shader to RGB のセル表現、桑原コンポジット、反転ハルの輪郭線)を参考にしています。
  • Blender は Blender Foundation の商標です。本プロジェクトは独立したプロジェクトで、Blender Foundation とは提携しておらず、承認も受けていません。

KanaWorks_AI のマスコット、手を振る Kana

Made with ♥ by KanaWorks_AI

Painterly 2.5D が役に立ったら、⭐ が次のアップデートの励みになります。ほかのプロジェクト:github.com/kanaworksai-hue

Reviews (0)

No results found