ComfyStereo

出典: https://github.com/Dobidop/ComfyStereo フィードバックやヘルプの提供は自由にお願いします

概要

- Stereo Image Node – Automatic1111のステレオスクリプトを移植し、深度マップのエッジ感知型・方向感知型ぼかしなどの機能を追加。ノード内では左右視、交差視、アナグリフモードが利用可能です。

- DeoVR View Node – DeoVRで画像や動画を起動・表示するためのノード。

DeoVR View Nodeの設定

DeoVRの開発者設定で「リモート制御を有効にする」を有効にしてください。

このノードからDeoVRを起動するには、設定ファイルにDeoVR.exeのパスを設定する必要があります：

ComfyUI\custom_nodes\comfystereo\config.json

デフォルトパス:

"C:\\Program Files (x86)\\Steam\\steamapps\\common\\DeoVR Video Player\\DeoVR.exe"

重要な注意点:

- このノードでヘッドセットに表示される内容を変更するには、事前にDeoVRで画像または動画を開いておく必要があります。

- DeoVRがメインメニュー画面にいる場合には動作しません。

- ランチャーはメインメニュー画面を自動的にスキップしますが、手動でDeoVRを起動した場合は、このノードを使用する前に画像/動画を開いておく必要があります。

---

新機能と深度マップのぼかし

新しい機能には、エッジ感知型・方向感知型の深度マップぼかし、追加の補間手法、ステレオ歪みの改善が含まれます。

深度マップのぼかし:

- 最終的なステレオ画像におけるアーチファクトや急激なトランジションを低減します。特に高い分離値で顕著です。

- トレードオフ: 計算時間が5〜25%増加します。速度が重要な場合は無効化を検討してください。

- depth_map_threshhold は深度マップの勾配のしきい値を設定します。低い値はより広範囲の緩やかな勾配にぼかしを適用し、深度マップ全体をより強くぼかします（結果に悪影響を及ぼす可能性があります）。高い値は急峻な勾配のみを対象とします。

アダプティブぼかしの有効化方法

- 'depth_map_blur' = True に設定してください。

マスク出力についての注意

- マスク出力は不完全であり、主に**「No Fill」および「Imperfect Fill」**オプションで有用です。これは埋められなかった領域を白黒画像として出力します。

---

ステレオ画像生成方法

主なパラメータ

分離 (`separation`)

- 左右画像に追加で適用する水平シフトのパーセンテージを定義します。

- ステレオペアの距離を変更し、整列に影響を与えます。

分岐 (`divergence`)

- 3D効果の強度（パーセンテージで表されます）を制御します。

- 分岐値が高いほど奥行き感が増し、低いほど平面的な効果になります。

ステレオバランス (`stereo_balance`)

- 分岐効果を両目間でどのように分配するかを決定します。

- 0.0 = 均等に分配

- 正または負の値は効果を片方の目へシフトさせます。

ステレオオフセット指数 (`stereo_offset_exponent`)

- 深度とオフセットのマッピングを調整し、深度値が水平シフトに変換される方法に影響を与えます。

---

埋め込み方法

一部の埋め込み手法は高速ですが、構造の保持には劣ります。

- ナイーブな手法はやや高速です。

- Polylines Soft は一般的に最適な埋め込み手法です。

埋め込み手法の比較

No Fill 深度に応じてピクセルをシフトし、隙間は埋めません。

No Fill - Reverse Projection ピクセル値を逆方向に割り当てますが、隙間は残します。

Imperfect Fill - Hybrid Edge 「Polylines」と「Reverse Projection」を組み合わせ、構造をより良く保ちます。

Fill - Naive 最近傍ピクセルを使用して隙間を埋めます（引き伸ばしが発生します）。

Fill - Naive Interpolating 補間を使用して隙間を滑らかにします。

Fill - Polylines Soft ソフトなエッジを持つポリラインを使用して構造を維持します。

Fill - Polylines Sharp 「Soft」と同様ですが、よりシャープなトランジションです。

Fill - Post-Fill 「No fill」＋エッジ感知型補間。

Fill - Reverse Projection + Post-Fill 「Reverse Projection」＋方向指向補間。

Fill - Hybrid Edge with Fill 適応的スムージングを追加した強化版「Hybrid Edge」。

---

インストール

簡単な方法（推奨）

ComfyUI-Managerを使用して迅速にインストールしてください。

手動インストール

リポジトリをクローンし、ComfyUIのcustom_nodesディレクトリに配置してください：

git clone https://github.com/Dobidop/ComfyStereo.git
pip install -r requirements.txt

---

サンプルワークフロー

画像ワークフロー

動画ワークフロー

https://github.com/user-attachments/assets/0a61bc30-1821-40b8-b90d-12733f85bdea)

---

問題解決

- CPU使用率が低い？

- PythonおよびComfyUI-Managerをアップデートしてみてください。この対応で1名のユーザーが問題を解決しました。