Outils pour utilisateurs

Outils du site


Panneau latéral

Français


English

bezels_fr

Comment récupérer les overlays des systèmes et des jeux

Fonctionnalité disponible à partir de la version 1.6.3.0 (à venir)

ARRM permet la récupération sur Screenscraper d'images permettant de créer des overlays avec leurs fichiers de configuration pour les systèmes et les jeux pour Recalbox, Batocera et Retropie qui utilisent chacun des procédés différents. ARRM peut détecter les zones transparentes/translucides d'une image d'overlay et ainsi d'en déduire les coordonnées qu'il appliquera dans les fichiers de configurations d'overlays.

Ci-dessous, les explications seront données pour les systèmes RECALBOX, BATOCERA et RETROPIE qui utilisent des méthodes différentes pour gérer les overlays.


Fichier de paramétrage des chemins

le fichier %appdata%\Nexouille soft\arrm\database\overlays_path.txt contient les chemins utilisés lors de la génération des overlays. Vous pouvez ici paramétrer les chemins d'Overlays Systèmes et Jeux pour Recalbox et Retropie. Pour Batocera, les chemins sont, actuellement, intégrés dans l'application.

Structure du fichier

Contenu :

# retropie
retropie_directory_input_overlay_game|/opt/retropie/configs/all/retroarch/overlay
retropie_directory_input_overlay_system|/opt/retropie/configs/all/retroarch/overlay

retropie_directory_cfg_system|\configs\
retropie_directory_overlay_system|\configs\all\retroarch\overlay\

retropie_directory_cfg_game|\configs\all\retroarch\config\
retropie_directory_overlay_game|\configs\all\retroarch\overlay


#recalbox
recalbox_directory_input_overlay_game|/recalbox/share/overlays
recalbox_directory_input_overlay_system|/recalbox/share/system/.config/retroarch/overlays

recalbox_directory_cfg_system|\system\.config\retroarch\
recalbox_directory_overlay_system|\system\.config\retroarch\overlays\

recalbox_directory_cfg_game|\overlays\
recalbox_directory_overlay_game|\overlays\
  • recalbox_directory_input_overlay_game = correspond au chemin indiqué dans 'input_overlay' qui sera ajouté par ARRM dans les fichiers de config pour les overlays jeux pour Recalbox.
  • recalbox_directory_input_overlay_system = correspond au chemin indiqué dans 'input_overlay' qui sera ajouté par ARRM dans les fichiers de config pour les overlays systèmes pour Recalbox.
  • recalbox_directory_cfg_system = chemin où seront stockés les fichiers .cfg principaux pour les overlays de systèmes pour Recalbox.
  • recalbox_directory_overlay_system = chemin où seront stockés les fichiers .cfg d'image et les fichiers images d'overlays pour les systèmes pour Recalbox.
  • recalbox_directory_cfg_game = chemin où seront stockés les fichiers .cfg principaux pour les overlays de jeux pour Recalbox.
  • recalbox_directory_overlay_game = chemin où seront stockés les fichiers .cfg d'image et les fichiers images d'overlays pour les jeux pour Recalbox.

On retrouve le même type de déclaration pour Retropie. Pour Batocera c'est hard codé dans l'application étant donné que le chemin est unique : 'decorations'

Pour informations, les chemins contenu dans 'recalbox_directory_cfg_system' , 'recalbox_directory_overlay_system' , 'recalbox_directory_cfg_game' , 'recalbox_directory_overlay_game' seront crées à l'identique dans le répertoire défini dans 'Répertoire d'Overlays'.

Exemple pour Recalbox :

  • si ce 'Répertoire d'Overlays' indique '\\recalbox\share' les fichiers seront crées directement sur votre Recalbox.
  • si ce 'Répertoire d'Overlays' indique un répertoire local de votre disque (par exemple 'c:\tempo') , alors il faudra recopier c:\tempo\system et c:\tempo\overlays sur '\\recalbox\share'

Exemple pour Retropie

  • si ce 'Répertoire d'Overlays' indique '\\retropie' les fichiers seront crées directement sur votre Retropie.
  • si ce 'Répertoire d'Overlays' indique un répertoire local de votre disque (par exemple 'c:\tempo') , alors il faudra recopier c:\tempo\configs sur '\\retropie'

