Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

🔗

Providing Geometry Data

Marso needs the exported alembic file (mesh), and the ST maps to account for the lens in the photography

To start the processing click the start button at the bottom right:

19_start_processing.pngImage Removed

This will launch a window that needs to be populated with the information from photogrammetry.
An estimate of the required disk space will be calculated based on the selected UV texture resolution.

20_populated_start_window.pngImage Removed

Clicking Start will begin the process.

21_processing_job_row.pngImage Removed InfoSimilarly to data preparation, only one job can be processed at a time.

Configuration

Once you have completed your photogrammetry workflow, the job must be configured with the resulting alembic and ST map. Configuration also allows you to choose the export texture resolution, any down-samples, and whether you wish to enable UV Bleed to counteract “cracking” on the final asset.

Select the row and click Configure to provide this information.

25_configure_button.pngImage Added

This will launch a window form to fill with the required information.

26_initial_configure_window.pngImage Added

The Light system has been pre-filled from when the job was created. It can be overwritten if the measurements were wrong, however if the new light system has a different number of lights to the initial configuration, Marso may not work correctly.

The Exposure Preset defines how your raw files should be processed. These can be created from a single Calibration Image captured with the same setup as you took the scan. See Calibration for more information.

27_configure_select_exposure.pngImage Added

Then provide the Mesh File and ST Map produced by photogrammetry. You can optionally provide a Mask Mesh if there is geometry in the scene that can occlude the subject from any camera angle.

29_configure_photogrammetry_info.pngImage Added

Then UV Bleed can be turned on or off, we recommend leaving on by default. Select the desired UV texture resolution. If multiple are selected, the material will be processed at the highest resolution and smaller textures will be down-sampled from it. If new shaders are available they can be selected, the textures will be made for each shader you select.

30_configure_output_options.pngImage Added

Clicking Save to save changes, or Cancel to discard changes.

31_populated_configure_window.pngImage Added

The changes will then be visible in the “Details” Panel. Once a job has been configured, the status will become READY, meaning it is able to be queued. There should also be no missing fields, coloured red, remaining.

32_queue_ready_processing.pngImage Added

Click Start to begin processing the asset.

33_start_queued_processing.pngImage Added
Panel
panelIconId23f0
panelIcon:alarm_clock:
panelIconText
bgColor#F4F5F7
This final step may

Processing can take upwards of

12

6 hours, depending on the mesh size, source photography resolution, and the number of cameras and lights.

☠️ Manually Terminating a Job

While a job is running, clicking Stop will stop the process. This will lose any progress within the current step, so it is not recommended unless necessary. Attempting to close the main Marso window while a process is running will cause the prompt below to appear. Selecting Yes will also terminate any running job.

image-20240517-232634.pngImage Removed

See Processing Times.

34_processing_job_row.pngImage Added

📦 Results

Upon processing completion, the Results button will be made available and clicking it will open the directory storing the material textures:

22_finished_job.pngImage Removed35_finished_job.pngImage Added

The results directory for each completed job will present the following contents:

A directory named Textures, containing folders for each supported render engine (currently just BlenderCycles).  PBR textures will be generated for the Diffuse, Roughness, Specular and Normals channels in EXR, PNG, and JPEG formats.

image-20240605-132842.pngImage Modified

☠️ Interrupting a Job

A running job can be interrupted with either the Stop/Skip or Pause buttons. Both will keep any progress up to the current step. Pause will return it to the front of the queue, while Skip will remove it from the queue and start processing the next queued item.