> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-b886298.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SavePointCloud - ComfyUI Built-in Node Documentation

> Save Point Cloud 노드는 3D 포인트 클라우드 파일을 출력 디렉토리에 저장하고, 선택적으로 3D 뷰어용 미리보기 데이터를 제공합니다. 파일 이름 지정 및 저장을 처리하면서, 표시 목적으로 카메라 및 모델 정보를 전달합니다.

Save Point Cloud 노드는 3D 포인트 클라우드 파일을 출력 디렉토리에 저장하고, 선택적으로 3D 뷰어용 미리보기 데이터를 제공합니다. 파일 이름 지정 및 저장을 처리하면서, 표시 목적으로 카메라 및 모델 정보를 전달합니다.

## 입력

| 매개변수                                                                                                                                                                                                                                           | 설명                                | 데이터 타입                                   | 필수  | 범위        |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | ---------------------------------------- | --- | --------- |
| `model_3d`                                                                                                                                                                                                                                     | 포인트 클라우드 파일(.ply)                 | FILE3D\_POINT\_CLOUD\_ANY 또는 FILE3D\_PLY | 예   | -         |
| `filename_prefix`                                                                                                                                                                                                                              | 저장된 파일 이름의 접두사(기본값: "3d/ComfyUI") | STRING                                   | 예   | -         |
| `viewport_state`                                                                                                                                                                                                                               | 카메라 및 모델 정보를 포함한 현재 뷰포트 상태        | LOAD3D                                   | 예   | -         |
| `model_3d_info`                                                                                                                                                                                                                                | 3D 뷰어용 추가 모델 정보                   | LOAD3D\_MODEL\_INFO                      | 아니요 | -         |
| `camera_info`                                                                                                                                                                                                                                  | 3D 뷰어용 카메라 정보                     | LOAD3D\_CAMERA                           | 아니요 | -         |
| `width`                                                                                                                                                                                                                                        | 미리보기 표시의 너비(픽셀 단위, 기본값: 1024)     | INT                                      | 예   | 1 \~ 4096 |
| `height`                                                                                                                                                                                                                                       | 미리보기 표시의 높이(픽셀 단위, 기본값: 1024)     | INT                                      | 예   | 1 \~ 4096 |
| 저장된 파일은 `filename_prefix`에 5자리 카운터를 추가하여 출력 디렉토리에 기록됩니다(예: `3d/ComfyUI_00001.ply`). 선택적 `camera_info` 입력이 연결되지 않은 경우 카메라 정보는 `viewport_state`에서 가져옵니다. 마찬가지로 `model_3d_info`가 연결되지 않은 경우 모델 정보는 `viewport_state`에서 가져옵니다(사용 가능한 정보가 없으면 빈 목록). |                                   |                                          |     |           |

## 출력

| 출력 이름           | 설명              | 데이터 타입                    |
| --------------- | --------------- | ------------------------- |
| `model_3d`      | 저장된 포인트 클라우드 파일 | FILE3D\_POINT\_CLOUD\_ANY |
| `model_3d_info` | 3D 뷰어용 모델 정보    | LOAD3D\_MODEL\_INFO       |
| `camera_info`   | 3D 뷰어용 카메라 정보   | LOAD3D\_CAMERA            |
| `width`         | 미리보기 표시의 너비     | INT                       |
| `height`        | 미리보기 표시의 높이     | INT                       |

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

***

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