Exemple pour Batocera

  • si ce 'Répertoire d'Overlays' indique '\\batocera\share' les fichiers seront crées directement sur votre Batocera.
  • si ce 'Répertoire d'Overlays' indique un répertoire local de votre disque (par exemple 'c:\tempo') , alors il faudra recopier c:\tempo\decorations sur '\\batocera\share'

Recalbox et les overlays

Les Overlays Systèmes

Recalbox utilise 3 fichiers différents pour afficher un overlay :

Exemple avec la Megadrive/Genesis :

1er fichier : \\recalbox\share\system\.config\retroarch\megadrive.cfg

Contenu de ce fichier :

# output resolution
video_fullscreen_x = "1920"
video_fullscreen_y = "1080"

# aspect ratio
aspect_ratio_index = "23"
video_force_aspect = "true"
video_scale_integer = "false"
video_smooth = "false"

video_font_size = "28.000000"
video_message_color = "ffff00"

# common overlay parameters
input_overlay_hide_in_menu = "false"
input_overlay_enable = "true"
input_overlay_opacity = "1.000000"
input_overlay_scale = "1.000000"

# shader
video_shader_enable = "true"

custom_viewport_x = "235"
custom_viewport_y = "4"
custom_viewport_width = "1448"
custom_viewport_height = "1076"

input_overlay = "/recalbox/share/system/.config/retroarch/overlays/16-9/megadrive.cfg"

2eme fichier : \\recalbox\share\system\.config\retroarch\overlays\16-9\megadrive.cfg

contenu de ce fichier :

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

3eme fichier (l'image de l'overlay) : \\recalbox\share\system\.config\retroarch\overlays\16-9\megadrive.png

Les overlays de Jeux

Recalbox utilise 3 fichiers différents pour afficher un overlay :

Exemple avec le jeu 'Alex Kidd in the Enchanted Castle (Europe).zip' sur Megadrive/Genesis :

1er fichier : \\recalbox\share\overlays\megadrive\Alex Kidd in the Enchanted Castle (Europe).zip.cfg

Contenu de ce fichier :

# output resolution
video_fullscreen_x = "1920"
video_fullscreen_y = "1080"

# aspect ratio
aspect_ratio_index = "23"
video_force_aspect = "true"
video_scale_integer = "false"
video_smooth = "false"

video_font_size = "28.000000"
video_message_color = "ffff00"

# common overlay parameters
input_overlay_hide_in_menu = "false"
input_overlay_enable = "true"
input_overlay_opacity = "1.000000"
input_overlay_scale = "1.000000"

# shader
video_shader_enable = "true"

custom_viewport_x = "235"
custom_viewport_y = "4"
custom_viewport_width = "1448"
custom_viewport_height = "1076"

input_overlay = "/recalbox/share/overlays/megadrive/16-9/Alex Kidd in the Enchanted Castle (Europe).cfg"

2eme fichier : \\recalbox\share\overlays\megadrive\16-9\Alex Kidd in the Enchanted Castle (Europe).cfg

contenu de ce fichier :

overlays = 1
overlay0_full_screen = true
overlay0_descs = 0
overlay0_overlay = "Alex Kidd in the Enchanted Castle (Europe).png"

3eme fichier (l'image de l'overlay) : \\recalbox\share\overlays\megadrive\16-9\Alex Kidd in the Enchanted Castle (Europe).png


Fonctionnement d'ARRM dans la création d'overlays pour Recalbox

Création des Overlays Systèmes avec ARRM pour Recalbox

Pour créer les fichiers de configuration, ARRM se base sur des fichiers modèles situés dans le répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\systems_autogen\'. Ces fichiers sont volontairement incomplets, car c'est ARRM qui se chargera de les compléter en ajoutant les viewports (coordonnées d'affichage du jeu dans l'overlay).

Attention Pensez à modifier dans ces fichiers, les lignes suivantes en fonction de votre résolution :

video_fullscreen_x = "1920"
video_fullscreen_y = "1080"

