> ## 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에서 타일링 PBR 머티리얼과 맵

> Patina 노드로 사진이나 프롬프트를 ComfyUI에서 이음새 없이 타일링되는 PBR 머티리얼로 변환하고, basecolor, 노멀, roughness, metalness, 높이 맵까지 얻으세요.

Patina는 3D 에셋에 필요한 표면 데이터를 생성합니다. 한 번 실행하면 기본 텍스처와 함께 PBR 재질이 기대하는 베이스컬러, 노멀(normal), 러프니스, 메탈니스, 높이 맵이 반환되며, 전체 세트가 동일한 잠재 데이터에서 나오므로 별도의 베이크 없이도 맵이 픽셀 하나하나 정확히 일치합니다.

ComfyUI에서 이 공급자는 세 개의 파트너 노드를 통해 동작합니다. **Patina Material**은 텍스트 프롬프트로, 사진으로, 또는 사진과 마스크를 조합해 재질을 만듭니다. **Patina Material Extract**는 원하는 표면이 이미 담긴 사진에서 타일링 재질을 뽑아냅니다. **Patina PBR Material Maps**는 아무것도 다시 생성하지 않고 이미지 하나를 맵 세트로 변환합니다.

세 노드 모두 클라우드 API 노드입니다. 크레딧이 있는 Comfy 계정이 필요하고, 모델 파일을 다운로드하지 않으며, 실행마다 과금됩니다. 각 노드의 가격 배지에 현재 요금이 표시되며, 활성화하는 맵마다 가격이 더해집니다.

> [!TIP]
>
> 파트너 노드를 사용하려면 올바르게 로그인되어 있고 허가된 네트워크 환경을 사용하고 있는지 확인해야 합니다. 파트너 노드를 사용하기 위한 구체적인 요구사항은 문서의 [파트너 노드 개요](https://docs.comfy.org/ko/tutorials/partner-nodes/overview.md) 섹션을 참조해 주세요.

> [!TIP]
>
> > [tab] 로컬 사용자
> >
> > ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.
> >
> > * [ComfyUI 다운로드](https://www.comfy.org/download)
> > * [업데이트 가이드](https://docs.comfy.org/ko/installation/update_comfyui.md)
> >
> > 이 가이드의 워크플로는 [워크플로 템플릿](https://docs.comfy.org/ko/interface/features/template.md)에서 확인할 수 있습니다.
> > 템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.
> >
> > 워크플로를 로드할 때 노드가 누락되는 경우, 가능한 원인:
> >
> > 1. 최신 ComfyUI 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
> > 2. 일부 노드가 시작 시 가져오기에 실패함
>
> > [tab] 클라우드 사용자
> >
> > * [클라우드](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 Material Maps 워크플로 미리보기](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` | 세 노드 모두 | 어떤 맵을 반환할지 선택합니다. 노드는 basecolor와 normal이 켜져 있고 나머지 세 개는 꺼져 있으며, 네 가지 템플릿은 다섯 개를 모두 켭니다. 활성화된 맵마다 실행 가격이 올라갑니다 |
| `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 | 결과가 소스 사진에서 얼마나 멀어질 수 있는지 나타냅니다. text to material에서는 무시됩니다 |
| `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` | 정수 | 세 노드 모두 | 같은 seed를 유지하면 같은 결과를 재현하고, 바꾸면 다른 변형을 얻습니다 |
| `auto_downscale` | 기본적으로 켜짐 | PBR Maps | 가장 긴 변이 2048 px를 넘는 입력을 2048 px로 다시 축소합니다. 끄면 크기가 큰 이미지에서 오류가 발생합니다 |

출력은 고정된 슬롯 순서를 따릅니다. Material과 Material Extract는 `texture`, `basecolor`, `normal`, `roughness`, `metalness`, `height`, `expanded_prompt`를 반환합니다. PBR Maps는 별도의 기본 텍스처 없이 다섯 개의 맵을 반환합니다. 꺼 둔 맵도 해당 슬롯에 1×1 검은색 자리표시자를 출력합니다.

## 팁

* **장면이 아니라 표면을 지칭하세요.** 의자 사진에서 "chair webbing fabric"이라고 지정하면 직조된 스트랩만 추출하고 프레임, 바닥, 화면에 함께 담긴 패들은 무시합니다.
* **패턴이 흐트러질 때는 구조를 추가하세요.** Extract에서 "keep the weave and the strap edges" 같은 문구를 넣으면 실행할 때마다 패턴이 달라지는 것을 막아 줍니다.
* **몇백 픽셀 안에서 반복되는 재질을 고르세요.** 웨빙, 벽돌, 보도블록, 판재, 회반죽은 타일링이 잘 됩니다. 암벽, 항공 지형, 단일 오브젝트는 타일링되지 않는 재페인팅 결과로 돌아옵니다.
* **실행하기 전에 맵을 꺼 두세요.** 게임이나 제품용 재질에는 보통 세 개의 맵이면 충분하며, 가격은 맵 개수에 따라 달라집니다. 해당 SaveImage 노드를 끊거나 바이패스하지 않으면 자리표시자가 맵으로 저장됩니다.
* **한 장의 사진에서 전체 세트를 얻으려면 Extract를 PBR Maps로 연결하세요.** Extract가 basecolor 타일을 만들고, PBR Maps가 그로부터 남은 맵을 파생합니다.
* **맵을 생성한 다음, 금속에서는 metalness를 확인하세요.** 금속 표면이 밋밋하게 나오는 흔한 이유는 프롬프트 확장입니다.

## 시작하기

1. ComfyUI를 최신 버전으로 업데이트하세요
2. Template Library로 이동해 `Patina`를 검색하세요
3. 입력에 맞는 워크플로를 선택하세요. 표면 사진에는 Extract, 프롬프트만 있는 경우에는 Text to Material, 사진을 다시 그리려면 Image to Material, 기존 basecolor에는 PBR Maps를 사용합니다
4. 필요 없는 맵은 끄고 워크플로를 실행하세요


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