Configuration files and command line parameters fr

Fichiers de configurations et paramètres en lignes de commandes

Fichier de configuration principale (emu.cfg)

Le fichier principal où sont rédigés la plupart des paramètres de Flycast se nomme "emu.cfg";
et se situe à la racine du dossier flycast.

Section Audio [audio]

Les seules options ici sont "le backend audio utilisé" et la désactivation (ou non) du son.
Note: les backends disponibles dans l'option "backend" peuvent varier en fonction du système d'exploitation (OS) utilisé;
mais généralement la sélection "auto" fonctionne aussi bien.

Option	Valeurs	Description
backend	auto/null/dépend de l'OS	choix du backend
disable	0 ou 1	désactiver le son

Section de configuration principale [config]

Option	Valeurs	Déscription
Debug.SerialConsoleEnabled	no/yes	À propos du câble série. Non affiché dans le menu des paramètres. Réservé au débogage.
Debug.SerialPTY	no/yes	Non affiché dans le menu des paramètres. Réservé au débogage. pour Linux/Unix uniquement.
Dreamcast.Broadcast	0-4	Paramètre d'affichage. 0=NTSC, 1=PAL, 2=PAL/M, 3=PAL/N, 4=Default
Dreamcast.Cable	1-3	Paramètre du câble. 1=VGA, 2=RGB Component, 3=TV Composite
Dreamcast.ContentPath	path;	Chemin d'accès aux jeux. Les chemins d'accès supplémentaires sont séparés par ";"
Dreamcast.ForceWindowsCE	no/yes	Force l'émulation complète MMU (Memory Management Unit) et autres fonctionnalités Windows CE.
Dreamcast.HideLegacyNaomiRoms	no/yes	Masque les ROMs "Legacy NAOMI" (.bin/.dat et .lst) de la liste de jeux.
Dreamcast.Language	0-6	Langage 0=Japonais, 1=Anglais, 2=Allemand, 3=Français, 4=Espagnol, 5=Italien, 6=Default.
Dreamcast.Region	0-3	Paramètre régional. 0=Japon, 1=USA, 2=Europe, 3=Default

Section fenêtre/écran [window]

Les options disponibles ici sont utiles pour modifier la taille de la fenêtre (largeur et hauteur),
ainsi que pour sélectionner si Flycast est maximisé ou en plein écran.

Option	Valeurs	Description
fullscreen	no/yes	Plein-écran
height	nombre en mm	hauteur
maximized	no/yes	maximisé
width	nombre en mm	largeur

Paramètres en lignes de commandes

Lancer un jeu en ligne de commande/batch

Flycast peut charger les jeux avec un glissé-déposé sur le fichier .exe, en utilisant un fichier batch, ou avec une ligne de commande.
Par exemple: Si vous possédez une ROM 'Marvel VS. Capcom 2' à la racine du dossier Flycast, ainsi qu'un fichier flycast.exe;
vous pouvez taper "flycast.exe mvsc2.zip" en ligne de commande et flycast devrait se lancer en démarrant 'Marvel VS Capcom 2'.
(sous réserve que vous ayez le BIOS NAOMI installé).

