> ## 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` | テクスチャを抽出する元画像です。 | IMAGE | はい | - |
| `prompt` | 画像からどのテクスチャを抽出するかの説明です。例: `"the wall"`。 | 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` | ノーマルマップを生成します。デフォルト: True。 | BOOLEAN | はい | true false |
| `roughness` | ラフネスマップを生成します。デフォルト: False。 | BOOLEAN | はい | true false |
| `metalness` | メタルネスマップを生成します。デフォルト: False。 | BOOLEAN | はい | true false |
| `height` | ハイト（ディスプレイスメント）マップを生成します。デフォルト: False。 | BOOLEAN | はい | true false |
| `upscale_factor` | PBRマップのシームレスなSeedVRアップスケーリングです。ベーステクスチャはアップスケーリングされません。4xでは2048ピクセルのマップが8Kになります。デフォルト: 0（オフ）。 | INT | はい | 0～4（ステップ 2） |
| `seed` | 再現可能な生成のためのシードです。デフォルト: 42。 | INT | はい | 0～2147483646 |
| `strength` | 入力画像をどの程度変換するかです。詳細設定です。デフォルト: 0.6。 | FLOAT | はい | 0.01～1.0（ステップ 0.01） |
| `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） |
| `prompt_expansion` | より豊かなテクスチャ詳細のために、言語モデルでプロンプトを拡張します。デフォルトではオフです。拡張はプロンプトを写真として再構成するため、メタルネスマップが薄れる傾向があるからです。詳細設定です。 | 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の結果は、2048ピクセルのレンダーのマップを4xにアップスケーリングしたものであり、単一の8K生成によるものではありません。

## 出力

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

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

***

**Source fingerprint (SHA-256):** `484b8eaa57388541e352cd88c8998c63aa0b2a99d98cd8e602252625064f16ba`


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