Editer un fichier Technics.ini : Différence entre versions

De SEOW Wiki FR
Sauter à la navigation Sauter à la recherche
 
(10 révisions intermédiaires par le même utilisateur non affichées)
Ligne 5 : Ligne 5 :
 
Les fichiers Technics sont des fichiers de configuration interne qui déterminent les comportements des objets sol (mobiles et stationnaires). Des paramètres comme l'épaisseur de blindage, la rapidité de mouvement, les portées de tir et beaucoup d'autres paramètres se trouvent dans le fichier Technics. Le fichier d'origine d'IL2 comportent certains défauts pour beaucoup de scénarios particuliers, quelquefois même de simples erreurs typographiques. Ce qui signifie que les concepteurs de campagne doivent adapter ces valeurs dans certains cas de figure. Par exemple, une campagne comportant des combats en zone urbaine nécessitera sans doute une réduction des portées de tir des blindés pour permettre une revalorisation de l'infanterie. Ou, pour une campagne en été sur des routes en bon état, le concepteur souhaitera augmenter la vitesse de certains véhicules pour leur donner un avantage.
 
Les fichiers Technics sont des fichiers de configuration interne qui déterminent les comportements des objets sol (mobiles et stationnaires). Des paramètres comme l'épaisseur de blindage, la rapidité de mouvement, les portées de tir et beaucoup d'autres paramètres se trouvent dans le fichier Technics. Le fichier d'origine d'IL2 comportent certains défauts pour beaucoup de scénarios particuliers, quelquefois même de simples erreurs typographiques. Ce qui signifie que les concepteurs de campagne doivent adapter ces valeurs dans certains cas de figure. Par exemple, une campagne comportant des combats en zone urbaine nécessitera sans doute une réduction des portées de tir des blindés pour permettre une revalorisation de l'infanterie. Ou, pour une campagne en été sur des routes en bon état, le concepteur souhaitera augmenter la vitesse de certains véhicules pour leur donner un avantage.
  
Voici la solution: Dans une mission coopérative, le réglage du fichier Technics du host s'impose à tous les joueurs connectés. Cela signifie qu'il est facile pour le concepteur de campagne de développer un fichier Technics adapté à sa campagne et tous les participants observeront les mêmes comportements en jeu des unités sol. Il est également possible de fournir ce fichier aux pilotes sous la forme d'un mode activable pour leurs entrainements. Le nouvel outil SEOW, le Technics Processor Tool, permet de simplifier l'édition de ce fichier long et complexe, d'exporter facilement de nouveaux fichiers Technics et d'éditer la base de données SEOW.
+
Voici la solution: Il est facile pour le concepteur de campagne de développer un fichier Technics adapté à sa campagne, de le proposer sous forme de mode activable (jsgme)et tous les participants observeront les mêmes comportements en jeu des unités sol. Le nouvel outil SEOW, le Technics Processor Tool, permet de simplifier l'édition de ce fichier long et complexe, d'exporter facilement de nouveaux fichiers Technics et d'éditer la base de données SEOW.
  
== SEOW Technics Processor Tool (TPT) ==
+
== SEOW Outil Technics Processor Tool (TPT) ==
The TPT is available with all versions of the Mission Planner after v6.0.0. You can find TPT under the Tools page shown on the main MP screen. Please note that the TPT employs the DHTML5 File API, so at this stage it only works under Firefox (recommended) and perhaps Google Chrome. It will not work with Internet Explore or with Firefox/IETab. TPT has an optional setting (in the Technics/Technics_Configuration.php file) to enable/disable password authentication to use the tool. By default, the need for authentication is disabled ($TechnicsAuth = 0;). Authentication is enabled by setting $TechnicsAuth = 1;. If authentication is enabled users will need to supply the password defined in Technics/auth.js before they can use TPT.
+
Le TPT est compatible avec toutes les versions SEOW supérieures à 6.0.0. Cet outil se trouve sur la page d'accueil de SEOW dans l'onglet Tools (Outils). A noter que cet outil utilise le fichier DHTML5 API qui ne fonctionne que sous Firefox (recommandé) et peut-être sous Google Chrome. Il ne fonctionnera pas sous Internet Explore ou avec Firefox/IETab. TPT possède une option (dans le fichier Technics/Technics_Configuration.php) pour activer/désactiver un accès par mot de passe. Par défaut, cette option est désactivée ($TechnicsAuth = 0;). Si le mot de passe est demandé, les utilisateurs devront entrer le mot de passe défini dans le fichier Technics/auth.js.
  
