Outils pour utilisateurs

Outils du site


Panneau latéral

Français

General

Scrape

Template

Gestion de Roms

Gamelist

Outils

Divers







English

General

Scrape

Template

Roms management

Gamelist

Tools

Miscellaneous

create_template-fr

Créer son propre template pour ARRM

ARRM permet de créer vos propres templates que vous pourrez utiliser lors de vos scraps en utilisant le mode 'Mix' dans 'Images Options'.


Répertoire du template

Un template doit être positionné dans le répertoire : %appdata%\roaming\Nexouille Soft\arrm\ressources\templates\nom_du_template

Le nom donné au répertoire (nom_du_template) est libre de choix.

Attention, si vous créez des templates, utilisez des nouveaux noms de répertoires sinon ils seront supprimés lors d'une désinstallation de l'application lors du processus de mise à jour.

Ce répertoire (nom_du_template) doit contenir impérativement le fichier suivant : - un fichier .xml contenant la définition du template (voir code ci-dessous)

Il est conseillé d'avoir également le fichier sample .png (ci-dessous) qui permettra d'afficher l'aperçu du template dans le module de sélection du template - un fichier sample .png qui contient un aperçu du template final (à récupérer sur un scrap mix fait avec ce template).

sample_mix_arcade_red_profile_v2.png

D'autres fichiers .png qui constitueront votre template peuvent être ajoutés, dans ce répertoire (exemple background.png, console.png, foreground.png etc…)

background.png foreground.png


Fichier .xml de configuration du template

Voici un exemple de fichier .xml, qu'il vous faudra adapter en fonction du template que vous souhaitez faire. Celui-ci correspond au template 'mix_arcade_red_profile_v2.xml' disponible dans le répertoire %appdata%\roaming\Nexouille Soft\arrm\ressources\templates\mix_arcade_red_profile _v2

<?xml version="1.0" encoding="utf-8" ?>
<data>
    <infos>
        <author>author's name</author>
        <description>template's description</description>
    </infos>
    <element>
        <name>Arcade Red profile V2</name>
        <sample>sample_mix_arcade_red_profile_v2.png</sample>
        <commentaire>edit custom xml to remove boxart</commentaire>
        <type>profile</type>
        <box>true</box>
        <marquee>true</marquee>
        <add_black_borders>true</add_black_borders>
        
	<custom_background_width>635</custom_background_width> 
        <custom_background_height>745</custom_background_height>
        
        <custom_screenshot_ulx>105</custom_screenshot_ulx>
        <custom_screenshot_uly>250</custom_screenshot_uly>
        <custom_screenshot_urx>442</custom_screenshot_urx>
        <custom_screenshot_ury>254</custom_screenshot_ury>
        <custom_screenshot_llx>121</custom_screenshot_llx>
        <custom_screenshot_lly>471</custom_screenshot_lly>
	<custom_screenshot_lrx>449</custom_screenshot_lrx>
        <custom_screenshot_lry>451</custom_screenshot_lry>
	        
        <custom_screenshot_width>337</custom_screenshot_width>
        <custom_screenshot_height>217</custom_screenshot_height>
        
        <custom_boxart_x>25</custom_boxart_x>
        <custom_boxart_y>440</custom_boxart_y>
        <custom_boxart_width>250</custom_boxart_width>
        <custom_boxart_height>300</custom_boxart_height>
        
        <custom_marquee_ulx>144</custom_marquee_ulx>
        <custom_marquee_uly>36</custom_marquee_uly>
        <custom_marquee_urx>522</custom_marquee_urx>
        <custom_marquee_ury>77</custom_marquee_ury>
        <custom_marquee_llx>141</custom_marquee_llx>
        <custom_marquee_lly>155</custom_marquee_lly>
	<custom_marquee_lrx>523</custom_marquee_lrx>
        <custom_marquee_lry>178</custom_marquee_lry> 
        
        <custom_marquee_width>378</custom_marquee_width>
        <custom_marquee_height>119</custom_marquee_height>
		
	<custom_marquee2_ulx>277</custom_marquee2_ulx>
        <custom_marquee2_uly>545</custom_marquee2_uly>
	<custom_marquee2_urx>628</custom_marquee2_urx>
        <custom_marquee2_ury>545</custom_marquee2_ury>
        <custom_marquee2_llx>277</custom_marquee2_llx>
        <custom_marquee2_lly>729</custom_marquee2_lly> 
        <custom_marquee2_lrx>628</custom_marquee2_lrx>
        <custom_marquee2_lry>729</custom_marquee2_lry> 
		
	<custom_marquee2_width>352</custom_marquee2_width>
        <custom_marquee2_height>185</custom_marquee2_height>		
		
	<layer1>background.png</layer1>
	<layer2>screenshot</layer2>
	<layer3>foreground.png</layer3>
	<layer4>boxart</layer4>
	<layer5>marquee</layer5>
	<layer6>marquee2</layer6>
	<layer7></layer7>
	<layer8></layer8>
	<layer9></layer9>
	<layer10></layer10>
		
    </element>
</data>


Un autre exemple de fichier .xml, utilisable depuis la version d'ARRM 1.7.7.5 qui permet de gérer différemment l'affichage des boxarts en fonction de leur format (portrait, landscape (style N64), CD), géré par les balises :

  • <item boxart=“portrait”>
  • <item boxart=“landscape”>
  • <item boxart=“cd”>

Exemple avec le fichier template 'Next_Pixel_1080_console.xml' disponible dans le répertoire %appdata%\roaming\Nexouille Soft\arrm\ressources\templates\Next_Pixel_1080_console

<?xml version="1.0" encoding="utf-8"?>
<data>
  <infos>
    <author>Franck Pouilly</author>
    <description>Template for NextPixel :  CONSOLES snes,gx4000,jaguar,megadrive,neogeo,pcengine,n64,satellaview,sega32x,sufami,3do,amigacd32,dreamcast,gc,neogeocd,pcenginecd,pcfx,ps2,psx,saturn,segacd,supergrafx</description>
  </infos>
  <element>
    <name>Next_Pixel_1080_console</name>
    <sample>sample_next_pixel_1080_console.png</sample>
    <box>true</box>
    <marquee>true</marquee>
    <add_black_borders>true</add_black_borders>
    <custom_background_width>1260</custom_background_width>
    <custom_background_height>1080</custom_background_height>
    <custom_screenshot_x>400</custom_screenshot_x>
    <custom_screenshot_y>143</custom_screenshot_y>
    <custom_screenshot_width>640</custom_screenshot_width>
    <custom_screenshot_height>480</custom_screenshot_height>

    <custom_marquee_x>599</custom_marquee_x>
    <custom_marquee_y>712</custom_marquee_y>
    <custom_marquee_width>653</custom_marquee_width>
    <custom_marquee_height>328</custom_marquee_height>
	
	<custom_boxart_x>9</custom_boxart_x>
	<custom_boxart_y>432</custom_boxart_y>
	<custom_boxart_width>339</custom_boxart_width>
	<custom_boxart_height>625</custom_boxart_height>
	
	<custom_cartridge_x>342</custom_cartridge_x>
	<custom_cartridge_y>829</custom_cartridge_y>
	<custom_cartridge_width>214</custom_cartridge_width>
	<custom_cartridge_height>214</custom_cartridge_height>
	
	
	<item boxart="portrait">
		<custom_boxart_x>9</custom_boxart_x>
		<custom_boxart_y>432</custom_boxart_y>
		<custom_boxart_width>339</custom_boxart_width>
		<custom_boxart_height>625</custom_boxart_height>
	
		<custom_cartridge_x>342</custom_cartridge_x>
		<custom_cartridge_y>829</custom_cartridge_y>
		<custom_cartridge_width>214</custom_cartridge_width>
		<custom_cartridge_height>214</custom_cartridge_height>
	</item>
	
	<item boxart="landscape">		
	    <custom_boxart_x>6</custom_boxart_x>
		<custom_boxart_y>726</custom_boxart_y>
		<custom_boxart_width>500</custom_boxart_width>
		<custom_boxart_height>271</custom_boxart_height>
	
		<custom_cartridge_x>65</custom_cartridge_x>
		<custom_cartridge_y>546</custom_cartridge_y>
		<custom_cartridge_width>277</custom_cartridge_width>
		<custom_cartridge_height>178</custom_cartridge_height>
    </item>
	
    <item boxart="cd">		
		<custom_boxart_x>2</custom_boxart_x>
		<custom_boxart_y>593</custom_boxart_y>
		<custom_boxart_width>365</custom_boxart_width>
		<custom_boxart_height>489</custom_boxart_height>
	
		<custom_cartridge_x>288</custom_cartridge_x>
		<custom_cartridge_y>800</custom_cartridge_y>
		<custom_cartridge_width>271</custom_cartridge_width>
		<custom_cartridge_height>271</custom_cartridge_height>
    </item>	
		
    <resize width = "630" height = "540" />	
	
    <layer1>console.png</layer1>
    <layer2>screenshot</layer2>
    <layer3>boxart</layer3>
    <layer4>marquee</layer4>
    <layer5>cartridge</layer5>
    <layer7 />
    <layer8 />
    <layer9 />
    <layer10 />
  </element>
</data>

Description des balises

<name> Nom du template. Il sera affiché dans la selection des mix
<sample> nom du fichier png contenant le sample du template definitif. Il sera affiché dans la selection des mix
<commentaire> Commentaire informatif \\
<type> mettre profile (<type>profile</type>)
<box> mettre true (<box>true</box>) , si vous souhaitez afficher le boxart, sinon false
<marquee> mettre true (<marquee>true</marquee>) , si vous souhaitez afficher le marquee (titre), sinon false

Taille de l'image MIX finale

<custom_background_width> largeur totale de votre image template
<custom_background_height> hauteur totale de votre image template




SCREENSHOT

correspond à la balise <screenshot> de la gamelist

Coordonnées du screenshot qui s'affichera dans le template. La zone du screenshot est représentée en jaune sur l'image ci-dessous avec coordonnées en vert

<custom_screenshot_ulx> coordonnée X du point en haut à gauche du screenshot dans votre template <custom_screenshot_uly> coordonnée Y du point en haut à gauche du screenshot dans votre template <custom_screenshot_urx> coordonnée X du point en haut à droite du screenshot dans votre template <custom_screenshot_ury> coordonnée Y du point en haut à droite du screenshot dans votre template <custom_screenshot_llx> coordonnée X du point en bas à gauche du screenshot dans votre template <custom_screenshot_lly> coordonnée Y du point en bas à gauche du screenshot dans votre template <custom_screenshot_lrx> coordonnée X du point en bas à droite du screenshot dans votre template <custom_screenshot_lry> coordonnée Y du point en bas à droite du screenshot dans votre template

Taille du screenshot

<custom_screenshot_width> correspond à la largeur du screenshot dans le template (calcul : <custom_screenshot_urx> - <custom_screenshot_ulx>)
<custom_screenshot_height> correspond à la hauteur du screenshot dans le template (calcul : <custom_screenshot_lly> - <custom_screenshot_uly>)

screenshot




BOXART

correspond à la balise <boxart> de la gamelist

Coordonnées du Boxart La zone du Boxart est représentée en bleu sur l'image ci-dessous avec coordonnées en vert

<custom_boxart_x> correspond à la coordonnée X du Boxart
<custom_boxart_y> correspond à la coordonnée Y du Boxart

Taille du Boxart

<custom_boxart_width> correspond à la largeur du Boxart
<custom_boxart_height> correspond à la hauteur du Boxart , Faire attention que (custom_boxart_y + custom_boxart_height) ne soient pas > à custom_background_height sinon le boxart sortirait de l'écran.

