VNCCS Panorama Mapper

Panoramas are great for 3D reconstruction, but an equirectangular image is a warped mess for a model that wants to see straight-on perspective views. VNCCS_PanoramaMapper is the correction step: you tell it where the room's corners are (in the node's interactive widget), and it unwarps the panorama into four flat wall images - front, right, back, left - plus a corrected_panorama.

The use case is obvious once you see it: feed those four flat walls into the reconstruction nodes, and WorldMirror gets clean, distortion-free perspective views to work from instead of one curved panorama. This is the manual-quality version of what the pack's Equirect360ToViews does automatically - same family, this one gives you control at the cost of clicking corners.

How it works

The whole input is a single widget_data string - a JSON blob produced by the node's UI widget. It carries the panorama image_path and the corners (default [45, 135, 225, 315], i.e. the four compass directions in degrees). The node loads the image, uses the corner angles to split the equirect into four perspective slabs, applies the distortion correction from the widget, and returns the five images.

Practical implications: this node needs the widget's JSON to be present and correct. The source code's failure mode for bad input is returning four blank 512×512 images - which is silent and confusing if you don't read the console warnings. If your outputs come back empty/black, check that the panorama path in the widget actually resolves, then check the console for the "No image path provided" / "Panorama image not found" messages.

Using it

• Set the corners in the widget to match where the room's walls actually turn - the default cardinal directions are right for typical rooms.
• Output front/right/back/left are plain IMAGEs; feed them (as a batch, or one at a time) into VNCCS_WorldMirror3D / VNCCS_WorldMirrorV2_3D.
• The corrected_panorama output is the perspective-corrected source - handy if you want to re-run other panorama tools on a fixed image.

This is a niche node - if you're reconstructing from equirect panoramas and don't need manual control, the pack's Equirect360ToViews node is the more automatic path, and the author points people there for the 360-view workflow. But when automatic extraction gets the corners wrong (odd layouts, angled walls), this manual version is the fix.

Install

Standard for the pack:

cd ComfyUI/custom_nodes
git clone https://github.com/AHEKOT/ComfyUI_HYWorld2
cd ComfyUI_HYWorld2
pip install -r requirements.txt
python install.py

No extra model downloads for this node - it's pure image geometry. The gsplat fork from install.py matters for whatever you do with the outputs, not for the mapping itself.