HFS Play

Le forum francophone dédié à l'émulation et au retrogaming. Aide à la réalisation de bornes d'arcade et de bartops. Téléchargement gratuit de médias
https://forum.hfsplay.fr/

[WikiZ] Tout ce qu'il faut savoir sur Zspin

https://forum.hfsplay.fr/viewtopic.php?f=116&t=7898

Page 1 sur 4

[WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 10 sept. 2015 - 04:12
par Meth
WIKIZ




1. Premier lancement.


Ce qu'il faut d'abord savoir, c'est que Zspin respecte la même arborescence de dossiers que hyperspin.
De fait il supporte ce qui a été fait pour hyperspin (theme, database,...) certaines particularités restent encore à implanter tout de même.

Vous pouvez placer votre Zspin ou vous le voulez. Pour fonctionner il doit simplement pointer sur un répertoire de données construit comme suit.

Pour la version 0.2.0:
Image

Au premier démarrage vous sera proposé un menu de configuration:

Image


[*]Langue
[tab=30]Langue de l'application: Choix de la langue

[*]Chemins
[tab=30]Repertoire de données: sélectionnez votre répertoire [YourBox] selon l'exemple vue plus haut.

[*]Lanceur
[tab=30]Application lanceur: sélectionnez le .exe de votre launcher (RocketLauncher, RetroArch...)
[tab=30]Paramètres du lanceur: à modifier selon votre launcher

[*]Touches
[tab=30]Vous permet d'appliquer les contrôles de votre choix pour naviguer sous Zspin.

[*]Executer l'application
[tab=30]Au démarrage de zspin: Permet comme son nom l'indique d’exécuter une application au lancement de Zspin.
[tab=30]A la sortie de zspin: Permet comme son nom l'indique d’exécuter une application à la sortie de Zspin.

[*]Voir les dossiers
[tab=30]Permet d’ouvrir les différents dossiers.

[*]Remise à zéro
[tab=30]Permet de réinitialiser les paramètres


Les configs de ZSpin sont sauvées dans le répertoire

Code : Tout sélectionner

\Users\[Nom User]\AppData\Local\zspin



2. Fonctionnement du multi wheel.





Hyperspin ne permettait pas de pointer un database type "main menu" depuis un autre du même format. Zspin rectifie cela et vous pouvez maintenant classer vos systèmes sur plusieurs niveaux.
Le seul imperatif reste que le menu initial soit nommé Main Menu.xml.

Exemple:

Code : Tout sélectionner

<menu>
  <game name="Arcade"/>
  <game name="Consoles"/>
  <game name="Consoles Portables"/>
  <game name="Ordinateurs"/>
</menu>
En sélectionnant Arcade nous ouvrons le database Arcade.xml

Code : Tout sélectionner

<menu>
  <game name="Capcom"/>
  <game name="Cave"/>
  <game name="SNK Neo Geo"/>
</menu>
En sélectionnant Capcom nous ouvrons le database Capcom.xml

Code : Tout sélectionner

<menu>
  <game name="Capcom Play System"/>
  <game name="Capcom Play System 2"/>
  <game name="Capcom Play System 3"/>
</menu>
Puis pour finir en sélectionnant Capcom Play System 3 nous ouvrons le database Capcom Play System 3.xml

Code : Tout sélectionner

<?xml version="1.0" encoding="utf-8"?>
<menu>
	<header>
		<listname>CPS3</listname>
		<lastlistupdate>10/31/2011</lastlistupdate>
		<listversion>1.0 Final</listversion>
		<exporterversion>HyperList XML Exporter Version 1.3 Copywrite (c) 2009-2011 William Strong</exporterversion>
		<hyperfreespin>HyperFREEspinToXML version 1.00</hyperfreespin>
	</header>
	<game name="sfiii3nr1" index="" image="">
		<description>Street Fighter III: 3rd Strike - Fight for the Future</description>
		<cloneof></cloneof>
		<crc>8D7B1201</crc>
		<manufacturer>Capcom</manufacturer>
		<year>1999</year>
		<genre>Fighting</genre>
		<rating></rating>
		<enabled>Yes</enabled>
	</game>
	<game name="sfiiij" index="" image="">
		<description>Street Fighter III: 1st New Generation</description>
		<cloneof></cloneof>
		<crc></crc>
		<manufacturer>Capcom</manufacturer>
		<year>1997</year>
		<genre>Fighting</genre>
		<rating></rating>
		<enabled></enabled>
	</game>
	<game name="warzard" index="" image="">
		<description>Warzard / Red Earth</description>
		<cloneof></cloneof>
		<crc></crc>
		<manufacturer>Capcom</manufacturer>
		<year>1996</year>
		<genre>Fighting</genre>
		<rating></rating>
		<enabled></enabled>
	</game>
</menu>

Le seul impératif est de créer un dossier Media au nom de votre .xml et contenant les médias nécessaires à l'affichage du menu comme suit:

Image



3. Le wheel.json.


La position des wheels est définie par un fichier nommé wheel.json placé dans le dossier database du système voulu.
Il se présente sous cette forme:

Code : Tout sélectionner

{
  "transitionTime": 170,
  "selectPosition": 14,
  "hide": false,
  "hideStart": 1500,
  "hideDuration": 1500,
  "points": [
    {"x":-25, "y":80, "angle":-70, "scale":1, "index":1},
    {"x":-20, "y":80, "angle":-70, "scale":1, "index":2},
    {"x":-15, "y":80, "angle":-70, "scale":1, "index":3},
    {"x":-10, "y":80, "angle":-70, "scale":1, "index":4},
    {"x":-5, "y":80, "angle":-70, "scale":1, "index":5},
    {"x":0, "y":80, "angle":-70, "scale":1, "index":6},
    {"x":5, "y":80, "angle":-70, "scale":1, "index":7},
    {"x":10, "y":80, "angle":-70, "scale":1, "index":8},
    {"x":15, "y":80, "angle":-70, "scale":1, "index":9},
    {"x":20, "y":80, "angle":-70, "scale":1, "index":10},
    {"x":25, "y":80, "angle":-70, "scale":1, "index":11},
    {"x":30, "y":80, "angle":-70, "scale":1, "index":12},
    {"x":35, "y":80, "angle":-70, "scale":1, "index":13},
    {"x":40, "y":80, "angle":-70, "scale":1, "index":14},
    {"x":60, "y":80, "angle":0, "scale":2.2, "index":15},
    {"x":80, "y":80, "angle":-70, "scale":1, "index":14},
    {"x":85, "y":80, "angle":-70, "scale":1, "index":13},
    {"x":90, "y":80, "angle":-70, "scale":1, "index":12},
    {"x":95, "y":80, "angle":-70, "scale":1, "index":11},
    {"x":100, "y":80, "angle":-70, "scale":1, "index":10},
    {"x":105, "y":80, "angle":-70, "scale":1, "index":9},
    {"x":110, "y":80, "angle":-70, "scale":1, "index":8},
    {"x":115, "y":80, "angle":-70, "scale":1, "index":7}
  ]
}
Vous pouvez donc agir sur:
transitionTime: Le temps de transition pour le passage d'une wheel à l'autre.
selectPosition: désigne la wheel active, sachant que la numérotation commence de 0. Donc dans notre exemple la wheel 14 est désigné par la position de l'index 15
hide: true/false, désigne si vous souhaitez activer le hide ou pas.
hideStart désigne à partir de combien de temps le hide va débuter.
hideDuration: désigne la durée pour que les wheels disparaissent.
points: permet de placer su votre écran les points constituant votre wheel.
[tab=30]x: placement sur l'axe horizontal en pourcentage.
[tab=30]y: placement sur l'axe vertical en pourcentage.
[tab=30]angle: rotation de l’élément.
[tab=30]scale: zoom sur l’élément.
[tab=30]index: numérotation de l’élément. Attention selectPosition+1


Ce qui donne dans notre exemple:
Image






4. Le theme Html.







Ceci est une ébauche fait sous tapatalk au boulot, le but étant d'avoir une doc consistante pour la release de samedi.
Nous travaillerons donc sa mise en page au fur et à mesure de son édition.

Il serait vraiment très utile,pour renseigner au mieux le Github, de traduire en anglais toutes ces instructions. Des consignes les plus précises aideront à un meilleur développement du soft. Donc si parmi nous un membre assez calé pourrait se proposer à traduire chacun des chapitres, merci à lui.

Envoyé de mon iPad en utilisant Tapatalk

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 10 sept. 2015 - 09:49
par Porko
Yep! Bien joué!
Mais y a du boulot...

Je rajouterai
4. Edition du .json pour l'affichage des wheel

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 10 sept. 2015 - 10:23
par himura95
Juste avant la partie 2 je verrais bien : "Se remettre de la claque"
et pour la partie 3 j'aurais aimer dire : "Z-thème" et décrire le fonctionnement mais pour samedi on oubli :(

Plus sérieusement, je peux aider sur la trad anglaise qui devra quand même être soumise à relecture.

Just before the part 2, I would see : "recovering from the slap"
and for the part 3 I would love to say : "Z-thème" and describe the operation but for Saturday we forgotten :(

Seriously, I can help on English trad which will still be subject to review.

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 11 sept. 2015 - 07:54
par camarade35
Je prépare une base html vraiment épuré avec tout ce qu'il faut savoir pour les thèmes de base, les thèmes default, etc.
Les animations faites par Aruka ainsi que le projet Ztheme (@himura95 : je vais enfin pouvoir jeter un œil ^^)

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 11 sept. 2015 - 08:26
par locmazzo
ça promet tout ça, bien joué les gars ;)

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 11 sept. 2015 - 10:05
par Meth
Merci camarade, ton point sur le .json est effectivement à ajouter Porto.


Envoyé de mon iPad en utilisant Tapatalk

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 11 sept. 2015 - 10:21
par himura95
Porto ? Le correcteur orthographique semble avoir ses préférences :lol: C'est la ou tu étais en vacances ?

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 11 sept. 2015 - 10:23
par Meth
Lol fucking ipad.


Envoyé de mon iPad en utilisant Tapatalk

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 11 sept. 2015 - 10:54
par undertaker
pas de soucis je suis dispo pour faire la traduction dans la langue de Shakespeare ! ;)

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 13 sept. 2015 - 16:13
par desfix
yo, j'ai test vite fait zspin, il est rapide (et surtout très fluide) et j'aime ça ^^

