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