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.



Once a panorama is set to be the Reference Panorama, 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.


By default, Metareal's AI technology will level all panoramas automatically. You only need to manually add vertical level lines if you think that the automatic levelling hasn't done a good job, which usually only occurs in cases where there's poor lighting, image distortion, or image stitching errors.



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


If you do need 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


hese are the camera properties for the current panorama.



Lens Height


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


Nadir


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.


Updated on: 05/08/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!