maintenant j'attends avec impatience la partie deux 2 pour le multi wheel.
et aussi les autres parties, histoire de modifier la disposition et position des wheels.

Franchement du bon boulot, bon courage pour la suite les gars :)

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 13 sept. 2015 - 17:40
par Lorith
Merci pour les infos.
Je rajouterais juste un truc, préciser que les configs de ZSpin sont sauvées dans le répertoire

Code : Tout sélectionner

C:\Users\[Nom User]\AppData\Local\zspin
Ca peut être utile pour une raison x ou y....

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 17 sept. 2015 - 10:20
par Meth
Les parties 1 et 2 étant terminées, quelqu’un serait chaud pour les traduire en anglais? Cela nous permettrait d'avancer la doc sur le Github.

Merci.

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 17 sept. 2015 - 10:45
par himura95
Anglais ?
1. First launch.

What you need to know first is that Zspin follows the same folder tree as Hyperspin.
In fact it supports what has been done to Hyperspin (theme, database, ...) Special features are still to implement.

You can place your Zspin where you want. To work, it must simply point to a data directory constructed as follows.

For version 0.2.0:

At first start you will be offered a configuration menu:

[*]Language
Application language : Choose your language

[*] Paths
Data directory : Select your directory [YOURBOX] according to the example seen above.

