> ## 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. # SAM3DBody_Render - ComfyUI Built-in Node Documentation > 선택 가능한 스타일을 사용하여 3D 신체 포즈 데이터를 이미지로 렌더링합니다. 이 노드는 SAM3D 바디 트래커(MHR) 또는 Kimodo와 같은 외부 Y-up 릭(rig)의 포즈 데이터를 입력으로 받아들이며, 선택적 배경 이미지(제공되지 않은 경우 검은색 캔버스) 위에 결과를 합성할 수 있습니다. 사용 가능한 렌더 스타 선택 가능한 스타일을 사용하여 3D 신체 포즈 데이터를 이미지로 렌더링합니다. 이 노드는 SAM3D 바디 트래커(MHR) 또는 Kimodo와 같은 외부 Y-up 릭(rig)의 포즈 데이터를 입력으로 받아들이며, 선택적 배경 이미지(제공되지 않은 경우 검은색 캔버스) 위에 결과를 합성할 수 있습니다. 사용 가능한 렌더 스타일에는 음영 처리된 3D 메시, 이진 실루엣, 2D 및 3D OpenPose 스타일 스켈레톤, SCAIL 스타일 바디 캡슐이 포함됩니다. ## 입력 ### 공통 입력 | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | --- | ----------------------------------------------------------------------------- | | `render_style` | 렌더 모드입니다. 'mesh' = 카메라를 통해 래스터화된 3D MHR 메시. 'silhouette' = 메시의 이진 마스크. 'openpose\_2d' = 평면 2D 스켈레톤. 'openpose\_3d' = 플랫 셰이딩된 3D 모델로 표시된 OpenPose 스켈레톤. 'scail' = SCAIL 3D 캡슐. (기본값: "mesh") | DYNAMIC\_COMBO | 예 | "mesh"
"silhouette"
"openpose\_2d"
"openpose\_3d"
"scail" | | `pose_data` | MHR 포즈 데이터 또는 외부 Y-up 릭(rig) 포즈 데이터(KimodoSample)입니다. 모든 렌더 스타일은 `_skeleton_override`에 OpenPose 관절 맵을 포함하는 외부 릭에서 작동합니다(KimodoSample이 해당됨). | MHR\_POSE\_DATA 또는 KIMODO\_POSE\_DATA | 예 | — | | `배경` | 프레임별 배경입니다. 생략하면 검은색 캔버스가 사용됩니다. | IMAGE | 아니요 | — | | `너비` | 출력 너비(픽셀)입니다. 0 = 포즈 데이터의 기본 image\_size를 사용합니다. width/height 중 하나만 설정된 경우 원본 종횡비를 유지하면서 나머지가 파생됩니다. (기본값: 0) | INT | 아니요 | 0 \~ 16384, step 8 | | `높이` | 출력 높이(픽셀)입니다. 0 = 포즈 데이터의 기본 image\_size를 사용합니다. width/height 중 하나만 설정된 경우 원본 종횡비를 유지하면서 나머지가 파생됩니다. (기본값: 0) | INT | 아니요 | 0 \~ 16384, step 8 | | `camera_info` | 자유 6DOF 카메라 오버라이드입니다. 연결되면 포즈는 예측된 카메라 대신 이 카메라(위치/대상/줌/회전/FoV)를 통해 재투영됩니다. | LOAD\_3D\_CAMERA | 아니요 | — | ### 메시 입력 이 매개변수들은 `render_style`이 "mesh"일 때 표시됩니다. | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | --- | ---------------------------------------------------------------------------------------------------------------- | | `shader` | 사전 설정된 셰이더입니다. 'normals' = 카메라 공간의 현재 표면 법선(OpenGL Y+ 노말맵 규약: +X→R, +Y→G, +Z→B). 'rainbow' = RealisDance 스타일 body-Y 제트. 'rainbow\_face\_\*' 변형은 법선/영역별 색상으로 얼굴 정점을 덮어씁니다. 'depth' = 선형 회색. (기본값: "default") | DYNAMIC\_COMBO | 아니요 | "default"
"normals"
"rainbow"
"rainbow\_face\_normal"
"rainbow\_face\_semantic"
"depth" | | `rainbow_tilt_z` | 무지개 제트 축을 Z축(전방) 기준으로 회전합니다. 좌/우를 구분합니다. `shader`가 "rainbow", "rainbow\_face\_normal" 또는 "rainbow\_face\_semantic"인 경우에만 사용할 수 있습니다. (기본값: -35.0) | FLOAT | 아니요 | -90.0 \~ 90.0, step 0.5 | | `rainbow_tilt_x` | 무지개 제트 축을 X축(오른쪽) 기준으로 회전합니다. 앞/뒤를 구분합니다. `shader`가 "rainbow", "rainbow\_face\_normal" 또는 "rainbow\_face\_semantic"인 경우에만 사용할 수 있습니다. (기본값: 0.0) | FLOAT | 아니요 | -90.0 \~ 90.0, step 0.5 | | `opacity` | 배경 이미지 위에 적용되는 메시 알파입니다. 배경이 연결되지 않은 경우 검은색 위에 적용됩니다. (기본값: 1.0) | FLOAT | 아니요 | 0.0 \~ 1.0, step 0.01 | | `person_palette_falloff` | 사람별 흰색 방향 채도 저하(desaturation)입니다. 트랙 k는 (1 - falloff^k) 파스텔 혼합이 적용됩니다(SCAIL '더 부드러운 두 번째 사람'). 1.0 = 비활성화. (기본값: 0.6) | FLOAT | 아니요 | 0.1 \~ 1.0, step 0.05 | | `region` | 'hands\_only'는 사전 계산된 `hand_vert_mask`(표준 손 키포인트에 대한 LBS 가중치)를 통해 면을 필터링하여 디버깅용 손 메시를 분리합니다. 마스크가 없으면 전체 메시로 폴백됩니다. (기본값: "full\_body") | COMBO | 아니요 | "full\_body"
"hands\_only" | ### 실루엣 입력 `render_style`이 "silhouette"일 때 노드는 3D 메시의 이진 마스크를 렌더링합니다. 이 모드에는 추가 매개변수가 없습니다. ### OpenPose 2D 입력 이 매개변수들은 `render_style`이 "openpose\_2d"일 때 표시됩니다. | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------ | --- | ----------------------------------------- | | `marker_radius_px` | 신체 키포인트 점 반경(px)입니다. (기본값: 4) | INT | 아니요 | 1 \~ 32, step 1 | | `stick_width_px` | 신체 연결선(limb) 타원의 절반 너비(px)입니다. DWPose 기본값 = 4. (기본값: 4) | INT | 아니요 | 1 \~ 32, step 1 | | `limb_alpha` | 연결선별 알파입니다. DWPose 기본값 = 0.6. (기본값: 0.6) | FLOAT | 아니요 | 0.0 \~ 1.0, step 0.05 | | `face_style` | 'full' = 모든 얼굴 랜드마크(있으면 sapiens-238, 없으면 릭 폴백 약 30개). 'eyes\_mouth' = 릭 폴백 하위 집합(약 12개 점: 눈과 바깥쪽 입술만). 'disabled' = 얼굴 점 없음. (기본값: "disabled") | COMBO | 아니요 | "disabled"
"full"
"eyes\_mouth" | | `hand_style` | 21+21 손 키포인트와 연결선을 그립니다. 'disabled' = 손 없음. 'dwpose' = 단색 파란색 점. 'openpose' = 무지개색 점. (기본값: "disabled") | COMBO | 아니요 | "disabled"
"dwpose"
"openpose" | | `person_palette_falloff` | 사람별 채도 저하(desaturation)입니다. 트랙 k는 1 - falloff^k만큼 흰색 방향으로 혼합됩니다. 트랙 0은 선명하게 유지되며, 1.0은 폴오프를 비활성화합니다. (기본값: 0.6) | FLOAT | 아니요 | 0.1 \~ 1.0, step 0.05 | ### OpenPose 3D 입력 이 매개변수들은 `render_style`이 "openpose\_3d"일 때 표시됩니다. | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | ------------------------ | --------------------------------------------------------------------------------------------------------------- | ------- | --- | ------------------------ | | `radius_m` | 연결선 캡슐 반경(미터)입니다. (얇을수록 막대기 형태에 가깝습니다) (기본값: 0.015) | FLOAT | 아니요 | 0.004 \~ 0.1, step 0.001 | | `include_hands` | 21+21 손 키포인트를 3D 캡슐로 그립니다. (기본값: True) | BOOLEAN | 아니요 | True or False | | `person_palette_falloff` | 사람별 채도 저하(desaturation)입니다. 트랙 k는 1 - falloff^k만큼 흰색 방향으로 혼합됩니다. 트랙 0은 선명하게 유지되며, 1.0은 폴오프를 비활성화합니다. (기본값: 0.6) | FLOAT | 아니요 | 0.1 \~ 1.0, step 0.05 | ### SCAIL 입력 이 매개변수들은 `render_style`이 "scail"일 때 표시됩니다. | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | --- | ----------------------------------------- | | `radius_m` | 캡슐 반경(미터)입니다. (SCAIL 참고값: \~0.022m) (기본값: 0.022) | FLOAT | 아니요 | 0.005 \~ 0.2, step 0.001 | | `hand_style` | 3D 캡슐 바디 위에 2D OpenPose 손을 합성합니다(SCAIL과 일치 — 3D 손 캡슐 없음). 'disabled' = 손 없음. 'dwpose' = 단색 파란색 손 점. 'openpose' = 무지개색 점. 연결선은 어느 경우든 손가락별로 무지개색을 유지합니다. (기본값: "dwpose") | COMBO | 아니요 | "disabled"
"dwpose"
"openpose" | | `face_style` | 'full' = 모든 얼굴 랜드마크(있으면 sapiens-238, 없으면 릭 폴백 약 30개). 'eyes\_mouth' = 릭 폴백 하위 집합(약 12개 점: 눈과 바깥쪽 입술만). 'disabled' = 얼굴 점 없음. (기본값: "disabled") | COMBO | 아니요 | "disabled"
"full"
"eyes\_mouth" | | `person_palette_falloff` | 사람별 채도 저하(desaturation)입니다. 트랙 k는 1 - falloff^k만큼 흰색 방향으로 혼합됩니다. 트랙 0은 선명하게 유지되며, 1.0은 폴오프를 비활성화합니다. (기본값: 0.6) | FLOAT | 아니요 | 0.1 \~ 1.0, step 0.05 | ### 참고 사항 * `width`와 `height`가 모두 0이면 출력은 포즈 데이터의 기본 이미지 크기를 사용합니다. 둘 중 하나만 설정된 경우 원본 종횡비를 유지하면서 나머지가 파생됩니다. 연결된 `background`는 렌더 해상도에 맞게 크기가 조정됩니다. * `camera_info`가 연결되면 포즈는 예측된 카메라 대신 해당 카메라를 통해 재투영됩니다. * 메시 모드에서 `rainbow_tilt_z` 및 `rainbow_tilt_x`는 `shader`가 "rainbow", "rainbow\_face\_normal" 또는 "rainbow\_face\_semantic"으로 설정된 경우에만 사용할 수 있습니다. * 메시 모드에서 `region`이 "hands\_only"인 경우 손 영역 필터는 포즈 데이터에 손 정점 마스크가 포함되어 있어야 합니다. 마스크가 없으면 전체 메시가 대신 렌더링됩니다. * scail 모드에서는 손이 항상 2D 오버레이로 그려지며 3D 손 캡슐은 없습니다. * 출력 해상도가 포즈 데이터의 기본 해상도와 다른 경우 openpose\_2d 마커와 연결선 크기가 비례적으로 조정됩니다. * 배경의 프레임 수가 포즈 데이터보다 적으면 나머지 프레임에 대해 마지막 배경 프레임이 재사용됩니다. * 출력에는 입력 포즈 프레임당 하나의 프레임이 포함됩니다. 포즈 데이터에 프레임이 없으면 단일 검은색 이미지가 반환됩니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | | ----- | -------------------------------------------------------------------------------------------------------------------- | ------ | | `이미지` | 렌더링된 프레임입니다. 선택한 렌더 스타일로 그려진 포즈 데이터가 배경이 연결된 경우 배경 위에, 그렇지 않은 경우 검은색 위에 합성됩니다. 입력 포즈 프레임당 하나의 프레임이 단일 배치 이미지로 반환됩니다. | IMAGE | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SAM3DBody_Render/ko.md) *** **Source fingerprint (SHA-256):** `96556283cf07727e6b4bb3549537bf925ed771bab8607f65c93ab54a5f0e9ba5`