# Changelog

### Version Changelog

<details>

<summary>Version 26.1.5</summary>

* New features:
  * Added an experimental JPEG extraction for CR3 files to allow for preview in the develop and process modal
  * Added video tutorials on some modals, see the education button on the bottom left
  * Added learning centre with tutorials page to include in the application
* Bugfixes:
  * Fixed an issue with argument validation when creating basic exposures via CLI
  * Fixed an issue in the 3D viewer where data files would fail to parse, presenting as 'No Textures Available'
  * Fixed an issue during uninstall when users would leave the processing server running
  * Fixed an issue with the restart manager in windows failing to act

</details>

<details>

<summary>Version 26.1.4</summary>

* New features:
  * System toaster notifications on asset status change, with controllable setting
  * Support log collection button to generate a zip of your log files for support automatically
* Bugfixes:
  * Fixed an issue which would cause a process hang on systems with very high CPU core counts
  * Fixed an issue in the UI where clicking away from a modal would close the modal
* New Model:
  * Better metal/non-metal distinction
  * More consistent roughness values
  * Stronger normal map output
  * More accurate colour
  * Intended for use on all materials, but for black shiny non-metal objects it is recommended to still use the narrow model

</details>

<details>

<summary>Version 26.1.3</summary>

* Bugfixes:
  * Minor change with installer steps
  * Minor change with process completion

</details>

<details>

<summary>Version 26.1.2</summary>

* New features:
  * New PBR shader mapping in exports, works on old and new scans
  * New advanced PBR model for limited set of preview users

</details>

<details>

<summary>Version 26.1.1</summary>

* New features:
  * Login has now been moved to an external window
* Bugfixes:
  * Fixed an issue on AMD systems that would cause processing to always fail
  * Fixed an issue with processing where friendly error messaged would be replaced with error codes e.g. `[ERROR ] RESULT: 3221226505`
  * Fixed an issue with restarts on GUI triggering erroneous processing server starts, appearing as an `[ERROR ] Cannot start Marso Processing Server on port 18070, already in use`
  * Fixed an issue where logging for the GUI could not be enabled
  * Fixed an issue where certain checks in the process view would fail or not appear clearly to the user

</details>

<details>

<summary>Version 26.1.0</summary>

* New features:
  * New 3D Asset viewer with PBR display of results
  * Enhanced checking of inputs for processing
  * New welcome tour
* Minor bugfixes

</details>

<details>

<summary>Version 25.5.0</summary>

* New features:
  * New 3D viewer in UI
  * Alembic file verification check in UI before processing
  * Clearer error messages in UI reducing need to look in logs

</details>

<details>

<summary>Version 25.4.0</summary>

* New features:
  * New lights and exposure subcommands for the CLI
  * New ID options for the job subcommand for the CLI
  * Improved shader workflow mapping for export textures for both gamuts.&#x20;
* Fixes:
  * Fixed an issue where the exposure subcommand in the CLI required an unnecessary argument
  * Fixed an issue where a step in the installer would be blocked in certain IT environments

</details>

<details>

<summary>Version 25.3.0</summary>

* New features:
  * Advanced exposure creation system added to GUI and CLI
  * New navigational control for image previews in GUI
  * Filtering in tables added in GUI
  * Improved columns and added camera detail to exposure table in GUI
* Fixes:
  * Fixed an issue where automatic white balancing would occur on photography
  * Fixed an asset export error that would display even if export completed successfully in some instances
  * Fixed an issue with the loading of user's profile image
  * Fixed an issue with the Process selection dialog table filters behavior
  * Fixed an issue with the helptext in the CLI
  * Minor UI fixes

</details>

<details>

<summary>Version 25.2.0</summary>

* New, easier to navigate UI
* New Installer
* New processing options
* New generation of models available
* Introduced material gamuts

</details>

### Previous Versions

<details>

<summary>Version 25.1.2</summary>

* Bugfixes
  * Fixed Authentication issue when installing on multiple computers with the same account
  * Fixed module database connection issue affecting a small number of customers

</details>

