Функции модулей в Gwyddion запоминают значения параметров между вызовами и между сеансами работы с программой. Место хранения этих параметров называется настройками. Настройки также содержат некоторое количество параметров, относящихся к основной программе.
Постоянным хранилищем настроек является файл settings в каталоге пользователя, что обычно означает каталог ~/.gwyddion (в Unix) или Documents and Settings\gwyddion (в MS Windows). Этот файл читается только при старте программы и записывается при завершении её работы. Следует иметь это в виду если вы собираетесь исправить что-то в нём вручную. Неизвестные настройки в этом файле игнорируются, но сохраняются.
Файл настроек начинается с магической строки заголовка
Gwyddion Settings 1.0
за которой следуют строки с отдельными параметрами и значениями (которые формируют, технически, переведённый в последовательный вид GwyContainer). Gwyddion записывает элементы в алфавитном порядке, но это не является обязательным требованием и вам не нужно сохранять этот порядок при модификации файла.
Каждая строка параметров записывается в форме
"key"typevalue
Типичные ключи настроек модуля начинаются с /module/, хотя в некоторых случаях часть имени модуля не является по сути именем, либо потому что несколько модулей разделяют общие настройки, либо по причинам исторического характера. Ключи настройки самой программы начинаются с modulename/app/. Все возможные типы значений перечислены в следующей таблице.
| Тип | Описание |
|---|---|
| boolean | Логическое значение, может быть либо True, либо False. |
| char | Один символ. Обычные символы представлены напрямую одним символом. Специальные символы представлены в шестнадцатеричной нотации как 0x. Этот тип параметров практически не используется в модулях. |
| int32 | 32битное целое со знаком. Gwyddion записывает их в десятичной нотации, но читает также другие виды, например, шестнадцатеричную. |
| int64 | 64битное целое со знаком. Gwyddion записывает их в десятичной нотации, но читает также другие виды, например, шестнадцатеричную. |
| double | Число с плавающей точкой. Может быть в научном представлении, т.е. 1.23e-4. Они представлены в стандартной локали C/POSIX, т.е. десятичным разделителем является точка (а не запятая или что-нибудь другое). |
| string | Строка символов в двойных кавычках, в общем случае в кодировке UTF-8. Специальные символы, включая вложенные двойные кавычки, экранируются используя стандартную нотацию с обратной чертой. |
Некоторые потенциально полезные общепрограммные настройки, которые можно изменить в файле настроек:
| Ключ | Тип | Описание |
|---|---|---|
| /app/restore-tool-position | boolean | Если установлено в True, Gwyddion восстанавливает не только размеры диалогов инструментов, но и их размещение на экране (если это получается). Для хороших оконных менеджеров это скорей раздражает, чем помогает, но в MS Windows может оказаться полезным включить эту настройку. |
| /app/3d/axes/disable | boolean | Если установлено в True, подписи осей не будут рисоваться в окнах трёхмерного просмотра OpenGL, даже если они включены. Это может помочь с некоторыми проблемными комбинациями видеодрайвера/видеокарты/GtkGLExt, с которыми Gwyddion падает при попытке отрисовки этих осей. |
| /app/help/user-guide-base | string | Место размещения руководства пользователя для работы справочной системы. Если не задано, будет использоваться значение по умолчанию, указывающее на онлайновую версию, т.е., нечто вроде "https://gwyddion.net/documentation/user-guide-en", в зависисмости от языка. Если вы хотите использовать локальную версию руководства пользователя в формате HTML, установите это значение в название каталога, например, "/home/yeti/docs/gwyddion-user-guide-xhtml-en-2014-09-17". |