Sequoia Configuration

  • A number of SEQUOIA settings are user-configurable.

  • The settings and their values are defined and stored in several places:

    • Factory Defaults

      • The initial value of each setting is hard-coded in the Sequoia executable.

      • These are the fallback values in case the sources below are damaged or missing.

      • This definition also contains all metadata like value ranges and descriptions.

    • Constants File

      • The same values are provided in a human-editable file called “sequoia_constants.json” in the root folder of Sequoia.

      • While the file is normally write-protected, it could be modified by power users to tweak the metadata like value ranges and descriptions.

    • Customized Settings

      • The changes applied via the Configuration dialog described below are stored in an INI file in the User’s Local Roaming account folder.

      • Only the setting name and value are stored, the metadata like tooltips or allowed ranges is read from one of the two above sources.

      • When SEQUOIA is started, it will attempt to update the settings initialized from the above two sources with the values from the INI file.

      • If this information is missing, the system will fall back to the Constants File; if it is also missing, the Factory Defaults will be used.

    • Setting Presets

      • In addition to the latest settings stored in the User’s Local Roaming account folder, the user can save and load custom presets containing all settings.

      • These files can be named and saved, shared with other users, loaded on demand and generally used to quickly switch SEQUOIA to a custom configuration.

  • If one of the above sources is corrupted or missing, a warning message will be displayed, however SEQUOIA will still launch and function propertly using the Factory Defaults.

The Sequoia Configuration Dialog

  • To open the Sequoia Configutation Dialog, select Main Menu > Options > CONFIGURATION…

  • A dialog similar to the Map Keyboard Bindings dialog will open:

../../_images/configuration_dialog.png

Configuration Level

  • The Configuration dialog offers three levels, controlled by the radio buttons on top.

    • User Level - these are the most often needed controls for end users.

    • Advanced Level - in addition to the User Level controls, a few more settings for power users will be displayed.

    • Developer Level - in addition to all controls from the previous two levels, some deep controls meant mostly for developers that should normally not be touched anyway will be displayed.

Locating A Constant

  • To locate a specific setting, either

    • Scroll through the list until you find the desired value;

    • Type a part of the Setting or Category name in the text field above of list:

../../_images/configuration_dialog_advanced.png

  • In the above screenshot, all Advanced Level settings containing the token “View are listed.

Changing A Constant’s Value

  • To change a setting, slect a line from the list.

    • If it is a Numeric value, type in a new value or use the slider to increase/decrease the value.

    • If it is a Boolean value, change the state of the Checkbutton.

    • If it is a Text value, type in the new text.

Resetting A Value

  • To reset the shortcuts of the currently selected command to the factory defaults, press the [Reset Value] button.

Resetting All Values

  • To restore all settings to the default / factory default settings, press the [Restore Defaults] button.

  • The settings will be taken from the sequoia_constants.json file, or if it is corrupted or missing, from the factory defaults hard-coded in the executable.

Saving A Settings Preset

  • To save the current settings to an .SCD file, press the [Export…] button.

Loading A Settings Preset

  • To load previously saved bindings from disk, press the [Import…] button and pick an existing .SCD file.

  • Note that all current settings will be lost - if you want to back them up, first save a Settings Preset before loading a new Preset.

Applying, Rejecting And Closing The Dialog

  • The Configuration dialog is modeless - you can change the settings interactively and press the [Apply] button to apply them to the running SEQUOIA session.

  • Pressing the [Cancel] button will close the dialog AND restore all settings to their values before the dialog was opened.

  • To close the dialog AND accept all changes to settings made while it was open, press the [OK] button.