> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Patina Textureノード: ComfyUIでタイル状PBRマテリアルとマップ

> Patinaノードを使って、写真やプロンプトからComfyUIでシームレスにタイル状に並ぶPBRマテリアルを生成します。ベースカラー、ノーマル、ラフネス、メタルネス、高さマップにも対応します。

Patinaは3Dアセットに必要なサーフェスデータを生成します。1回の実行でベーステクスチャに加え、PBRマテリアルが想定するベースカラー、ノーマル、ラフネス、メタルネス、高さの各マップが返ります。セット全体が同じ潜在から生成されるため、マップは個別のベイクを必要とせず、ピクセル単位で位置が揃います。

ComfyUIでは、このプロバイダーは3つのパートナーノードを通じて実行されます。**Patina Material** はテキストプロンプトから、写真から、あるいは写真とマスクからマテリアルを構築します。**Patina Material Extract** は、目的のサーフェスがすでに写っている写真からタイリング可能なマテリアルを抽出します。**Patina PBR Material Maps** は、何も再生成せずに1枚の画像をマップセットに変換します。

3つともクラウドAPIノードです。クレジットを持つComfyアカウントが必要で、モデルファイルのダウンロードは一切行わず、実行ごとに課金されます。各ノードの価格バッジに現在の料金が表示され、有効にしたマップごとに料金が加算されます。

> [!TIP]
>
> APIノードを使用するには、正しくログインしていることと、許可されたネットワーク環境で使用していることを確認する必要があります。APIノードの使用に必要な具体的な要件については、ドキュメントの「[APIノードの概要](https://docs.comfy.org/ja/tutorials/partner-nodes/overview.md)」セクションをご参照ください。

> [!TIP]
>
> > [tab] ローカルユーザー
> >
> > ComfyUI が最新版に更新されていることを確認してください。
> >
> > * [ComfyUI のダウンロード](https://www.comfy.org/download)
> > * [更新手順](https://docs.comfy.org/ja/installation/update_comfyui.md)
> >
> > このガイドで紹介するワークフローは、[ワークフローテンプレート](https://docs.comfy.org/ja/interface/features/template.md)から入手できます。
> > テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。
> >
> > ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：
> >
> > 1. 最新の ComfyUI（Nightly 版）を使用していない
> > 2. 起動時に一部のノードのインポートに失敗している
>
> > [tab] クラウドユーザー
> >
> > * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。
> >
> > したがって、このドキュメントでコアノードが見つからない場合、それは新しいコアノードがまだ最新の安定版にリリースされていない可能性があります。次回の安定版リリースをお待ちください。

## 利用可能なワークフロー

### Material Extract：写真からタイリングマテリアル

マテリアルがすでに含まれている写真をノードに指定し、プロンプトで抽出する表面と保持する構造を指定します。テクスチャはシームレスな状態で出力されるため、大きな面に繰り返し配置しても目に見える境界が生じません。

![Patina Material Extract ワークフローのプレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_patina_material_extract-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=api_patina_material_extract\&utm_source=docs\&utm_medium=referral\&utm_campaign=patina)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_patina_material_extract.json)
>
> JSON をダウンロードするか、テンプレートライブラリで「Patina: Material Extract」を検索してください

**入力マテリアル**

> [card] [patina\_chair\_webbing.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/patina_chair_webbing.png)
>
> `LoadImage` ノードに読み込みます。マテリアルがすでに含まれている写真

写真は平坦に切り取ったものである必要はありません。ノードがレイアウトを再合成するため、マテリアル自体が繰り返すものであれば、商品写真でも問題ありません。`strength`（高度な機能、テンプレートでは 0.6）は、抽出されたテクスチャが写真からどれだけ逸脱できるかを設定します。

### Material：テキストからマテリアル

表面を説明するだけで、ソース画像をまったく使わずに完全なマテリアルを取得できます。プロンプトが結果全体を決めるため、そのマテリアルが属する物体ではなく、模様と仕上げを指定してください。

![Patina テキストからマテリアルへのワークフローのプレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_patina_material_t2m-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=api_patina_material_t2m\&utm_source=docs\&utm_medium=referral\&utm_campaign=patina)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_patina_material_t2m.json)
>
> JSON をダウンロードするか、テンプレートライブラリで「Patina: Text to Material」を検索してください

構造がはっきりしたマテリアルのほうが良い結果になります。木材、石材、金属、布地、漆喰、セラミックタイルなどです。「flat even lighting, no perspective」を追加すると、結果は壁の写真として認識されるのではなく、タイリングされるようになります。

### Material：画像からマテリアル

表面の写真を接続すると、Patina が画像の模様を保ちながら、タイリングマテリアルとして描き直します。`strength` は写真からどれだけ離れるかを決めます。低い場合はオリジナルのテクスチャを保ち、高い場合はより多くを書き換えます。

![Patina 画像からマテリアルへのワークフローのプレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_patina_material_i2m-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=api_patina_material_i2m\&utm_source=docs\&utm_medium=referral\&utm_campaign=patina)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_patina_material_i2m.json)
>
> JSON をダウンロードするか、テンプレートライブラリで「Patina: Image to Material」を検索してください

**入力マテリアル**

> [card] [patina\_brick\_wall.jpg](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/patina_brick_wall.jpg)
>
> `LoadImage` ノードに読み込みます。規則的な構造を持つ表面の写真

オプションの `mask` 入力を使うと、描き直す範囲を領域に限定できます。白は再生成、黒は保持を意味します。画像なしでマスクを指定するとエラーが発生します。

### PBR Maps：画像からマップセット

すでにマテリアルとなっている画像からマップを導出します。ここでは何も再生成されません。マップは画像の内容を正確に表すため、ソースの継ぎ目、パースペクティブ、照明は結果にそのまま残ります。

![Patina PBR マテリアルマップのワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_patina_pbr_maps-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=api_patina_pbr_maps\&utm_source=docs\&utm_medium=referral\&utm_campaign=patina)
>
> Comfy Cloud で開く

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_patina_pbr_maps.json)
>
> JSON をダウンロードするか、テンプレートライブラリで「Patina: PBR Maps」を検索してください

