Quick Start#

Standard and recommended methods of working with the add-on are described here. Of course, no one forces you to use them - here you can experiment at your own discretion.

  • Export Object Wire

In order to simplify the task when importing the model to Blender, we export the model as a Wavefront (.obj) file. In newer versions of Blender (3.2+), this type of file is imported quickly and contains only the data needed to work with the addon. The important options here are:

  • Coordinate System - Same as XMP

  • Transformation Preset - Blender

These will be used as presets for the import from Reality Capture when importing the scene.

_images/qs-rc-export-obj.jpg
  • Export Camera Data

_images/qs-rc-export-metadata-xmp.jpg
  • Setup Context

Next, you need to import this data. Start Blender and run setup context. There is nothing in the standard scene that will help us in our work, so this data can be deleted. This should also be done if, for example, you have finished adjusting one scene and want to move on to the next dataset. Therefore, the first question will be whether to clear the existing data:

_images/qs-data-cleanup.jpg

Next, select the file containing the object wire and import it.

_images/qs-rc-import-scene.jpg

Then you need to choose the texture that we will adjust.

_images/qs-rc-ensure-canvas.jpg

Next, we import camera data. This will allow you to use lens distortion without exporting distortion corrected images.

_images/qs-rc-import-cameras.jpg

The next step will be linking the images to the camera objects.

_images/qs-rc-bind-images.jpg

And after that you can start adjusting the texture.

_images/qs-rc-complete.jpg
  • Export Object Wire

Export the reconstructed scene. It is recommended to use the Wavefront (.obj) format for this, as Blender 3.2+ will import this file type the fastest and it can store all the necessary mesh data and not contain extraneous data such as camera position information that needs to be imported separately.

_images/qs-ms-export-obj.jpg
  • Export Camera Data

Next, we export the camera data, for this we will use the Agisoft XML format.

_images/qs-ms-export-agisoft-xml.jpg
  • Setup Context

Next, you need to import this data. Start Blender and run setup context. There is nothing in the standard scene that will help us in our work, so this data can be deleted. This should also be done if, for example, you have finished adjusting one scene and want to move on to the next dataset. Therefore, the first question will be whether to clear the existing data:

_images/qs-data-cleanup.jpg

Select the previously exported scene file and the presets for Agisoft Metashape.

_images/qs-ms-import-scene.jpg

Next, it is necessary to choose the texture that we will adjust.

_images/qs-ms-ensure-canvas.jpg

Then import camera data from an XML file.

_images/qs-ms-import-cameras.jpg

Finally, you need to bind the image to the cameras. To do this, select the directory in which the images are located.

_images/qs-ms-bind-images.jpg

This completes the context setting, you can adjust the texture.

_images/qs-ms-complete.jpg