1. Informations générales
Les fichiers de configuration dans le sens d'OMSI sont des fichiers texte qui définissent l'interaction entre le modèle (fichiers 3D, souvent appelés mesh), les textures et les scripts. Ils peuvent être ouverts avec des éditeurs de texte courants, le Notepad++ (gratuit) a fait ses preuves. En principe, on peut dire que toutes les informations qui peuvent être converties en texte clair (à l'exception des scripts) sont définies dans des fichiers de configuration.
L'extension (cf. formats de fichiers) des fichiers de configuration varie, les extensions "classiques" sont cfg, sco, sli, bus et ovh.
2. Mots-clés (= Schlüsselwort)
Comme pour les langages de programmation, les fichiers de configuration contiennent des mots-clés qui varient en fonction du type de fichier. Il peut y avoir autant de mots-clés différents que l'on veut par fichier (selon le format attendu). Presque tous les mots-clés sont placés entre crochets (à l'exception, par exemple, du fichier de hof). Tout ce qui se trouve en dehors des mots-clés ou des blocs appartenant à des mots-clés est ignoré par OMSI.
OMSI reconnaît les mots-clés en fonction de la casse, ce qui signifie que les majuscules et les minuscules des mots-clés doivent correspondre exactement
.
La convention générale est de toujours laisser au moins une ligne vide avant et après les mots-clés afin d'indiquer clairement les blocs qui vont ensemble :
Il existe les types de mots-clés suivants :
2.1. Seul
Ils sont indépendants et n'ont besoin d'aucune autre information.
2.2. Nombre fixe de paramètres
Mots-clés nécessitant des indications supplémentaires, par exemple des noms de fichiers, des valeurs, etc. Ces paramètres peuvent être des caractères, des chaînes de caractères et/ou des nombres à virgule flottante (avec point décimal !). Le nombre est toujours fixe par mot-clé. Au sens strict, les mots-clés isolés sont un cas particulier de ce type (0 paramètre).
Un mot-clé avec un paramètre de string:
[mesh]
MeinMesh.o3d
Un mot-clé avec 4 paramètres à virgule flottante:
[profilepnt]
1.5
0.1
1
-0.1
Un mot-clé avec 4 paramètres de type différent:
[char]
A
242
262
02.3. Nombre variable de paramètres
Pour certains mots-clés, la longueur du bloc est dynamique. Dans ce cas, le premier paramètre du mot-clé détermine le nombre d'entrées suivantes.
Un mot-clé suivi de 3 paramètres:
[stringvarnamelist]
3
script\IBIS_stringvarlist.txt
script\Rollband_stringvarlist.txt
script\cockpit_stringvarlist.txt
Dans de rares cas, il peut être nécessaire de ne pas passer de paramètres au mot-clé.:
[global_strings]
02.4. Commande explicite END
Pour les mots-clés qui contiennent un texte plus long (p. ex. des descriptions pour le joueur), la méthode mentionnée précédemment n'est pas très utile. Dans ce cas, la fin d'un bloc est marquée par un [end] explicite.
[description]
Données techniques d'un bus
Longueur: 11.490 mm
Largeur: 2500 mm
Hauteur: 4060 mm
Moteur: MAN D2566MUH, 141 kW bei 2100 U/min
Boîte de vitesses: Voith D851
...
[end]3. Structure
La règle est toujours la même : le mot-clé doit être seul sur une ligne. Ainsi, il ne doit pas y avoir d'espace ou d'autres caractères avant ou après le mot-clé. Si cela a été fait, la commande est considérée comme commentée et n'a donc aucune signification. Les commentaires peuvent être écrits avant, entre ou après les mots-clés.
Dans cet exemple :
- [Schlüsselwort] : 3 lignes supplémentaires sont lues.
- [absheight] : 0 lignes supplémentaires sont lues
- [description] : jusqu'à la commande [end].
- [script] : une ligne supplémentaire. Ce nombre détermine ensuite combien d'autres chiffres seront lus
Das ist ein Kommentar
C'est un commentaire
[Schlüsselwort]
0.1
envmap.bmp
3
Cette ligne est à nouveau un commentaire, car à partir du mot-clé, seules 3 autres lignes sont lues
Kommentar
[absheight]
Il s'agit d'un commentaire, car le mot-clé est seul.
[description]
Ce bus est... et peut ...
Longeur: ...
Hauteur: ...
...
Il n'y a PAS de commentaire ici, car la commande [end] n'a pas encore été suivie.
[end]
Il y a de nouveau des lignes de commentaires ici
[absheight]
^ Ce n'est pas un mot-clé valable, car la ligne commence par un tabulateur.
[Schlüsselwort]
^ Ce n'est pas non plus un mot-clé, car la ligne commence par un espace. Par conséquent, les trois lignes suivantes sont également ignorées.4. Utilisation des fichiers de configuration
Les fichiers de configuration sont utilisés pour ce qui suit :
- Listes de AI
- fichiers global.cfg pour les cartes
- Routes de signalisation
- Fichiers de lignes de temps pour les cartes
- Configurations monétaires
- Configurations de textures
- fichiers model
- Configurations de sièges
- Configurations de chemin
- Configurations de nuages
- envir.cfg
- Options
Cette liste n'est en aucun cas exhaustive. Comme décrit précédemment, presque toutes les données qui ne sont ni des scripts (.osc), ni des fichiers de modèles (.x, .o3d), ni des fichiers d'images/de sons sont considérées comme des données de configuration dans OMSI.
