ComfyUI_GaussianSplatToMesh

Gaussian Splat（PLY_DATA）からメッシュ（TRIMESH）への変換を行うComfyUIカスタムノードです。

概要

HY-World 2.0（WorldMirror）などで生成されたGaussian Splatting点群データ（PLY_DATA）を、3Dメッシュ（TRIMESH）に変換します。変換後のメッシュは Hy3DExportMesh ノードに接続して GLB/OBJ/PLY/STL 形式でエクスポートできます。

Open3Dに依存せず、scipy + trimesh + sklearn のみで動作するため、Python 3.13環境でも利用可能です。

対応するComfyUIノード

| ノード名 | 説明 | |----------|------| | VNCCS_WorldMirrorV2_3D | HY-World 2.0 シングルイメージ3D再構築（PLY_DATA出力） | | GaussianSplatToMesh | 本ノード — PLY_DATA → TRIMESH変換 | | Hy3DExportMesh | TRIMESH → GLB/OBJ/PLY/STLエクスポート |

ノード情報

• ノード名: GaussianSplatToMesh
• 表示名: 🔷 Gaussian Splat to Mesh
• カテゴリ: 3D/mesh

入力

必須入力

| パラメータ | 型 | 説明 | |-----------|-----|------| | ply_data | PLY_DATA | Gaussian Splat点群データ（VNCCS_WorldMirrorV2_3Dの出力） |

オプション入力

| パラメータ | 型 | デフォルト | 説明 | |-----------|-----|-----------|------| | method | 選択 | alpha_shape | サーフェス再構築手法（alpha_shape / ball_pivoting / marching_cubes） | | alpha | FLOAT | 0.0 | alpha_shape手法のアルファ値。0=凸包、大きい値=より詳細（0.5〜10.0推奨） | | resolution | INT | 128 | marching_cubes手法のボクセルグリッド解像度（32〜512） | | radius_factor | FLOAT | 1.5 | ball_pivoting手法の半径倍率（0.5〜10.0） | | max_points | INT | 100000 | 最大点数（超過時はダウンサンプリング） | | remove_outliers | BOOLEAN | True | 再構築前に統計的外れ値を除去 | | outlier_std_ratio | FLOAT | 2.0 | 外れ値除去の標準偏差比率（小さい値=より積極的に除去） |

出力

| パラメータ | 型 | 説明 | |-----------|-----|------| | trimesh | TRIMESH | 変換されたメッシュオブジェクト（trimesh.Trimesh） |

サーフェス再構築手法

alpha_shape（推奨）

Delaunay三角形分割ベースのアルファシェイプ。高速で密な点群に適しています。

• alpha=0: 凸包（最も単純）
• alpha>0: 値が大きいほど詳細な形状を再現（穴も増える）

ball_pivoting

近似ボールピボッティング。局所的なDelaunay三角形分割パッチを使用し、エッジ長でフィルタリングします。

marching_cubes

ボリューメトリック再構築。点群をボクセルグリッドに変換し、マーチングキューブ法でメッシュ化します。滑らかな結果が得られますが、scikit-imageが必要です。

ワークフロー接続例

[Load Image] → [VNCCS_WorldMirrorV2_3D] → (PLY_DATA) → [GaussianSplatToMesh] → (TRIMESH) → [Hy3DExportMesh] → GLB/OBJ

典型的なワークフロー:

1. 画像を VNCCS_WorldMirrorV2_3D に入力して3D再構築
2. 出力の PLY_DATA を GaussianSplatToMesh に接続
3. 変換された TRIMESH を Hy3DExportMesh に接続してエクスポート

依存パッケージ

| パッケージ | 用途 | 備考 | |-----------|------|------| | numpy | 数値計算 | ComfyUI環境に標準搭載 | | torch | テンソル処理 | ComfyUI環境に標準搭載 | | scipy | Delaunay三角形分割、KDTree、ガウシアンフィルタ | ComfyUI環境に標準搭載 | | trimesh | メッシュ生成・処理 | ComfyUI環境に標準搭載 | | scikit-image | marching_cubes手法で使用（オプション） | alpha_shape/ball_pivoting使用時は不要 |

注意: Open3Dは不要です。Python 3.13でOpen3Dが利用できない問題を回避するため、scipy/trimeshベースで実装しています。

インストール

ComfyUI-Managerから

ComfyUI-Managerの「Install Custom Nodes」から ComfyUI_GaussianSplatToMesh を検索してインストール。

手動インストール

cd /path/to/ComfyUI/custom_nodes
git clone https://github.com/toriumi/ComfyUI_GaussianSplatToMesh.git

追加の依存パッケージのインストールは通常不要です（ComfyUI環境に含まれています）。

ライセンス

MIT License