Q100730: How to edit the missing Navigation Preferences in Mari 7.5v1

SYMPTOMS

In Mari 7.5v1, some navigation preferences are missing from the UI, under Edit > Preferences > Navigation.  

In Mari versions prior to 7.5v1, there are four sections in the navigation preferences: General, Orbit, Roll and Transform.


In Mari 7.5v1, Orbit, Roll and Transform are no longer visible, while General can still be seen.


While these navigation preferences are not visible in the UI, they can still be edited via Mari’s user configuration file, which will be discussed in the Resolution section of this article. 

 

CAUSE

This is a known issue, and has been logged to our internal database. To learn more and check on the progress of this bug, please see the following report in our Bug Tracker:

ID 611409 - Some Navigation Preferences are missing from the UI

 

RESOLUTION

There are three methods that can be used to work around this issue. The first two require using an older version of Mari to access the complete list of navigation preferences. 

The first method is suitable if you don’t mind resetting all user settings across Mari 7.5v1 to their default. 

The second method is suitable for when you have already changed some options in Mari 7.5v1 and you do not want to lose your customisations.

The third method is only recommended for users who feel comfortable editing Mari’s config file manually.

 

Mari’s Config 

All changes applied to Mari by the user - be that Preferences, tool properties, custom shelves, shortcuts, or layouts - are stored in files inside a folder called TheFoundry, so that they persist across Mari sessions. We will be working with the config file, which is called Mari7.5v1 and it’s where Preferences are saved.

The config file for Mari 7.5v1 can be found in the following directories respective of your OS: 

Windows: C:\Users\<USERNAME>\.mari\TheFoundry
Linux: /home/<USERNAME>/.config/TheFoundry

Inside the TheFoundry folder, you will find a Mari7.5v1 file (the extension will be .ini for Windows and .conf for Linux). This is the config file.

More information can be found here:
Q100723: Mari's user configuration files and where to find them

 

Method 1 - Importing a whole old config into Mari 7.5v1

This issue only applies to Mari 7.5v1, meaning that it is still possible to find and edit all navigation preferences via the UI in previous versions of Mari. With this in mind, it is possible to work around the issue by launching an older version of Mari, changing the preferences, and then importing these preferences into Mari 7.5v1. The instructions are as follows:

  1. Launch an older version of Mari, such as Mari 7.1v2. 
    You can download older versions of Mari here: https://downloads.foundry.com/mari/previous
     
  2. In Mari 7.1v2, navigate to Edit > Preferences > Navigation. There you will see the options under Orbit, Roll and Transform. Change these preferences to suit your needs and then select Ok.
     
  3. Close Mari 7.1v2. 
     
  4. Rename the Mari7.5v1 config file or move it out of the TheFoundry folder, so that Mari can’t find it but you keep a backup of it.
     
  5. Launch Mari 7.5v1. You will be prompted with a dialog asking whether you would like to import your preferences from Mari 7.1v2. Select Yes

This will import your settings, including the navigation preferences that are no longer available to edit in the Preferences UI. 

 

Method 2 - Pasting into an existing Mari 7.5v1 config

To edit the navigation preferences without losing other customisations you have already set in Mari 7.5v1, you will need to paste these preferences into Mari 7.5v1’s existing config file.

This method requires you to edit the navigation preferences in an older version of Mari, open the config file for this version, copy the navigation preferences and paste them into Mari 7.5v1’s config file. The step-by-step instructions are as follows:

  1. Launch an older version of Mari, such as Mari 7.1v2. 
    You can download older versions of Mari here: https://downloads.foundry.com/mari/previous
     
  2. In Mari 7.1v2, navigate to Edit > Preferences > Navigation. There you will see the options under Orbit, Roll and Transform. Change these preferences to suit your needs, then select Ok.
     
  3. Close Mari 7.1v2. 
     
  4. Navigate to the TheFoundry folder and open the Mari7.1v2 and Mari7.5v1 config files in a text editor (the extension will be .ini for Windows and .conf for Linux).
     
  5. Copy and paste the navigation preferences from the 7.1v2 config file to the 7.5v1 config file. You may find this information helpful:
    • The navigation preferences are in three separate blocks: [Navigation] , [GeoOrbitTool] and [GeoRollTool]
    • Copy entire blocks of preferences  over to the Mari 7.5v1 config, instead of picking and choosing single lines.
    • If these blocks already exist in the Mari7.5v1 config file, replace their content instead of having duplicated blocks.
    • Preference blocks are listed in alphabetical order by default, but you don’t need to follow this.
  6. Save the changes to the Mari7.5v1 config file and launch Mari 7.5v1.

You should now have all of your Mari 7.5v1 customisations, as well as the navigation preferences set to how you would like them.

 

Method 3 - Writing your preferences into the Mari 7.5v1 config

  1. With Mari 7.5v1 closed, locate and open the config file for Mari 7.5v1 in a text editor.
     
  2. Use this table to manually add or edit the preferences you need:
UI in Mari Preferences in Config

[Navigation] 
momentumEnabled=false 
minimumSpeed=@Variant(\0\0\0\x87?aG\xae)
friction=@Variant(\0\0\0\x87?\x80\0\0)
controlType=Modo
steppingAngle=21
 

[GeoOrbitTool]

flags=3 (Lock to World Up = off)

flags=7 (Lock to World Up = on)

centerMode=2 (Look At=1; Objects=2; Origin=3; Selection=4)

[GeoRollTool]

flags=1 (Toggled Off)

flags=3 (Toggled On)

 

  1. Save the changes made to the Mari7.5v1 config file and launch Mari 7.5v1. 

 

FURTHER HELP

If you are experiencing difficulties please create a Support ticket and provide us with the information requested in this article:
Q100090: Reporting a Mari issue

For more information on how to open a Support request, please refer to this article:
Q100064: How to raise a support ticket


 

    We're sorry to hear that

    Please tell us why