SAM3DBody_Render - ComfyUI Built-in Node Documentation

선택 가능한 스타일을 사용하여 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에서 편집

Source fingerprint (SHA-256): 96556283cf07727e6b4bb3549537bf925ed771bab8607f65c93ab54a5f0e9ba5

​입력

​공통 입력

​메시 입력

​실루엣 입력

​OpenPose 2D 입력

​OpenPose 3D 입력

​SCAIL 입력

​참고 사항

​출력

입력