﻿# Configuration with INI-File

> [HTML Version](configuration_with_ini-file.html)

Some configuration of the software can be done using ‘mesys.ini’ in the installation folder.

Currently the settings are used for database access and formatting of the report.

| Section | Value | Description |
|------|------|------|
| General | recentfilenumber | Number of recent files shown in the file menu of the software |
|  | floatinglicense | Path to the licensing file for floating license. It will be written by the software but might be copied to other installations.<br>Format: \\\\\\\\Server\\\\Share\\\\path\\license.lic<br>Note: Each ‘\\’ has to be doubled. |
|  | floatingtimeout | Time in seconds after a floating license is release if the program is not used. Default is 1800. |
|  | licenselogfile | For floating licenses a logfile can be defined using this entry. Some information about software usage is reported in this file.<br>For path separators either use ‘/’ or ‘\\\\’ but not ‘\\’. |
|  | fontsize | Fontsize in points, set 0 for default, dependent on operating system. |
|  | style | Either 'windows11', 'fusion', 'windowsvista'. <br>'windows11' and 'fusion' support a dark mode, 'windowsvista' does not. |
|  | classicicons | Set to true for colored icons of previous version. these are only used in light mode, not in dark mode. |
|  | listseparator | Character used as separator for table export. If not set the default setting in operating is used. |
|  | systemlocale | Set to true for decimal point of operating system or false for ‘.’ as decimal separator. |
|  | usecalculatethread | If set to true calculation is done in a separate thread, else set to false. |
|  | ffmpegpath | Path to the program ffmpeg to create videos from animations. It can found at [www.ffmpeg.org](http://www.ffmpeg.org)<br>For path separators either use ‘/’ or ‘\\\\’ but not ‘\\’. |
|  | helpFormat | Use "CHM" to use "mesys.chm" to display the help information. This might not work over the network. Then "WEB" can be used to show the help in a web browser. Using "EXE" a custom viewer "MesysManual" is used which also works on network shares.<br>Another option is "HTML" which would look for the help in subfolder "help", please contact [support@mesys.ch](mailto:support@mesys.ch) in this case as the folder is not provided in the default installation. |
|  | allownesteddockwindows | If set to true, docked windows can be set in several columns. The default is false. |
|  | disablewheelforlists | If set to true, the wheel on a mouse does not change selection inputs. |
|  | showcalculationtime | Shows the time needed for a calculation in the status bar if set to true. |
| database | path | The path to the database file can be defined. The database can be copied onto a server, so all software users share the same database. If the filename is given without path, it is opened from the installation directory.  <br>For path separators either use ‘/’ or ‘\\\\’ but not ‘\\’. |
|  | iswritable | Set it to true if the database may be changed. If set to false no changes are made to the database by the software. |
|  | usecache | If set to true the database is read to memory. This speeds up the program in case the database is on a network drive. Default is false. |
| importdatabases | path\_1 | A path to additional databases can be defined. These additional databases are read only and optionally encrypted. If the filename is given without path, it is opened from the installation directory.<br>For path separators either use ‘/’ or ‘\\\\’ but not ‘\\’. |
|  | password\_1 | The password for the encrypted database |
| shaft | defaultinputs | Path to a xml-file with default settings<br>For path separators either use ‘/’ or ‘\\\\’ but not ‘\\’. |
|  | preloadcadlibrary | If set to true, the cad library is loaded on program startup. Then importing a STEP file is faster afterward's. |
|  | calculateonfileload | If set to true the calculation is run when a file is loaded. Default is true. |
|  | acceptfiledrop | If set to true a \*.xml input file can be loaded by dropping it on the main window |
|  | logo | A logo for use on the system page can be defined here. The format has to be PNG. |
|  | backupinterval | Interval in seconds to save backup files in TEMP directory |
|  | backupstates | Number of backup states to keep. Use zero to disable automatic backup files. The backup files are deleted after file open, file save or file new. |
|  | numberofthreads | The number of threads that should be used in FEA calculations. The default is the number of physical cores. |
|  | feamaxmemory | The maximum amount of memory in MB used by the fea solver. If more memory is required it will be swapped to disk. |
|  | feaswappath | Path of a directory for the swapfile for FEA calculation in case not enough memory is available. Default is the temp directory of the operating system. Using this setting a fast drive with enough space can be used instead. |
|  | feamaxtotalmemory | The maximum amount of memory in MB used by the fea solver. If more memory would be required by the solver, the calculation is canceled.<br>Using this setting instead of 'feamaxmemory' avoids swapping to disk and therefore much longer calculation times. On error the mesh sizes would have to be changed. |
|  | externalcondensationcommand | A path to an executable can be specified to be run for condensation of 3D-elastic parts. This can start MesysShaft of a remote server to run a condensation faster.<br>For path separators either use ‘/’ or ‘\\\\’ but not ‘\\’. |
|  | externalcondensationparameters | The parameters for the external program above can be specified here. A placeholder %1 will be replaced by the filename of a temporary file. |
| rbc | defaultinputs | Path to a xml-file with default settings<br>For path separators either use ‘/’ or ‘\\\\’ but not ‘\\’. |
|  | calculateonfileload | If set to true the calculation is run when a file is loaded. Default is true. |
|  | acceptfiledrop | If set to true a \*.xml input file can be loaded by dropping it on the main window. |
|  | logo | A logo for use on the system page can be defined here. The format has to be PNG. |
|  | backupinterval | Interval in seconds to save backup files in TEMP directory |
|  | backupstates | Number of backup states to keep. Use zero to disable automatic backup files. The backup files are deleted after file open, file save or file new. |
|  | allowcontactangleoverride | If set to true the contact angle for angular contact bearings from the database can be overwritten |
| ballscrew | defaultinputs | Path to a xml-file with default settings<br>For path separators either use ‘/’ or ‘\\\\’ but not ‘\\’. |
|  | calculateonfileload | If set to true the calculation is run when a file is loaded. Default is true. |
|  | acceptfiledrop | If set to true a \*.xml input file can be loaded by dropping it on the main window. |
|  | logo | A logo for use on the system page can be defined here. The format has to be PNG. |
|  | backupinterval | Interval in seconds to save backup files in TEMP directory |
|  | backupstates | Number of backup states to keep. Use zero to disable automatic backup files. The backup files are deleted after file open, file save or file new. |
| hertz | defaultinputs | Path to a xml-file with default settings<br>For path separators either use ‘/’ or ‘\\\\’ but not ‘\\’. |
|  | calculateonfileload | If set to true the calculation is run when a file is loaded. Default is true. |
|  | acceptfiledrop | If set to true a \*.xml input file can be loaded by dropping it on the main window |
|  | logo | A logo for use on the system page can be defined here. The format has to be PNG. |
|  | backupinterval | Interval in seconds to save backup files in TEMP directory |
|  | backupstates | Number of backup states to keep. Use zero to disable automatic backup files. The backup files are deleted after file open, file save or file new. |
| axrarbc | numberofthreads | The number of threads that should be used in FEA calculations. The default is 2. More threads have only a small impact on performance, but the calculation time is still reduced. |
|  | backupinterval | Interval in seconds to save backup files in TEMP directory |
|  | backupstates | Number of backup states to keep. Use zero to disable automatic backup files. The backup files are deleted after file open, file save or file new. |
| report | format | The outputted report file can have different formats. By default, this value is equal to “INTERNALPDFA”, but it can be set to "INTERNALPDF", “DOCX”, “DOC”, ODT” or “PDF” (without quotes). |
|  | topmargin | The top margin for the report in mm |
|  | bottommargin | The bottom margin for the report in mm |
|  | leftmargin | The left margin for the report in mm |
|  | rightmargin | The right margin for the report in mm |
|  | papersize | The size of the paper for the report. Available values are A4 and Letter |
|  | template | Path to the created template file used for the report creation. Supported file formats: “DOCX”, “DOC” or “ODT” |
|  | logo | A different logo can be defined, which will be used in the report. The format had to be PNG. |
|  | showfilename | If set to "yes" the file name will be shown including path in the report header.<br>If set to "no", the file name will not be shown.<br>If set to "short" the file name without path will be used. |
|  | marginbox1\\active | The marginbox is used if set to true, else set it to false. |
|  | marginbox1\\rect | The size of the marginbox is defined with values in mm. The format is @Rect(x1 y1 width height). The parameters x1 and y1 describe the upper left corner of the box. Positive values are measured from the top/left negative values from the bottom/right.<br>For example @Rect(-35 -20 30 20) is a rectangle at the right bottom. |
|  | marginbox1\\text | The text for the margin box. It has to be set in quotations marks (like in “Text”). Either normal text or HTML can be used.<br>Some placeholders are defined: #page, #pageCount, #data, #datetime |
|  | marginbox1\\angle | A rotation angle of the margin box can be set in degrees. The orientation of the angle is clockwise if positive. |
|  | marginbox1\\isHtml | Either set it to true or false dependent on the type of text. |
|  | marginbox1\\drawBox | If set to true a rectangle is drawn indicating the size of the marginbox. Else set it to false. |
|  | marginbox2\\... | Like for margin box 1 additional boxes can be defined with increasing numbers. |




Please note that the listed options for margin boxes (marginbox1\\...) are only valid if format is equal to “INTERNALPDF”. 