Versions Compared

Key

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

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

These are generated using the DEVELOP step.

Photogrammetry Images

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.

20_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.


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.

23_create_job.pngImage Added

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

CreateJobConfirm.pngImage Added

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

24_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.

Click “Queue' to add the selected job to the

processing

run queue

, for the DEVELOP step

.

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.

25_prep_job_queue.pngImage Removed

26_prep_job_configure.pngImage Removed

A preview of the photogrammetry image will be loaded.

26_prep_job_configure.pngImage Added

This will open preview of your photogrammetry images.

27_prep_job_preview.pngImage Added

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

This will affect the photogrammetry images

Photogrammetry images will have their brightness adjusted.

27_prep_job_preview.pngImage Removed
28_prep_job_brightness.pngImage Added

28_prep_job_brightness.pngImage Removed

You can also optionally

create photogrammetry images as EXRs

export as larger EXR files, instead of JPGs, and

have

modify the directory where the photogrammetry images

be written to a custom directory.

are being written.

For most use cases we recommend JPG photogrammetry images.

29_prep_job_options.pngImage Added

Once you are happy with your

settings

configuration, click

“Queue”

‘Queue’ to save the config and add the job to the processing queue.

29_prep_job_options.pngImage Removed

30_prep_job_configure_finish.pngImage Removed
30_prep_job_configure_finish.pngImage Added

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

processing

run queue.

Click start to begin processing

Run Develop

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

.

You can pause or stop processing at any time.

31_prep_job_in_queue.pngImage Removed

32_prep_job_running.pngImage Removed

will run.

31_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 Added

Once the DEVELOP step is complete, the

status will be

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.

33_prep_job_success.pngImage Removed
33_prep_job_success.pngImage Added


Do Solve

You are can now free to follow begin your normal photogrammetry process, as long as the photogrammetry photogrammetry workflow with the images created by Marso are used. You may modify the contents of these images as long as they are not renamed or re-ordered.See below for specific tips for the photogrammetry solution you use: