Outils pour utilisateurs

Outils du site


Panneau latéral

Français


English

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

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

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.

boxart




MARQUEE / TITRE

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




MARQUEE 2 / TITRE 2

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>)




CARTRIDGE / CARTOUCHE

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.


<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
  • marquee2 (en cas d'affichage du marquee sur une 2eme position)
  • 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: 2019/11/01 17:11 par nexusone13