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

Once you have the capture photography for a particular subject, you need to create a job for it in Marso.

Create Job

In Marso, The top-most panel of the main window is used for creating new jobs from capture photography.

15_new_job_frame.pngImage Removed20_create_job_frame.pngImage Added

Job Information

  1. Job Name: A descriptive name that will be used to identify the job 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.

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.

Fill in the Job Information, then select or create a Light System that matches the capture setup.

See Calibration Section for more information.

21_create_job_light_select.pngImage Added

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

16_create_new_job.pngImage Removed23_create_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 RemovedCreateJobConfirm.pngImage Added

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

24_show_created_job.pngImage Removed24_show_created_job.pngImage Added

Image Creation

Once you have created a job, the Photogrammetry images need to be created by running the initial DEVELOP step.25_prep_job_queue.pngImage Removed

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

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

25_prep_job_queue.pngImage Added

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.pngImage Removed26_prep_job_configure.pngImage Added

This will open preview of your photogrammetry images.

27_prep_job_preview.pngImage Removed27_prep_job_preview.pngImage Added

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.pngImage Removed28_prep_job_brightness.pngImage Added

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.pngImage Removed29_prep_job_options.pngImage Added

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.pngImage Removed30_prep_job_configure_finish.pngImage Added

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


Run Develop

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

31_prep_job_in_queue.pngImage Removed31_prep_job_in_queue.pngImage Added

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.pngImage Removed32_prep_job_running.pngImage Added

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.pngImage Removed33_prep_job_success.pngImage Added


Do Solve

You can now begin your photogrammetry workflow with the images created by Marso.


⬅️ Capture