Outils pour utilisateurs

Outils du site


tutos:software:frontend:hyperspin:presentation_de_hyperspin
Cette version est dépassée. Une version approuvée plus récente existe.DiffCette version (2017/02/01 10:10) est en ébauche.
Approuvés: 0/1
La version précédemment approuvée (2017/01/08 10:30) est disponible.Diff

Ceci est une ancienne révision du document !


Hyperspin - Présentation du frontend et de ses composants

Tutoriel original : Heavyarms du 20/03/2013

Pour compléter le premier tuto fait par ITR78, je reviens donc sur la base d'Hyperspin, je l'ai fait pour le forum Neo Arcadia mais je pense qu'il à sa place ici. J'espère que ce sera utile !

Avant de commencer, je voudrais préciser une chose très importante si vous avez dans l’idée de tout configurer vous-même, à savoir que sans aucun doute possible, Hyperspin est le frontend le plus compliqué à configurer, ce qui ne l’empêche pas d’être un des meilleurs, mais il nécessite une autonomie certaine de votre part. Jamais je ne serai arrivé à un tel niveau de compréhension de ce système sans avoir cherché sur internet et bidouiller pendant des heures (plutôt des mois) les fichiers qui le compose.

La chose qu’il faut avoir à l’esprit, c’est que malgré les tutoriaux disponibles sur Hyperspin, il vous arrivera toujours des petits problèmes qui ne devraient pas survenir mais qu’il existe toujours une solution, il suffit juste de chercher par soi même soit sur internet ou soit en plongeant directement dans les fichiers ini, ahk ,xml et j’en passe, d’essayer de nouvelles choses et de tester, en gros de s’investir vraiment à fond la dedans sans attendre que la réponse vous tombe dans le bec comme ca.

Je serai la pour aider ainsi que certains autres, je pense d’ailleurs à Naku de Neo Arcadia qui est une pointure sur ce frontend et sans qui j’aurai bien pu galérer sur des petits détails qui maintenant me semble logique et avec lequel je n’ai pas fini d’apprendre, encore un grand merci à toi l’ami. Pour clore cette introduction, voici quelques liens qui vont vous servir tout au long de votre parcours.

Le forum HyperSpin France (vous y etes normalement^^), le seul endroit français consacré uniquement à HS et qui est une véritable mine d’or de savoir et de ressources, en grand merci au passage aux 2 créateurs NutsreturN2 et Micaelo14 ainsi qu'a ITR78 pour leur travail : index.php

Le site officiel du frontend avec un forum qui bouge beaucoup : http://hyperspin-fe.com/

Un topic sur Gamoover dans lequel vous pourrez trouvez des infos et des réponses : http://www.gamoover.net/Forums/index.php?topic=16504.0

Allez, en route !

Qu’est ce qu’Hyperspin ?

Hyperspin (noté souvent HS par la suite) est un frontend.

Qu’est ce qu’un frontend ? C’est une interface qui vous permettra de vous passer de clavier, de souris et ainsi de contrôler le lancement de vos jeux par votre control panel en remplaçant l’environnement bureautique de Windows par une interface graphique beaucoup plus sympa et intuitive qui colle parfaitement à l’esprit d’une borne d’arcade. Il en existe beaucoup mais aucun n’est aussi personnalisable et abouti graphiquement qu’HS.

L’interface d’Hyperspin se présente sous forme de roues appelées « Wheels » que l’on tourne pour accéder à tel émulateur, puis à tel jeu, le tout étant animé par des thèmes, images et vidéos que l’on aura préalablement installées. Ce qui nous donne par exemple ce résultat :

264142hyperspinwheel.jpg

Vous voyez par exemple la roue à droite et les émulateurs présents sur le système mais ce n’est juste que le thème par défaut d’HS. Il en existe des centaines différents, vous pouvez même créer les votre, mettre la roue à gauche, en bas en haut… La roue peut avoir autant d'entrées que vous le souhaitez et tous les thèmes graphiques d'HyperSpin que ce soit pour les jeux ou pour les émulateurs sont externes à l'exécutable pour une personnalisation maximale de l'apparence de votre interface.