Concrètement; en plaçant le nom de fichier exécutable de Flycast à côté du nom du fichier ROM (chemin d'accès relatif OU complet), Flycast devrait le charger.
Note: si les noms de fichier ou du chemin d'accès ont des espaces, vous devrez les mettre entre guillemets.

Voici quelques exemples:

• flycast mvsc2.zip

  • => flycast.exe + nom de fichier
    • (sous Windows vous pouvez utiliser uniquement le nom du fichier .exe).

• flycast.exe "games/dreamcast/Daytona USA (USA).chd"

  • => flycast.exe + chemin d'accès du jeu dans le dossier racine
    • (notez que le chemin du jeu est à mettre entre guillemets).

• flycast.exe "C:\Emulators\flycast\games\dreamcast\Dennou Senki - Virtual-On - Oratorio Tangram (Japan)\Dennou Senki - Virtual-On - Oratorio Tangram (Japan).gdi"

  • => flycast.exe + chemin d'accès COMPLET vers le jeu
    • (aussi absurde que paraisse la longueur de la commande, cela fonctionne);
    • (notez que le chemin du jeu est à mettre entre guillemets).

• "C:\Emulators\flycast\flycast.exe" "C:\mvsc2.zip"

  • => Chemin d'accès COMPLET de flycast.exe + chemin d'accès du jeu
    • (chemin du jeu qui dans cet exemple se situe à la racine de C:\ );
    • (notez que le chemin du jeu est à mettre entre guillemets).

• C:\Emulators\flycast\flycast.exe C:\mvsc2.zip

  • => Chemin d'accès COMPLET de flycast.exe + chemin d'accès du jeu
    • (chemin du jeu qui dans cet exemple se situe à la racine de C:\ );
    • (notez que le chemin du jeu n'est PAS entre guillemets car il n'y a aucun espace dedans);
    • (cette commande est également valide avec les guillemets comme indiqués dans les exemples précédents).

Dans tous les cas si le chemin d'accès contient un dossier, ou si le nom du jeu possède des espaces,
vous devriez mettre ces chemins (relatif ou littéral) entre guillemets;
et si votre chargement via ligne de commande ne fonctionne pas,
entourez le de guillemets même si celui-ci semble ne contenir aucun espace.

Utilisation des paramètres dans les lignes de commandes

Vous pouvez outrepasser les réglages de Flycast avec ces paramètres, afin que l'émulateur les utilise lors du chargement via la ligne de commande ou le batch;
ceux-ci sont temporaires et ne sont pas sauvegardés lorsque l'émulateur est fermé.
(à quelques exceptions près, la modification des paramètres dans l'émulateur resteront enregistrés après utilisation de ceux-ci).

Les paramètres utilisés sont des extraits possibles du fichier 'emu.cfg',
le modèle étant: -config section:key=value;

• "section" est la section où le paramètre/la clé est localisé (dans la liste au-dessus, la section pour chacun est placé entre crochets),
• "la clé" (key) est le paramètre/l'option à modifier,
• "la valeur" (value) est la valeur que vous utiliseriez pour ledit paramètre.

Par exemple: Utiliser flycast.exe -config config:rend.Rotate90=yes ouvrira Flycast avec l'image tournée à 90 degrés;

• ici la section localisé est 'config',
• le paramètre/l'option (key) est rend.Rotate90 (mentionné au dessus dans la section [config]),
• et sa valeur (value, qui peut être yes ou no), est définie sur yes.

Ceux-ci peuvent également être utilisés lors du chargement d'un jeu via la ligne de commande
(les paramètres DOIVENT être spécifiés avant les noms et chemins du/des fichiers du jeu).
Plusieurs paramètres peuvent être utilisés en même temps en plaçant un -config supplémentaire avec les paramètres voulus devant le premier, etc..

Autre exemple possible: si nous voulons charger 'Capcom VS SNK Pro NAOMI' depuis un dossier,
en plein écrans (fullscreen) avec le 'Widescreen Hack' activé;
nous devons utiliser: flycast.exe -config config:rend.WideScreen=yes -config window:fullscreen=yes "C:\Emulators\flycast\games\arcade\cvsgd.7z"

Avec la structure suivante:

• flycast.exe
• -config config:rend.WideScreen=yes
  • => utilisé pour activer le Widescreen hack
• -config window:fullscreen=yes
  • => utilisé pour ouvrir l'émulateur en plein-écran (fullscreen),
  • (peut importe si cette option ait été définie précédemment ou non)
• "C:\Emulators\flycast\games\arcade\cvsgd.7z"
  • => chemin d'accès complet vers la ROM 'Capcom VS SNK Pro'
  • (ici les guillemets ne sont pas obligatoires étant donné l'absence d’espace dans le chemin d'accès).