Camera Pose Visualizer (CameraPoseVisualizer) - ComfyUI-KJNodes

Camera Pose Visualizer ノードは、2つの主要なデータソースをサポートします：AnimateDiff-Evolved の CameraCtrl ポーズデータと、RealEstate カメラの内部パラメータと座標を含む .txt ファイルです。

Camera Pose Visualizer は、カメラの姿勢を視覚化するためのノードです。抽象的なカメラの位置と向きのデータを直感的な3Dグラフィックに変換し、ユーザーが3D空間内でのカメラの動きの軌跡と視点の変化を理解するのに役立ちます。

ノード機能

このノードは、2つの主要なデータソースをサポートします：AnimateDiff-Evolved の CameraCtrl ポーズデータと、RealEstate カメラの内部パラメータと座標を含む .txt ファイルです。そのコアメカニズムは、これらのデータを読み取り、3次元座標系内で各カメラの位置と向きを表す円錐または座標系を描画し、最終的に 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)