Vous pouvez appliquer des valeurs différentes en fonction du format du BOXART avec la balise <item>

		<item boxart="portrait">
			<custom_boxart_x>0</custom_boxart_x>
			<custom_boxart_y>240</custom_boxart_y>
			<custom_boxart_width>360</custom_boxart_width>
			<custom_boxart_height>360</custom_boxart_height>
		
			<custom_cartridge_x>160</custom_cartridge_x>
			<custom_cartridge_y>410</custom_cartridge_y>
			<custom_cartridge_width>160</custom_cartridge_width>
			<custom_cartridge_height>160</custom_cartridge_height>
		</item>
	
		<item boxart="landscape">		
			<custom_boxart_x>0</custom_boxart_x>
			<custom_boxart_y>240</custom_boxart_y>
			<custom_boxart_width>360</custom_boxart_width>
			<custom_boxart_height>360</custom_boxart_height>
	
			<custom_cartridge_x>40</custom_cartridge_x>
			<custom_cartridge_y>260</custom_cartridge_y>
			<custom_cartridge_width>160</custom_cartridge_width>
			<custom_cartridge_height>160</custom_cartridge_height>
		</item>
	
		<item boxart="cd">		
			<custom_boxart_x>0</custom_boxart_x>
			<custom_boxart_y>240</custom_boxart_y>
			<custom_boxart_width>360</custom_boxart_width>
			<custom_boxart_height>360</custom_boxart_height>
		
			<custom_cartridge_x>160</custom_cartridge_x>
			<custom_cartridge_y>410</custom_cartridge_y>
			<custom_cartridge_width>160</custom_cartridge_width>
			<custom_cartridge_height>160</custom_cartridge_height>
		</item>
		

boxart




MARQUEE

correspond à la balise <wheel> de la gamelist

Coordonnées du Marquee / Titre
La zone du Marquee est représentée en jaune sur l'image ci-dessous avec coordonnées en vert

<custom_marquee_ulx> coordonnée X du point en haut à gauche du marquee dans votre template
<custom_marquee_uly> coordonnée Y du point en haut à gauche du marquee dans votre template
<custom_marquee_urx> coordonnée X du point en haut à droite du marquee dans votre template
<custom_marquee_ury> coordonnée Y du point en haut à droite du marquee dans votre template
<custom_marquee_llx> coordonnée X du point en bas à gauche du marquee dans votre template
<custom_marquee_lly> coordonnée Y du point en bas à gauche du marquee dans votre template
<custom_marquee_lrx> coordonnée X du point en bas à droite du marquee dans votre template
<custom_marquee_lry> coordonnée Y du point en bas à droite du marquee dans votre template

Taille du Marquee / Titre

<custom_marquee_width> correspond à la largeur du marquee dans le template (calcul : <custom_marquee_urx> - <custom_marquee_ulx>)
<custom_marquee_height> correspond à la hauteur du marquee dans le template (calcul : <custom_marquee_lly> - <custom_marquee_uly>)

marquee




MARQUEE2

correspond à la balise <wheel> de la gamelist

Il est possible d'afficher un 2eme Marquee/titre à un autre endroit de l'image. Même principe que le MARQUEE
Dans ce cas, il faut ajouter les lignes suivantes :

<custom_marquee2_ulx> coordonnée X du point en haut à gauche du marquee2 dans votre template
<custom_marquee2_uly> coordonnée Y du point en haut à gauche du marquee2 dans votre template
<custom_marquee2_urx> coordonnée X du point en haut à droite du marquee2 dans votre template
<custom_marquee2_ury> coordonnée Y du point en haut à droite du marquee2 dans votre template
<custom_marquee2_llx> coordonnée X du point en bas à gauche du marquee2 dans votre template
<custom_marquee2_lly> coordonnée Y du point en bas à gauche du marquee2 dans votre template
<custom_marquee2_lrx> coordonnée X du point en bas à droite du marquee2 dans votre template
<custom_marquee2_lry> coordonnée Y du point en bas à droite du marquee2 dans votre template

<custom_marquee2_width> correspond à la largeur du marquee2 dans le template (calcul : <custom_marquee2_urx> - <custom_marquee2_ulx>)
<custom_marquee2_height> correspond à la hauteur du marquee2 dans le template (calcul : <custom_marquee2_lly> - <custom_marquee2_uly>)




