> ## 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 マテリアル - ComfyUI Built-in Node Documentation

> テキスト記述から、完全でシームレスにタイル可能な PBR マテリアルを生成します。

テキスト記述から、完全でシームレスにタイル可能な PBR マテリアルを生成します。ベーステクスチャと最大 5 枚のマテリアルマップを生成し、必要に応じてマップの SeedVR アップスケーリングも行います。入力画像を指定すると image-to-image パスとして結果を制御でき、入力画像とマスクを組み合わせると inpaint パスになります。実際のマテリアルをスキャンすることなく、ゲーム向けまたは 3D 向けのサーフェスを生成するために使用できます。

## 入力

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| - | - | - | - | - |
| `prompt` | 生成するマテリアルまたはテクスチャの説明。 | STRING | はい | 複数行テキスト |
| `image_size` | 出力テクスチャサイズ。`"custom"` を指定すると `width` と `height` 入力が表示されます。デフォルト: `"1:1 (1024x1024)"`。 | DYNAMIC\_COMBO | はい | `"1:1 (1024x1024)"` `"1:1 (512x512)"` `"4:3 (1024x768)"` `"3:4 (768x1024)"` `"16:9 (1024x576)"` `"9:16 (576x1024)"` `"custom"` |
| `basecolor` | basecolor（アルベド）マップを生成します。デフォルト: True。 | BOOLEAN | はい | true false |
| `normal` | normal マップを生成します。デフォルト: True。 | BOOLEAN | はい | true false |
| `roughness` | roughness マップを生成します。デフォルト: False。 | BOOLEAN | はい | true false |
| `metalness` | metalness マップを生成します。デフォルト: False。 | BOOLEAN | はい | true false |
| `height` | height（ディスプレイスメント）マップを生成します。デフォルト: False。 | BOOLEAN | はい | true false |
| `upscale_factor` | PBR マップをシームレスに SeedVR アップスケーリングします。ベーステクスチャはアップスケーリングされず、4x では 2048 ピクセルのマップが 8K になります。デフォルト: 0（オフ）。 | INT | はい | 0 から 4（ステップ 2） |
| `seed` | 再現可能な生成のためのシード。デフォルト: 42。 | INT | はい | 0 から 2147483646 |
| `tiling_mode` | タイリング方向：全方向、水平、または垂直。詳細設定。デフォルト: `"both"`。 | COMBO | はい | `"both"` `"horizontal"` `"vertical"` |
| `num_inference_steps` | テクスチャ生成のデノイジングステップ数。詳細設定。デフォルト: 8。 | INT | はい | 1 から 8 |
| `tile_size` | 潜在空間でのタイルサイズ。64 は 512 ピクセル、128 は 1024 ピクセルを意味します。詳細設定。デフォルト: 128。 | INT | はい | 32 から 256（ステップ 2） |
| `tile_stride` | 潜在空間でのタイルストライド。詳細設定。デフォルト: 64。 | INT | はい | 16 から 128（ステップ 2） |
| `image` | オプションのソース画像。単独では image-to-image を実行し、マスクと組み合わせると inpaint パスを実行します。 | IMAGE | いいえ | - |
| `mask` | オプションの inpaint マスク。入力画像が必要です。白い領域は再生成され、黒い領域は保持されます。 | MASK | いいえ | - |
| `strength` | 入力画像をどの程度変換するか。画像が接続されている場合にのみ使用されます。詳細設定。デフォルト: 0.6。 | FLOAT | はい | 0.01 から 1.0（ステップ 0.01） |
| `prompt_expansion` | 言語モデルでプロンプトを拡張し、テクスチャの詳細をより豊かにします。デフォルトではオフです。拡張によりプロンプトが写真として再構成され、metalness マップが薄くなる傾向があるためです。詳細設定。 | BOOLEAN | はい | true false |
| `safety_checker` | リクエストに対してプロバイダーのコンテンツ安全チェックを実行します。詳細設定。デフォルト: False。 | BOOLEAN | はい | true false |

### カスタム画像サイズ入力

これらの入力は、`image_size` が `"custom"` に設定されている場合に表示されます。

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| - | - | - | - | - |
| `image_size.width` | テクスチャの幅（ピクセル）。デフォルト: 1024。 | INT | はい | 512 から 2048（ステップ 16） |
| `image_size.height` | テクスチャの高さ（ピクセル）。デフォルト: 1024。 | INT | はい | 512 から 2048（ステップ 16） |

**制約と動作：**

* マテリアルマップを 1 つも有効にしないことも可能です。その場合、ノードはベーステクスチャのみを返し、すべてのマップ出力は 1x1 のプレースホルダーのままになります。
* マスクには入力画像が必要です。マスク単体ではエラーが発生します。
* 8K の結果は、単一の 8K 生成によるものではなく、2048 ピクセルのレンダリングのマップを 4x アップスケーリングすることで得られます。

## 出力

| 出力名 | 説明 | データ型 |
| - | - | - |
| `texture` | マテリアルのベーステクスチャです。マップは適用されていません。 | IMAGE |
| `basecolor` | basecolor（アルベド）マップ。このマップが無効な場合は 1x1 のプレースホルダーです。 | IMAGE |
| `normal` | normal マップ。このマップが無効な場合は 1x1 のプレースホルダーです。 | IMAGE |
| `roughness` | roughness マップ。このマップが無効な場合は 1x1 のプレースホルダーです。 | IMAGE |
| `metalness` | metalness マップ。このマップが無効な場合は 1x1 のプレースホルダーです。 | IMAGE |
| `height` | height（ディスプレイスメント）マップ。このマップが無効な場合は 1x1 のプレースホルダーです。 | IMAGE |
| `expanded_prompt` | プロバイダーが実際に使用したプロンプト。`prompt_expansion` が有効な場合にのみ入力と異なります。 | STRING |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/PatinaMaterialNode/ja.md)

***

**Source fingerprint (SHA-256):** `4e8305fa56a29dce72c54de12ae05207e8de39a1fea1f4753906c26e8af60383`


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