**入力マテリアル**

> [card] [patina\_pbr\_webbing\_basecolor.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/patina_pbr_webbing_basecolor.png)
>
> `LoadImage` ノードに読み込みます。平らで均一に照らされた表面、または既存のベースカラーマップ

このノードはタイリングしません。すでにシームレスなベースカラーがあり、セットの残りを取得したい場合に使用します。結果を繰り返す必要がある場合は、Material または Material Extract を使用してください。最大 2048 px の入力を受け付けます。それより大きな画像は、`auto_downscale` をオフにしない限り縮小されます。

## ノードのコントロール

| コントロール | 値 | 対象 | 効果 |
| - | - | - | - |
| `prompt` | テキスト | Material、Material Extract | サーフェスまたはマテリアルの名前を指定します。Extract では、写真のどの部分を抽出するかを指定します。PBR Maps にはプロンプト入力がありません |
| マップの切り替え | `basecolor`, `normal`, `roughness`, `metalness`, `height` | 3 つのノードすべて | どのマップを返すか。ノードでは basecolor と normal がオン、残り 3 つがオフで、4 つのテンプレートはいずれも 5 つすべてをオンにしています。有効にしたマップごとに実行価格が加算されます |
| `image_size` | `1:1 (1024x1024)`, `1:1 (512x512)`, `4:3 (1024x768)`, `3:4 (768x1024)`, `16:9 (1024x576)`, `9:16 (576x1024)`, `custom` | Material、Material Extract | 出力サイズ。`custom` は 512 から 2048 まで 16 刻みで幅と高さを指定します |
| `upscale_factor` | `0`, `2`, `4` | Material、Material Extract | マップのシームレスなアップスケーリング。ベーステクスチャはアップスケーリングされず、`4` を指定すると 2K の実行から 8K のマップ出力に達します |
| `strength` | 0.01 〜 1.0、デフォルト 0.6 | Material、Material Extract | 結果がソース写真からどこまで離れてよいか。テキストからマテリアルの場合は無視されます |
| `tiling_mode` | `both`, `horizontal`, `vertical` | Material、Material Extract | タイリング方向 |
| `num_inference_steps` | 1 〜 8、デフォルト 8 | Material、Material Extract | ノイズ除去ステップ数。8 を超えても得るものはありません |
| `tile_size` | 32 〜 256、デフォルト 128 | Material、Material Extract | 潜在空間でのタイルサイズ: 64 は約 512 px、128 は約 1024 px |
| `tile_stride` | 16 〜 128、デフォルト 64 | Material、Material Extract | 潜在空間でのタイルストライド |
| `prompt_expansion` | デフォルトはオフ | Material、Material Extract | LLM によるプロンプトの書き換え。プロンプトが薄い場合を除いてオフのままにしてください。展開はプロンプトを写真として再構成するため、metalness マップが潰れやすくなります |
| `seed` | 整数 | 3 つのノードすべて | 同じ seed を保てば同じ結果を再現でき、変更すると別のバリエーションになります |
| `auto_downscale` | デフォルトはオン | PBR Maps | 最長辺が 2048 px を超える入力を 2048 px に縮小します。オフにすると、サイズ超過の画像ではエラーになります |

出力は固定のスロット順に従います。Material と Material Extract は `texture`、`basecolor`、`normal`、`roughness`、`metalness`、`height`、`expanded_prompt` を返します。PBR Maps は独立したベーステクスチャなしで 5 つのマップを返します。オフにしたマップもスロットに 1×1 の黒いプレースホルダーを出力します。

## ヒント

* **シーンではなく表面を指定します。** 椅子の写真では、「chair webbing fabric」と指定すると織られたストラップだけが抽出され、フレーム、床、写り込んだパドルは無視されます。
* **パターンがずれるときは構造を追加します。** Extract では、「keep the weave and the strap edges」のようなフレーズを加えると、実行ごとにパターンが変わるのを防げます。
* **数百ピクセル以内で繰り返すマテリアルを選びます。** ウェビング、レンガ、舗装ブロック、板材、漆喰はタイル化しやすい素材です。岩の崖、空撮地形、単一のオブジェクトは、タイル化できない再描画として出力されます。
* **実行する前にマップをオフにします。** ゲームや製品のマテリアルには通常3つのマップで十分で、価格はマップの数に応じて変わります。該当する SaveImage ノードを切断するかバイパスしてください。そうしないとプレースホルダーがマップとして保存されます。
* **1枚の写真からフルセットを作るには、Extract を PBR Maps に接続します。** Extract がベースカラーのタイルを生成し、PBR Maps がそこから残りのマップを導出します。
* **マップを生成してから、金属部分のメタルネスを確認します。** 金属表面がフラットに出力される通常の原因は、プロンプト拡張です。

## はじめる

1. ComfyUIを最新バージョンにアップデートします
2. テンプレートライブラリを開き、`Patina` を検索します
3. 入力に合ったワークフローを選択します。表面の写真には Extract、プロンプトのみの場合は Text to Material、写真を再描画する場合は Image to Material、既存のベースカラーの場合は PBR Maps を使用します
4. 不要なマップをオフにしてから、ワークフローを実行します


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.