> ## 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.

# VaeDecodeTextureTrellis - ComfyUI Built-in Node Documentation

> 이 노드는 Trellis2 텍스처 잠상을 VAE를 사용하여 복셀 색상으로 디코딩합니다. 입력 잠상에는 좌표가 포함된 희소 피처 샘플이 들어 있으며, 노드는 각 복셀의 색상을 재구성하고 그 결과를 복셀 그리드로 반환합니다.

이 노드는 Trellis2 텍스처 잠상을 VAE를 사용하여 복셀 색상으로 디코딩합니다. 입력 잠상에는 좌표가 포함된 희소 피처 샘플이 들어 있으며, 노드는 각 복셀의 색상을 재구성하고 그 결과를 복셀 그리드로 반환합니다. PaintMesh와 같은 다운스트림 노드는 이 그리드를 사용하여 3D 메시에 색상을 입힐 수 있습니다.

## 입력

| 매개변수     | 설명                                                                                  | 데이터 타입            | 필수 | 범위 |
| -------- | ----------------------------------------------------------------------------------- | ----------------- | -- | -- |
| `샘플`     | 디코딩할 텍스처 잠상입니다. 샘플 피처와 희소 좌표를 포함하며, 좌표 개수, 모델 프레임, 좌표 해상도 등의 선택적 메타데이터를 포함할 수 있습니다. | LATENT            | 예  | —  |
| `vae`    | 텍스처 잠상을 복셀 색상으로 디코딩하는 데 사용되는 Trellis2 VAE입니다.                                       | VAE               | 예  | —  |
| `형상 세분화` | 디코딩 중 더 높은 세부 수준의 재구성을 안내하는 데 사용되는 형상 정보입니다. 더 높은 해상도에서 구조 일관성을 유지하는 데 도움이 됩니다.     | SHAPE\_SUBDIVIDES | 예  | —  |

참고: `samples` 잠상에 좌표 개수가 포함된 경우, 개수는 음수가 아니어야 하고 총합은 좌표 행 수와 일치해야 하며 각 배치에는 정확히 예상된 행 수가 있어야 합니다. 그렇지 않으면 노드가 오류를 발생시킵니다. 잠상의 모델 프레임이 "z\_up"이면 디코딩된 복셀 좌표는 메시 정점과 정렬되도록 Y-up으로 다시 매핑됩니다. 좌표 해상도가 제공되면 출력 텍스처 해상도는 해당 값에 16을 곱한 값입니다. 그렇지 않으면 가장 큰 복셀 좌표에서 추론되어 256, 512, 1024, 1536 또는 2048 중 하나로 올림됩니다(사용 가능한 좌표가 없으면 1024).

## 출력

| 출력 이름   | 설명                                                                                                                                                  | 데이터 타입 |
| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| `복셀 색상` | 디코딩된 복셀 데이터로, 좌표, 색상 피처, 텍스처 해상도를 포함합니다. 각 복셀에는 기본 색상(RGB), 금속성, 거칠기, 알파의 6개 색상 채널이 있으며 모두 \[0, 1] 범위입니다. PaintMesh와 같은 정점 색상 소비자는 처음 3개 채널을 사용합니다. | VOXEL  |

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

***

**Source fingerprint (SHA-256):** `cfbe59efb18d2c3c7c597c5212900fea54d660aa98005817debf4711401a6967`