Camera Pose Visualizer (CameraPoseVisualizer) - ComfyUI-KJNodes

Узел Camera Pose Visualizer поддерживает два основных источника данных: данные поз CameraCtrl от AnimateDiff-Evolved, а также .txt файлы, содержащие внутренние параметры камеры и координаты RealEstate.

Camera Pose Visualizer: это узел для визуализации поз камеры. Он преобразует абстрактные данные о положении и ориентации камеры в интуитивно понятную 3D-графику, помогая пользователю понять траекторию движения и изменение ракурса камеры в трёхмерном пространстве.

Функциональность узла

Узел поддерживает два основных источника данных: данные поз CameraCtrl от AnimateDiff-Evolved, а также .txt файлы, содержащие внутренние параметры камеры и координаты RealEstate. Его основной механизм заключается в чтении этих данных, отрисовке конусов или систем координат, представляющих положение и ориентацию каждой камеры, в трёхмерной системе координат, и, наконец, в рендеринге 3D-графика, созданного с помощью Matplotlib, в тензор изображения, пригодный для использования в 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)