Un autre exemple avec le thème d’un jeu (pas n'importe lequel :twisted: :twisted: :twisted: ) :

fetch03.php.jpg

Voici un des thèmes disponibles avec une vidéo, une image de fond, le nom du jeu et l’année de sortie, etc… Ce qui est vraiment géniale, c'est que chaque élément du menu ou de sous-menu peut être modifié, de la simple image de Wheel à la vidéo d’intro au lancement d’Hyperspin. Vous pourrez aussi les changer par un autre ou créer les votre pour avoir votre interface ! On peut aussi se faire un système entièrement vertical. Tout ou presque est possible avec HS, ce qui le rend vraiment génial !

2 petites vidéos de ce qui est possible de faire, une avec un système en Yoko, l’autre en Tate :

http://www.youtube.com/watch?v=Mr0ZRpGt_vQ

http://www.youtube.com/watch?v=oLXatmjMphI

Alors loin de moi l’idée de vous décourager dans ce projet, mais sachez qu’avant d’en arriver à ce genre de résultat, il y a énormément de pain sur la planche et ne comptez pas les heures de tri, de configuration et de réglages sinon crise cardiaque garantie !^^

Installation

Premièrement l’installation d’Hyperspin. Vous aurez besoin de plusieurs choses pour avoir le frontend le plus à jour possible. Pour pouvoir télécharger les liens suivants, vous devez vous inscrire gratuitement sur le site officiel d’Hyperspin. Voici les liens pour la dernière version, prenez bien les tous les fichiers, tout sera expliqué ensuite (vous pouvez aussi trouver tout ca sur le ftp du forum je pense) :

Hyperspin 1.0 : http://www.hyperspin-fe.com/forum/downl… ileid=323
Hyperspin 1.3.0 : http://www.hyperspin-fe.com/downloads/H… in_1_3.zip
HyperTheme : http://rapidshare.com/files/876714319/HyperTheme115.zip
HyperLaunch 2.25c :http://www.hyperspin-fe.com/forum/attac… 1345955595

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 »

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

Voici le lien sur le cloud : HFS Team - Hyperspin MAJ.zip (336.8 Mo) https://mega.co.nz/#!xdhGFCBL!EGdvFUgKV… BWaWio8d9M

L'installation se compose de 6 dossiers principaux, l'exécutable Hyperspin est à la racine, ainsi que HyperLaunch, HyperHQ, HyperTheme et HyperBrite.

Normalement, cela devrait vous donner ca :

fetch04.php.jpg

Tout ceci ne vous dit pour l’instant rien donc je vais décortiquer chaque dossier et fichier pour y voir plus clair.

Présentation des dossiers et fichiers composants Hyperspin

D’abord quelques termes que j’utiliserai dorénavant pour désigner certaines choses :

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

Databases

Le dossier « Databases » comporte des bases de données XML qui contiennent les informations que HyperSpin va afficher dans son interface, les systèmes et leurs roms donc. Chaque Wheel (roue) est en fait une base de données. Nous verrons plus tard comment il est possible de faire le tri dans ce que vous voulez afficher ou non, comment éditez un fichier xml ou même éditer automatique un xml avec toutes vos roms pour chaque système.

Emulators

C’est simplement le dossier où vous mettrez tous vos émulateurs avec leurs roms.

HyperTheme

Ce dossier comprend vos thèmes créés avec HyperThme (voir plus bas) et une licence 7-zip autonome pour compresser les thèmes. HyperTheme placera votre thème, avec les artwork renommés, dans un sous-dossier nommé d'après le thème. Le logiciel compresse deux thèmes en .zip. L'un sera nommé selon la charte mise en place par le créateur d'Hyperspin (GameName - créateur (AAAAMMJJ).zip). L'autre copie sera à placer directement dans votre dossier de thèmes (gamename.zip).

Media

« Media » est l’endroit où vos stockerez toutes vos images, vidéos, thèmes, sons… En gros tous les détails de votre interface. Dans chaque dossier d’un système sera présent 4 sous dossiers qui sont :

fetch05.php.jpg

Le dossier « Themes » sera celui qui accueillera les thèmes de vos roms et le dossier « Video » contiendra leurs vidéos propres, nous y reviendrons dans un autre tuto.

Attardons nous juste sur les dossiers restants. Commençons par « Images » :

fetch06.php.jpg

Ces différents sous dossiers serviront à classer vos images en fonction de leurs natures pour qu’Hyperspin puisse bien les afficher. Vous verrez que le plus important d’entre eux sera le dossier « Wheel » qui contiendra les images designant vos jeux dans la Sub Wheel rom du système.

Passons au dossier « Sound » :

fetch07.php.jpg

Ces sous dossiers vous serviront à classer les sons que vous voudrez ajouter à Hyperspin selon leurs natures encore une fois.

Nous reviendrons sur le classement des médias dans un futur tuto.

Modules

« Modules » est l’endroit où vos stockerez tous les modules, les fichiers AHK donc, servant à Hyperlaunch pour lancer puis quitter les émulateurs. Je reviens en détails sur les modules un peu en dessous avec Hyperlaunch.

Settings

Le dossier « Settings » contiendra tous vos fichiers de paramétrage par système. Chaque Wheel est contrôlé par ces fichiers ini. Les fichiers settings sont des fichiers texte avec l'extension.ini que vous pourrez modifier avec NotePad ++. Mais vous pouvez également gérer vos settings avec HyperHQ, ce qui est le plus simple et ce qui se fera de manière général mais vous verrez qu’il est des fois bien avisé de venir mettre son nez dans les ini en eux même que de passer par HQ.

Les soft annexes

Hyperlaunch et ses fichiers (voir photo précédente)

Hyperlaunch est le programme qui permet de dire à Hyperspin de lancer tel ou tel émulateur avec tel rom, de faire tourner le jeu en premier plan et ensuite de quitter l’émulateur pour revenir sur le frontend directement. Pour schématiser, HyperSpin serait le chef d’orchestre et Hyperlaunch serait les musiciens. Et pour que les musiciens puissent jouer, il s leurs faut bien sur des instruments et dans ce cas, ces instruments seront les modules qui sont des fichiers au format AHK que vous mettrez dans le dossier « Modules ».

Un module est en fait un fichier AutoHotKey qui contient des informations comme « démarrer cet émulateur avec ce jeu » ou encore « quitter l’émulateur et revenir sur Hyperspin »par exemple, des données lisibles par HyperLaunch pour que l’émulateur fonctionne correctement avec Hyperspin. Il faut savoir qu’un module n’est pas propre à un système (Megadrive par exemple) mais à un émulateur (Kega Fusion, Mess, Haze MD…), comprenez par la qu’en fonction de l’émulateur que vous choisirez, vous aurez besoin d’un module différent. L’explication vient du fait que tous les émulateurs ne sont pas fait de la même façon et que le fichier AHK ne contiendra pas les mêmes informations à donner à Hyperlaunch, logique.

Je reviendrai de toute façon assez souvent sur l’utilisation et l’édition des modules, ne vous inquietez pas.

Hyperbrite

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… pcBQFQu6gQ

HyperHQ

Sans doute votre meilleure ami dans cette aventure, cet exécutable permet en effet d'éviter aux allergiques de la bidouille au bloc note, de longues heures de configurations. C’est en fait 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… Comme le dit ITR78 d’HS France, voyez-le comme le menu “Options” de votre Hyperspin. Je détaille entièrement ses options dans la suite de ce tuto.

HyperSpin

Tout simplement l’exécutable de notre frontend !

HyperTheme

HyperTheme est un logiciel de création de thème pour HS. Vous pourrez donc par son biais exprimer votre créativité en créant de nouveaux thèmes pour vos jeux si le cœur vous en dit. Seul petit bémol, il n’est qu’en anglais mais de très bons tutos existent déjà pour vous guider comme celui la : http://saturn.netboarder.com/t6994-tuto-hyperspin (voir la section créer son thème)

Pour conclure cette première partie, je me permettrai de citer Hervéni du forum Gamoover qui résume parfaitement un des points essentiels de ce frontend.


En effet, un des premiers trucs à piger, c'est qu'Hyperspin comme la plupart des frontend fonctionne sur 2 plans qu'on va appeler “la forme” et “le fond”.

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 …

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

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 …

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

Ces 2 parties sont plus ou moins indépendantes. Vous pouvez donc avoir un joli menu sans la moindre rom, ni même le moindre émulateur (c'est par exemple la config de base après avoir téléchargé Hyperspin), ou vous pouvez également ajouter pléthore de roms et systèmes supplémentaires dans l'arborescence d'Hyperspin sans que ce dernier n'en tienne compte (tant que la database en xml ne correspond pas avec les noms des roms présentes).

Pour que tout fonctionne, il faut donc agir de concert sur ces 2 tableaux.


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

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

img15.hostingpics.net_pics_957810hyperhq1.jpg

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

img15.hostingpics.net_pics_635644hyperhq2.jpg

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

img15.hostingpics.net_pics_341640hyperhq3.jpg

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

img15.hostingpics.net_pics_560555hyperhq4.jpg

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

img15.hostingpics.net_pics_321884hyperhq5.jpg

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

img15.hostingpics.net_pics_999683hyperhq6.jpg

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

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 Default : 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

img15.hostingpics.net_pics_810087hyperhq7.jpg

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

img15.hostingpics.net_pics_772305hyperhq8.jpg

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.


img15.hostingpics.net_pics_524896hyperhq9.jpg

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 » :

img15.hostingpics.net_pics_568377hyperhq14.jpg

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 :

img15.hostingpics.net_pics_413531hyperhq10.jpg

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 » :

img15.hostingpics.net_pics_112997hyperhq11.jpg

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 :

img15.hostingpics.net_pics_593843hyperhq12.jpg

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.

img15.hostingpics.net_pics_191267hyperhq13.jpg

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 :

img15.hostingpics.net_pics_721436hyperhq15.jpg

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

img15.hostingpics.net_pics_865531hyperhq16.jpg

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

img15.hostingpics.net_pics_545570hyperhq17.jpg

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

img15.hostingpics.net_pics_672233hyperhq18.jpg

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

img15.hostingpics.net_pics_785370hyperhq19.jpg

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

img15.hostingpics.net_pics_316660hyperhq20.jpg

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

img15.hostingpics.net_pics_1207381fichierxml.jpg

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 :

img15.hostingpics.net_pics_8571082infossurthemes.jpg

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 :

img15.hostingpics.net_pics_8063213compositiondedatabases.jpg

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 (102 Ko)

Décompressez le où vous voulez, moi j'ai choisi le dossier Hyperspin. Ensuite, ouvrez le logiciel, vous tomberez la dessus :

img15.hostingpics.net_pics_4622374hyperrom2xml1.jpg

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 :

img15.hostingpics.net_pics_1137485hyperrom2xml2.jpg

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.

Bonne lecture et bon partage ! :D

tutos/software/frontend/hyperspin/presentation_de_hyperspin.1485940222.txt.gz · Dernière modification: 2017/02/01 10:10 de oijkn