Camera Pose Visualizer (CameraPoseVisualizer) - ComfyUI-KJNodes

El nodo Camera Pose Visualizer admite dos fuentes principales de datos: datos de poses CameraCtrl de AnimateDiff-Evolved, y archivos .txt que contienen parámetros intrínsecos y coordenadas de cámara de RealEstate.

Camera Pose Visualizer es un nodo para visualizar la pose de la cámara. Convierte datos abstractos de posición y orientación de la cámara en gráficos 3D intuitivos, ayudando a los usuarios a comprender la trayectoria del movimiento de la cámara y los cambios de perspectiva en el espacio tridimensional.

Funcionalidad del Nodo

Este nodo admite dos fuentes de datos principales: datos de poses CameraCtrl de AnimateDiff-Evolved, y archivos .txt que contienen parámetros intrínsecos y coordenadas de cámara de RealEstate. Su mecanismo central consiste en leer estos datos, dibujar conos o sistemas de coordenadas que representan la posición y orientación de cada cámara en un sistema de coordenadas tridimensional, y finalmente renderizar el gráfico 3D generado por Matplotlib como un tensor de imagen utilizable en ComfyUI.

Explicación de los Parámetros del Nodo - Camera Pose Visualizer

Parámetros de Control (Parameters)

Nombre del Parámetro	Tipo de Dato	Requerido	Valor por Defecto	Rango/Opciones	Descripción
`pose_file_path`	STRING	Sí	""	-	Especifica la ruta del archivo .txt que contiene los datos de pose de la cámara. Déjelo vacío para usar la entrada de poses CameraCtrl.
`base_xval`	FLOAT	Sí	0.2	0 - 100 (incremento: 0.01)	Ajusta el tamaño base del cono de la cámara a lo largo del eje X. Rango 0-100, incremento 0.01.
`zval`	FLOAT	Sí	0.3	0 - 100 (incremento: 0.01)	Ajusta la escala de visualización del cono de la cámara a lo largo del eje Z (profundidad). Rango 0-100, incremento 0.01.
`scale`	FLOAT	Sí	1.0	0.01 - 10.0 (incremento: 0.01)	Controla el factor de escalado de toda la escena de visualización 3D. Rango 0.01-10.0, incremento 0.01.
`use_exact_fx`	BOOLEAN	Sí	False	-	Interruptor booleano que determina si se utiliza el valor exacto de la distancia focal de la cámara para ajustar el campo de visión del cono.
`relative_c2w`	BOOLEAN	Sí	True	-	Interruptor booleano que controla si las poses de la cámara se interpretan como transformaciones relativas al sistema de coordenadas mundial.
`use_viewer`	BOOLEAN	Sí	False	-	Interruptor booleano. Cuando está habilitado, intenta abrir una ventana interactiva de Matplotlib para mostrar el gráfico.
`cameractrl_poses`	CAMERACTRL_POSES	No	None	-	-

Salida

Nombre del Parámetro	Tipo de Dato	Descripción
IMAGE	IMAGE	Produce un tensor de imagen que contiene la visualización 3D de la pose de la cámara.

Casos de Uso

Al crear animaciones basadas en AnimateDiff, puedes conectar este nodo a tu flujo de trabajo para previsualizar si la trayectoria del movimiento de la cámara generada por el módulo CameraCtrl es suave y cumple con las expectativas. O bien, al procesar conjuntos de datos que contienen trayectorias de cámara reales (como RealEstate10K), utilizarlo para verificar rápidamente si los archivos de poses de cámara importados son correctos.

Consideraciones

Ten en cuenta que este nodo está diseñado principalmente para previsualización visual. La resolución de la imagen que genera es fija y no es adecuada para la salida de renderizado final. Cuando el parámetro use_viewer está habilitado, puede abrirse una ventana independiente de Matplotlib en algunos entornos de ejecución.

Enlace al Código Fuente del Nodo Camera Pose Visualizer

El nodo Camera Pose Visualizer proviene del paquete de nodos ComfyUI-KJNodes.

Camera Pose Visualizer(CameraPoseVisualizer)