ComfyUI Node
SphereSfM Add Camera Path (Dual-Res)
A ComfyUI node in SplatKit with 22 inputs and 4 outputs.
SphereSfM Add Camera Path (Dual-Res)
- pano_frames_1
- pano_frames_2
- pano_frames_3
- pano_frames_4
- model_dir
- num_images
- num_points
- num_added_frames
◄dataset_dir►
◄hires_1—►
◄hires_2—►
◄hires_3—►
◄hires_4—►
◄frame_stride1►
◄max_frames0►
◄matcher_typeexhaustive►
◄adjust_existing_camerasfalse►
◄retriangulatetrue►
◄face_size0►
◄max_num_features8192►
◄peak_threshold0.0066►
◄edge_threshold10►
◄max_num_matches32768►
◄abs_pose_min_num_inliers30►
◄image_ordercamera_major►
◄cleanup_hires_sourcefalse►
CategorySplatKit
Inputs (22)
| Name | Type | Default | Description |
|---|---|---|---|
| dataset_dir | STRING | The EXISTING dual-res dataset to grow -- wire the Dataset Project node's dataset_dir (the same value the dual-res build node used as output_name). | |
| pano_frames_1 | IMAGE | The NEW trajectory's proxy_frames from its HiRes Composite. Must be the same resolution as the proxies the base dataset was posed on. | |
| hires_1 | STRING | hires_manifest from the SAME HiRes Composite feeding pano_frames_1 -- that trajectory's exact 8K file list. | |
| pano_frames_2opt | IMAGE | Optional second new trajectory; concatenated after pano_frames_1. | |
| pano_frames_3opt | IMAGE | Optional third new trajectory. | |
| pano_frames_4opt | IMAGE | Optional fourth new trajectory. | |
| hires_2opt | STRING | hires_manifest for pano_frames_2. | |
| hires_3opt | STRING | hires_manifest for pano_frames_3. | |
| hires_4opt | STRING | hires_manifest for pano_frames_4. | |
| frame_strideopt | INT | 11–100 | Use every Nth new frame. Stride HERE, not in a loader: this thins the proxies and the matching 8K files together. |
| max_framesopt | INT | 00–1000 | Cap NEW frames after stride (0 = no cap). |
| matcher_typeopt | COMBO | exhaustive | exhaustive (default) matches the new frames against the EXISTING ones too, which is what lets a separate path link into the reconstruction. Keep it unless the new clip is a direct temporal continuation of the last one. |
| adjust_existing_camerasopt | BOOLEAN | false | OFF (default): existing poses stay FIXED, only the new faces are written. ON: let a global solve refine them (re-renders EVERY cube face from 8K -- slow). |
| retriangulateopt | BOOLEAN | true | Run point_triangulator so the new images contribute 3D points. |
| face_sizeopt | INT | 00–8192 | Cube-face resolution (px). 0 = COLMAP default off the 8K SPHERE camera. Set the SAME value the base build used. |
| max_num_featuresopt | INT | 81921024–32768 | — |
| peak_thresholdopt | FLOAT | 0.00660–0.1 | — |
| edge_thresholdopt | FLOAT | 101–50 | — |
| max_num_matchesopt | INT | 327684096–131072 | — |
| abs_pose_min_num_inliersopt | INT | 3010–200 | Min verified inliers to register a new image. Lower if the new frames won't register; raise for stricter. |
| image_orderopt | COMBO | camera_major | 2 options: camera_major, frame_major |
| cleanup_hires_sourceopt | BOOLEAN | false | After the add, delete the NEW trajectory's consumed 8K frames from the HiRes Composite's frames/ folder -- but only once a same-size copy is confirmed staged in this dataset's _spheresfm_work/equirect_hires. OFF by default. Note: if frames/ and equirect_hires are on the same volume they are hardlinked, so this reclaims a directory listing but ~no disk; it frees real space only when they are separate copies. |
Outputs (4)
| Name | Type | Description |
|---|---|---|
| model_dir | STRING | — |
| num_images | INT | — |
| num_points | INT | — |
| num_added_frames | INT | — |