<details>

<summary>Version 25.1.1</summary>

* Bugfixes
  * Fixed Critical authentication issue in installer

</details>

<details>

<summary>Version 25.1.0</summary>

* Bugfixes
  * In multi-light capture setups, photogrammetry images average all lighting conditions instead of using just the first
  * Pause returns jobs to the front of the queue instead of to the available pool
* Features
  * \[NEW] Transitioned from License Keys to M-XR Accounts
  * \[NEW] Configuration Presets are bound to your account, so can be shared between machines.
  * v0.1 Marso Command Line Interface
* Tweaks
  * Updated loading screen
  * Documentation overhaul

</details>

<details>

<summary>Version 25.0.1</summary>

* Features
  * \[NEW] Photogrammetry images brightness can be adjusted before they are generated, as well as their filetype and output directory.
  * \[NEW] Jobs that have already had photogrammetry images generated can regenerate them using the Develop tab in the configure dialog.
  * Added an ‘Export ZIP’ button to make it easier to collect data for support when jobs fail
* Bugfixes
  * Fixed jobs reporting Failed if the user directory contains non-ascii characters, now supports most latin languages.
  * Improved readability of some error messages

</details>

<details>

<summary>Version 24.5.4</summary>

* Workflow
  * Added a new check to processing to ensure all raw files in a job have consistent exposure settings (shutter speed, aperture, ISO), the process will error now if the values are not consistent
* Performance
  * Improved the GPU utilisation of one of the processing modules, resulting in a notable performance improvement
* Features
  * Marso and Updater are now signed with a self signed certificate (M-XR Ltd)
* Bugfixes
  * Fixed an issue where the default type filter for the ST Map explorer window would be not set correctly for RealityCapture
  * Fixed an issue where the `ESC` key would not work in the photography calibration rectangle selection window, now you can back out of the program back to the main GUI
  * Fixed an issue where the extension dropdown list would not refresh when creating a second job with the same raw images folder as the first job
  * Fixed an issue where during deletion of a job if a user very quickly selected another job during the deletion it would remove the newly selected job from the list but leave the original

</details>

<details>

<summary>Version 24.5.3</summary>

* Bugfixes
  * Fixed Marso being unable to start due to unnecessary dependency

</details>

<details>

<summary>Version 24.5.2</summary>

* Workflow
  * Photogrammetry images can be produced without creating an Exposure Params preset
  * Exposure Params Preset and Light System can be re-assigned in the configure dialog rather than being fixed after job creation
  * Jobs can now be sorted by most recent interaction
  * License key will be populated on start-up if installed with the updater
  * Marso logs will now roll-over daily instead of creating a single massive log file
* Bugfixes
  * Exposure Preset creation would hang if started while a job was running

N.B. Some Finished jobs may need to be re-configured before they can be queued again, if they were created on a previous version of Marso

</details>

<details>

<summary>Version 24.5.1</summary>

* Bugfixes
  * Fixed an issue where some RAW image files would fail to be read correctly

</details>

<details>

<summary>Version 24.5.0</summary>

* Results
  * Added new ***experimental*** Specular workflow as an optional output
  * Added new filtering to reduce artifacts from photogrammetry reconstruction
* Performance
  * Reduced storage utilisation by 40%-90% (depending on input data size)
  * Time to process scan reduced by 35%-75% (depending on input data size)
* Workflow
  * The prep stage is no longer required if the photogrammetry data is available
* Bugfixes
  * Fixed an issue where changes may be lost in settings window
  * Fixed an issue where parts of the GUI could not be resized

</details>

<details>

<summary>Version 24.4.2</summary>

* Bug Fixes
  * Fixed issue where new users could not activate their license keys
* Results
  * Improved Normals results when light offset from camera is large

</details>

<details>

<summary>Version 24.4.1</summary>

* GUI Changes
  * Added 3D viewer for previewing light positions
  * Added storage estimate for Preparation stage of Job
* Bugfixes
  * Addressed an issue with how backface were handled in the Alembic file that could cause a crash
  * Addressed an issue with how orientations of RAW files were handled
  * Addressed an issue where the row highlighting for a new light system was not working

