nodes/toriumi-ComfyUI_GaussianSplatToMesh

Files

T

toriumi 3f1bcf85b7 Initial commit: GaussianSplatToMesh custom node

- __init__.py: ComfyUI node registration
- nodes.py: PLY_DATA (Gaussian Splat) to TRIMESH conversion
  - Supports alpha_shape, ball_pivoting, marching_cubes methods
  - No Open3D dependency (scipy + trimesh + sklearn only)
  - Compatible with Python 3.13 and ComfyUI v0.22.0
- README.md: Documentation with usage, parameters, and workflow examples

2026-05-27 22:04:43 +09:00

4.4 KiB

Raw Permalink Blame History

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

典型的なワークフロー:

画像を VNCCS_WorldMirrorV2_3D に入力して3D再構築
出力の PLY_DATA を GaussianSplatToMesh に接続
変換された 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

4.4 KiB Raw Permalink Blame History Unescape Escape