Vous pourriez vouloir éditer un émulateur, ou encore ajouter un émulateur à la liste des émulateurs reconnus pas mGalaxy.
Le plus simple est alors d’en faire la requête sur le forum mais si vous voulez le faire par vous même nous allons voir dans les lignes qui suivent comment procéder.
Ces tutoriels vont concerner la création d’un émulateur mais si le principe est acquis il devrait vous permettre également d’éditer un émulateur en toute connaissance.
Création d’un émulateur #
La liste des émulateurs est dans le fichier « mGalaxy\Data\Definition\Emulators.xml »
Ce fichier est à ouvrir avec un éditeur de texte.
Voici comment est défini un émulateur:
Le tag « Emulator » #
Dans la première ligne, 2 attributs
- name: va recevoir le nom de l’émulateur.
- hidden: dont la valeur peut être « true » ou « false » va permettre de définir si l’on veut lancer l’émulateur avec son interface non-visible (« true ») ou visible (« false »).
Certains émulateurs le permettent, d’autres pas, c’est donc à tester au préalable.
Le tag « System » #
Compris dans le tag « Systems » suivent le ou les systèmes émulés par cet émulateur, avec comme attributs:
- name: le nom exact du système tel que défini dans le fichier « Systems.xml »
- option: une information supplémentaire, si nécessaire
- script: dont la valeur peut être « true » ou « false » va permettre de définir si l’on veut lancer l’émulateur par le biais d’un script (« true ») ou pas (« false »).
- cmd: la ligne de commande à envoyer à l’émulateur
- extensions: la liste des extensions de fichier permises par cet émulateur, séparée par un « | »
Nous allons nous attarder en détail sur la ligne de commande.
La quasi totalité des émulateurs sont lançable via une « ligne de commande ». Ces commandes sont trouvables sur le site officiel ou la documentation de l’émulateur.
mGalaxy utilise cette pratique et va donc s’adresser à l’émulateur en lui envoyant au passage des demandes d’options (tels que ‘démarre en plein écran’) ainsi que le chemin vers le jeux à lancer.
Par facilité, la meilleur approche est donc sans doute de d’abord tester l’émulateur avec un fichier batch
…et quand tout fonctionne parfaitement, de remplacer ce qui doit l’être.
Le tag « Requirement » #
La valeur de ce tag est un texte reprenant les informations de prérequis au lancement de l’émulateur.
Ce texte peut contenir des balises de formatage du texte, telles que:
Par contre il ne peut comprendre aucun des signes spéciaux réservés au language XML. Ces signes devront être remplacés manuellement ou par le biais d’un outils en ligne, tel que https://codebeautify.org/xml-escape-unescape
Insertion du nouvel émulateur dans la liste #
Une fois que votre bloc de définition est prêt, copiez-le au même niveau que les autres définitions.