Once authentication barrier is passed, the user will see a a page with a simple file loading dialog where they can navigate their LOCAL filesystem to select a starting technics.ini file. It is important to note that even though the TPT is located on a remote web server, it only ever operates on LOCAL files on the user's computer. There is no way to use TPT to edit (or hack) remote technics.ini files.
+
La fenêtre principale permet de charger un fichier Technics situé en local sur l'ordinateur. Il est important de noter que même si le TPT est situé sur un serveur en ligne, son action n'aura d'effet que sur les fichiers de l'ordinateur local. Ce qui peut permettre à n'importe quel joueur de l'utiliser sur son propre jeu. Il n'y a aucune possibilité de modifier à distance le fichier Technics du serveur.
  
The following picture shows the TPT after the user has navigated to and loaded a stock technics.ini file. Note that the standard "sepia" skin has been selected for the MP. TPT dynamically adjusts its colouring scheme to MP skin settings.
+
L'image suivante montre le TPT une fois le fichier technics.ini chargé. A noter que l'interface "sepia" a été choisie pour le MP, celle-ci se règle automatiquement en fonction des réglages choisis pour le MP principal.
  
 
[[Image:Technics_main.jpg]]
 
[[Image:Technics_main.jpg]]
  
Below the file loader dialogue, there is a single row of tool links, followed by a large data grid showing the data contained in the loaded technics.ini file. The data is grouped into 3 categories: '''gunnery''', '''armour''' and '''movement''', each of which is associated with a tool link. Only one category is displayed at any time; the display category can be changed simply by clicking on the relevant tool links above. Note that not all parameters in the technics.ini file are displayed by TPT, only a subset that are of most interest to campaign designers.
+
Au dessous de la boite de dialogue de chargement de fichier se trouvent une ligne d'onglets pour différents outils et au dessous un grand tableau présentant les données du fichier technics.ini. Les données sont classées en 3 catégories: '''gunnery''', '''armour''' et '''movement''', chacune d'elles est associée avec un outil correspondant. Une seule catégorie est affichée à l'écran, pour en changer, simplement cliquer sur la rubrique appropriée au dessus. A noter que tous les paramètres du technics.ini ne sont pas affichés par le TPT, seuls ceux présentant un intérêt pour les concepteurs de campagne sont présentés.
  
The list of tool links is:
+
La liste des outils est la suivante:
  
* '''reload''' : goes back to the loaded technics.ini file and reloads and refreshes all data values from this file; also resets display view to '''gunnery''' category.
+
* '''reload''' : Retour au fichier technics.ini original, toutes les valeurs modifiées sont effacées.
* '''gunnery''' : changes display view to '''gunnery''' category, with appropriate column headings.
+
* '''gunnery''' : Permute l'affichage sur la catégorie '''gunnery'''.
* '''armour''' : changes display view to '''armour''' category, with appropriate column headings.
+
* '''armour''' : Permute l'affichage sur la catégorie '''armour'''.
* '''movement''' : changes display view to '''movement''' category, with appropriate column headings.
+
* '''movement''' : Permute l'affichage sur la catégorie '''movement'''.
* '''toSQL''' : creates a list of SQL INSERT statements from data in the current category view that can be used to update relevant values in the SEOW Object_Specifications table in the database. This allows easy synchronization between the game technics.ini and related SEOW campaign information.
+
* '''toSQL''' : Crée une liste de requêtes SQL pour éditer rapidement la table Object_Specifications de la base de données SEOW. Cela permet une synchronisation entre le fichier technics.ini du jeu et les données correspondantes de SEOW.
* '''save''' : allows the user to save the current data set (under ALL categories simultaneously) in a new technics.ini file, using a local filesystem navigator.
+
* '''save''' : Permet à l'utilisateur de sauvegarder les données modifiées (de toutes les catégories en même temps) dans un nouveau fichier technics.ini.
* '''?''' : a help tool that displays definitions of the various editable parameters presented in the various categories of the data grid
 
  
Here is a picture of the '''?''' help tool:
+
[[Image: Technics_save.jpg]]
 +
 
 +
* '''?''' : Un outil d'aide affichant la description des différents paramètres présents dans le technics.ini affiché.
 +
La fenêtre est à défilement et permet d'afficher la description et les unités utilisées pour les différents paramètres.
  
 
[[Image: Technics_help.jpg]]
 
[[Image: Technics_help.jpg]]
  
This is a scrollable element that provides information on the definition and measurement units for every displayed data column in the three category views.
+
== Utilisation du tableau de données du TPT ==
 
 
Finally, the '''save''' tool displays a simple window that leads to a local filesystem navigator for choosing the saved Technics filename.
 
 
 
[[Image: Technics_save.jpg]]
 
 
 
== Using the Data Grid View of TPT ==
 
 
 
The main body of TPT is a displayed data grid view showing data of the chosen category. This looks a little like a spreadsheet, but it does not contain the same scripting engine of a spreadsheet (although it potentially could with some development effort). The library used to generate the data grid is '''dhtmlxGrid''' [http://dhtmlx.com/docs/products/dhtmlxGrid/index.shtml] which is very powerful and configurable.
 
  
In the current implementation of TPT, the data grid allows the following functions:
+
Ce tableau se présente comme un tableur simplifié affichant les différentes catégories de paramètres. La librairie utilisée est '''dhtmlxGrid''' [http://dhtmlx.com/docs/products/dhtmlxGrid/index.shtml] qui est très puissante et configurable.
  
* '''sort''' : each column of the data grid can be sorted alphanumerically by clicking on the column header. Repeated clicking cycles between ascending and descending sorts
+
Dans l'actuelle configuration, cette grille de données permet les fonctions suivantes:
* '''edit''' : each data value can be edited by double-clicking and entering the desired value (see '''Warning/Disclaimer''' section below)
 
  
These features allow rapid comparison of parameter values and assessment of rankings etc, quick changes etc. Some rules and tips are useful:
+
* '''sort''' : Classement alphabétique par colonne en cliquant sur le texte de l'entête de colonne. L'ordre inverse s'obtient en cliquant à nouveau.
 +
* '''edit''' : Chaque valeur peut être modifiée en double cliquant dessus et en entrant la valeur désirée (voir la partie '''Précautions''' ci-dessous)
  
* '''object''' fields : these are not editable
+
Quelques restrictions:
* '''blanks''' : In the actual technics.ini file, not all objects have all relevant parameters defined for them. Missing parameters will appear as blank entries in the data grid. Inserting values for blank parameters will cause the associated parameter directives to appear for the selected object in the saved Technics file. Alternatively, removing values (creating blank fields) for parameters will cause the associated parameter directives to be removed from the saved Technics file.
 
* '''text versus numeric''' : the data values are shown as listed in the loaded technics file. It is the user's responsibility to ensure that edited data in each field is correct and appropriate - no validation is performed by TPT.
 
* '''undo''' : no list of changes is kept internally by TPT, so if you want to undo ALL your edits you can either use the '''reload''' tool or just go back to the file loader above and reload manually. There is no other undo support
 
* '''save''' : the '''save''' tool does NOT simply overwrite the loaded technics file - it ALWAYS presents you with a file chooser to select the location and name of the saved Technics file
 
* '''tokens''' : when saving the new Technics file, TPT will insert textual tokens inside the file to indicate changed parameter values or newly inserted parameter directives. This makes it easy to edit the Technics file and search for changes manually using Notepad or similar. Note: no tokens are written for removed parameter directives.
 
  
 +
* '''object''': Ces champs ne sont pas éditables.
 +
* '''champs vides''' : Dans l'actuel fichier technics.ini, tous les objets n'ont pas des paramètres définis. Les paramètres manquants seront remplacés par des blancs dans la grille. Entrer des valeurs dans ces champs vides modifiera les paramètres en jeu de l'objet correspondant. De la même façon, supprimer un champ existant par un champ vide affectera l'objet du jeu dans le nouveau fichier technics.ini sauvegardé.
 +
* '''format texte ou numérique''' : Les données sont affichées telles qu'elles sont présentées dans le fichier original. Aucun contrôle n'est effectué par le TPT sur le format de la cellule. Ceci est donc sous la responsabilité de l'utilisateur.
 +
* '''annulation''' : Aucune liste de modifications n'est conservée par le TPT, en cas d'erreur, il, faut repartir soit du fichier original, soit de la dernière version sauvegardée.
 +
* '''save''' : L'outil '''save''' ne fait pas que sauvegarder le fichier technics.ini en écrasant le précédent, il présente toujours une fenêtre de sauvegarde permettant de choisir un emplacement et un nom.
 +
* '''tokens''' : En sauvegardant le nouveau fichier technics.ini, le TPT insérera des repères texte indiquant les paramètres modifiés. Cela permet ultérieurement de retrouver facilement les modifications effectuées en éditant le fichier manuellement avec un éditeur de texte. Note: Aucun repère n'est placé lorsqu'on enlève des paramètres.
  
== Warning/Disclaimer ==
+
== Précautions ==
As noted above, TPT performs no internal validation of data changes entered by the user. Therefore the user accepts ALL responsibility for the changes they make in customizing a new Technics file.
+
Comme précisé ci-dessus, TPT ne garantit pas la validité des modifications effectuées par l'utilisateur, celles-ci sont sous sa responsabilité.
  
Furthermore, the Technics file should be regarded as what it is - an integral part of the internal IL-2 game code. The IL-2 game engine is tightly linked to the Technics file, so it is possible that changes to the Technics parameter values may result in unexpected in-game behaviours, or even in game crashes and/or loading failures. For these reasons we state the following items for TPT users (and for all mod developers):
+
Le fichier technics.ini doit être considéré comme une partie du code du jeu. Le moteur d'IL2 est intimement lié à ce fichier. Il est donc possible que des modifications hasardeuses de celui-ci puissent entrainer des comportements inattendus du jeu ou même des disfonctionnements de celui-ci. Pour cette raison, nous attirons l'attention des utilisateurs sur les 3 points suivants:
  
* '''Caveat Emptor''' : use at your own risk, you alone are responsible for customizing your own Technics file.
+
* '''Vigilance''' : Vous êtes seul responsable des modifications effectuées sur le fichier technics.ini.
* '''Test Before Use''' : make sure you test your new Technics file to confirm that the game loads correctly and that the ground objects display the intended behaviours BEFORE you host your coops/campaigns.
+
* '''Test avant usage''' : Testez systématiquement toute modification en conditions réelles de jeu.
* '''Backup!!!''' : always keep a backup of the stock technics.ini file so you can quickly revert to a known set of parameters. TPT is written in such a way to help guide you to keep a backup.
+
* '''Backup!!!''' : Sauvegardez systématiquement le fichier technics.ini d'origine. Cela vous permettra un retour en arrière.
  
That said, with TPT you can consider how to customize your ground campaign for greatest fidelity, dependent on season, terrain and the composition of opposing forces. Enjoy!
+
----
 +
Traduction: [[User:PA-Dore|PA-Dore]]  2012, dernière mise à  jour [[User:PA-Dore|PA-Dore]] Décembre 2012

Version actuelle datée du 22 décembre 2012 à 02:33

Beaucoup de discussions de la communauté IL2 tournent autour des modèles de vol. Ces modèles de vol sont clairement des facteurs importants dans le réalisme de la simulation. Dans SEOW, nous n'avons pas uniquement des opérations aériennes et les résultats des combats terrestres ont au moins autant d'importance. Le fichier Technics (actuellement nommé technics.ini) donne une interface assez simple pour gérer le comportement des objets terrestres. Depuis la version SEOW v6, le Mission Planner propose un outil pour afficher, analyser et éditer les fichiers Technics.


Pourquoi éditer un fichier Technics?

Les fichiers Technics sont des fichiers de configuration interne qui déterminent les comportements des objets sol (mobiles et stationnaires). Des paramètres comme l'épaisseur de blindage, la rapidité de mouvement, les portées de tir et beaucoup d'autres paramètres se trouvent dans le fichier Technics. Le fichier d'origine d'IL2 comportent certains défauts pour beaucoup de scénarios particuliers, quelquefois même de simples erreurs typographiques. Ce qui signifie que les concepteurs de campagne doivent adapter ces valeurs dans certains cas de figure. Par exemple, une campagne comportant des combats en zone urbaine nécessitera sans doute une réduction des portées de tir des blindés pour permettre une revalorisation de l'infanterie. Ou, pour une campagne en été sur des routes en bon état, le concepteur souhaitera augmenter la vitesse de certains véhicules pour leur donner un avantage.

Voici la solution: Il est facile pour le concepteur de campagne de développer un fichier Technics adapté à sa campagne, de le proposer sous forme de mode activable (jsgme)et tous les participants observeront les mêmes comportements en jeu des unités sol. Le nouvel outil SEOW, le Technics Processor Tool, permet de simplifier l'édition de ce fichier long et complexe, d'exporter facilement de nouveaux fichiers Technics et d'éditer la base de données SEOW.

SEOW Outil Technics Processor Tool (TPT)

Le TPT est compatible avec toutes les versions SEOW supérieures à 6.0.0. Cet outil se trouve sur la page d'accueil de SEOW dans l'onglet Tools (Outils). A noter que cet outil utilise le fichier DHTML5 API qui ne fonctionne que sous Firefox (recommandé) et peut-être sous Google Chrome. Il ne fonctionnera pas sous Internet Explore ou avec Firefox/IETab. TPT possède une option (dans le fichier Technics/Technics_Configuration.php) pour activer/désactiver un accès par mot de passe. Par défaut, cette option est désactivée ($TechnicsAuth = 0;). Si le mot de passe est demandé, les utilisateurs devront entrer le mot de passe défini dans le fichier Technics/auth.js.

La fenêtre principale permet de charger un fichier Technics situé en local sur l'ordinateur. Il est important de noter que même si le TPT est situé sur un serveur en ligne, son action n'aura d'effet que sur les fichiers de l'ordinateur local. Ce qui peut permettre à n'importe quel joueur de l'utiliser sur son propre jeu. Il n'y a aucune possibilité de modifier à distance le fichier Technics du serveur.

L'image suivante montre le TPT une fois le fichier technics.ini chargé. A noter que l'interface "sepia" a été choisie pour le MP, celle-ci se règle automatiquement en fonction des réglages choisis pour le MP principal.

Erreur lors de la création de la miniature : Impossible d'enregistrer la vignette sur la destination

Au dessous de la boite de dialogue de chargement de fichier se trouvent une ligne d'onglets pour différents outils et au dessous un grand tableau présentant les données du fichier technics.ini. Les données sont classées en 3 catégories: gunnery, armour et movement, chacune d'elles est associée avec un outil correspondant. Une seule catégorie est affichée à l'écran, pour en changer, simplement cliquer sur la rubrique appropriée au dessus. A noter que tous les paramètres du technics.ini ne sont pas affichés par le TPT, seuls ceux présentant un intérêt pour les concepteurs de campagne sont présentés.

La liste des outils est la suivante:

  • reload : Retour au fichier technics.ini original, toutes les valeurs modifiées sont effacées.
  • gunnery : Permute l'affichage sur la catégorie gunnery.
  • armour : Permute l'affichage sur la catégorie armour.
  • movement : Permute l'affichage sur la catégorie movement.
  • toSQL : Crée une liste de requêtes SQL pour éditer rapidement la table Object_Specifications de la base de données SEOW. Cela permet une synchronisation entre le fichier technics.ini du jeu et les données correspondantes de SEOW.
  • save : Permet à l'utilisateur de sauvegarder les données modifiées (de toutes les catégories en même temps) dans un nouveau fichier technics.ini.
Erreur lors de la création de la miniature : Impossible d'enregistrer la vignette sur la destination
  • ? : Un outil d'aide affichant la description des différents paramètres présents dans le technics.ini affiché.

La fenêtre est à défilement et permet d'afficher la description et les unités utilisées pour les différents paramètres.

Erreur lors de la création de la miniature : Impossible d'enregistrer la vignette sur la destination

Utilisation du tableau de données du TPT

Ce tableau se présente comme un tableur simplifié affichant les différentes catégories de paramètres. La librairie utilisée est dhtmlxGrid [1] qui est très puissante et configurable.

Dans l'actuelle configuration, cette grille de données permet les fonctions suivantes:

  • sort : Classement alphabétique par colonne en cliquant sur le texte de l'entête de colonne. L'ordre inverse s'obtient en cliquant à nouveau.
  • edit : Chaque valeur peut être modifiée en double cliquant dessus et en entrant la valeur désirée (voir la partie Précautions ci-dessous)

Quelques restrictions:

  • object: Ces champs ne sont pas éditables.
  • champs vides : Dans l'actuel fichier technics.ini, tous les objets n'ont pas des paramètres définis. Les paramètres manquants seront remplacés par des blancs dans la grille. Entrer des valeurs dans ces champs vides modifiera les paramètres en jeu de l'objet correspondant. De la même façon, supprimer un champ existant par un champ vide affectera l'objet du jeu dans le nouveau fichier technics.ini sauvegardé.
  • format texte ou numérique : Les données sont affichées telles qu'elles sont présentées dans le fichier original. Aucun contrôle n'est effectué par le TPT sur le format de la cellule. Ceci est donc sous la responsabilité de l'utilisateur.
  • annulation : Aucune liste de modifications n'est conservée par le TPT, en cas d'erreur, il, faut repartir soit du fichier original, soit de la dernière version sauvegardée.
  • save : L'outil save ne fait pas que sauvegarder le fichier technics.ini en écrasant le précédent, il présente toujours une fenêtre de sauvegarde permettant de choisir un emplacement et un nom.
  • tokens : En sauvegardant le nouveau fichier technics.ini, le TPT insérera des repères texte indiquant les paramètres modifiés. Cela permet ultérieurement de retrouver facilement les modifications effectuées en éditant le fichier manuellement avec un éditeur de texte. Note: Aucun repère n'est placé lorsqu'on enlève des paramètres.

Précautions

Comme précisé ci-dessus, TPT ne garantit pas la validité des modifications effectuées par l'utilisateur, celles-ci sont sous sa responsabilité.

Le fichier technics.ini doit être considéré comme une partie du code du jeu. Le moteur d'IL2 est intimement lié à ce fichier. Il est donc possible que des modifications hasardeuses de celui-ci puissent entrainer des comportements inattendus du jeu ou même des disfonctionnements de celui-ci. Pour cette raison, nous attirons l'attention des utilisateurs sur les 3 points suivants:

  • Vigilance : Vous êtes seul responsable des modifications effectuées sur le fichier technics.ini.
  • Test avant usage : Testez systématiquement toute modification en conditions réelles de jeu.
  • Backup!!! : Sauvegardez systématiquement le fichier technics.ini d'origine. Cela vous permettra un retour en arrière.

Traduction: PA-Dore 2012, dernière mise à jour PA-Dore Décembre 2012