ComfyUI Node
MV-SAM3D Run Multi-View (unofficial)
A ComfyUI node in MV-SAM3D with 22 inputs and 3 outputs.
MV-SAM3D Run Multi-View (unofficial)
- scene
- result
- glb_path
- ply_path
◄seed42►
◄stage1_steps50►
◄stage2_steps25►
◄ss_weightingtrue►
◄ss_entropy_layer9►
◄ss_entropy_alpha30.00►
◄stage2_weightingtrue►
◄stage2_weight_sourceentropy►
◄stage2_entropy_alpha30.00►
◄stage2_visibility_alpha30.00►
◄stage2_attention_layer6►
◄stage2_attention_step0►
◄stage2_min_weight0.001►
◄stage2_weight_combine_modeaverage►
◄decode_formatsgaussian,mesh►
◄filename_prefixmvsam3d►
◄offloadtrue►
◄da3_npz►
◄pixi_python►
◄repo_root►
◄pipeline_yaml►
CategoryMV-SAM3D
Inputs (22)
| Name | Type | Default | Description |
|---|---|---|---|
| scene | MVSAM3D_SCENE | From MV-SAM3D Load Views or Scene From Dir. | |
| seed | INT | 420–4294967295 | Random seed (paper example uses 42). |
| stage1_steps | INT | 501–200 | Stage-1 (sparse structure) denoise steps. Paper: 50. |
| stage2_steps | INT | 251–200 | Stage-2 (SLAT) denoise steps. Paper: 25. |
| ss_weighting | BOOLEAN | true | Stage-1 attention-entropy weighting (paper method). |
| ss_entropy_layer | INT | 90–32 | Stage-1 cross-attn layer tapped for entropy. Reference: 9. |
| ss_entropy_alpha | FLOAT | 30.000–200 | Stage-1 entropy softmax temperature. Reference: 30. |
| stage2_weighting | BOOLEAN | true | Stage-2 per-view weighting on/off. |
| stage2_weight_source | COMBO | entropy | entropy = paper headline method. visibility/mixed need a DA3 npz (da3_npz input). |
| stage2_entropy_alpha | FLOAT | 30.000–200 | — |
| stage2_visibility_alpha | FLOAT | 30.000–200 | — |
| stage2_attention_layer | INT | 60–32 | Stage-2 cross-attn layer tapped for entropy. Reference: 6. |
| stage2_attention_step | INT | 00–200 | — |
| stage2_min_weight | FLOAT | 0.0010–1 | — |
| stage2_weight_combine_mode | COMBO | average | 2 options: average, multiply |
| decode_formats | STRING | gaussian,mesh | Comma list of outputs: gaussian (-> .ply splat), mesh (-> .glb). |
| filename_prefix | STRING | mvsam3d | Output file prefix (letters/digits/._- only). |
| offloadopt | BOOLEAN | true | Stage-wise CPU offloading so the run fits 16 GB VRAM (measured 13.95 GB peak). Device placement only — the fusion math is unchanged. Disable on >24 GB cards for the fully-resident original behavior. |
| da3_npzopt | STRING | Optional Depth-Anything-3 pointmap npz (pointmaps_sam3d + image_files). Required for visibility/mixed weighting. | |
| pixi_pythonopt | STRING | Empty = auto-discover the sam3dobjects-nodes env python (or set MVSAM3D_PIXI_PYTHON). | |
| repo_rootopt | STRING | Empty = bundled vendor/MV-SAM3D submodule (or set MVSAM3D_REPO). | |
| pipeline_yamlopt | STRING | Empty = auto-discover models/sam3dobjects/pipeline.yaml (or set MVSAM3D_PIPELINE_YAML). |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| result | MVSAM3D_RESULT | — |
| glb_path | STRING | — |
| ply_path | STRING | — |