Configuration

Les fonctions proposées par Gwyddion conservent les valeurs des paramètres entre les différentes appels ou d'une session à une autre. Ces valeurs sont spécifiées dans un fichier de configuration. Ce fichier contient aussi quelques paramètres liés au programme.

L'enregistrement de la configuration se fait dans le fichier settings du répertoire utilisateur, c'est-à-dire dans ~/.gwyddion (Unix) ou Documents and Settings\gwyddion (MS Windows). Le fichier n'est lu que lors du lancement de Gwyddion, et écrit lors de sa fermeture. Gardez cet aspect en tête si vous souhaitez modifier manuellement ce fichier. Les entrées inconnues du fichier sont ignorées mais conservées.

Le fichier de configuration démarre avec la ligne d'en-tête

Gwyddion Settings 1.0

suivies par les lignes pour chaque paramètre et la valeur associée (formant, techniquement parlant, un GwyContainer sérialisé). Gwyddion écrit les entrées dans l'ordre alphabétique, mais cela n'est pas obligatoire, et vous pouvez ne pas conserver cet ordre lorsque vous modifiez le fichier.

Chaque ligne de paramètre est de la forme

"clef" type valeur

Les réglages des modules commencent par /module/nomdumodule, bien que dans certains cas la partie correspondant au nom du module ne corresponde pas exactement au nom du module ; soit parce que plusieurs modules partagent le même réglage, soit pour des raisons historiques. Les réglages du programme commencent par /app/. Les valeurs possibles sont listées dans le tableau qui suit.

TypeDescription
booléen Valeur logique pouvant être soit True soit False.
caractère Caractère unique. Les caractères normaux sont directement représentés par un caractère unique. Les caractères spéciaux sont représentés par la notation hexadécimale 0xXX. Ce type de paramètre n'est pas couramment utilisé par les modules.
int32 Entier 32 bits signé. Gwyddion l'écrit sous forme décimale mais il peut ausi lire d'autres formats telle que la notation hexadécimale.
int64 Entier 64 bits signé. Gwyddion l'écrit sous forme décimale mais il peut ausi lire d'autres formats telle que la notation hexadécimale.
double Nombre à virgule flottante. Il peut être sous la forme scientifique, par exemple 1.23e-4. Il est donné au format C/POSIX, c'est-à-dire que le caractère décimal est le point (pas de virgule ou d'autre caractère).
chaîne de caractères Chaîne de caractères entre guillemets droits, généralement encodé au format UTF-8. Les caractères spéciaux, incluant les guillemets droits inclus dans une chaîne, peuvent être introduits à l'aide de la barre oblique inversée (antislash).

Quelques options utiles du programme peuvent être modifiées en éditant le fichier de configuration :

ClefTypeDescription
/app/restore-tool-positionbooléen En le réglant sur True, Gwyddion enregistre non seulement la taille des boîtes de dialogue des outils, mais aussi leur position (lorsque cela est possible). Cette option peut être gênant si votre gestionnaire de fenêtre fonctionne correctement, mais elle peut s'avérer utile si vous travaillez sous MS Windows.
/app/3d/axes/disablebooléen En le réglant sur True, les labels des axes ne sont plus affichés dans la vue OpenGL 3D, même si ceux-ci sont activés. Cela peut vous être utile si vous êtes confronté à une combinaison pilote/carte/GtkGLExt posant problème et avec laquelle Gwyddion peut planter en tentant de dessiner les axes.
/app/help/user-guide-basechaîne de caractères Localisation du guide utilisateur pour l'aide. Si celle-ci n'est pas définie, la version en ligne est utilisée, c'est-à-dire qu'un lien semblable à "http://gwyddion.net/documentation/user-guide-fr", sera lancé. Si vous souhaitez utiliser une copie locale du guide HTML, définissez dans cette entrée le nom du répertoire, par exemple "/home/yeti/docs/gwyddion-user-guide-xhtml-en-2014-09-17".