Функции модулей в Gwyddion запоминают значения параметров между вызовами и между сеансами работы с программой. Место хранения этих параметров называется настройками. Настройки также содержат некоторое количество параметров, относящихся к основной программе.
Постоянным хранилищем настроек является файл settings
в каталоге пользователя, что обычно означает каталог ~/.gwyddion
(в Unix) или Documents and Settings\gwyddion
(в MS Windows). Этот файл читается только при старте программы и записывается при завершении её работы. Следует иметь это в виду если вы собираетесь исправить что-то в нём вручную. Неизвестные настройки в этом файле игнорируются, но сохраняются.
Файл настроек начинается с магической строки заголовка
Gwyddion Settings 1.0
за которой следуют строки с отдельными параметрами и значениями (которые формируют, технически, переведённый в последовательный вид GwyContainer). Gwyddion записывает элементы в алфавитном порядке, но это не является обязательным требованием и вам не нужно сохранять этот порядок при модификации файла.
Каждая строка параметров записывается в форме
"key
"type
value
Типичные ключи настроек модуля начинаются с /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 | Место размещения руководства пользователя для работы справочной системы. Если не задано, будет использоваться значение по умолчанию, указывающее на онлайновую версию, т.е., нечто вроде "http://gwyddion.net/documentation/user-guide-en" , в зависисмости от языка. Если вы хотите использовать локальную версию руководства пользователя в формате HTML, установите это значение в название каталога, например, "/home/yeti/docs/gwyddion-user-guide-xhtml-en-2014-09-17" . |