painterly-25d
Health Gecti
- License — License: GPL-3.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 10 GitHub stars
Code Gecti
- Code scan — Scanned 11 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
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.
日本語 | English | 简体中文 | 한국어 | Português | Español
🎨 ギャラリー · 🚀 はじめかた · 🎛️ 調整できること · ❓ FAQ · ⭐ Star で応援
Painterly 2.5D は、Blender のシーンをボタンひとつで「手描きの絵」に変える、無料の Blender アドオンです。光と影の境目にだけ筆のタッチを入れるトゥーン、2コマ打ちでゆらゆら揺れる手描きの輪郭線、油絵のような仕上げのフィルターを、どんなシーンにもまとめてかけます。
油絵・ガッシュ・水彩・クレヨン・色鉛筆・アニメ塗りの6つの画材から選べて、シャッフルを押すたびに筆の向きや色合いが変わるので、同じシーンでも毎回ちがう一枚になります。インストールから適用まで、AI エージェントに一言で頼むこともできます。
同じシーン、同じカメラ。左が普通のレンダリング、右が Painterly 2.5D。
✨ 特長
ワンクリック EEVEE、マテリアル、輪郭線、コンポジターまで一括で設定 |
画材は6種類 油絵・ガッシュ・水彩・クレヨン・色鉛筆・アニメ塗り |
シャッフル 押すたびに筆の向き・色むら・影の色・線の色・紙が変わる |
AIにおまかせ エージェントに一言。インストール、適用、プレビューまで自動 |
- どんなシーンでも動く: マテリアルのないオブジェクトには自動でマテリアルを作り(頂点カラーも保持)、ライトがなければキーライトを足します。Diffuse・Emission・画像だけ・ノードグループのマテリアルも元の色を引き継ぎ、ガラスや半透明の面はそのまま残します。コレクションインスタンスにも対応しています。
- 大きさに合わせて自動調整: オブジェクトの大きさとカメラの距離から、筆のタッチ・深度フォグ・線のフェードを決めます。10cm の小物でも 50m の建物でも同じ見た目になります。
- 線にモデルの色: 輪郭線を、それぞれのモデルの色を暗くした色で描けます(黒一色にもできます)。
- プリセット5種: ブルーアワーの夜、ゴールデンアワー、パステルスイーツ、絵本の昼、クリーン/プロダクト。画材と組み合わせて使えます。
- 元に戻せる: 「絵画風を解除」で元のマテリアル、コンポジター、表示設定に戻ります。値はシェーダーの中で読むので、アドオンがない環境でも同じ見た目でレンダリングできます。
- UI は日本語・英語・簡体中国語: Blender の「インターフェイス › 翻訳」の設定に従います。
🎨 ギャラリー
画材6種
同じモデル、同じライト。画材だけを切り替えました。

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

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

3つのレイヤー

🧭 しくみ
flowchart LR
M["あなたのシーン<br/>どんなモデル・マテリアルでも"] --> T["トゥーン<br/>明暗の境目に筆のタッチ<br/>色のゆらぎ"]
T --> O["輪郭線<br/>反転ハル · 2コマ打ち<br/>モデルの色"]
O --> P["仕上げ<br/>桑原フィルタ · にじみ · 紙<br/>網点・斜線"]
P --> R["手描きの 2.5D"]
- トゥーン: Diffuse → Shader to RGB で明暗を取り、キーライトの強さで割ってセル分けします。明暗の境目の近くでだけ、ボロノイの筆タッチで法線を揺らし、タッチごとに色相・彩度・明度を少しずつずらします。
- 輪郭線: ジオメトリノードの反転ハルで、画面上で一定の太さの線を作ります。ノイズで途切れさせ、2コマごとに描き直します。
- 仕上げ: コンポジターで、深度フォグ → 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。
- Releases から
painterly_25d-x.y.z.zipをダウンロード(解凍しないでください) - Blender → 編集 → プリファレンス → エクステンションを入手 → 右上の ⌄ → ディスクからインストール… → zip を選択

使い方
- シーンを開く(モデルやマテリアルは何でも OK)
- 3D ビューで N キー → Painterly タブ
- Make It Painterly(ワンクリックで絵画風に)
- プリセットと画材を選ぶ。迷ったら シャッフル
- 「トゥーン&筆タッチ」「アウトライン」「ポストエフェクト」で微調整して、F12 でレンダリング
🎛️ 調整できること
メインパネル| 項目 | 内容 |
|---|---|
| プリセット | 色と雰囲気(夜・夕焼け・パステル・昼・クリーン) |
| 画材 | 塗り方(油絵・ガッシュ・水彩・クレヨン・色鉛筆・アニメ塗り) |
| バリエーション / シャッフル | 筆の向き・色のゆらぎ・影の色・線の色・紙をランダムに変える番号。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(このページ) 3D を手描きの絵に。油絵・水彩・クレヨン・アニメ塗り |
![]() Harappa アニメ背景の原っぱ・木・空に、池・滝・天気までワンクリックで |
![]() Senga Sketch 3D をペンで描いた線画に。ハッチング・鉛筆・銅版画・トーン |
![]() KiraPaint 3D をキラキラの絵画風 2.5D に。砕いたダイヤのツヤと星の光 |
![]() 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 とは提携しておらず、承認も受けていません。
Made with ♥ by KanaWorks_AI
Painterly 2.5D が役に立ったら、⭐ が次のアップデートの励みになります。ほかのプロジェクト:github.com/kanaworksai-hue
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi






