Panoramic
Warp an image through panoramic, HDRI, and 360 map projections: mirror ball, equirect, stereographic, and others.
What it does
Panoramic remaps an image through one of twelve cartographic projection functions: Mirror Ball, Mercator, Stereographic, Sinusoidal, Mollweide, Polar, Cylindrical, Gnomonic, Panini, Octahedral, Dual Paraboloid, and Cubemap Cross. It converts between flattened-map and 360° sphere layouts of the same image, and bends a flat image through an exotic lens shape.
Rotation spins the virtual viewing direction before the projection is applied, Y for yaw and X for pitch, which recentres a panorama on any point. Invert flips the direction of the mapping, so the same node converts a panorama both into and back out of a given projection.
When to use it
Converting between panorama formats, mirror ball to equirectangular or the reverse, for an Environment or HDRI setup.
A little-planet or fisheye-style distortion: Stereographic or Polar on a wide image.
Re-aiming a 360° panorama: dial in Rotation to recentre the view before further processing.
An unusual creative warp on an ordinary image, panorama or not.
| Parameter | Type | Default |
|---|---|---|
content_in | OneOf([FieldOf(Raster)]) | — |
projection | String | "Mirror Ball" |
invert | Boolean | false |
rotation | Vec2 | (0, 0) |
fov | Number | 90 |
panini_d | Number | 1 |
edge_mode | String | "Transparent" |
spatial_strength | Field | — |
strength | Number | 1 |
Gotchas
Field of View appears for Gnomonic, Panini and Stereographic only. The other projections do not use it and it stays hidden.
Panini Compression appears only when Projection is set to Panini. At 0 it behaves like a rectilinear projection; at 1 it is a full cylindrical stereographic projection.
Several projections (Sinusoidal, Mollweide, Gnomonic, Panini, Dual Paraboloid, Mirror Ball, Polar) cover part of the frame only, and the rest falls outside the projection's valid domain. Edge Mode controls what happens there: Black leaves those pixels transparent or black, Clamp stretches the nearest edge pixel, Repeat and Mirror tile the source across them.
A colour or pattern fed in from a procedural node is rendered to a flat image first, then warped. The projection always operates on pixels, never on the live procedural recipe.
Worked example
Add a Panoramic node and wire an equirectangular panorama into Content.
Set Projection to Mirror Ball to preview it as a mirror-ball capture, or leave it on the default and use Invert to go the other way.
Adjust Rotation, X for pitch and Y for yaw, to recentre the panorama on the subject.
Switch Projection to Stereographic and raise Field of View for a little-planet look, then try each Edge Mode to see how the frame edges fill.