Skip to content

Retroarch setup overlays (FR)

Tornelf edited this page Mar 31, 2018 · 14 revisions

A - Overlays par jeu:

Ce dont vous avez besoin :

  • créez un répertoire overlays + un sous répertoire avec le même nom que le système
  • ajoutez y vos .png, un romName.cfg + un romName.zip.cfg

Voyons ensemble un exemple de base

  • Système : mame
  • Rom : double dragon (ddragon.zip)

Répertoire : /recalbox/share/overlays/mame
Fichiers :

  • /recalbox/share/overlays/mame/ddragon.zip.cfg :
input_overlay = "/recalbox/share/overlays/mame/ddragon.cfg"
  • /recalbox/share/overlays/mame/ddragon.cfg :
overlays = "1"
overlay0_overlay = "ddragon.png"
overlay0_full_screen = "true"
overlay0_descs = "0"

Regardez attentivement le lien : Recalbox recherche un fichier overlays/<system>/<rom.extension>.cfg qui lui même fait référence à un autre fichier .cfg (ce second fichier n'a pas besoin d'être nommé comme la rom, libre à vous de personnaliser le paramètre input_overlay. Il en est de même pour le nom de l'overlay .png).

Nous venons de voir les prérequis de base. Vous pouvez bien entendu ajouter des paramètres personnalisés dans le fichier /recalbox/share/overlays/mame/ddragon.zip.cfg.
Bien souvent vous aurez à forcer les viewports.
Point abordé en section C du wiki.

B - Overlays par système:

Ce dont vous avez besoin :

  • créez le répertoire overlays
  • ajoutez y vos .png + systemName_overlay.cfg dans le répertoire /recalbox/share/system/configs/retroarch/overlays
  • ajoutez votre systemName.cfg dans le répertoire /recalbox/share/system/configs/retroarch

Voyons ensemble un exemple de base

  • Système : psx

Répertoire : /recalbox/share/system/configs/retroarch
Fichier : /recalbox/share/system/configs/retroarch/psx.cfg

input_overlay = "/recalbox/share/system/configs/retroarch/overlays/psx_overlay.cfg"
input_overlay_hide_in_menu = "false"
input_overlay_opacity = "0.7000000"
video_message_pos_x = "0.050000"
video_message_pos_y = "0.050000"

input_overlay = lien vers le fichier de configuration de l'overlay.
input_overlay_hide_in_menu = permet de gérer l'affichage de l'overlay dans le menu retroarch (valeur par défaut: true).
input_overlay_opacity = permet de gérer le niveau d'opacité de l'overlay (valeur par défaut: 0.7000000, valeur max: 1.0000000).
video_message_pos_x = permet de gérer la position en X des messages retroarch (valeur par défaut: 0.0500000).
video_message_pos_y = permet de gérer la position en Y des messages retroarch (valeur par défaut: 0.0500000).

Répertoire : /recalbox/share/system/configs/retroarch/overlays
Fichier : /recalbox/share/system/configs/retroarch/overlays/psx_overlay.cfg :

overlays = "1"
overlay0_overlay = "psx.png"
overlay0_full_screen = "true"
overlay0_descs = "0"

Regardez attentivement le lien : Recalbox recherche un fichier retroarch/<systemName>.cfg qui lui même fait référence à un autre fichier .cfg (ce second fichier n'a pas besoin d'être nommé systemName_overlay, libre à vous de personnaliser le paramètre input_overlay. Il en est de même pour le nom de l'overlay .png).

Nous venons de voir les prérequis de base. Vous pouvez bien entendu ajouter des paramètres personnalisés dans le fichier /recalbox/share/system/configs/retroarch/psx.cfg.
Bien souvent vous aurez à forcer les viewports.
Point abordé en section C du wiki.

  • Exception pour o2em, l'émulateur Videopac/Odyssée² :

Le fichier <systemName>.cfg doit s'appeler odyssey2.cfg.

C - Viewports personnalisés:

Une fois les overlays par système définis, afin de caler correctement l'image du jeu dans les overlays, nous allons voir comment définir des viewports personnalisés pour chaque système.
Dans la suite de ce wiki, nous allons prendre la gamegear comme exemple et voir 2 situations différentes.
Le but étant d'obtenir ce résultat:

goal

1 - Pré-requis:

  • Définir dans les options de Emulationstation le ratio sur custom afin d'indiquer au système de pas gérer ce paramètre de façon automatique.
    GAMES SETTINGS / GAME RATIO = CUSTOM

ratio_custom

  • Lancer un jeu gamegear, puis ouvrir le menu retroarch avec Hotkey+B.
  • Contrôler que l'option permettant d'afficher l'overlay dans le menu retroarch est bien gérée. Aller dans le menu settings/onscreen_display/onscreen_overlay, puis vérifier que l'option suivante hide_overlay_in_menu est bien sur off. Si ce n'est pas le cas, la modifier.

show_overlay_menu

2 - Cas N°1: avec l'option Integer Scale:

Cette option permet de redimensionner le viewport tout en conservant le ratio d'origine du système émulé. Cela dans le but de ne pas étirer les pixels afin de conserver des pixels "perfect" et des scanlines bien espacées.
Cette option implique cependant que vos overlays soient respectueux de ce ratio d'origine. En effet la fenêtre d'affichage de l'overlay doit correspondre parfaitement avec ce ratio afin que le jeux entre parfaitement dans cette zone.
Dans ce cas, nous ne pouvons jouer que sur 2 valeurs: custom aspect ratio width et custom aspect ratio height.

  • Définir dans les options de Emulationstation Integer Scale (Pixel Perfect) sur on.
    GAMES SETTINGS / INTEGER SCALE (PIXEL PERFECT): ON

pixel_perfect

  • Aller dans le menu retroarch (Hotkey+B) settings/video:
  • Définir l'aspect ratio sur custom
  • Ajuster les valeurs de custom aspect ratio width et custom aspect ratio height pour caler l'image dans l'overlay.
  • Noter ces 2 valeurs.

custom_viewports_1

  • Quitter le menu retroarch ainsi que le jeu sans rien sauvegarder.

  • Editer le fichier /recalbox/share/system/configs/retroarch/gamegear.cfg préalablement créé.

    • ajouter les valeurs définies lors de l'étape précédente:
    aspect_ratio_index = "22"
    custom_viewport_width = "992"
    custom_viewport_height = "720"
    

Notre fichier contient donc les informations suivantes:

input_overlay = "/recalbox/share/system/configs/retroarch/overlays/gamegear.cfg"
input_overlay_opacity = "0.7000000"
aspect_ratio_index = "22"
video_message_pos_x = "0.050000"
video_message_pos_y = "0.050000"
custom_viewport_width = "992"
custom_viewport_height = "720"
  • Sauvegarder et quitter.
  • Lancer un jeu pour contrôler et tester.
  • Have fun.

3 - Cas N°2: sans l'option Integer Scale:

Sans l'option Integer Scale d'activée nous pourrons jouer sur tous les réglages afin de faire correspondre le viewport avec la fenêtre d'affichage de l'overlay au pixel près, quelque soit l'overlay.
Mais cela ce fera sûrement au détriment du respect du ratio d'origine du système émulé. Si vous modifiez trop le ratio d'origine, vous déformerez l'image et vous n'aurez donc plus des pixels "perfect" ainsi que des scanlines alignées.

  • Définir dans les options de Emulationstation Integer Scale (Pixel Perfect) sur off.
    GAMES SETTINGS / INTEGER SCALE (PIXEL PERFECT): OFF

no_pixel_perfect

  • Aller dans le menu retroarch (Hotkey+B) settings/video:
  • Définir l'aspect ratio sur custom
  • Ajuster les valeurs de custom aspect ratio x pos, custom aspect ratio y pos, custom aspect ratio width et custom aspect ratio height pour caler l'image dans l'overlay.
  • Noter ces 4 valeurs.

custom_viewports_2

  • Quitter le menu retroarch ainsi que le jeu sans rien sauvegarder.

  • Editer le fichier /recalbox/share/system/configs/retroarch/gamegear.cfg préalablement créé.

    • ajouter les valeurs définies lors de l'étape précédente:
    aspect_ratio_index = "22"
    custom_viewport_x = "306"
    custom_viewport_y = "89"
    custom_viewport_width = "980"
    custom_viewport_height = "728"
    

Notre fichier contient donc les informations suivantes:

input_overlay = "/recalbox/share/system/configs/retroarch/overlays/psx_overlay.cfg"
input_overlay_hide_in_menu = "false"
input_overlay_opacity = "0.7000000"
video_message_pos_x = "0.220000"
video_message_pos_y = "0.120000"
aspect_ratio_index = "22"
custom_viewport_x = "306"
custom_viewport_y = "89"
custom_viewport_width = "980"
custom_viewport_height = "728"
  • Sauvegarder et quitter.
  • Lancer un jeu pour contrôler et tester.
  • Have fun.

Personnellement, post réglages, je règle l'opacité des overlays au maximum: input_overlay_opacity = "1.0000000" et j'ajuste la position des messages retroarch avec video_message_pos_x et video_message_pos_y pour qu'ils s'affichent dans le viewport.

Pour faire afficher un aspect ratio prédéfini, un rapport 4:3 ou 16:9 par exemple, voici les correspondances des code aspect_ratio_index:

0: 4:3
1: 16:9
2: 16:10
3: 16:15
4: 1:1
5: 2:1
6: 3:2
7: 3:4
8: 4:1
9: 4:4
10: 5:4
11: 6:5
12: 7:9
13: 8:3
14: 8:7
15: 19:12
16: 19:14
17: 30:17
18: 32:9
19: config (video_aspect_ratio setting)
20: 10:9 (1:1 PAR)
21: Core Provided
22: Custom

Donc pour forcer un rendu 4:3 au lieu du custom ("22"), il suffit d'écrire aspect_ratio_index = "0".

English

Basic

Advanced


Français

Basique

Avancée


Deutsch

Basic

Fortgeschritten


Español

Basic

Avanzado


Português

Básico

Avançado


Italiano

Di base

Avanzate

Clone this wiki locally
You can’t perform that action at this time.