FANART

correspond à la balise <fanart> de la gamelist

Coordonnées du FANART

<custom_fanart_ulx> coordonnée X du point en haut à gauche du fanart dans votre template
<custom_fanart_uly> coordonnée Y du point en haut à gauche du fanart dans votre template
<custom_fanart_urx> coordonnée X du point en haut à droite du fanart dans votre template
<custom_fanart_ury> coordonnée Y du point en haut à droite du fanart dans votre template
<custom_fanart_llx> coordonnée X du point en bas à gauche du fanart dans votre template
<custom_fanart_lly> coordonnée Y du point en bas à gauche du fanart dans votre template
<custom_fanart_lrx> coordonnée X du point en bas à droite du fanart dans votre template
<custom_fanart_lry> coordonnée Y du point en bas à droite du fanart dans votre template

Taille du fanart

<custom_fanart_width> correspond à la largeur du fanart dans le template (calcul : <custom_fanart_urx> - <custom_fanart_ulx>)
<custom_fanart_height> correspond à la hauteur du fanart dans le template (calcul : <custom_fanart_lly> - <custom_fanart_uly>)




TITLESHOT

correspond à la balise <titleshot> de la gamelist

Coordonnées du TITLESHOT

<custom_titleshot_ulx> coordonnée X du point en haut à gauche du titleshot dans votre template
<custom_titleshot_uly> coordonnée Y du point en haut à gauche du titleshot dans votre template
<custom_titleshot_urx> coordonnée X du point en haut à droite du titleshot dans votre template
<custom_titleshot_ury> coordonnée Y du point en haut à droite du titleshot dans votre template
<custom_titleshot_llx> coordonnée X du point en bas à gauche du titleshot dans votre template
<custom_titleshot_lly> coordonnée Y du point en bas à gauche du titleshot dans votre template
<custom_titleshot_lrx> coordonnée X du point en bas à droite du titleshot dans votre template
<custom_titleshot_lry> coordonnée Y du point en bas à droite du titleshot dans votre template

Taille du titleshot

<custom_titleshot_width> correspond à la largeur du titleshot dans le template (calcul : <custom_titleshot_urx> - <custom_titleshot_ulx>)
<custom_titleshot_height> correspond à la hauteur du titleshot dans le template (calcul : <custom_titleshot_lly> - <custom_titleshot_uly>)




CARTRIDGE

correspond à la balise <cartridge> de la gamelist

Coordonnées de la Cartouche / Cartridge (même principe que Boxart)

<custom_cartridge_x> correspond à la coordonnée X de la cartouche
<custom_cartridge_y> correspond à la coordonnée Y de la cartouche

Taille de la Cartouche/Cartridge

<custom_cartridge_width> correspond à la largeur de la cartouche
<custom_cartridge_height> correspond à la hauteur de la cartouche , Faire attention que (custom_cartridge_y + custom_cartridge_height) ne soient pas > à custom_background_height sinon la cartridge sortirait de l'écran.