</details>

<details>

<summary>Version 24.4.0</summary>

* GUI Changes
  * Added ability to deactivate license for moving to another machine
  * Enabled experimental 2D processing
  * Enabled option to process 3D scans at 16k on powerful enough systems
  * Added ability to specify mesh mask for 3D processing
  * Added option to choose between `JPG` and `EXR` for photogrammetry images
* Results Improvements
  * New algorithm for handling low UV resolution processing
* Bugfixes
  * Addressed a backend issue that would sometimes cause an error to hang indefinitely
  * Addressed a UI scaling issue with some Windows settings
  * Addressed an issue that would cause errors to not report correctly during the preparation stage
  * Addressed an issue where the colour space for normals in `PNG` and `JPG` was mistakingly `sRGB`

</details>

<details>

<summary>Version 24.3.2</summary>

* GUI changes
  * New queue system
    * Added ability to create multiple jobs and then run them in sequence
    * Queue supports pausing jobs and skipping job to then continue to next in queue
    * Added configuration button for handling user input after job creation
    * Added details panel to see more meta information for a job
  * Added ability to select multiple texture resolutions when configuring a job
  * Added button to see license information & details for Marso
  * Added ability to keep intermediary files in Application Settings
  * Added storage utilisation chart to Application Settings
* Results improvements
  * Added a filtering system to remove artefacts in scans with non optimal distributions
* Bugfixes:
  * Addressed crash when attempt to calibrate some Phase One RAW image files
  * Addressed issue where some submodules would hang at the end of execution rather than closing normally

</details>

<details>

<summary>Version 24.3.1</summary>

* GUI changes
  * Added progress bar to indicate sub-step progress for running job
  * Added ability to interrupt and resume from last checkpoint
  * Added scan mode indicator to job row
* Bugfixes
  * Fixed an issue where some errors would cause the program to hang and not report the error
  * Added clear error for when updater/installer is not present

</details>

<details>

<summary>Version 24.3.0</summary>

* Updates to backend
  * Improvement in processing speed (\~1.2-2.0 x)
  * Improvement in storage utilisation (\~2.0 x)
* GUI changes:
  * Added display for details of currently selected light system
  * Added display of reconstruction tool to job row alongisde resolution
* Bugfixes:
  * Fixed an issue with the results button not always opening the folder
  * Fixed an issue where the uv bleed was not applying to the normals output texture
  * Fixed an issue with the build system which would cause Marso to not run on some systems due to a non bundled dependency

</details>

<details>

<summary>Version 24.2.2</summary>

* Bugfixes:
  * Fixed camera ordering issue for some Reality Capture alembics
  * Fixed issue with UV margin algorithm for very dark textures
  * Fixed ST map loading for uncommon size combinations
* Added and improved UV margin algorithm

</details>

<details>

<summary>Version 24.2.1</summary>

* UX improvements
  * Step reporting during processing
  * Links to help pages for calibration
  * UV Resolution can be set by user
  * Enabled removing materials
  * Enabled resizing on UI windows
* Bugfixes
* Added UV margin to Output Textures
* Photogrammetry images output at default brightness
* Marso checks for new versions on launch

</details>

<details>

<summary>Version 24.2.0</summary>

* Reality Capture support
* UX improvements
  * Verbose logging from UI
  * Option to control display brightness during calibration process
* Improvements to crash handling
* Support for rotated cameras (i.e. portrait and landscape)
* Database Upgrade

</details>

<details>

<summary>Version 24.1.1</summary>

* Preprocessing accounts for rotation parameter in Raw data

</details>

<details>

<summary>Version 24.1.0</summary>

* Removed dependency on Agisoft Pro installation
* Several under the hood improvements to output textures
* Performance improvements to some modules
* Support for photogrammetry not solving all cameras in a scene
* Support for varying numbers of lights used in scanning light system
* Added ability for user to specify the grey value of their calibration target
* Added some security improvements
* Added support for mobile scans

</details>