Nodes/Mickmumpitz-Nodes/Perspective to Pano Warp
ComfyUI Node

Perspective to Pano Warp

A ComfyUI node in Mickmumpitz/Panorama with 12 inputs and 4 outputs.

By mickmumpitz·Created 7 months ago·Updated about 14 hours ago· 39
Perspective to Pano Warp
  • image
  • control_video
  • control_mask
  • inpaint_mask
  • erp_guide
width1408
height704
length1
h_fov_deg70.0
yaw_deg0
pitch_deg0
mask_feather0
supersample2.0
grid_spacing_deg10
guide_opacity0.55
fill_color#000000
CategoryMickmumpitz/Panorama

Inputs (12)

NameTypeDefaultDescription
imageIMAGE
widthINT140864–8192ERP canvas width. Keep 2:1 (width = 2*height) for a full pano.
heightINT70432–4096
lengthINT11–257Frames in the still batch (N = 1+4k). 1 = single ERP still (fastest); 5 gives a video model a little temporal extent.
h_fov_degFLOAT70.010–170HORIZONTAL field of view of the source photo, in degrees. Photos do not carry this, so it is set here. Too small places the photo too tightly, too large smears it across the canvas. Match your camera: phone main ~70, wide ~90, ultrawide ~110-120.
yaw_degoptFLOAT0-180–180Where on the sphere the photo points. 0 is canvas centre, 180 is the wrap seam.
pitch_degoptFLOAT0-90–90Camera tilt. 0 for a level shot. If the horizon comes out wrong, this is the value to change first.
mask_featheroptINT00–128Feather (px) on the inpaint_mask edge, ramping INTO the known side only. Keep at 0 for models trained on hard edges; a ramp there is content mixed towards the fill colour.
supersampleoptFLOAT2.01–4Anti-alias quality. The source is heavily minified into the ERP footprint; this area-prefilters it to footprint x this factor before a bicubic warp, killing aliasing/moire. 2 is a good default, 3-4 for very high-res sources, 1 = off (old bilinear-ish).
grid_spacing_degoptINT105–90Lat/lon grid spacing (deg) on the 'erp_guide' chart. The guide is a TECHNICAL equirect reference (no photo): lat/lon grid + degree labels, floor/ceiling perspective curves, and a dotted FOV box marking exactly where the image sits. Feed it to a generator as a pure geometry hint for the 360 layout.
guide_opacityoptFLOAT0.550–10 = draw only the lat/lon grid + FOV box; >0 = also draw the floor + ceiling perspective curves (how a ground/ceiling plane distorts into equirect).
fill_coloroptSTRING#000000Colour of the UNKNOWN region on the ERP canvas (everything outside the photo's footprint). Hex '#RRGGBB' / '#RGB', or 'r,g,b' with 0-255 components. Default black. This only tints control_video -- the masks are unchanged, so an inpainting sampler still regenerates the region regardless. Handy when a model reacts badly to black init (try '#808080' mid-grey).

Outputs (4)

NameTypeDescription
control_videoIMAGE
control_maskIMAGE
inpaint_maskMASK
erp_guideIMAGE