[*] Launcher
Application Launcher : Select the .exe of your launcher (rocketlauncher, RetroArch ...)
Launcher settings : modify according to your launcher

[*] Keys
You can apply the controls of your choice for browsing Zspin.

[*] Run the application
At Zspin startup : Allows, as its name suggests to run an application at Zspin's launch.
On leaving zspin : Allows, as its name suggests to run an application at Zspin's exit.

[*] See folders
Allow to open the differents folders.

[*]Reset
Resets settings

The ZSpin configs are saved in the directory

2. Operation of the multi wheel.

Hyperspin did not allow to point database like "main menu" from another of the same type. Zspin rectifies this and you can now organize your systems on several levels.
The only imperative remains that the initial menu is named "Main Menu.xml".

Example:

By selecting "Arcade", we open the "Arcade.xml" database

By selecting "Capcom", we open the "Capcom.xml" database

Then finally, by selecting "Capcom Play System 3", we open the "Capcom Play System 3.xml" database


The only requirement is to create a Media folder on behalf of your .xml containing the media needed to display the menu as follows:

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 17 sept. 2015 - 10:56
par Meth
Merci @himura95 je push!

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 17 sept. 2015 - 11:52
par desfix
Yes merci @metheore, je viens de test les multi wheels, et ça marche du tonnerre :)

