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"

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

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.

• 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


• 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.


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](https://raw.githubusercontent.com/wiki/recalbox/recalbox-os/images/overlays/overlays_4.png)

• 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](https://raw.githubusercontent.com/wiki/recalbox/recalbox-os/images/overlays/overlays_5.png)

• 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.

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


• 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](https://raw.githubusercontent.com/wiki/recalbox/recalbox-os/images/overlays/overlays_7.png)

• 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.