Les fichiers .zip.cfg (il faudra certainement modifier selon vos besoins le contenu de ces fichiers). Ces fichiers correspondent dans notre exemple ci-dessus au 1er fichier : \\recalbox\share\system\.config\retroarch\megadrive.cfg

  • model_bezel_systems_recalbox_zip_cfg_4-3.txt
  • model_bezel_systems_recalbox_zip_cfg_16-9.txt

Chaque fichier correspond à une ratio d'écran différent (4/3; 16/9) Je vous conseille de prendre le ratio 16/9 car il propose beaucoup plus d'overlays que les autres ratio.

Le fichiers .cfg (il n'est pas nécessaire actuellement de le modifier). Ce fichier correspond dans notre exemple ci-dessus au 2eme fichier : \\recalbox\share\system\.config\retroarch\overlays\16-9\megadrive.cfg

  • model_bezel_systems_recalbox_cfg.txt

Ces fichiers sont appliqués pour tous les systèmes par ARRM.

ARRM détecte automatiquement les zones de transparence de l'overlay et calcule automatiquement les valeurs suivantes qu'il applique dans le fichier .zip.cfg :

  • custom_viewport_x
  • custom_viewport_y
  • custom_viewport_width
  • custom_viewport_height

Cependant vous pouvez appliquer un paramétrage particulier pour chaque système en recopiant le couple de fichiers modèles (model_bezel_systems_recalbox_cfg.txt, model_bezel_systems_recalbox_zip_cfg_16-9.txt) , dans le répertoire des systèmes voulus et de les modifier selon vos besoins. Ces fichiers sont situés dans ce répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\systems\'

  • model_bezel_systems_recalbox_zip_cfg_4-3.txt
  • model_bezel_systems_recalbox_zip_cfg_16-9.txt
  • model_bezel_systems_recalbox_cfg.txt



Création des Overlays par Jeux avec ARRM pour Recalbox

Pour créer les fichiers de configuration, ARRM se base sur des fichiers modèles situés dans le répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\games_autogen\'. Ces fichiers sont volontairement incomplets, car c'est ARRM qui se chargera de les compléter en ajoutant les viewports (coordonnées d'affichage du jeu dans l'overlay).

Attention Pensez à modifier dans ces fichiers, les lignes suivantes en fonction de votre résolution :

video_fullscreen_x = "1920"
video_fullscreen_y = "1080"

Les fichiers .zip.cfg (il faudra certainement modifier selon vos besoins le contenu de ces fichiers). Ces fichiers correspondent dans notre exemple ci-dessus au 1er fichier : \\recalbox\share\overlays\megadrive\Alex Kidd in the Enchanted Castle (Europe).zip.cfg

  • model_bezel_games_recalbox_zip_cfg_4-3.txt
  • model_bezel_games_recalbox_zip_cfg_16-9.txt

Chaque fichier correspond à une ratio d'écran différent (4/3; 16/9) Je vous conseille de prendre le ratio 16/9 car il propose beaucoup plus d'overlays que les autres ratio.

Le fichiers .cfg (il n'est pas nécessaire actuellement de le modifier). Ce fichier correspond dans notre exemple ci-dessus au 2eme fichier : \\recalbox\share\system\configs\retroarch\overlays\16-9\megadrive.cfg

  • model_bezel_systems_recalbox_cfg.txt

Ces fichiers sont appliqués pour tous les systèmes par ARRM.

ARRM détecte automatiquement les zones de transparence de l'overlay et calcule automatiquement les valeurs suivantes qu'il applique dans le fichier .zip.cfg :

  • custom_viewport_x
  • custom_viewport_y
  • custom_viewport_width
  • custom_viewport_height

Cependant vous pouvez appliquer un paramétrage particulier les jeux de chaque système en recopiant le couple de fichiers modèles (model_bezel_games_recalbox_cfg.txt, model_bezel_games_recalbox_zip_cfg_16-9.txt) , dans le répertoire des systèmes voulus et de les modifier selon vos besoins. Ces fichiers sont situés dans ce répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\games\'

  • model_bezel_games_recalbox_zip_cfg_4-3.txt
  • model_bezel_games_recalbox_zip_cfg_16-9.txt
  • model_bezel_games_recalbox_cfg.txt

Retropie et les overlays

Les Overlays Systèmes

Retropie utilise 3 fichiers différents pour afficher un overlay :

Exemple avec la Megadrive/Genesis :

1er fichier : \\retropie\configs\megadrive\retroarch.cfg

Contenu de ce fichier :

# output resolution
video_fullscreen_x = "1920"
video_fullscreen_y = "1080"

# aspect ratio
aspect_ratio_index = "23"
video_force_aspect = "true"
video_scale_integer = "false"
video_smooth = "false"

video_font_size = "28.000000"
video_message_color = "ffff00"


# common overlay parameters
input_overlay_hide_in_menu = "false"
input_overlay_enable = "true"
input_overlay_opacity = "1.000000"
input_overlay_scale = "1.000000"

# shader
video_shader_enable = "true"

# Auto-generated by ARRM
custom_viewport_x = "239"
custom_viewport_y = "0"
custom_viewport_width = "1441"
custom_viewport_height = "1079"


input_overlay = "/opt/retropie/configs/all/retroarch/overlay/16-9/megadrive.cfg"

input_remapping_directory = "/opt/retropie/configs/megadrive/"

#include "/opt/retropie/configs/all/retroarch.cfg"

2eme fichier : \\retropie\configs\all\retroarch\overlay\16-9\megadrive.cfg

contenu de ce fichier :

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

3eme fichier (l'image de l'overlay) : \\retropie\configs\all\retroarch\overlay\16-9\megadrive.png

Les overlays de Jeux

Retropie utilise 3 fichiers différents pour afficher un overlay :

Exemple avec le jeu 'Aladdin (USA).zip' sur Megadrive/Genesis :

1er fichier : \\retropie\configs\all\retroarch\config\Genesis Plus GX\Aladdin (USA).cfg

Vous remarquez que le nom du système 'megadrive' est remplacé par 'Genesis Plus GX' qui correspond au 'Core' utilisé pour ce système. Vous pouvez connaitre le nom du 'Core' en ouvrant avec un éditeur de texte le fichier '\\retropie\configs\megadrive\content_history.lpl' qui indique le “core_name” utilisé . Extrait:

{
  "version": "1.0",
  "items": [
    {
      "path": "/home/pi/RetroPie/roms/megadrive/Alien Soldier (Europe).md",
      "label": "",
      "core_path": "/opt/retropie/libretrocores/lr-genesis-plus-gx/genesis_plus_gx_libretro.so",
      "core_name": "Genesis Plus GX",
      "crc32": "",
      "db_name": ""
    },

Contenu de ce fichier \\retropie\configs\all\retroarch\config\Genesis Plus GX\Aladdin (USA).cfg

# output resolution
video_fullscreen_x = "1920"
video_fullscreen_y = "1080"

# aspect ratio
# aspect_ratio_index = "23"
video_force_aspect = "true"
video_scale_integer = "false"
video_smooth = "false"

video_font_size = "28.000000"
video_message_color = "ffff00"


# common overlay parameters
input_overlay_hide_in_menu = "false"
input_overlay_enable = "true"
input_overlay_opacity = "1.000000"
input_overlay_scale = "1.000000"

# shader
video_shader_enable = "true"

custom_viewport_x = "244"
custom_viewport_y = "3"
custom_viewport_width = "1431"
custom_viewport_height = "1072"


input_overlay = "/opt/retropie/configs/all/retroarch/overlay/megadrive/16-9/Aladdin (USA).cfg"

2eme fichier : \\retropie\configs\all\retroarch\overlay\megadrive\16-9\Aladdin (USA).cfg

contenu de ce fichier :

overlays = 1
overlay0_full_screen = true
overlay0_descs = 0
overlay0_overlay = "Aladdin (USA).png"

3eme fichier (l'image de l'overlay) : \\retropie\configs\all\retroarch\overlay\megadrive\16-9\Aladdin (USA).png


Fonctionnement d'ARRM dans la création d'overlays pour Retropie

Création des Overlays Systèmes avec ARRM pour Retropie

Pour créer les fichiers de configuration, ARRM se base sur des fichiers modèles situés dans le répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\systems_autogen\'. Ces fichiers sont volontairement incomplets, car c'est ARRM qui se chargera de les compléter en ajoutant les viewports (coordonnées d'affichage du jeu dans l'overlay).

Attention Pensez à modifier dans ces fichiers, les lignes suivantes en fonction de votre résolution :

video_fullscreen_x = "1920"
video_fullscreen_y = "1080"

Les fichiers .zip.cfg (il faudra certainement modifier selon vos besoins le contenu de ces fichiers). Ces fichiers correspondent dans notre exemple ci-dessus au 1er fichier : \\retropie\configs\megadrive\retroarch.cfg

  • model_bezel_systems_retropie_zip_cfg_4-3.txt
  • model_bezel_systems_retropie_zip_cfg_16-9.txt

Chaque fichier correspond à une ratio d'écran différent (4/3; 16/9) Je vous conseille de prendre le ratio 16/9 car il propose beaucoup plus d'overlays que les autres ratio.

Le fichiers .cfg (il n'est pas nécessaire actuellement de le modifier). Ce fichier correspond dans notre exemple ci-dessus au 2eme fichier : \\retropie\configs\all\retroarch\overlay\16-9\megadrive.cfg

  • model_bezel_systems_retropie_cfg.txt

Ces fichiers sont appliqués pour tous les systèmes par ARRM.

ARRM détecte automatiquement les zones de transparence de l'overlay et calcule automatiquement les valeurs suivantes qu'il applique dans le fichier retroarch.zip:

  • custom_viewport_x
  • custom_viewport_y
  • custom_viewport_width
  • custom_viewport_height

Cependant vous pouvez appliquer un paramétrage particulier pour chaque système en recopiant le couple de fichiers modèles (model_bezel_systems_retropie_cfg.txt, model_bezel_systems_retropie_zip_cfg_16-9.txt) , dans le répertoire des systèmes voulus et de les modifier selon vos besoins. Ces fichiers sont situés dans ce répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\systems\'

  • model_bezel_systems_retropie_zip_cfg_4-3.txt
  • model_bezel_systems_retropie_zip_cfg_16-9.txt
  • model_bezel_systems_retropie_cfg.txt



Création des Overlays par Jeux avec ARRM pour Retropie

Pour créer les fichiers de configuration, ARRM se base sur des fichiers modèles situés dans le répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\games_autogen\'. Ces fichiers sont volontairement incomplets, car c'est ARRM qui se chargera de les compléter en ajoutant les viewports (coordonnées d'affichage du jeu dans l'overlay).

Attention Pensez à modifier dans ces fichiers, les lignes suivantes en fonction de votre résolution :

video_fullscreen_x = "1920"
video_fullscreen_y = "1080"

Les fichiers .zip.cfg (il faudra certainement modifier selon vos besoins le contenu de ces fichiers). Ces fichiers correspondent dans notre exemple ci-dessus au 1er fichier : \\retropie\configs\all\retroarch\config\Genesis Plus GX\Aladdin (USA).cfg

  • model_bezel_games_retropie_zip_cfg_4-3.txt
  • model_bezel_games_retropie_zip_cfg_16-9.txt

Chaque fichier correspond à une ratio d'écran différent (4/3; 16/9) Je vous conseille de prendre le ratio 16/9 car il propose beaucoup plus d'overlays que les autres ratio.

Le fichiers .cfg (il n'est pas nécessaire actuellement de le modifier). Ce fichier correspond dans notre exemple ci-dessus au 2eme fichier : \\retropie\configs\all\retroarch\overlay\megadrive\16-9\Aladdin (USA).cfg

  • model_bezel_systems_retropie_cfg.txt

Ces fichiers sont appliqués pour tous les systèmes par ARRM.

ARRM détecte automatiquement les zones de transparence de l'overlay et calcule automatiquement les valeurs suivantes qu'il applique dans le fichier .cfg :

  • custom_viewport_x
  • custom_viewport_y
  • custom_viewport_width
  • custom_viewport_height

Cependant vous pouvez appliquer un paramétrage particulier les jeux de chaque système en recopiant le couple de fichiers modèles (model_bezel_games_retropie_cfg.txt, model_bezel_games_retropie_zip_cfg_16-9.txt) , dans le répertoire des systèmes voulus et de les modifier selon vos besoins. Ces fichiers sont situés dans ce répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\games\'

  • model_bezel_games_retropie_zip_cfg_4-3.txt
  • model_bezel_games_retropie_zip_cfg_16-9.txt
  • model_bezel_games_retropie_cfg.txt

Batocera et les overlays

Les Overlays Systèmes

Batocera est un peu plus simple dans sa gestion des overlays, il n'utilise que 2 fichiers différents pour afficher un overlay :

Exemple avec la Megadrive/Genesis :

1er fichier : \\batocera\share\decorations\mybezels\systems\megadrive.info

Contenu de ce fichier :

{
 "width":1920,
 "height":1080,
 "top":2,
 "left":241,
 "bottom":1,
 "right":243,
 "opacity":0.7000000,
 "messagex":0.220000,
 "messagey":0.120000
}

2eme fichier (l'image de l'overlay) : \\batocera\share\decorations\mybezels\systems\megadrive.png

Less overlays de Jeux

Batocera utilise 2 fichiers différents pour afficher un overlay :

Exemple avec le jeu 'Alex Kidd in the Enchanted Castle (Europe).zip' sur Megadrive/Genesis :

1er fichier : \\batocera\share\decorations\mybezels\games\Alex Kidd in the Enchanted Castle (Europe).info

Contenu de ce fichier :

{
 "width":1920,
 "height":1080,
 "top":2,
 "left":241,
 "bottom":1,
 "right":243,
 "opacity":0.7000000,
 "messagex":0.220000,
 "messagey":0.120000
}

2eme fichier (l'image de l'overlay) : \\batocera\share\decorations\mybezels\games\Alex Kidd in the Enchanted Castle (Europe).png


Fonctionnement d'ARRM dans la création d'overlays pour Batocera

Création des Overlays Systèmes avec ARRM pour Batocera

Pour créer les fichiers de configuration, ARRM se base sur des fichiers modèles situés dans le répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\systems_autogen\'. Ces fichiers sont volontairement incomplets, car c'est ARRM qui se chargera de les compléter en ajoutant les viewports (coordonnées d'affichage du jeu dans l'overlay).

Attention Pensez à modifier dans ces fichiers, les lignes suivantes en fonction de votre résolution :

 "width":1920,
 "height":1080,

Les fichiers .info (il faudra certainement modifier selon vos besoins le contenu de ces fichiers). Ces fichiers correspondent dans notre exemple ci-dessus au 1er fichier : \\batocera\share\decorations\mybezels\systems\megadrive.info

  • model_bezel_systems_batocera_4-3.txt
  • model_bezel_systems_batocera_16-9.txt

Chaque fichier correspond à une ratio d'écran différent (4/3; 16/9) Je vous conseille de prendre le ratio 16/9 car il propose beaucoup plus d'overlays que les autres ratio.

Ce fichier sera appliqué pour tous les systèmes par ARRM.

ARRM détecte automatiquement les zones de transparence de l'overlay et calcule automatiquement les valeurs suivantes qu'il applique dans le fichier .info:

  • “top”:
  • “left”
  • “bottom”
  • “right”

Cependant vous pouvez appliquer un paramétrage particulier pour chaque système en recopiant le fichier modèle ('model_bezel_systems_batocera_16-9.txt'), dans le répertoire des systèmes voulus et de les modifier selon vos besoins. Ces fichiers modèles sont situés dans ce répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\systems\'

  • model_bezel_systems_batocera_4-3.txt
  • model_bezel_systems_batocera_16-9.txt



Création des Overlays par Jeux avec ARRM pour Batocera

Pour créer les fichiers de configuration, ARRM se base sur des fichiers modèles situés dans le répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\games_autogen\'. Ces fichiers sont volontairement incomplets, car c'est ARRM qui se chargera de les compléter en ajoutant les viewports (coordonnées d'affichage du jeu dans l'overlay).

Attention Pensez à modifier dans ces fichiers, les lignes suivantes en fonction de votre résolution :

 "width":1920,
 "height":1080,

Les fichiers .info (il faudra certainement modifier selon vos besoins le contenu de ces fichiers). Ces fichiers correspondent dans notre exemple ci-dessus au 1er fichier : \\batocera\share\decorations\mybezels\games\Alex Kidd in the Enchanted Castle (Europe).info

  • model_bezel_games_batocera_4-3.txt
  • model_bezel_games_batocera_16-9.txt

Chaque fichier correspond à une ratio d'écran différent (4/3; 16/9) Je vous conseille de prendre le ratio 16/9 car il propose beaucoup plus d'overlays que les autres ratio.

Ce fichier sera appliqué pour tous les systèmes par ARRM.

ARRM détecte automatiquement les zones de transparence de l'overlay et calcule automatiquement les valeurs suivantes qu'il applique dans le fichier .info:

  • “top”:
  • “left”
  • “bottom”
  • “right”

Cependant vous pouvez appliquer un paramétrage particulier les jeux de chaque système en recopiant le fichier modèle (model_bezel_games_batocera_16-9.txt) , dans le répertoire des systèmes voulus et de les modifier selon vos besoins. Ces fichiers sont situés dans ce répertoire : '%appdata%\Nexouille soft\arrm\ressources\overlays\games\'

  • model_bezel_games_batocera_4-3.txt
  • model_bezel_games_batocera_16-9.txt

Création des overlays systèmes et jeux avec ARRM pour Batocera, Recalbox et Retropie

Maintenant que vous avez assimilé les principes de fonctionnement, vous allez pouvoir récupérer automatiquement vos overlays systèmes et jeux.

Pensez à renseigner les paramètres Login,Password,nom du Frontend dans le panneau de configuration 'Batocera/Recalbox/Retropie/Screenscraper/TGBD'

Il est impératif de choisir le répertoire de stockage des overlays. Il peut s'agir :

  • d'un répertoire local (conseillé), dans ce cas il vous faudra recopier les répertoires 'overlays' et 'system' pour Recalbox , 'decorations' pour Batocera et 'configs' pour Retropie sous \\recalbox\share (pour recalbox) ou \\batocera\share (pour batocera) ou \\retropie (pour retropie)
  • du répertoire \\recalbox\share (pour recalbox) ou \\batocera\share (pour batocera) ou \\retropie (pour retropie). Attention cela écrasera vos overlays existants

Activez la checkbox Overlay, et choisissez le format voulu. Attention, favorisez le format 16/9 qui possède de nombreux bezels comparé au 4/3. En cliquant sur l'oeil vous accéder aux fichiers de configuration par défaut.

Pensez à paramétrer les fichiers modèles (voir conseils plus haut).

  • Pour créer les overlays systèmes

Sélectionner les systèmes et cliquez sur le bouton 'Overlay système'. Vos overlays seront installés directement dans votre Box si vous avez choisi comme répertoire d'overlays : \\recalbox\share (pour recalbox) ou \\batocera\share (pour batocera) ou \\retropie (pour retropie) , ou vous pourrez les copier/coller de votre répertoire local, vers \\recalbox\share (pour recalbox) ou \\batocera\share (pour batocera) ou \\retropie (pour retropie).

Avec Batocera les fichiers récupérés se trouveront dans le dossier de récupération des overlays, puis '\decorations\mybezels16-9\systems\'
Avec Recalbox les fichiers récupérés se trouveront dans le dossier de récupération des overlays, puis '\system\configs\retroarch'

Avec Retropie les fichiers récupérés se trouveront dans le dossier de récupération des overlays, puis '\configs\'

  • Pour créer les overlays de jeux

Sélectionner vos Roms et cliquer sur Screenscraper. Si vous ne souhaitez que récupérer/créer les overlays, cocher 'Pas d'image, uniquement les textes' dans l'onglet de configuration 'image options' afin d'accélérer le processus. Vos overlays seront installés directement dans votre recalbox si vous avez choisi comme répertoire d'overlays : \\recalbox\share (pour recalbox) ou \\batocera\share (pour batocera) ou \\retropie (pour retropie), ou vous pourrez les copier/coller de votre répertoire local, vers \\\recalbox\share (pour recalbox) ou \\batocera\share (pour batocera) ou \\retropie (pour retropie).

Avec Batocera les fichiers récupérés se trouveront dans le dossier de récupération des overlays, puis '\decorations\mybezels16-9\games\'
Avec Recalbox les fichiers récupérés se trouveront dans le dossier de récupération des overlays, puis '\overlays'
Avec Retropie les fichiers récupérés se trouveront dans le dossier de récupération des overlays, puis '\configs\'

Remarque : Pour Retropie, pensez à modifier le nom du répertoire 'systeme' par le nom du 'core' du système. exemple : \\retropie\configs\all\retroarch\config\megadrive devra être modifié en \\retropie\configs\all\retroarch\config\Genesis Plus GX

Vous pouvez connaitre le nom du 'Core' d'un système en ouvrant avec un éditeur de texte le fichier (pour la megadrive) '\\retropie\configs\megadrive\content_history.lpl' qui indique le “core_name” utilisé

La checkbox 'Dev' permet de sauvegarder une image de l'overlay avec un cadre jaune correspondant au coordonnées trouvées par ARRM. Cela permet de détecter facilement les erreurs de coordonnées et de modifier par la suite vos fichiers de configuration ou le fichier overlay (voir 'Forcer l'utilisation d'overlays par défaut') Cette image est sauvegardés dans le répertoire de stockage des overlays dans le sous répertoire '\overlays_preview\games\%system%\'

La checkbox → 720 : Converti les overlays 1080 en 720 et modifie les coordonnées des viewports en conséquence.

Exemples de fichier preview indiquant en jaune la zone trouvée automatiquement par ARRM:

  • Bonnes coordonnées

good_overlays_coord.jpg

  • Mauvaise coordonnées

bad_overlays_coord.jpg


Remarques

ARRM détecte automatiquement les zones de transparence de l'overlay et calcule automatiquement les valeurs a appliquer dans les fichiers de configuration. Cependant si l'overlay contient des pixels transparents / translucides en dehors de la zone voulue, cela peut engendrer des erreurs dans les coordonnées. Dans ce cas, il vous sera nécessaire de modifier les coordonnées dans les fichiers de configuration manuellement ou d'utiliser un fichier modèle comme expliqué plus haut.

Les overlays des systèmes sont disponibles pour la plupart des systèmes, ce qui n'est pas le cas des overlays de jeux. Beaucoup de console/ordi n'ont pas encore d'overlays de jeux disponibles. Vous pouvez toujours en créer et les proposer sur le site Screenscraper

Lors de la création d'overlays pour Batocera un répertoire 'mybezels%ratio%' (ou %ratio correspond à 16-9 ou 4-3 exemple : 'mybezels16_9') est crée afin de ne pas écraser votre répertoire par défaut 'mybezels' existant .

Si vous constatez certaines erreurs sur des overlays, il vous suffit avec un éditeur d'image (photofiltre par exemple) de repérer la zone de transparence et d'appliquer les coordonnées dans les fichiers de configuration appropriés, ou de modifier l'image .png et d'appliquer la procédure 'Forcer l'utilisation d'overlays par défaut'

Les noms des jeux pour lesquels aucun overlay n'a été trouvé sont sauvegardés dans le fichier '_missing_overlays_%SYSTEM%.txt' situé dans le répertoire du système choisi.


Forcer l'utilisation d'overlays par défaut

Si vous avez modifié ou crée des overlays (image .png), vous pouvez forcer ARRM à les prendre en compte. Il suffit pour cela de positionner votre image d'overlay dans le répertoire de stockage des overlays dans le sous répertoire '\overlays_priority\' . Il faudra mettre votre fichier .png dans le répertoire avec le nom (id du système ) du système si c'est un overlay système, ou le nom du fichier rom si c'est un overlay de jeu.

bezels_fr.txt · Dernière modification: 2019/07/07 22:23 par nexusone13