QuickSDFTool

English

QuickSDFTool ドキュメント

QuickSDFTool は Unreal Engine 5.7.x でトゥーン影マスクをメッシュ上へペイントし、スタイライズドレンダリング向けの SDF スレッショルドマップを生成するエディターモードプラグインです。

このサイトでは、導入手順、基本ワークフロー、生成テクスチャのマテリアル接続、互換性、検証済みリリース情報を確認できます。

クイックスタート GitHub リポジトリ デモを見る

主なページ

Authoring Workflow Select、Paint、2D Canvas、ペン入力、Quick Stroke、Material Slots、Timeline、Live SDF preview、Symmetry、Guard、import/export、SDF generation を確認します。 Material Setup 生成した SDF スレッショルドマップを toon / cel-shading 用マテリアルへ接続します。 Troubleshooting インストール、ビルド、マテリアル、ペン入力、2D Canvas、ブラシ挙動の代表的な問題を確認します。 Release Notes 検証済み Unreal Engine バージョン、アップグレード情報、リリースアセットを確認します。 Roadmap 1.0 以降の優先度と計画中の機能要件を確認します。 Development Notes 内部構成、検証、生成済み概念図、必要な実機スクリーンショット、リポジトリ保守メモを確認します。

ワークフロースクリーンショット

現在のドキュメント用キャプチャは、slot 選択から SDF 出力までの v1.0 workflow を示します。概念図は authoring pipeline、pen input、pressure curve、symmetry、Monotonic Guard の説明用です。UI の状態を証明する画像は、生成画像ではなく実際の UE editor から撮影したスクリーンショットを使います。

Select mode active material slot overlay
Select active slot Select mode はメッシュ全体を表示したまま、選択行と cyan viewport overlay で active material slot を示します。
Paint mode with Screen projection brush preview
Screen mode での Paint Paint mode は Screen projection、ブラシプレビュー、UV texture preview、active slot context を表示します。
Quick SDF timeline controls and keyframes
Timeline Timeline は thumbnails、angle labels、keyframe controls を表示したまま seek や key drag を行えます。
Generated SDF threshold texture preview
SDF output 生成された SDF threshold texture が toon material で使うデータです。

スクリーンショット内キャラクターモデル: 真冬 Mafuyu / オリジナル3Dモデル（ぷらすわん）。キャラクターデザイン / 3Dモデリング: 有坂みと。

クイックスタート

  1. このリポジトリを C++ Unreal project の Plugins/QuickSDFTool/ にコピーします。
  2. Project files を再生成し、ビルド後に QuickSDFTool を有効化して editor を再起動します。
  3. Editor Mode selector から Quick SDF を選びます。
  4. Select mode で、編集したい mesh / material surface を viewport 上でクリックします。
  5. Material Slots で active slot を確認します。選択行と cyan viewport overlay が現在の material slot を示し、row click で viewport pick を補正できます。
  6. Start Paint を押します。Paint mode は既定で active slot を isolate します。全体表示が必要な場合は Isolate Slot をオフにします。
  7. LMB で白、Shift + LMB で黒 / shadow をペイントします。
  8. texture-space の作業には 2D Canvas を使います。Texture Set / Angle selector、brush size、Fit / 100% zoom、rotate/flip、checker/grid、UV overlay、onion skin、ペン入力に対応します。
  9. stroke を hold すると Quick Stroke になります。移動して preview を調整し、release で最終位置を確定します。
  10. 最終 texture 生成前の確認には Live SDF material preview を使います。GPU JFA による高速な近似表示です。
  11. Timeline で light angle を seek し、keyframe を追加または duplicate し、paint target mode を選びます。
  12. Generate Selected SDF または Generate SDF Threshold Map を実行します。
  13. /Game/QuickSDF_GENERATED/ に生成された texture を toon material で使います。

互換性

QuickSDFTool v1.0 は Unreal Engine 5.7.x を対象にしており、UE 5.7.4 がリリース検証ターゲットです。UE 5.8+ は対応予定ですが、v1.0 の検証対象には含まれていません。

基本ワークフロー

painted light/shadow masks -> SDF interpolation -> RGBA threshold texture -> controlled toon shadow

QuickSDF authoring pipeline diagram

QuickSDFTool は、物理的な正しさよりもアートディレクションに沿った影形状を優先したい場面に向いています。顔影、髪影、服の折り目影、小規模チームでの editor 内反復制作に使えます。