Vous pouvez appliquer des valeurs différentes en fonction du format du CARTRIDGE avec la balise <item> (A partir de la version 1882 beta 11

		<item cartridge="portrait">
			<custom_cartridge_x>160</custom_cartridge_x>
			<custom_cartridge_y>410</custom_cartridge_y>
			<custom_cartridge_width>160</custom_cartridge_width>
			<custom_cartridge_height>160</custom_cartridge_height>
		</item>
	
		<item cartridge="landscape">		
			<custom_cartridge_x>40</custom_cartridge_x>
			<custom_cartridge_y>260</custom_cartridge_y>
			<custom_cartridge_width>160</custom_cartridge_width>
			<custom_cartridge_height>160</custom_cartridge_height>
		</item>
	
		<item cartridge="cd">		
			<custom_cartridge_x>160</custom_cartridge_x>
			<custom_cartridge_y>410</custom_cartridge_y>
			<custom_cartridge_width>200</custom_cartridge_width>
			<custom_cartridge_height>200</custom_cartridge_height>
		</item>
		



BOXBACK (à partir de la version 1882 beta 11)

correspond à la balise <boxback> de la gamelist, en général correspond au dos de la boite Pensez à le définir dans l'affectation des media Screenscraper

Coordonnées du BoxBack (même principe que Boxart)

<custom_boxback_x> correspond à la coordonnée X de la cartouche
<custom_boxback_y> correspond à la coordonnée Y de la cartouche

Taille de la BoxBack

<custom_boxback_width> correspond à la largeur de la BoxBack
<custom_boxback_height> correspond à la hauteur de la BoxBack , Faire attention que (custom_boxback_y + custom_boxback_height) ne soient pas > à custom_background_height sinon la BoxBack sortirait de l'écran.

Vous pouvez appliquer des valeurs différentes en fonction du format du BOXBACK avec la balise <item>
		<item boxback="portrait">
			<custom_boxback_x>0</custom_boxback_x>
			<custom_boxback_y>240</custom_boxback_y>
			<custom_boxback_width>360</custom_boxback_width>
			<custom_boxback_height>360</custom_boxback_height>
		</item>
	
		<item boxback="landscape">		
			<custom_boxback_x>0</custom_boxback_x>
			<custom_boxback_y>240</custom_boxback_y>
			<custom_boxback_width>360</custom_boxback_width>
		        <custom_boxback_height>360</custom_boxback_height>
        	</item>
	
		<item boxback="cd">		
			<custom_boxback_x>0</custom_boxback_x>
			<custom_boxback_y>240</custom_boxback_y>
			<custom_boxback_width>360</custom_boxback_width>
			<custom_boxback_height>360</custom_boxback_height>
		</item>

<resize width = “630” height = “540” /> indique à ARRM (depuis la version 1.7.7.6) qu'il doit redimensionner le mix avec une largeur de 630px et une hauteur de 540px




DEFINITION DES LAYERS / COUCHES

ARRM peut combiner 10 layers / couches, qui sont un empilement de la couche la plus au fond (layer1) jusqu'à celle la plus en avant (layer10).
Tous les layers ne sont pas forcément renseignés, comme dans l'exemple donné.
Un layer peut contenir un fichier image .png situé dans le répertoire du template, ou un des tags suivants :

  • screenshot
  • boxart
  • marquee (correspond au tag <wheel> de la gamelist)
  • marquee2 (en cas d'affichage du marquee sur une 2eme position) (correspond au tag <wheel> de la gamelist)
  • cartridge

Dans l'exemple, le background est constitué de l'écran noir de la borne.
Dans l'exemple, le foreground est constitué de la borne. (la zone de l'écran est en mode transparent)
Dans le code xml ci-dessous, on constate que le background (l'écran noir) est d'abord affiché, puis vient le screenshot et ensuite la foreground (la borne). Les layers 4, 5, et 6 seront en avant plan.

<layer1>background.png</layer1>
<layer2>screenshot</layer2>
<layer3>foreground.png</layer3>
<layer4>boxart</layer4>
<layer5>marquee</layer5>
<layer6>marquee2</layer6>
<layer7></layer7>
<layer8></layer8>
<layer9></layer9>
<layer10></layer10>



Partagez vos créations

N'hésitez pas à étudier les templates disponibles, notamment ceux proposant une intégration de la cartouche insérée dans la console (mix_atari_2600_cartridge, mix_snes …) qui vous permettra de comprendre la façon d'utiliser les layers.

Si vous créez des templates, n'hésitez pas à me les faire parvenir par Mail, je les mettrai en téléchargement sur le site des JujuVinceBros dans la section Template pour ARRM, afin d'en faire profiter d'autres utilisateurs d'ARRM.

Attention, si vous créez des templates, utilisez des nouveaux noms de répertoires sinon ils seront supprimés lors d'une désinstallation de l'application lors du processus de mise à jour.
create_template-fr.txt · Dernière modification: 2021/03/24 21:24 de nexusone13

Outils de la page