Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel2
include
outlinefalse
indent
styledefault
exclude
typelist
class
printabletrue

Create Job

In Marso, you can now input your capture photography by creating a job. The top-most panel of the main window is used for this:

15_new_job_frame.pngImage Added

Enter the job information:

  1. Job Name: A descriptive name that will be used to identify the scan throughout processing and once the results are ready. e.g Blue_Leather_Handbag

Info

Letters, numbers, hyphens, and underscores are allowed. Do not use special characters.

  1. Raw Images Folder: Specify the path to the raw images from the scan to be processed.

  2. Raw Images Extension: Select from the list of supported file formats found in the Raw Images Folder.

Note

Marso can only ingest camera RAW or DNG Files, it cannot read jpeg, png or exr, see supported files for details.

  1. Light System: Describes the relative position of the lights to the camera. These are presets that can be re-used for different jobs if the same scanning setup is being used. See Calibration Section for more information.

Click Create to add the new job to the job list.

16_create_new_job.pngImage Added

A confirmation dialog will be displayed. Check the number of images and the raw extension is as expected before proceeding.

CreateJobPopup.pngImage Added

The created job will then be displayed in the ‘Available’ pool.

24_show_created_job.pngImage Added

To continue you will need to run the initial DEVELOP step, to create photogrammetry images, and

When using Marso, photogrammetry must only be done with images generated from Marso, rather than using the RAW images, or your own JPEGs/EXRs. See Photogrammetry Requirements.

Marso Photogrammetry Images are created by running the DEVELOP step.

Image Creation

25_prep_job_queue.png

Click “Queue' to add the selected job to the run queue.

This will launch a configure dialog where you can customise your photogrammetry images.

Image Customisation

Click ‘Open Image’ to open an image preview from the capture.

A preview of the photogrammetry image will be loaded.

26_prep_job_configure.png

This will open preview of your photogrammetry images.

27_prep_job_preview.png

If the preview image is too bright or too dark, adjust the brightness slider.

Photogrammetry images will have their brightness adjusted.

28_prep_job_brightness.png

You can also optionally export as larger EXR files, instead of JPGs, and modify the directory where the photogrammetry images are being written.

For most use cases we recommend JPG photogrammetry images.

29_prep_job_options-20250127-113014.png

Once you are happy with your configuration, click ‘Queue’ to save the config and add the job to the processing queue.

30_prep_job_configure_finish-20250127-113017.png

This will return you to the main Marso window, where the selected job is now in the run queue.

Running the Develop step

With a job in the run queue, click 'Start' and all jobs in the queue will run.

31_prep_job_in_queue.png

The first job in the queue will begin running. Progress is displayed at the bottom of the window.

If necessary, the running job can be paused or stopped at any time, using the buttons in the bottom right of the window.

32_prep_job_running.png

Once the DEVELOP step is complete, the job will return to the available pool with status ‘DO SOLVE’.

Click ‘Images’ to open explorer at the folder containing the images that should be used for photogrammetry.

35_images_button.png

Do Solve

You are now free to follow your normal photogrammetry process, as long as it meets the
Photogrammetry Requirements.

See below for specific tips for the photogrammetry solution you use:

⬅️ Capture

Processing ➡️