Différences

Ci-dessous, les différences entre deux révisions de la page.

--- tutos:software:frontend:hyperspin:presentation_de_hyperspin [2017/01/08 10:30]
nabubokon [Hyperspin - Présentation du frontend et de ses composants]
+++ tutos:software:frontend:hyperspin:presentation_de_hyperspin [2017/02/01 10:43]
oijkn
@@ Ligne 18: / Ligne 18: @@
 Allez, en route !
 ===== Qu’est ce qu’Hyperspin ? =====
@@ Ligne 59: / Ligne 58: @@
 Il n’y a pas vraiment d’installation, dans l’ordre :
-- Dezipper l’archive d’HS 1.0 dans un dossier sur votre disque dur ;\\ - Extraire l’archive d’HS 1.3.0 dans le même dossier et écraser les anciens .exe par les nouveaux ;\\ - Extraire HyperTheme dans le même dossier qu’Hyperspin et écraser l’ancien ;\\ - Extraire l’archive d’HyperLaunch dans le même dossier et écraser l’ancien ;\\ - Dans le dossier d’HS, créez les dossiers « Emulators » et « Modules »\\ - Vous pouvez supprimer le fichier « EULA – READ ME .txt »
+- Dezipper l’archive d’HS 1.0 dans un dossier sur votre disque dur ;\\
+- Extraire l’archive d’HS 1.3.0 dans le même dossier et écraser les anciens .exe par les nouveaux ;\\
+- Extraire HyperTheme dans le même dossier qu’Hyperspin et écraser l’ancien ;\\
+- Extraire l’archive d’HyperLaunch dans le même dossier et écraser l’ancien ;\\
+- Dans le dossier d’HS, créez les dossiers « Emulators » et « Modules »\\
+- Vous pouvez supprimer le fichier « EULA – READ ME .txt »
 Mais comme ici, on est dans le partage, je vous est déja préparé une archive contenant un Hyperspin vierge, mis à jour et pret à l'emploi. :D
@@ Ligne 78: / Ligne 82: @@
 Wheel : roue en anglais, désigne la roue ou l’image servant a identifier la sub wheel suivante. Sub Wheel : une roue qui se trouve après une autre. Par exemple, le système Mame est dans la Wheel principal et quand on entre dedans pour sélectionner sa rom, on entrera dans sa Sub Wheel, c'est-à-dire sa Wheel de roms. XML : Désigne un ou des fichiers XML présents dans le dossier « Databases ». AHK : Désigne un ou des fichiers AHK présents dans le dossier « Modules ». INI : Désigne un ou des fichiers INI présents dans le dossier « Settings ». HQ : Désigne Hyper HQ.
 ===== Les dossiers =====
