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

# BakeTextureFromVoxel - ComfyUI Built-in Node Documentation

> 이 노드는 메시의 기존 UV 레이아웃을 사용하여 3D 메시에 PBR 텍스처를 베이킹합니다.

이 노드는 메시의 기존 UV 레이아웃을 사용하여 3D 메시에 PBR 텍스처를 베이킹합니다. UV 공간에서 메시를 래스터화하고 각 텍셀에서 희소 복셀 볼륨의 색상 및 재질 속성을 샘플링하여 베이스 컬러 이미지와 메탈릭 및 러프니스 맵을 출력합니다. 메시의 UV를 언랩하지 않으므로 UV 언랩 노드를 업스트림에 연결해야 합니다. 결과 이미지는 GLB로 저장하기 위해 ApplyTextureToMesh에서 동일한 메시와 함께 사용하도록 되어 있습니다.

## 입력

| 매개변수             | 설명                                                                               | 데이터 타입 | 필수  | 범위           |
| ---------------- | -------------------------------------------------------------------------------- | ------ | --- | ------------ |
| `mesh`           | 텍스처를 베이킹할 3D 메시입니다. 이미 UV 레이아웃이 있어야 하며, UV 언랩 노드가 업스트림에 연결되어 있어야 합니다.            | MESH   | 예   |              |
| `voxel_colors`   | 복셀별 색상과 선택적 PBR 속성(메탈릭 및 러프니스 채널)을 포함하는 희소 복셀 볼륨입니다.                             | VOXEL  | 예   |              |
| `texture_size`   | 정사각형 UV 아틀라스 해상도입니다(표시 이름: "resolution", 기본값: 2048).                             | INT    | 예   | 64  \~  8192 |
| `reference_mesh` | 선택적 고밀도 데시메이션 전 메시입니다. 샘플링 전에 각 텍셀을 실제 표면에 역투영하여 거친 메시에서 패싯 형태로 베이킹되는 현상을 제거합니다. | MESH   | 아니요 |              |

참고:

* 입력 메시에는 UV가 있어야 합니다. UV가 없으면 노드에서 오류를 발생시킵니다. UV는 정점과 1:1이어야 합니다(정점당 하나의 UV).
* 메시와 복셀 좌표에 배치 차원이 포함된 경우 각 배치 항목이 개별적으로 베이킹됩니다. 배치 항목에 복셀이 없거나 면이 없으면 건너뛰고 해당 항목에 대해 검은색 텍스처를 출력합니다.
* 배치에 대해 `reference_mesh`가 제공되면 배치 인덱스로 매칭됩니다. 단, 메시가 하나만 포함된 경우에는 해당 메시가 모든 항목에 사용됩니다.
* 어떤 UV 삼각형에도 덮이지 않은 텍셀은 가장 가까운 덮인 텍셀에서 채워지므로 텍스처 이음새에 검은색이 끌어들여지지 않습니다.

## 출력

| 출력 이름        | 설명                                                        | 데이터 타입 |
| ------------ | --------------------------------------------------------- | ------ |
| `base_color` | RGB 베이스 컬러 텍스처 맵입니다. 값은 0–1 범위의 float입니다.                 | IMAGE  |
| `metallic`   | 그레이스케일 메탈릭 맵입니다(float, 0–1). 복셀 색상에 메탈릭 채널이 없으면 검은색입니다.   | IMAGE  |
| `roughness`  | 그레이스케일 러프니스 맵입니다(float, 0–1). 복셀 색상에 러프니스 채널이 없으면 검은색입니다. | IMAGE  |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/BakeTextureFromVoxel/ko.md)

***

**Source fingerprint (SHA-256):** `080dcb670620f1cb97523d04fc45293e03d139e513845d0fa7b1c4d2f8bdf32d`