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

Some tutorials for starting with zspin.

Modérateurs : vik, Modérateurs

Avatar de l’utilisateur
metheore
Administrateur
Administrateur
Messages : 4343
Inscription : 18 oct. 2012 - 23:00
Localisation : Conflans-en-Jarnisy
A remercié : 770 fois
A été remercié : 1053 fois
Contact :

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

Message par metheore » 10 sept. 2015 - 02:12

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
Dernière modification par metheore le 13 sept. 2015 - 21:18, modifié 2 fois.

Avatar de l’utilisateur
Porko
Modérateur
Modérateur
Messages : 2031
Inscription : 01 févr. 2014 - 23:00
Localisation : 26700
A remercié : 214 fois
A été remercié : 347 fois

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

Message par Porko » 10 sept. 2015 - 07:49

Yep! Bien joué!
Mais y a du boulot...

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

Avatar de l’utilisateur
himura95
Mentor
Mentor
Messages : 2991
Inscription : 05 mars 2015 - 19:13
Localisation : Pontoise
A remercié : 736 fois
A été remercié : 410 fois

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

Message par himura95 » 10 sept. 2015 - 08:23

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

Avatar de l’utilisateur
camarade35
Maître
Maître
Messages : 4004
Inscription : 04 sept. 2013 - 23:00
Localisation : Chevaigné
A remercié : 388 fois
A été remercié : 485 fois
Contact :

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

Message par camarade35 » 11 sept. 2015 - 05:54

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 ^^)
Derrière chaque joystick il y a un cœur qui "ahk/bash/vbs/c++/node/c#/bat"

locmazzo
Connaisseur
Connaisseur
Messages : 360
Inscription : 18 mars 2014 - 23:00
Localisation : en Bourgonie du Sud
A remercié : 7 fois
A été remercié : 9 fois

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

Message par locmazzo » 11 sept. 2015 - 06:26

ça promet tout ça, bien joué les gars ;)
Image

Avatar de l’utilisateur
metheore
Administrateur
Administrateur
Messages : 4343
Inscription : 18 oct. 2012 - 23:00
Localisation : Conflans-en-Jarnisy
A remercié : 770 fois
A été remercié : 1053 fois
Contact :

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

Message par metheore » 11 sept. 2015 - 08:05

Merci camarade, ton point sur le .json est effectivement à ajouter Porto.


Envoyé de mon iPad en utilisant Tapatalk

Avatar de l’utilisateur
himura95
Mentor
Mentor
Messages : 2991
Inscription : 05 mars 2015 - 19:13
Localisation : Pontoise
A remercié : 736 fois
A été remercié : 410 fois

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

Message par himura95 » 11 sept. 2015 - 08:21

Porto ? Le correcteur orthographique semble avoir ses préférences :lol: C'est la ou tu étais en vacances ?
Image

Avatar de l’utilisateur
metheore
Administrateur
Administrateur
Messages : 4343
Inscription : 18 oct. 2012 - 23:00
Localisation : Conflans-en-Jarnisy
A remercié : 770 fois
A été remercié : 1053 fois
Contact :

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

Message par metheore » 11 sept. 2015 - 08:23

Lol fucking ipad.


Envoyé de mon iPad en utilisant Tapatalk

undertaker
Gourou
Gourou
Messages : 774
Inscription : 14 oct. 2013 - 23:00
Localisation : Sur le Peurt du Hav'
A remercié : 177 fois
A été remercié : 31 fois

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

Message par undertaker » 11 sept. 2015 - 08:54

pas de soucis je suis dispo pour faire la traduction dans la langue de Shakespeare ! ;)

Avatar de l’utilisateur
desfix
Gourou
Gourou
Messages : 510
Inscription : 30 mai 2014 - 23:00
A remercié : 12 fois
A été remercié : 20 fois

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

Message par desfix » 13 sept. 2015 - 14:13

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

Avatar de l’utilisateur
Lorith
Connaisseur
Connaisseur
Messages : 269
Inscription : 30 sept. 2014 - 23:00
Localisation : PAU

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

Message par Lorith » 13 sept. 2015 - 15:40

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

Avatar de l’utilisateur
metheore
Administrateur
Administrateur
Messages : 4343
Inscription : 18 oct. 2012 - 23:00
Localisation : Conflans-en-Jarnisy
A remercié : 770 fois
A été remercié : 1053 fois
Contact :

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

Message par metheore » 17 sept. 2015 - 08:20

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.

Avatar de l’utilisateur
himura95
Mentor
Mentor
Messages : 2991
Inscription : 05 mars 2015 - 19:13
Localisation : Pontoise
A remercié : 736 fois
A été remercié : 410 fois

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

Message par himura95 » 17 sept. 2015 - 08:45

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

Avatar de l’utilisateur
metheore
Administrateur
Administrateur
Messages : 4343
Inscription : 18 oct. 2012 - 23:00
Localisation : Conflans-en-Jarnisy
A remercié : 770 fois
A été remercié : 1053 fois
Contact :

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

Message par metheore » 17 sept. 2015 - 08:56

Merci @himura95 je push!

Avatar de l’utilisateur
desfix
Gourou
Gourou
Messages : 510
Inscription : 30 mai 2014 - 23:00
A remercié : 12 fois
A été remercié : 20 fois

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

Message par desfix » 17 sept. 2015 - 09:52

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

Avatar de l’utilisateur
metheore
Administrateur
Administrateur
Messages : 4343
Inscription : 18 oct. 2012 - 23:00
Localisation : Conflans-en-Jarnisy
A remercié : 770 fois
A été remercié : 1053 fois
Contact :

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

Message par metheore » 17 sept. 2015 - 10:01

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.

Avatar de l’utilisateur
metheore
Administrateur
Administrateur
Messages : 4343
Inscription : 18 oct. 2012 - 23:00
Localisation : Conflans-en-Jarnisy
A remercié : 770 fois
A été remercié : 1053 fois
Contact :

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

Message par metheore » 17 sept. 2015 - 19:11

Partie 3 up :).

Avatar de l’utilisateur
Odissine
Virtuose
Virtuose
Messages : 1226
Inscription : 19 févr. 2014 - 23:00
A remercié : 12 fois
A été remercié : 31 fois

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

Message par Odissine » 17 sept. 2015 - 19:25

Sacré boulot ! Très clair et bref ! Ca montre bien que ZSpin est ultra simple à manipuler ;)
Image

Avatar de l’utilisateur
Odissine
Virtuose
Virtuose
Messages : 1226
Inscription : 19 févr. 2014 - 23:00
A remercié : 12 fois
A été remercié : 31 fois

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

Message par Odissine » 01 oct. 2015 - 20:08

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

Avatar de l’utilisateur
Pnumekin
Amateur
Amateur
Messages : 57
Inscription : 10 mars 2013 - 23:00
A remercié : 1 fois

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

Message par Pnumekin » 01 oct. 2015 - 20:29

Je plussoie, je n'arrive pas à donner un angle à mes wheel, en rentrant pourtant les valeur comme indiqué dans le tuto de Metheore.

Répondre

Revenir à « Tutorials »