Setting Up Materials
Setting Up Properties
Landscape Tool
Sandworm (Experimental)
Extending Editor Functionality
Usage Examples
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine Tools
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes

Panoramic Rendering

With panoramic rendering you can get impressive 180 or even 360 degree panoramas on one monitor. To increase the total resolution of the rendered image, this viewport can be spanned across several monitors, if required.

This plugin cannot be used in a Qt-based application.

Panoramic Rendering Modes#

The following rendering modes are supported:

  • 180 or 360 degree panorama with curved edges
  • 180 or 360 degree linear panorama without distortion at the edges
  • Orthographic fisheye panorama with an adjustable field of view
  • Equidistant (tru-theta or f-theta) fisheye panorama with an adjustable field of view
  • Stereographic fisheye panorama with an adjustable field of view
  • Equisolid (equal-area) fisheye panorama with an adjustable field of view

The horizontal axis on the chart above is the angle (radians) of incident light on the lens where 0 degrees is along the lens axis. The vertical axis is proportional to the radius on the fisheye image where that light exits the lens.

Curved Panorama#

Curved Panorama

180 degree panorama with curved edges on 1 monitor

Linear Panorama#

Linear Panorama

180 degree linear panorama on 1 monitor



180 degree spherical panorama

How Panoramic Rendering Works#

During panoramic rendering 4 viewports are seamlessly stitched into one for extra-wide field of view. Images are overlapped and blended along the border shown below.

4 viewports of panorama

Four viewports used to render panorama

Enabling Panoramic Rendering#

To enable panoramic rendering for your application, open the console and run the render_viewport_mode command with the required panoramic mode (1-8). For example, to enable 180 degree panorama with curved edges:

Source code
Unigine~# render_viewport_mode 1
It is not possible to use panoramic rendering with:

When panoramic rendering is enabled, the camera's Field of view option is not applicable.

To adjust FOV for fisheye panoramic rendering modes, select one of the Fisheye modes and set the desired Panorama Fisheye FOV via Screen Settings or using the corresponding console commands:

Source code
Unigine~# render_viewport_mode 7 render_panorama_fisheye_fov 30
Available only when render_viewport_mode mode is set to one of the fisheye panorama modes (5-8).

Multi-Monitor Mode#

It is also possible to span panorama across several identical monitors (only) in the fullscreen mode without decorations. For that, you need to specify on the start-up:

  • The summed resolution of two displays (for example, for two 1280x1024 displays, that would be 2560x1024)
  • video_fullscreen 2

For example (do not forget to specify other required start-up options):

Shell commands
main_x64.exe -video_mode -1 -video_width 2560 -video_height 1024 -video_fullscreen 2

Curved Panorama

Last update: 2020-11-11