toujours aussi rapide, rien a dire, il y a juste entre chaque changement de thèmes un écran blanc qui apparaît comme un flash.
hormis cela, zspin va casser la baraque :)

bien jouer les gars

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 17 sept. 2015 - 12:01
par Meth
desfix a écrit :Yes merci @metheore, je viens de test les multi wheels, et ça marche du tonnerre :)

toujours aussi rapide, rien a dire, il y a juste entre chaque changement de thèmes un écran blanc qui apparaît comme un flash.
hormis cela, zspin va casser la baraque :)

bien jouer les gars

Normalement les transitions seront de la partie dans l'avenir.

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 17 sept. 2015 - 21:11
par Meth
Partie 3 up :).

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 17 sept. 2015 - 21:25
par Odissine
Sacré boulot ! Très clair et bref ! Ca montre bien que ZSpin est ultra simple à manipuler ;)

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 01 oct. 2015 - 22:08
par Odissine
Question pour les spécialistes json :p
Chez moi ça marche pas du coup je me demandais si l'option angle fonctionnait uniquement sur les wheels horizontales ou bien les verticales aussi ?
En effet voilà mon json pour mes wheels verticales flat :
wheel.json

Code : Tout sélectionner

{
  "transitionTime": 170,
  "selectPosition": 8,
  "hide": false,
  "hideStart": 1500,
  "hideDuration": 1500,
  "points": [
{"x":86, "y":5, "angle":50, "scale":1, "index":1},
{"x":86, "y":10, "angle":30, "scale":1.5, "index":2},
{"x":86, "y":15, "angle":10, "scale":1.5, "index":3},
{"x":85, "y":20, "angle":0, "scale":1.5, "index":4},
{"x":85, "y":25, "angle":0, "scale":1.5, "index":5},
{"x":84, "y":30, "angle":0, "scale":1.5, "index":6},
{"x":84, "y":35, "angle":0, "scale":1.5, "index":7},
{"x":83, "y":40, "angle":0, "scale":1.5, "index":8},
{"x":82, "y":45, "angle":0, "scale":2, "index":9},
{"x":83, "y":50, "angle":0, "scale":1.5, "index":8},
{"x":84, "y":55, "angle":0, "scale":1.5, "index":7},
{"x":84, "y":60, "angle":0, "scale":1.5, "index":6},
{"x":85, "y":65, "angle":0, "scale":1.5, "index":5},
{"x":85, "y":70, "angle":0, "scale":1.5, "index":4},
{"x":86, "y":75, "angle":10, "scale":1.5, "index":3},
{"x":86, "y":80, "angle":30, "scale":1.5, "index":2},
{"x":86, "y":85, "angle":50, "scale":1, "index":1}
  ]
}
[spoiler]

Et le rendu en image :
Image

J'aurais voulu que les 2/3 dernieres Wheels (hautes et basses) est une légère rotation mais "angle" ne semble pas fonctionner :/
J'ai la version 0.2.1 de ZSpin.
Merci pour votre aide ;)

Re: [WikiZ] Tout ce qu'il faut savoir sur Zspin

Publié : 01 oct. 2015 - 22:29
par Pnumekin
Je plussoie, je n'arrive pas à donner un angle à mes wheel, en rentrant pourtant les valeur comme indiqué dans le tuto de Metheore.
Fuseau horaire sur UTC+02:00
Page 1 sur 4
Powered by phpBB® Forum Software © phpBB Limited
https://www.phpbb.com/