.. include:: ../substitutions.txt

.. _preferences:

===========
Preferences
===========

From preferences dialog you can tweak |m| user interface (or client-side) configuration. 
They are related to the computer running a |m| client and will not be saved on any instrument.

The first entry, ``ConfigurationFile``, is the location where |m| stores its configutaion's details.

Everytime you change something, you should press ``Save`` to ensure that all changes have been saved.

The ``Reload`` button allows you to reload the configuration if, for example, something went wrong after a change.

``Open`` button shows a dialog to locate and load another existing configuration.


.. image:: ../art/preferences.png
	:scale: 70%

--------
Main Tab
--------

The ``Main`` tab contains general configuration options.

- ``Client Language`` allows to select the interface language
- ``Remote Server Refresh Rate (ms)`` lets you change the frequency, in milliseconds, 
  of data update from server, if you are connected to a server (in an offline environment, you can ignore this option)
- ``Default Database`` is the location of the default tests database (see :ref:`database`)
- ``Auto-download finished tests``: when connected to a server, this option defines if a test should be downloaded locally or not when it finishes.
- ``Recent Servers`` is the number of recent servers to be remembered
- ``Save User/Password bu Default`` defines if, when connecting to a server, the password should be saved or not
- ``Recent Database Files``: the number of databases to remember in the list of last used databases
- ``Recent Test Files``: the number of tests to remember in the list of last opened tests
- ``Recent Misura3 Databases``: the number of |m| 3 databases to remember in the list of last opened |m| 3 databases
- ``Log files directory``: the location to place log files
- ``Logging level``: from 0 to 50, defines the amount of logging (0 -> notheng, 50 -> everything)
- ``Size of each log file``: the size of a log file, after which, the log file is archived
- ``Max number og logfiles to be kept``: when the number of log files exeeds this number, the oldest log file is deleted
- ``Measurement units``: a table that defines, for every |m| dataset, its unit


------------
Misura 3 Tab
------------

This tab contains only the ``Enable Misura 3 database interface`` flag, that enables/disables |m| capabilities to import |m| 3 databases.