﻿Lisez-moi de l'utilitaire LCC_Trad_Correct pour les jeux Infinity Engine version 3.0


Sommaire :
I.   Introduction
II.  Installation
III. Comment ça marche ?
IV.  Remerciements
V.   Historique.

I. Introduction

Ce petit utilitaire a été conçu pour faciliter la tâche de tous ceux qui maintiennent des patches de correction orthographique pour les jeux Infinity Engine (BG, BG2, IWD2 et PsT).
Repérer et corriger les fautes n'est déjà pas facile, saisir les corrections dans un fichier tra assez pénible, mais devoir écrire toutes les lignes correspondantes dans le setup.tp2 pour que ces corrections soient effectives est carrément barbant.
L'idée m'est donc venue d'écrire une petite procédure WeiDU qui permettrait de le faire automatiquement à partir d'un fichier tra.


II. Installation

Comme la plupart des mods, il suffit de décompresser l'archive dans votre répertoire principal de jeu, puis de lancer l'exécutable setup-LCC_Trad_Correct.exe.

ATTENTION : Plutôt que de prévoir une liste de composants permettant de gérer tous les jeux, j'ai privilégié une utilisation plus fonctionnelle détaillée dans le chapitre suivant "Comment ça marche ?" que je vous conseille de lire attentivement.
Cet utilitaire ne modifiant pas les fichiers du jeu, il est inutile de le désinstaller et il n'est pas référencé dans le fichier WeiDU.log (comme Bambatcher).


III. Comment ça marche ?

C'est très simple !

a) Vous pouvez choisir deux options de traitement :
	1. La méthode rapide qui suppose que les références soient saisies dans l'ordre ascendant.
	2. La méthode classique, plus longue car elle trie les références par ordre descendant. Cette option permet de travailler avec des fichiers tra non triés.

b) Copiez votre fichier tra de correctifs dans le répertoire LCC_Trad_Correct/francais.

c) Ouvrez le fichier setup-LCC_Trad_Correct.tp2 dans un éditeur de texte.

d) Si nécessaire, modifiez les lignes 41 et 74 (OUTER_SPRINT GW_file "correcfr") en remplaçant le nom du fichier tra par défaut (correcfr) par le vôtre (sans l'extension .tra).
	==> OUTER_SPRINT GW_file "myfile"

e) Sélectionner les lignes de procédures qui vous intéressent.
Les lignes 53 à 64 et 79 à 90 contiennent la liste des instructions à effectuer pour générer automatiquement une liste d'instructions STRING_SET dans un fichier tpa.
Selon le jeu sur lequel vous travaillez, il vous suffit de "commenter" une ligne (ajouter "//" en début de ligne) pour ne pas la traiter, ou de la "décommenter" (supprimer "//" en début de ligne) pour la traiter.
Par défaut, les traitements sont définis pour BG2 et ToB :

	LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = ToB GW_file END
	LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = BG2 GW_file END
ou
	LAF ~GW_SPEEDY_CREATE_STRING_SET_TPA~ INT_VAR GW_stringrefs STR_VAR GW_game = ToB GW_file END
	LAF ~GW_SPEEDY_CREATE_STRING_SET_TPA~ INT_VAR GW_stringrefs STR_VAR GW_game = BG2 GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = BG GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = TOTSC GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = PST GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = IWD GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = IWD2 GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = BGEE GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = SOD GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = BG2EE GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = IWDEE GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = PSTEE GW_file END

Si vous souhaitez traiter des corrections pour IWD, commentez les deux premières lignes concernant BG2 et ToB (GW_game = ToB et GW_game = BG2) et décommentez la ligne pour IWD (GW_game = IWD) :

	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = ToB GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = BG2 GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = BG GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = TOTSC GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = PST GW_file END
	LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = IWD GW_file END
ou
	LAF ~GW_SPEEDY_CREATE_STRING_SET_TPA~ INT_VAR GW_stringrefs STR_VAR GW_game = IWD GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = IWD2 GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = BGEE GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = SOD GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = BG2EE GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = IWDEE GW_file END
	//LAF ~GW_CREATE_STRING_SET_TPA~ STR_VAR GW_game = PSTEE GW_file END

Note : cet utilitaire a été conçu pour traiter les fichiers tra des packs correctifs pour BG et BG2 qui utilisent ce type de références : @1056482, @1004589, @1000123, @1000010 et @1000001. Si vous utilisez des références classiques (@1, @12 ... @74106), modifiez les lignes de commande ainsi :

	LAF ~GW_CREATE_STRING_SET_TPA~ INT_VAR GW_form = 0 STR_VAR GW_game = ToB GW_file END
	LAF ~GW_CREATE_STRING_SET_TPA~ INT_VAR GW_form = 0 STR_VAR GW_game = BG2 GW_file END
ou
	LAF ~GW_SPEEDY_CREATE_STRING_SET_TPA~ INT_VAR GW_form = 0 GW_stringrefs STR_VAR GW_game = ToB GW_file END
	LAF ~GW_SPEEDY_CREATE_STRING_SET_TPA~ INT_VAR GW_form = 0 GW_stringrefs STR_VAR GW_game = BG2 GW_file END

f) Sauvegardez le fichier tp2, puis lancez l'exécutable setup-LCC_Trad_Correct.exe.

g) La procédure crée automatiquement dans le répertoire LCC_Trad_Correct/lib les fichiers String_Set_nom du jeu.tpa qui contiennent la liste d'instructions STRING_SET permettant de modifier le dialog.tlk en fonction des références contenues dans votre fichier tra.

   Exemple :
	STRING_SET 1 @1000001
	STRING_SET 7 @1000007
	STRING_SET 12 @1000012
	STRING_SET 14 @1000014
	STRING_SET 16 @1000016
	STRING_SET 17 @1000017
	STRING_SET 20 @1000020
	....

h) Vous pouvez alors soit recopier ces instructions dans votre tp2, soit copier les fichiers tpa dans le répertoire de votre pack correctif et les lancer directement dans votre tp2 de la manière suivante :

	INCLUDE ~%MOD_FOLDER%/String_Set_BG2.tpa~
	INCLUDE ~%MOD_FOLDER%/String_Set_ToB.tpa~
	...

Pour toute information complémentaire, n'hésitez pas à consulter cette page : http://www.baldursgateworld.fr/lacouronne/programmation-weidu/30700-trad-utilitaire-lcc_trad_correct-pour-mettre-jour-les-correctifs.html


IV. Remerciements

- Comme d'hab, les concepteurs et les mainteneurs de WeiDU.
- Isaya qui m'a beaucoup aidé pour définir les expressions régulières nécessaires au composant classique.


V. Historique.

Version 3.0 (09.09.2018) :
  - Choix de la procédure à utiliser : classique (plus lente) ou rapide (plus rapide).
  - Ajout d'une option de procédure de traitement plus rapide.
  - Ajout d'un compteur du nombre de références présentes dans le fichier tra.
  - Suppression du statut bêta puisque l'utilitaire a été validé.

Version beta 2.0 (23.08.2017) :
  - Ajout du traitement des références au format @nnnnnn.
  - Ajout d'un compteur récapitulatif du nombre de références traitées.

Version beta 1.0 (05.08.2017) :
  - Sortie initiale.