Versions Compared

Key

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

24.4.1

License Key Activation Failure

If you are activating a license for the first time on a machine you may see the following error even if your license is valid.

...

To confirm that this error is invalid, check the most recent log file in

%LOCALAPPDATA%/M-XR/Maestro/Logging/Job_Manager_GUI/

If you see line similar to the below then your license may in fact be valid, and you should try following workaround.

Code Block
[ERROR  ] not enough values to unpack (expected 3, got 2)

Workaround

  1. Close Marso if you still have it open.

  2. In a text editor open %LOCALAPPDATA%/M-XR/Maestro/config.json

  3. Insert your license key in quotation marks like so:

    image-20240926-173138.pngImage Removed
  4. Restart Marso

You should find that your license key is already populated in the settings dialog, and activating now works correctly if your license is in fact valid.

24.4.0

Update Failure

The Updater shipped with Marso in versions up until 24.4.1 has been disabled as of the 20th of September 2024 due to an access key rotation. If you are unable to update from a version before 24.4.1 to a version after 24.4.1 you may need to re-download the Updater executable (M-XR_Marso_Update.exe) from here and replace the update executable in your install directory.

You should then be able to launch Marso and have it update correctly.

24.3.2

Normals Texture Files

The colour space on the Normals for PNG and JPEG outputs is not correct. Normally the should be in raw/linear and not need an input transformation, there is an issue with the file authoring that is encoding them as sRGB. To resolve, adjust the input transformation in your program of choice to treat them as sRGB.

Light System Menu Crash

...

When the menu is in this state, i.e. you have any number of rows in the New Light System frame, if you click on a row in this frame then the program will crash. Any data currently entered for a light system you are creating will be lost. No saved light system data will be impacted. If you are running a job and this crash occurs Marso will attempt to recover at next startup but progress for that job may be lost.

GUI not displaying error

...

Current

DLL Fault

Users may sometimes experience an application fault. This will not appear in the log and will look like the application has just closed without any further information. To confirm you can look in the event viewer and you should see an error like this:

Code Block
Faulting application name: M-XR_Marso.exe, version: 0.0.0.0, time stamp: 0x67aa8eb2
Faulting module name: tcl86t.dll, version: 8.6.2.13, time stamp: 0x6547c47c
Exception code: 0x80000003
Fault offset: 0x00000000000fc06d
Faulting process id: 0x3a78
Faulting application start time: 0x01db7cad7aa51c9d
Faulting application path: %LOCALAPPDATA%\M-XR_Marso.exe
Faulting module path: %LOCALAPPDATA%\M-XR\Maestro\Unpack\_MEI3522\tcl86t.dll
Report Id: 5b93f63c-d321-483b-9e74-2992ef6aee00
Faulting package full name: 
Faulting package-relative application ID: 

To resolve just relaunch the application and continue. If any job was running during the crash it will have to be restarted.

Spaces in paths

Currently having spaces in paths is not supported. So most steps will fail if a path includes a space. This covers calibration and processing. As a solution for the time being it is recommended to move the data to a location where there are no spaces in the path.

...

To resolve you must clear space on the drive, usually we aim for 1TB 250GB of free space. Then the program can be relaunched and job can be restarted safely.

...

If you have your firewall blocked and set not allow any connections then Marso will crash and will not provide a clear error. Marso requires external internet connection to run inorder in order to conenct connect to our DRM system.

To resolve, add a whitelist to your firewall for the Marso program and any program in this directory %LOCALAPPDATA%/M-XR/Maestro/Unpack

...

Currently based on our testing, Marso does not work with VPNs. They can tried at the user’s own risk but we do not expect them to work.

Historic

Expand
titleHistoric Issues

Default type filter for ST Map explorer window

Reality capture is the default photogrammetry software selected when opening the configure dialog on a new unconfigured job. If you try and select the ST map with the button through the subsequent explorer window, the program will only allow you to select a file, it shoud only be allowing a folder.

To work around this, in the Photogrammetry Software dropdown, select Agisoft and then reselect Reality Capture. This will force the interface to reset the filter in the explorer window when you open it to select the ST map.

Portrait Calibration

Calibrating with camera orientated portrait will result in landscape photogrammetry images that repeat the subject.

photogrammetry_00000.jpgImage Added

The calibration should be done in landscape to correct this issue. If the light offset was relative to the camera in portrait orientation, this will also need to be recreated to match the new calibration orientation. Scan images can then be taken in portrait and they should be rotated to landscape by Marso. The photogrammetry solve should then rotate the camera object back to portrait.

photogrammetry_00000_fixed.jpgImage Added

If you have an existing scan with this issue it will need to be re-created in Marso with the horizontal calibration and new light system selected.

GUI not displaying error

In a small set of circumstances with the prepare step when it errors the GUI is unable to report the error back to the user as it would normally. It will just show the job in the FAILED PREP state. To get around this look into %LOCALAPPDATA%/M-XR\Maestro\Logging\Job_Manager_GUI for the error details.

License Key Activation Failure

Fixed: 24.4.2

If you are activating a license for the first time on a machine you may see the following error even if your license is valid.

image-20240926-171848.pngImage Added

To confirm that this error is invalid, check the most recent log file in

%LOCALAPPDATA%/M-XR/Maestro/Logging/Job_Manager_GUI/

If you see line similar to the below then your license may in fact be valid, and you should try following workaround.

Code Block
[ERROR  ] not enough values to unpack (expected 3, got 2)

Workaround

  1. Close Marso if you still have it open.

  2. In a text editor open %LOCALAPPDATA%/M-XR/Maestro/config.json

  3. Insert your license key in quotation marks like so:

    image-20240926-173138.pngImage Added
  4. Restart Marso

You should find that your license key is already populated in the settings dialog, and activating now works correctly if your license is in fact valid.

Update Failure

Fixed: 24.4.1

The Updater shipped with Marso in versions up until 24.4.1 has been disabled as of the 20th of September 2024 due to an access key rotation. If you are unable to update from a version before 24.4.1 you may need to re-download the Updater executable (M-XR_Marso_Update.exe) from here and replace the update executable in your install directory.

You should then be able to launch Marso and have it update correctly.

Normals Texture Files

Fixed 24.4.0

The colour space on the Normals for PNG and JPEG outputs is not correct. Normally the should be in raw/linear and not need an input transformation, there is an issue with the file authoring that is encoding them as sRGB. To resolve, adjust the input transformation in your program of choice to treat them as sRGB.

Light System Menu Crash

Fixed 24.4.0

Untitled-20240809-095052.pngImage Added

When the menu is in this state, i.e. you have any number of rows in the New Light System frame, if you click on a row in this frame then the program will crash. Any data currently entered for a light system you are creating will be lost. No saved light system data will be impacted. If you are running a job and this crash occurs Marso will attempt to recover at next startup but progress for that job may be lost.