Camera Pose Visualizer (CameraPoseVisualizer) - ComfyUI-KJNodes

Camera Pose Visualizer 노드는 두 가지 주요 데이터 소스를 지원합니다: AnimateDiff-Evolved의 CameraCtrl 포즈 데이터와 RealEstate 카메라 내부 파라미터 및 좌표가 포함된 .txt 파일입니다.

Camera Pose Visualizer는 카메라 포즈를 시각화하는 노드입니다. 추상적인 카메라 위치와 방향 데이터를 직관적인 3D 그래픽으로 변환하여 사용자가 3D 공간에서 카메라의 운동 궤적과 시점 변화를 이해하는 데 도움을 줍니다.

노드 기능

이 노드는 두 가지 주요 데이터 소스를 지원합니다: AnimateDiff-Evolved의 CameraCtrl 포즈 데이터와 RealEstate 카메라 내부 파라미터 및 좌표가 포함된 .txt 파일입니다. 핵심 메커니즘은 이 데이터를 읽어 3D 좌표계에서 각 카메라 위치와 방향을 나타내는 원뿔 또는 좌표계를 그리고, 최종적으로 Matplotlib로 생성된 3D 그래프를 ComfyUI에서 사용 가능한 이미지 텐서로 렌더링합니다.

노드 파라미터 설명 - Camera Pose Visualizer

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`pose_file_path`	STRING	예	""	-	카메라 포즈 데이터가 포함된 .txt 파일 경로를 지정합니다. 비워두면 CameraCtrl 포즈 입력을 사용합니다.
`base_xval`	FLOAT	예	0.2	0 - 100 (스텝: 0.01)	X축 방향의 카메라 원뿔 기본 크기를 조정합니다. 범위 0-100, 스텝 0.01.
`zval`	FLOAT	예	0.3	0 - 100 (스텝: 0.01)	Z축 방향(깊이)의 카메라 원뿔 표시 비율을 조정합니다. 범위 0-100, 스텝 0.01.
`scale`	FLOAT	예	1.0	0.01 - 10.0 (스텝: 0.01)	전체 3D 시각화 장면의 확대/축소 비율을 제어합니다. 범위 0.01-10.0, 스텝 0.01.
`use_exact_fx`	BOOLEAN	예	False	-	정확한 카메라 초점 거리 값을 사용하여 원뿔 시점을 조정할지 여부를 결정하는 논리값 스위치입니다.
`relative_c2w`	BOOLEAN	예	True	-	카메라 포즈를 월드 좌표계에 대한 상대적 변환으로 해석할지 여부를 제어하는 논리값 스위치입니다.
`use_viewer`	BOOLEAN	예	False	-	활성화하면 Matplotlib 대화형 창을 열어 차트를 표시하려고 시도하는 논리값 스위치입니다.
`cameractrl_poses`	CAMERACTRL_POSES	아니오	None	-	-

Output

파라미터 이름	데이터 타입	설명
IMAGE	IMAGE	3D 카메라 포즈 시각화 그래프가 포함된 이미지 텐서를 출력합니다.

사용 사례

AnimateDiff 기반 애니메이션을 제작할 때, 이 노드를 워크플로에 연결하여 CameraCtrl 모듈이 생성한 카메라 운동 경로가 부드럽고 예상대로인지 미리 볼 수 있습니다. 또는 RealEstate10K와 같은 실제 카메라 궤적이 포함된 데이터셋을 처리할 때, 가져온 카메라 포즈 파일이 정확한지 빠르게 확인하는 데 사용할 수 있습니다.

주의사항

이 노드는 주로 시각화 미리보기용이며, 생성된 이미지의 해상도는 고정되어 있어 최종 렌더링 출력에는 적합하지 않습니다. use_viewer 파라미터가 활성화된 경우, 일부 실행 환경에서 독립적인 Matplotlib 창이 열릴 수 있습니다.

Camera Pose Visualizer 노드 소스 코드 링크

Camera Pose Visualizer 노드는 ComfyUI-KJNodes 노드 패키지에서 제공됩니다.

Camera Pose Visualizer(CameraPoseVisualizer)