Articles on: Stage Documentation

Reference Panorama

Reference Panorama

The reference panorama, not to be confused with the blend reference, is the panorama image that is used as a reference for the reconstructed room. Its location is set at the origin and the 3D geometry is built around that origin. The orientation of the reference panorama determines the general orientation of the room geometry.

Make Reference

To make a panorama the room reference panorama, select it from the image list, and then hit MAKE REFERENCE in the helper panel. The R icon should appear on the tile to indicate that this image is now the reference.

The helper panel now enables the reference panorama tools.

Aligning the Reference Panorama

The reference panorama needs to be levelled and correctly aligned to help reconstruction be as accurate as possible. To show the alignment guides, hit Show alignment tools.

The red line will show the current floor orientation, and the blue lines will show the levelling

To change the orientation of the room and align on image features, drag the handle. For example, we are going to align the orientation of the room with the tiles on the floor. Note that using the PLAN VIEW mode helps a lot for this task.

Note how the grid is also aligned with the floor tiles. This makes reconstruction a lot easier, because angle snapping will be aligned with the room features.

Good features to use for the orientation alignment tool are bases of walls or floor tiles if not available

Levelling the Reference Panorama

To level the reference panorama, switch to the LEVELLING VIEW mode.

This will display an alignment grid that will make the levelling process more precise.

To create a new leveling guide, first, spot a good vertical feature. Wall corners make great candidates.

Hit DRAW LEVEL LINE, then click where the first end of the guide should appear and click a second time where the second end of the guide should appear. The accuracy of the levelling will increase the longer the guide is.

The panorama should level itself. To check if the levelling is accurate enough, use the grid in the LEVELLING VIEW.

Continue adding vertical guides in areas that aren't aligned correctly until you have reached a level of quality that is satisfactory. For example, looking around here, we can spot another corner that is slanted.

Adding another guide will level the entire panorama so that on average, the vertical lines stay vertical.

You can also adjust existing levelling guides by dragging one of their handles.

To delete a level guide, select it and press the DELETE or BACKSPACE key.

Once the orientation and the levelling is good, turn off Show alignment tools so the guides won't get in the way.

Camera Parameters

These are the camera properties for the current panorama.

Lens Height

Sets the height of the center of the lens of the camera to the floor. This needs to be measured during shooting. The accuracy of the room dimensions depends highly on the precision of this value.


Sets a masking circle that includes unwanted features at the nadir of the image, such as tripods.

Adjust it as tightly as possible to avoid wasting too much pixels in the image. To do this, either enter a numerical value, or use the MEASURE tool. When using the MEASURE tool, first, hit the MEASURE button.

Then click once in the viewport and move the mouse to set the radius of the nadir zone.

Then click again to set the value.

Check Also apply to Zenith to mask the zenith of the image with the same radius. This is useful for stitched panoramas without a top image.


Makes the image darker or brighter by changing its exposure.

Updated on: 14/06/2021

Was this article helpful?

Share your feedback


Thank you!