@@ Ligne 137: / Ligne 140: @@
 Hyperbrite ne sera pas utile pour la quasi-totalité d’entre nous mais son intérêt est très intéressant. C’est un soft qui permet à Hyperspin d’afficher des données sur des afficheurs à leds externes. Par exemple, le nom d’un système ou d’une rom, des données sur le jeu que l’utilisateur aura paramétré, voir même les High Scores du jeu ! Une petite vidéo sera plus parlante. [[http://www.youtube.com/watch?feature=pl|http://www.youtube.com/watch?feature=pl… pcBQFQu6gQ]]
 ==== HyperHQ ====
@@ Ligne 159: / Ligne 161: @@
 La forme, c'est tout ce qui se rapporte au menu en lui-même :
-- Le nombre de roues affichées ;\\ - Quels seront les jeux affichés par système ;\\ - S'il y a des vidéos/images/animations flash disponibles pour illustrer tel menu ou tel jeu ;\\ - Etc …
+- Le nombre de roues affichées ;\\
+- Quels seront les jeux affichés par système ;\\
+- S'il y a des vidéos/images/animations flash disponibles pour illustrer tel menu ou tel jeu ;\\
+- Etc …
 Les répertoires concernés sont "Databases" (pour les listes de roms en xml avec plus ou moins d'infos complémentaires à afficher comme l'éditeur ou l'année de sortie du jeu) et "Media" (pour y coller tous les médias liés à votre liste de jeux).
@@ Ligne 165: / Ligne 170: @@
 Le fond, c'est ce qu'il se passe avec entre l’émulateur et Hyperspin dès que vous lancez ou stoppez un jeu :
-- Lancer tel ému, avec tels paramètres ;\\ - Charger un iso dans un lecteur virtuel ;\\ - Lancer un logiciel tiers pour ajouter par exemple le support des fichiers 7zip alors que de base l'émulateur ne les reconnait pas ;\\ - Sauvegarder les hi-scores en quittant le jeu ;\\ - Etc …
+- Lancer tel ému, avec tels paramètres ;\\
+- Charger un iso dans un lecteur virtuel ;\\
+- Lancer un logiciel tiers pour ajouter par exemple le support des fichiers 7zip alors que de base l'émulateur ne les reconnait pas ;\\
+- Sauvegarder les hi-scores en quittant le jeu ;\\
+- Etc …
 Les répertoires concernés sont "Modules" (pour y coller les fichiers ahk de chaque émulateur spécifique) et " Settings" (qui stocke les paramètres de base pour chaque roue).
@@ Ligne 176: / Ligne 185: @@
 Je pense avoir fait un premier jet complet sur ce qu’est Hyperspin et comment il s’articule. Le second tuto portera uniquement sur HyperHQ et détaillera tous ses menus et options.
+====== Hyperspin - Utilisation d’Hyper HQ ======
+Pour retrouver la première partie du Tuto sur Hyperspin, c'est par ici : [[http://forum.hfsplay.fr/viewtopic.php?f=25&t=590|viewtopic.php?f=25&t=590]]
+Maintenant que nous avons vu le fonctionnement d’Hyperspin, je vais maintenant aborder l’utilisation de l’utilitaire de configuration du frontend, HyperHQ.
+Voici la version PDF sur le cloud : [[https://mega.co.nz/#!lJhQEJ4K!a7OmPFLrNr2a8kot1XBh9EME4vBQDf22oiqi7a5ofrI|https://mega.co.nz/#!lJhQEJ4K!a7OmPFLrNr2a8kot1XBh9EME4vBQDf22oiqi7a5ofrI]]
+Sans doute votre meilleure ami dans cette aventure, cet exécutable est une interface de configuration d’Hyperspin. Entre beaucoup d’autres, il vous permettra d’afficher vos systèmes sous HS, de lier vos émulateurs au frontend pour qu’ils puissent se lancer, etc.\\
+Il présente toutes les options sous la forme d’onglets, eux même contenant d’autres onglets dans lesquels nous pourrons paramétrer toutes les options nécessaires au bon fonctionnement d’HS.\\
+Je les présenterai dans un ordre différent de leur affichage pour être cohérent, dans un premier temps la configurer de l’interface en elle-même avec « Main Settings » et « Controls », puis l’ajout et la liaison des émulateurs à Hyperspin avec « Main Menu Wizard » et « Wheel Settings » dans un second temps, l’onglet « About » ne servant strictement à rien.
+Décortiquons ensemble la première partie.
+----
+===== Main Settings =====
+Dans cette partie, vous allez pouvoir configurer ce qui est uniquement lié à l’interface d’HS, à savoir la partie graphique, sonore et pratique (contrôles, attract mode…) du frontend.
+==== General ====
+{{http://img15.hostingpics.net/pics/957810HyperHQ1.jpg?nolink&652x515}}
+__//**Mode**//__ : Permet de choisir si HyperSpin tournera pour gérer un émulateur (Single, une seul Wheel avec les roms de ce système) ou en faire une interface multi émulateurs (Multi, avec donc une Wheel pour le choix des systèmes et des Sub Wheels pour la sélection de leurs roms). Le menu déroulant « Single Mode Name » permet de choisir l’émulateur si l’on choisit le mode Single.
+__//**Use Last System**//__ : Permet à la Wheel des systèmes (en mode Multi uniquement) de revenir automatiquement sur le dernier émulateur utilisé lors du prochain lancement d’HS.
+==== Screen ====
+{{http://img15.hostingpics.net/pics/635644HyperHQ2.jpg?nolink&651x511}}
+__//**FullScreen et Windowed Resolution**//__ : Cochez cette case si vous voulez avoir HS en plein écran et indiquez la résolution souhaitée dans les 2 cases (cela vaut pour les 2 modes, WS ou FS)
+__//**Scanlines**//__ : Permet d’appliquer un filtre avec Scanlines pour ajouter une touche « Arcade » sur un écran LCD.
+__//**Scanlines Image**//__ : Definir le type de scanlines que l’on souhaite avoir si l’option « Scanlines » est activé. Cliquez sur l’icône du dossier pour avoir accès aux types de scanlines proposés.
+__//**Scanlines Scale**//__ : Permet d’augmenter l’épaisseur des scanlines. Par exemple, la valeur de 2 multiplie leur épaisseur par 2.
+__//**Scanlines Alpha**//__ : Permet d’augmenter la visibilité des scanlines.
+==== Optimizer ====
+{{http://img15.hostingpics.net/pics/341640HyperHQ3.jpg?nolink&647x512}}
+__//**App Quality**//__ : Ce choix est un réglage automatique de toutes les options de cet onglet qui défini les paramètres graphiques d’Hyperspin. En fonction de la puissance de votre MameBox, choisissez une des 4 options ou réglez vous-même les options suivantes.
+//__**Image Smoothing**__// : Sert à adoucir l’image donc limiter le crènelage ou les saccades lors de l’affichage des thèmes.
+__//**Tous les paramètres Backgrounds et Artworks entourés en rouge**//__ : Permet de sélectionner le nombre d’effets affichés dans un thème. En rajouter permet d’avoir une interface plus complète, plus jolie mais plus gourmande en ressources.
+__//**CPU Priority**//__ : Définit la priorité d’Hyperspin pour Windows. Dans le cas d’une MameBox, cela ne joue en rien donc à vous de voir.
+==== Attract ====
+{{http://img15.hostingpics.net/pics/560555HyperHQ4.jpg?nolink&649x513}}
+__//**Attract Mode et Time et Max Spin Time**//__ : Petite option sympa d’Hyperspin, l’Attract Mode permet de faire tourner la roue dans laquelle vous êtes au bout d’un temps d’inactivité et que la borne est sans joueur. L’option « Time » permet de définir au bout de combien de temps d’inactivité le lancement de la roue s’effectuera et « Max Spin Time » définira le temps de rotation de la roue avant qu’elle ne s’arrête sur un système.
+__//**Wait For Video**//__ : Permet d’ordonner à l’Attract Mode d’attendre la fin de la vidéo du thème sur lequel la roue est arrêtée avant de reprendre sa rotation.
+==== Sound ====
+{{http://img15.hostingpics.net/pics/321884HyperHQ5.jpg?nolink&648x510}}
+Permet de régler le volume principal du système, des vidéos dans les thèmes, des bruitages lors de la rotation de la Wheel et des bruitages de l’interface en général.
+==== Startup/Exit ====
+{{http://img15.hostingpics.net/pics/999683HyperHQ6.jpg?nolink&650x511}}
+__//**Intro Video**//__ : Il est possible de mettre une vidéo d’introduction lors du lancement d’Hyperspin. Une est déjà fournie par défaut mais vous pouvez très bien la changer par une de votre choix. Pour ce faire, il suffit d’avoir sa vidéo au format FLV, de la renommer « Intro.flv » et de la placer dans « Hyperspin\Media\Frontend\Video » en écrasant celle par défaut.
+Un exemple de vidéo d’intro, celle que j’utilise en l’occurrence : [[http://www.youtube.com/watch?v=TCaH7D96EFw|http://www.youtube.com/watch?v=TCaH7D96EFw]]
+__//**Stop Intro on Keypress**//__ : Permet de sauter la vidéo d’intro en appuyant sur un bouton, je vous conseille de la cocher.
+__//**Exit Menu et Exit Defau**//__lt : Permet d’avoir un menu vous demandant la confirmation de quitter Hyperspin. Je vous conseille de laisser ces 2 options cochées pour pouvoir revenir correctement en arrière dans vos Wheels et de ne pas faire de conneries.
+__//**Exit HyperSpin et Exit Action**//__ : Laisser la première option cochée et choisissez si en quittant Hyperspin, vous voulez seulement le fermer ou couper la MameBox (pratique quand le PC est intégré dans une borne).
+__//**Startup Program et Exit Program**//__ : Permet de lancer des programmes automatiquement au lancement et à la fermeture d’Hyperspin. Cela peut être par exemple utile avec Joy2Key pour le lancer avec HS si vous l’utilisez.
+==== Tools ====
+{{http://img15.hostingpics.net/pics/810087HyperHQ7.jpg?direct&}}
+Cet onglet ne servira surement à aucun d’entre nous, il permet d’utiliser LEDBlink, un soft en rapport avec HyperBrite qui vous permettra donc de regler votre afficheur LED externe et d’y activer le défilement des Hi Scores.
+===== Controls =====
+{{http://img15.hostingpics.net/pics/772305HyperHQ8.jpg?nolink&646x508}}
+Cet onglet va vous permettre de régler les commandes de l’interface (pas ceux des émulateurs attention !!!!). Vous pourrez y configurer les touches d’un clavier (pour l’utilisation avec un JammASD, J-PAC par exemple), d’une manette avec joysticks analogiques, ainsi que la sensibilité d’un Trackball ou d’un Spinner si vous en possédez.
+Up : Haut\\
+Down : Bas\\
+Skip Up : Navigation rapide Haut (rester appuyer 3 secondes pour faire apparaître le tri par lettres)\\
+Skip Down : Navigation rapide Bas (rester appuyer 3 secondes pour faire apparaître le tri par lettres)\\
+Skip Up Num : Avancer dans la roue de x jeux (x = nombre de jeux)\\
+Skip Down Num : Reculer dans la roue de x jeux (x = nombre de jeux)\\
+Hyperspin : Maintenir appuyé pour accélérer la roue pendant les recherches\\
+Genre : Genre\\
+Favorites : Vos favoris\\
+Start : Valider\\
+Exit : retour arrière et quitter Hyperspin
+----
+Allez, en avant pour la seconde partie.
+----
+===== Main Menu Wizard =====
+{{http://img15.hostingpics.net/pics/524896HyperHQ9.jpg?nolink&651x509}}
+C’est par l’intermédiaire de cet onglet que vous allez pouvoir ajouter ou retirer un émulateur à l’interface d’HyperSpin.
+Commençons par supprimer tous les systèmes pré installés d’HS à l’exception d’un pour la suite des évènements. Cliquez sur « __//**Remove item from Main Menu**//__ » :
+{{http://img15.hostingpics.net/pics/568377HyperHQ14.jpg?nolink&648x511}}
+Vous allez pouvoir ici retirer des systèmes installés que vous ne voulez plus. Dans notre cas nous allons __**supprimer tous les systèmes pré installés à l’exception d’un (n’importe lequel) pour pouvoir en ajouter par la suite**__. Vous avez le choix entre 2 options, soit retirer juste le système de la Database d’Hyperspin et de conserver tous les éventuels fichiers que vous avez installés pour cet émulateur (émulateurs avec roms, medias, fichiers ini et ahk), soit supprimer complètement tout le contenu (Fully Remove). Partons sur cette deuxième option puis validez à chaque fois.
+Une fois qu’il ne vous reste plus qu’un système installé, passons à l’étape la plus intéressante de cette partie à savoir l’ajout d’un nouveau système dans la base de données d’Hyperspin. Revenez sur « Main Menu Wizard et cette fois ci cliquez sur « __**Add new item to the Main Menu**__ », vous arriverez la dessus :
+{{http://img15.hostingpics.net/pics/413531HyperHQ10.jpg?nolink&647x509}}
+C’est ici que vous nommerez vos systèmes. Alors attention, point très très important, Hyperspin est extrêmement sensible au nommage des fichiers. Une majuscule ou un accent oublié, un espace en trop et il ne trouvera tout simplement rien. Vous verrez par la suite (surtout dans le nommage de vos médias et de vos roms) que cela pourra vous prendre énormément de temps à tout renommer correctement pour que tout fonctionne.
+Dans ce tuto, je vais prendre pour exemple Mame. Peu importe la version de Mame que vous utiliserez, nommez seulement le système Mame comme sur la photo ci-dessus. Continuons en cliquant sur « Next » :
+{{http://img15.hostingpics.net/pics/112997HyperHQ11.jpg?nolink&648x510}}
+Dans cette nouvelle page, HyperHQ nous demande si le système que l’on veut installer nécessitera une Sub Wheel pour les roms et iso, ou si l’élément que vous voulez installer sur Hyperspin est un exécutable (comme un jeu PC par exemple) qui ne nécessitera qu’une entrée dans la Wheel des systèmes pour être lancé.
+Dans les 2 cas, si vous avez déjà des émulateurs installés sur HS, vous arriverez sur cette page :
+{{http://img15.hostingpics.net/pics/593843HyperHQ12.jpg?nolink&649x513}}
+Vous devez ici choisir où placer ce nouvel émulateur dans le Wheel des systèmes. Cela peut être utile pour classer ses émulateurs par fabriquant (Arcade, Sega, Nintendo, Sony…). Vous n’avez qu’à cliquer sur un système déjà installé et l’ajouter avant ou après.
+{{http://img15.hostingpics.net/pics/191267HyperHQ13.jpg?nolink&1289x509}}
+Bien joué ! Vous venez donc de créer les dossiers et fichiers par défaut d’un nouveau système dans l’interface d’Hyperspin. A la suite de ces 2 écrans de confirmation, supprimez le système que vous aviez gardé au départ et, une fois cela fait, vous pouvez aller directement dans l’onglet « Wheel Settings » pour lier votre émulateur au nouveau système dans HS, suite du tuto.
+===== Wheel Settings =====
+C’est dans ce dernier onglet que nous allons maintenant pouvoir lier un émulateur correspond au système que nous venons d’installer dans Hyperspin. Dans cet exemple, nous utiliserons Mame pour une suite logique au tuto.
+==== Emulator ====
+C’est dans cet onglet que tout se passe réellement. Dans le menu défilant « Choose A Wheel », sélectionnez la Wheel Mame que nous venons de créer et vous devriez arriver sur cela :
+{{http://img15.hostingpics.net/pics/721436HyperHQ15.jpg?nolink&649x511}}
+__//**Execution**//__ : Permet de sélectionner si l’émulateur se lancera avec HyperLaunch ou indépendamment d’Hyperspin. Vu que l’on va travailler tout le temps avec HyperLaunch et ses modules, je vous conseille de toujours laisser ce choix coché.
+__//**PC Game**//__ : Permet de signaler si le système choisi est un jeu PC ou non. Pour tout émulateur, laissez sur « Disable ».
+__//**Executable**//__ : Cliquez sur l’icône du dossier pour rechercher l’exe de votre émulateur. Je vous conseille très fortement d’installer tous vos émulateurs et systèmes dans le dossier « Emulators » créé dans le précédent tutorial.
+**//__Rom Path__//** : Cliquez sur l’icône du dossier pour rechercher le dossier contenant les roms de votre système. Je vous conseille 2 manières de procéder pour ranger vos roms.
+- Soit de créer un dossier appelé « Roms » dans chacun de vos systèmes qui les contiendra ;\\
+- Soit de créer dans le dossier « Emulators » un dossier nommé « Rom Files » qui contiendra un sous dossier du même nom que votre système, dans lequel vous mettrez vos roms.
+J’ai personnellement opté pour la première solution et c’est celle que j’utiliserai dans les tutos suivants mais libre à vous, cela n’a pas vraiment d’importance.
+**//__Params__//** : Personnellement jamais utilisé, ce champ permettra d’inscrire des paramètres spécifiques pour le lancement d’un émulateur.
+Extensions : Vous inscrirez ici l’extension de vos roms en fonction de l’émulateur que vous utiliserez. Cela peut être zip, iso, cue, scf, md…. Toujours les noter sans le point et si il y’en a plusieurs a notifier, les séparer avec une virgule et un espace (par exemple : iso, cue, bin….)
+**//__Use Full Path To Roms__//** : Ce champ est important si vous comptez lancer vos jeux à partir de l’invité de commande et qui vous permettra d’utilisé le chemin complet de la rom. Laissez sur « Disable » si vous n’êtes pas dans ce cas.
+**//__Search Subfolders__//** : Cochez cette options si vos roms se trouvent dans des sous dossiers de votre dossier de roms, Hyperspin checkera tout seul ces sous dossiers lors du lancement du jeu.
+**//__WinState__//** : Sert à cacher Windows, toujours utiliser HIDDEN dans le cas d’une MameBox.
+==== Wheel ====
+{{http://img15.hostingpics.net/pics/865531HyperHQ16.jpg?direct&}}
+Vous ne toucherez quasiment jamais cet onglet qui sert à régler différents paramètres de la Sub Wheel du système, seulement dans le cas d’une MameBox configuré en vertical.
+__//**Style**//__ : Choisir le style du système. Vous avez le choix entre la roue standard effet 3D vertical, le défilement vertical, une roue horizontal avec fort zoom sur le système sélectionné ou un défilement horizontal.
+**//__Speed__//** : Modifier la vitesse de rotation de la Wheel (lent, moyen, rapide)
+**//__Position et Vertical 3D Position__//** : Choisir la position de la Wheel sur l’écran (droite, gauche, centre).
+**//__Wheel Images Sizes__//** : Modifier en pixels la taille des images de Wheel.
+**//__Horizontal Y__//** : Déplacement de la roue dans l'espace sur l'axe Y (de gauche a droite en position verticale, de haut en bas en position horizontale).
+**//__Alpha__//** : Réglez l’opacité des images de Wheel.
+**//__Pointer__//** : déplacement du pointeur sur les axes X et Y
+==== Navigation/Themes ====
+{{http://img15.hostingpics.net/pics/545570HyperHQ17.jpg?direct&}}
+Cet onglet vous permet de régler des quelques paramètres de navigation dans votre Wheel système et sa Sub Wheel de roms.
+**//__Game Jump__//** : Indiquez le nombre de jeux sautés lorsque vous appuyer sur la touche de saut d’Hyperspin.
+**//__Remove Wheel Info et Remove Textfield Info__//** : Supprime toutes les informations entre parenthèses (année de sortie du jeu, éditeur…) après la description du jeu ou du système.
+**//__Use XML Indexes__//** : Vous pouvez éditer vos fichiers XML en y ajoutant des balises de saut qu’Hyperspin repérera si vous utiliser la touche de saut dans la Wheel. Nous y reviendrons.
+**//__Jump Timer__//** : Détermine le temps que le joueur devra rester appuyé à gauche ou à pour arriver sur la Wheel de sélection de lettre.
+**//__Clones Use Parents Vids et Clone Use Parents Themes__//** : Cochez ces options si vous voulez que les roms clones utilisent les mêmes thèmes que les roms parents.
+**//__Animate Out Default Themes__//** : Permet de garder la même animation des Thèmes par défaut d’HS. Pas vraiment utile.
+**//__Reload Backgrounds__//** : Cochez cette case si vous voulez que l’image de fond par défaut se recharge à chaque fois que vous changer d’élément dans une Wheel
+**//__Wheel Entrance Options__ // **
+- //__Return to last game__// : Cochez cette case si vous souhaitez qu’en entrant dans une Wheel, Hyperspin retourne directement sur le dernier jeu lancé ;\\
+- __//Start on random games//__ : Cochez cette case si vous voulez qu’en entrant dans une Wheel, Hyperspin lance un jeu au hasard directement.
+**//__Wheel Filters__//** : Les 4 options permettent de filtrer l’affichage d’une Wheel avec uniquement les jeux disposant d’un thème (Themes Only), d’une image de Wheel (Wheels Only), uniquement les roms parents des jeux et non les clones (Parents Only) ou seulement les roms que vous avez dans le dossier roms que vous aurez sélectionné (Roms Only).
+==== Video ====
+{{http://img15.hostingpics.net/pics/672233HyperHQ18.jpg?direct&}}
+Tout simplement, l'endroit ou vous indiquez le chemin d’accès aux vidéos. Cliquez sur l’icône du dossier et recherchez l’emplacement de votre dossier de vidéos qui sera normalement dans « Hyperspin\Media\le nom de votre système\Video »
+==== Sounds ====
+{{http://img15.hostingpics.net/pics/785370HyperHQ19.jpg?nolink&652x513}}
+**//__Enable Wheel Game Sounds__//** : Activez ou désactivez les sons émis lors de l’affichage des thèmes de vos jeux.
+**//__Enable Wheel Click Sound__//** : Activez ou désactivez les bruitages lors du défilement de la Wheel.
+==== Special Art ====
+{{http://img15.hostingpics.net/pics/316660HyperHQ20.jpg?nolink&651x513}}
+Onglet que je n’utilise personnellement pas qui permet de définir les paramètres d’affichage (position, apparition, durée…) des éventuels Artworks que vous aurez ajouter dans votre dossier Media.
+----
+Nous en avons donc terminé avec HyperHQ, un bon bout de chemin de parcouru même si la route reste encore longue avant le Saint Graal d’une interface terminée. La prochaine partie du tuto traitera du dossier « Databases » et vous permettra de comprendre le fonctionnement et la compilation de vos fichiers XML pour l’affichage de vos systèmes et jeux dans Hyperspin.
+Pour la 3ème partie, en avant : [[http://forum.hfsplay.fr/tutos-pour-hyperlaunch/hyperspin-partie-databases-les-xml-hypersp-t786.html|tutos-pour-hyperlaunch/hyperspin-partie-databases-les-xml-hypersp-t786.html]]
+====== Hyperspin - Le dossier « Databases », les XML et Hyperspin ======
+Dans cette troisième partie de ce dossier, je vais détailler ce qu’il se passe dans le dossier « Databases », à quoi sert-il, ce que sont des fichiers XML, de quoi ils sont composés, comment les éditer rapidement, etc.
+Voici le tuto en version PDF sur le cloud : [[https://mega.co.nz/#!wZwEyRRS!NgfsSD8pO1C4pW0LB0Bm4CZkj8IZKic02mO-OWxVno8|https://mega.co.nz/#!wZwEyRRS!NgfsSD8pO1C4pW0LB0Bm4CZkj8IZKic02mO-OWxVno8]] (816 Ko)
+Nous allons commencer par voir ce qu’est un fichier XML, composant principal de ce dossier.
+===== Les fichiers XML =====
+Un fichier XML contient les informations (la base de données donc !) qui permettront a Hyperspin de savoir ce qu’il doit afficher. Voila comment il est édité (servez vous du Bloc Notes pour l’ouvrir) :
+{{http://img15.hostingpics.net/pics/1207381FichierXML.jpg?nolink&698x424}}
+Dans cet exemple, je vais me servir du fichier XML du système Taito Type X2 mais n’ayez pas peur, tous les fichiers XML sont faits de la même façon quelque soit le système.\\
+Pour chaque jeu, vous devrez suivre le même chemin pour éditez le XML à la main.
+La première ligne (le 3 rouge) est la balise où est inscrit **le nom de la rom** (juste après « name= »). Le reste de la balise n’est pas important.
+La deuxième balise description (le 4 vert) est la balise où est inscrit **le nom du jeu**.
+Les balises cloneof et crc ne servent qu’à indiquer a Hyperspin si la balise est un clone ou un boot d’une autre rom.
+Les balises suivantes (les 7, 8, 9, 10 encadrés en bleu) permettent à Hyperspin d’afficher des infos sur le jeu en plus du thème comme l’éditeur (manufacturer), l’année de sortie (year), le genre du jeu (genre) et son classement PEGI (rating). Elles sont généralement en bas à gauche de l’affichage, comme ceci :
+{{http://img15.hostingpics.net/pics/8571082InfossurThemes.jpg?direct&}}
+Et enfin, la balise enable (le 11 encadré en noir) est une balise qui vous permettra de dire à Hyperspin si il doit ou non afficher ce jeu avec les autres (Yes ou No).
+Ce fichier XML se trouver dans un dossier portant le même nom que le système que vous avez ajouté dans Hyperspin, qui lui-même devra se trouver dans le dossier « Databases » que nous allons voir maintenant.
+===== Le dossier « Databases » =====
+Databases, comme son nom l’indique en anglais, regroupe la base de données (sous forme de fichiers XML) de chaque système installé dans Hyperspin pour afficher vos wheels de systèmes et de jeux.
+**Vous aurez beau avoir une installation remplie jusqu'à la gueule d’émulateurs et de roms, si Hyperspin ne les voit pas (absence de fichier XML) ou ne comprend pas comment elle doit les afficher (erreurs dans l’édition des fichiers XML), il n’affichera tout simplement rien, ce qui serait un peu con !^^**
+Il doit avoir cette forme :
+{{http://img15.hostingpics.net/pics/8063213CompositiondeDatabases.jpg?direct&}}
+Au dessus, vous avez le contenu du dossier « Databases » en lui-même, donc d’un dossier par système installé dans Hyperspin qui doit avoir le même nom. Et en dessous vous avez le contenu du dossier du sytème installé.
+J’insiste bien sur le nommage car **un accent, un espace ou une majuscule en moins ou en trop et Hyperspin n’affichera rien car il ne comprendra pas**. Par exemple, pour le système que j’ai nommé « Taito Type X2 » dans HyperHQ, je dois avoir pour sa base de données le chemin suivant :
+Hyperspin\Databases\Taito Type X2\Taito Type X2.xml
+**Mêmes majuscules, mêmes espaces, tout pareil !**
+===== Edition de fichiers XML =====
+Alors, maintenant que l’on sait ce qu’est un XML, où il doit être placé et comment il est composé, vous allez me dire : « Putain, si je dois faire ca à la main pour toutes mes roms de chacun de mes systèmes, je ne suis pas sorti !!! ».
+Ou alors en prenant mon exemple en cas concret. Non intéressé par les fullset de MAME, Megadrive ou Super Nintendo, j'ai supprimé les roms bootleg et autres bouzes auxquelles je ne jouerai jamais et que je ne souhaitais pas avoir sur ma Mamebox. Je me suis dis "Chouette, j'ai supprimé mes roms donc elles ne s'afficheront plus dans les wheels d'Hyperspin !".\\
+Et bien non, à cause des fichiers xml des émulateurs, où sont recensés tous les jeux du système émulé et où Hyperspin vient piocher pour savoir ce qu'il à a afficher, elles continuaient à polluer mon Hyperspin.
+Alors rassurez vous, il existe des petits softs qui vont pouvoir faire cela automatiquement pour vous en scannant votre dossier contenant vos roms et en générant un XML contenant tout ce qu’il va falloir à Hyperspin pour les afficher !
+Pour faire ceci, je vous propose d’utiliser HyperRom2XML.
+Dans un premier temps, téléchargez le soft : [[https://mega.co.nz/#!lURFTIaI!KB8YCQ5PejIHP-Q1BlanUE4AIj1b0uh-aL5a8zEPyB8|https://mega.co.nz/#!lURFTIaI!KB8YCQ5PejIHP-Q1BlanUE4AIj1b0uh-aL5a8zEPyB8]] (102 Ko)
+Décompressez le où vous voulez, moi j'ai choisi le dossier Hyperspin. Ensuite, ouvrez le logiciel, vous tomberez la dessus :
+{{http://img15.hostingpics.net/pics/4622374HyperRom2XML1.jpg?direct&}}
+En 1 : Vous mettez l'emplacement de votre répertoire de roms déjà triés.
+En 2 : Sois vous mettez l'emplacement de l'ancien fichier XML (normalement dans \Hyperspin\Databases\le système en question\) pour l'écraser et le remplacer par le nouveau qui sera généré par le software, sois un autre emplacement en le nommant avec le nom du système, pour garder une copie de votre ancien XML au cas où.
+En 3 : Uniquement si cela concerne des roms pour Mame et que vous avez la case correspondante, vous mettez l'emplacement de votre exécutable de Mame.
+Et enfin la checkbox « Remove Tags from Game Description » supprimera les infos des jeux si vous n’en voulez pas.
+Voila ce que cela doit donner pour un nouvel XML de Mame :
+{{http://img15.hostingpics.net/pics/1137485HyperRom2XML2.jpg?direct&}}
+Ensuite cliquez sur GO et vous aurez un message vous disant que l'opération à été réussi avec succès. Et voila, en 10 secondes, vous avez un Hyperspin soit rempli avec tous vos jeux, soit vidé de tout ce que vous ne vouliez plus.
+Voila pour ce tuto sur les Databases et XML. La prochaine partie concernera le dossier « Media », comment il est articulé, comment ajouter des medias, etc.
+Hyperspin Partie 5 – Le dossier « Media », l’habillage d’HyperSpin
+Cinquième partie de ce dossier qui va traiter de tous les médias à insérer dans son Hyperspin. Je vais commencer par détailler la structure du dossier « Media », chaque type de média avec leurs caractéristiques, ou et comment les insérer, ainsi que la chose la plus importante au niveau de la personnalisation, comment créer ses propres médias et comment les partager avec la communauté.
+Je détaillerai au fur et à mesure de cet article les différentes manières d'éditer ses médias grâce à d'autres tutos écrits et vidéos que moi et d'autres membres du forum ont monté pour vous.
+En avant !
+Qu'est ce qu'un média ?
+Dans Hyperspin, on appelle médias tous les éléments qui permettent "d'habiller" son frontend et de le personnaliser. En effet toute l'interface d'Hyperspin peut être entièrement modifiée pour obtenir une configuration unique en fonction de ses goûts.
+Il existe au jour d'aujourd'hui une multitude de médias que l'on peut mettre dans Hyperspin, tous entièrement créés par les passionnés de la communauté arcade et HS, que l'on peut trouver gratuitement (la plupart du temps, quand les billets verts ne sont pas encore montés au cerveau de ceux qui les distribuent), en voici une liste non exhaustive mais qui regroupe les principaux médias que vous aurez sûrement à manipuler :
+- Thèmes\\
+- Wheels\\
+- Vidéos\\
+- Artworks\\
+- Sons\\
+- Pointeurs
+Tous ces éléments se complètent pour former une interface complète, homogène et agréable. Et grâce aux outils fournis par les créateurs d'Hyperspin et à de légères bases en édition d'image et de vidéo, vous serez en mesure de créer vos propres médias, soit qu'il vous manque, soit pour personnaliser un peu plus votre installation.
+Mais comme tout ajout dans Hyperspin, les médias ne se configurent pas n'importe comment et quelques règles sont à respecter pour qu'HS puissent trouver les bons médias que vous avez insérer pour les afficher. Avant de détailler chaque média dans les paragraphes qui vont suivre, il est pour moi important de connaître ces 2 règles d'or que je répéterai pour limiter au maximum les erreurs :
+. Chaque média (quelque soit son type) devra être nommé de la même façon que la ROM avec laquelle il est censé fonctionner, à la virgule près. Comme d'habitude, Hyperspin est très sensible au nommage des fichiers.\\
+. Les formats des médias (précisés dans la suite du tuto)sont extrêmement important pour un affichage dans HS. Une erreur de format, aucun affichage.
+Avec ces 2 règles à l'esprit, vous résoudrez seul 99.9% des problèmes de médias. Si votre média ne s'affiche pas dans HS, cela vient d'une ou de ces 2 choses, c'est aussi simple que ça.
+Le dossier « Media »
+Tous les médias seront à placer dans un des sous dossiers du dossier « Media » qui est structuré de la façon suivante :
+Image
+/ En premier lieu, vous avez accès au dossier « Media » à la racine de votre Hyperspin.
+/ A l’intérieur vous avez 3 types de dossiers (que je vais nommé « dossiers principaux » dans la suite du tuto) :
+Frontend : Contient tous les médias des menus d’Hyperspin (menu exit, différentes flèches et transitions entre wheels, vidéo d’intro d’Hyperspin, etc). Particularité de ce dossier, il est le seul à ne pas posséder de sous dossier « Themes », ce qui est logique vu qu’il ne regroupe que les éléments des menus.
+Main Menu : Contient tous les médias de la Wheel système (thèmes système, wheels systèmes, vidéos d’intro systèmes, etc)
+Tous les autres dossiers correspondent à un système installé dans Hyperspin (HyperHQ crée ce dossier à chaque installation d’un nouveau système avec le même nom) et contiennent donc les thèmes, wheels, images et vidéos des jeux proprement dits.
+/ Dans chacun de ces dossiers principaux de Media, vous retrouverez 4 sous dossiers (nommés « dossiers secondaires » dans la suite) :
+Images
+Image
+Ce dossier secondaire contiendra tous les Artworks, Wheels (voir partie sur les types de medias, un peu plus bas) et éléments de customisation d'Hyperspin. Il contient les sous dossiers suivants :
+Artwork 1,2,3 et 4 – Vous placerez ici vos Artworks que je décris plus bas.
+Backgrounds – Placez ici des Backgrounds visible lors des transitions entre 2 jeux quand vous tourner la wheel.
+Genre – Dans ce dossier, vous pourrez placer des wheels et des backgrounds à appliquer pour l'affichage des genres que vous aurez peut être créé (Foot, Puzzle Game, Vs Fighting, etc).
+Letters – Vous pouvez placer ici des types de polices de texte pour encore plus personnaliser votre interface.
+Others – Insérez ici vos pointeurs.
+Particle – Très peu utilisé, permet ici d'insérer des effets de particule personnel qui peuvent être utilisés en combinaisons avec différents Artworks.
+Special – Permet d'éditer ici les textes des genres de vos jeux si vous en avez créer.
+Wheel – Comme le port salut, mettez vos médias Wheels dans ce dossier.
+Sounds
+Image
+Ce dossier secondaire vous permet de customiser la partie sonore d'Hyperspin en y plaçant des pistes personnalisés.
+Background Music - Placez ici des pistes musicales personnalisés pour chaque jeu. Elles devront être nommé de la même façon que les roms et muteront les bandes sonores des vidéos.
+System Exit – Vous pouvez mettre ici vos pistes ou bruitages qui seront joués lorsque vous rentrerez dans la Wheel du système correspondant au dossier.
+System Start – Même principe que l'option précédente mais lorsque vous rentrerez dans la wheel du système correspondant a ce dossier.
+Wheel Sounds – Ici seront placés les sons que vous voulez entendre à chaque fois que vous tournerez la wheel et remplacer les sons de base d'Hyperspin. Normalement, ce dossier est vide et toutes les wheels jouent les sons de base d'HS présents dans le dossier « Wheel Sounds » du dossier principal « Main Menu ».
+Themes
+Image
+Sans grande surprise, ce dossier sera celui dans lequel vous placerez tous vos thèmes, soit de vos systèmes (dans le dossier principal « Main Menu »), soit de vos jeux et default (dans le dossier principal du système concerné). Voir le type de média « Themes » pour plus de détails
+Video
+Image
+Seconde évidence, ce dossier secondaire sera celui qui contiendra toutes vos vidéos de vos thèmes (voir le type de média « vidéo » pour plus de détails). Le dossier « Override Transitions » pourra contenir des transitions de vidéos que vous pourrez créer et qui seront adaptés à tel ou tel jeu (très peu utilisé).
+ATTENTION : La vidéo d'introduction d'Hyperspin (celle qui se lance lorsqu'Hyperspin se lance) se place dans le dossier « Medias\Frontend\Video » et non dans celui ci.
+Ceci étant dit, passons à la suite du tuto avec la présentation de chaque média.
+Les différents types de médias, caractéristiques et installation
+LES THEMES (format ZIP)
+Image
+Les thèmes sont les principaux médias d'Hyperspin. Tous les thèmes existants sont du contenu créé par les membres de la communauté qui habilleront l'interface pour chaque jeu ou système que vous afficherez. De nombreux thèmes sont disponibles sur notre cloud ou sur la board officielle mais il en reste encore beaucoup a créer alors à vous de jouer et partager vos créations !
+Petite précision, bien qu'ils soient créés de la même façon, il existe 3 grandes natures de thèmes :
+Le thème « Game » - C'est un thème créé pour un jeu en particulier. Principalement axé sur les jeux MAME et arcade. Theme au centre sur l'image.
+Le thème « System » - C'est un thème créé pour habiller l'entrée d'une Wheel système. Theme de gauche sur l'image.
+Le thème « Default » - C'est un thème « générique » qui comblera l'absence de thème « Game ». Il peut être utilisé en relation avec des Artworks de Box, de CD ou de cartouches par exemple pour personnalisé chaque jeu avec ses artworks. A noter qu'il ne sera utilisable que dans une roue système. Très utilisé pour les systèmes basés sur des consoles. Theme de droite sur l'image.
+Quoi qu'il en soit, un thème (peu importe sa nature) est une archive au format ZIP et qui doit être nommé de la même manière que le jeu ou le système avec lequel il est lié. Un thème default sera simplement nommé « Default.zip »
+HFS TUTO ! Un tutoriel réalisé par moi même sur la création d'un thème pas a pas en 2 parties, l'une écrit et l'autre en vidéo, est disponible sur le forum, jetez y un œil pour apprendre a créer vous même vos thèmes !
+Voici les liens :
+ere partie : viewtopic.php?f=29&t=1176\\
+eme partie : viewtopic.php?f=29&t=1179
+LES WHEELS (format PNG)
+Image
+Les médias appelés Wheels sont simplement les logos des jeux présents dans les différentes roues.
+Une wheel est une image au format PNG et qui doit être nommé de la même manière que le jeu ou le système avec lequel il est lié. Peu importe sa taille puisqu'elle sera redimensionnée automatiquement au dimensions par defaut, à savoir 400px de large pour 175px de haut.
+Petites astuces en passant pour se faire des wheels homogènes et bien organisés, qui ne se chevauchent pas. Si vous avez par exemple une wheel du type 1, essayez de les éditer avec un logiciel de retouche d'image pour obtenir une wheel du type 2, soit en la modifiant (Rally Bike coupé puis replacé en long), soit en redimensionnant la zone de travail pour que votre wheel soit centrée dedans (comme celle de SF II' CE).
+Image
+HFS TUTO ! Un tutoriel écrit par Metheore sur la création d'une wheel est disponible sur le forum d'HyperFreeSpin, jetez y un œil pour apprendre a créer vous même vos propres wheels manquantes que vous partagerez avec nous ensuite !
+Voici le lien : viewtopic.php?f=29&t=358
+LES VIDEOS (format MP4 ou FLV)
+Les vidéos sont donc en général, soit une introductions pour une video système qui présente les jeux de ce dernier, soit une vidéo in game pour un jeu.
+Les vidéos pour Hyperspin doivent être au format MP4 ou FLV, doivent être nommées de la même manière que les jeux ou les systèmes avec lesquels elles sont liées. Leur durée conseillé est de 30 secondes et leur taille de 640X480.
+ATTENTION : La vidéo d'intro d'Hyperspin doit se nommé « Intro » pour etre lue.
+HFS TUTO ! Un tutoriel écrit par Metheore sur la création de vidéos pour Hyperspin est disponible sur le forum HyperFreeSpin, jetez y un œil pour apprendre a créer vous même vos propres vidéos manquantes que vous partagerez avec nous ensuite !
+Voici le lien : viewtopic.php?f=29&t=650
+LES ARTWORKS (format PNG)
+Image
+Tout média qui est appelé Artwork est un élément qui peut être affiché avec un thème Default. Principalement utilisés pour les systèmes consoles ou micros, ils peuvent représentés des boites de jeux en 2D ou 3D, des cartouches de jeux, des CD, des disquettes, etc.\\
+Leurs emplacement et moyens d'insertion dans un thème sont reglé dans le thème Default en lui même donc vous devrez essayer plusieurs combinaisons pur trouver dans quel dossier mettre tel media. En règle général, les cartouches, CD et disquettes de jeux se mettent dans le dossier « Artwork 2 » et les box dans « Artwork 4 » mais à vous d'essayer.
+Quoiqu'il en soit, tous les Artworks sont des images au format PNG.
+Voila une petite illustration de ce que cela peut donner en terme d'affichage ;
+Image
+HFS TUTO ! Des tutoriels vidéos réalisés par Drawhyn et moi même sur le détourage d'objet et l'édition de cartouches sont disponibles sur le forum HyperFreeSpin et notre chaine Youtube (HeavyArcade), jetez y un œil pour apprendre a créer vous même vos propres artworks manquants que vous partagerez avec nous ensuite !
+Le lien vers le tuto sur le détourage de Drawhyn : viewtopic.php?f=29&t=900
+Le lien vers mon tuto sur l'édition de cartouches : viewtopic.php?f=29&t=1260
+LES SONS (format MP3)
+Pas de surprise ici, ce sont des pistes sonores de musiques ou de bruitages que vous pouvez insérer dans Hyperspin. Ils doivent être au format MP3.
+LES POINTEURS (format PNG)
+Image
+Élément très peu utilisé mais qui peut être assez stylé, les pointeurs sont affichés quand vous afficher la liste par lettre.
+Un pointeur est une image au format PNG, doit être placé dans le dossier Images\Other du système concerné et doit être nommé « Pointer.png », quelque soit le système.
+Voila qui clos ce tour d'horizon des médias pour Hyperspin, j'espère que cela vous aura plus et surtout aidé dans l'apprentissage d'Hyperspin !
 Bonne lecture !

Outils pour utilisateurs

Outils du site

Différences

Outils de la page