- III. Documentation Balises et leurs attributs (1)
J'ai décidé de découper cette documentation en deux parties, dans un premier temps, donc dans cette partie, je vais vous documenter sur les balises les plus basiques, et les plus utilisés, pour ne pas vous embrouiller avec trop de nouvelles choses à apprendre qui ne nous seront que secondaire dans notre manialink.
J'ai nommé les balises simple les balises de formes
balise /balise. On va en voir très peu dans cette partie
Cette balise a pour rôle d'indiquer à l'ordinateur que tout les éléments de la page de notre manialink se trouve entre sa balise début et sa balise fin (entre
manialink et
/manialink).
Première balise :
Dernière balise :
La première balise doit être situé après les renseignements sur le fichier (ndlr : Indispensables de votre script). La dernière balise doit être situé en dernier dans votre script (excepté un script PHP).
Lors de la sortie de ManiaPlanet, beaucoup de choses ont changés en Manialink, y compris la balise...
manialink.
Nous pourrons donc lui attribuer des valeurs :
-
version : En mettant 1 en valeur à l'attribut
version, votre Manialink passera en 16/9 !
-
background : En mettant 1 en valeur à l'attribut
background, vous pourrez enlever le background gris par defaut du Manialink, et il sera remplacé par le menu sur lequel vous naviguiez (menu principale, choix des skins,...).
Au risque de vous décevoir, je n'ai pas vraiment d'idée sur la signification de cette balise, je sais qu'il faut la mettre, mais je n'ai pas d'idée très clair sur son utilité. (Demande indications si vous avez).
Première balise :
Dernière balise :
Les deux balises doivent être situés entre les balises
manialink et la balise
/manialink
J'ai appelé les balises élémentaires, car dans
élémentaires, il y a
élément. Ce sont donc les balises qui concèrnent un élément sur la page. Donc sous la forme
balise /.
Dans cette partie, vous allez voir les Attributs nécessaires, et les autres attributs. Les attributs nécessaires, doivent absolument être présent pour que l'élément soit affiché.
La balise Label vous permet d'afficher un texte sur la page, et un texte en lien forme de lien.
-
posn
-
text : Attribut qui a pour valeur le texte en lui même. Pour afficher
TrackMania, vous devrez mettre en valeur à text : TrackMania.
-
sizen
-
halign
-
valign
-
style
-
manialink
-
url
-
textsize
-
scale
-
id
-
autonewline : permet le retour à la ligne automatique. Retourne à la ligne lorsque la valeur horizontale de sizen est atteint. Mettre en valeur 1 pour l'activer.
La balise Quad permet d'afficher une image, un cadre, un bouton. En faite, on ne fera aucune distinction entre une image, un cadre ou un bouton, puisque cela reste des images, et que la balise la traite de la même manière.
-
posn
-
sizen
-
image : Attribut qui a pour valeur l'URL (adresse absolu) de votre image. Attention, vous ne pouvez pas mettre cet attribut si vous mettez les attributs
style et
substyle !
-
style : Attribut qui a pour valeur le nom d'une catégorie d'image pré-enregistré dans TrackMania. Explications complète plus tard dans cette catégorie. Attention, cet attribut dans la balise quad doit absolument être accompagné de l'attribut
substyle. Et cet attribut ne doit pas être présent si l'attribut
image ou
imagefocus est présent dans cette balise.
-
substyle : Attribut qui a pour valeur le nom d'une image qui est présente dans la catégorie indiqué dans l'attribut style. Cet attribut doit être accompagné de l'attribut
style,
substyle ne doit pas être présent si
image ou
imagefocus sont présents !
-
halign
-
valign
-
imagefocus : Imagefocus permet d'afficher une autre image à la place de
image lors du passage de votre souris sur l'image.
C'est du rollover. La valeur de cette attribut est donc une adresse URL comme
image.
-
manialink
-
id
-
url
-
scale
Il est temps que je vous explique comment fonctionne l'attribut Posn, comme je vous l'ai expliqué, l'attribut Posn permet de positionner un (des) élément(s).
Lors de la sortie de ManiaPlanet (et dès la bêta) les créateur de Manialinks ont eu le choix entre créer un Manialink en 4:3 (comme sur Forever) ou 16:9 ! Qu'est-ce que cela signifie ? C'est simplement des formats d'images. Au cours de ces dernières années le 16:9 s'impose en terme d'écran, c'est pourquoi Maniaplanet s'y met aussi. Bref ! Pour activer le 16:9 (le 4:3 est toujours par défaut), remontez dans la doc' 1, au niveau de la balise
manialink.
Tout d'abord, la page d'un manialink est un grand repère orthonormé (vive les maths ! \o/). Un repère orthonormé c'est deux droites qui perpendiculaires, leur point d'intersection a pour valeur 0.
En 4:3, la taille standard (et donc maximale) du manialink sera de 1280*960. Le repère orthonormée a une envergure horizontale de 128 et verticale de 96. C'est à dire qu'à gauche du point 0 (milieu de l'écran) vous avez 64 points, et à droite 64 également, en haut 48 et en bas 48. En gros sur un schéma ça donne ça :
En 16:9, la taille standard du manialink est de 3200*1800. Le repère orthonormée a une envergure horizontale de 320 et verticale de 180. C'est à dire qu'à gauche du point 0 (milieu de l'écran), vous avez 160 points, et à droite 160 également, en haut 90 et en bas -90.
En gros ça donne ça :
Full +png
Pour les deux versions :
La valeur de l'attribut posn contient trois nombres, chacun séparés d'un espace :
posn="H V Z"
H c'est la valeur horizontale, elle va de -64 à 64 (vous pouvez aller au delà , mais au risque de ne plus voir l'image !).
V c'est la valeur verticale, elle va de -48 à 48 (de même, vous pouvez dépasser).
Z, alors là c'est plus complexe, imaginez vous tout d'abord deux images. Une image simple ayant comme attribut Z 1. Et maintenant une autre image qui est placé sur l'autre image, c'est à dire qu'elle se place par dessus l'autre, pour qu'elle soit par dessus, elle doit avoir une valeur Z supérieur à celle d'en dessous. Donc supérieur à 1. on metterai donc 2.
L'attribut de taille (dimensions) d'un fichier ressemble à l'attribut de position posn. C'est à dire que sa valeur se présente de la même manière, mais non pas trois valeurs H V Z mais deux valeurs, L et H.
L pour la largeur, H pour la hauteur.
Commencons par epliquer la taille du fond d'écran du Manialink. On a dit lors de l'explication sur la posn qu'en 16:9 la largeur de l'écran était de 320 et la hauteur de 180 (En 4:3 la largeur est de 128 et la hauteur de 96). Pour faire simple, cette taille est la taille totale de la page mais divisée par 10.
Donc si vous mettez un bouton qui fait 400 pixels de large et 100 de hauteur, on divise ces tailles par 10 et on obtient la taille pour notre script. Pour afficher ce bouton il vous suffira d'écrire :
N'oubliez pas l'espace entre les deux valeurs !
Pour conclure il n'y a aucune différence de dimensions (sizen) entre 16:9 et 4:3. Sauf que comme la taille en pixels total est bien plus grande en 16:9, même si l'on met la même valeur à sizen, votre image (ou autre élement) aura l'air plus petite en 16:9.
Pour avoir des valeurs plus préçises, utilisez le point et non la virgule (posn et sizen)
Ces deux attributs permettent d'aligner votre image par rapport au point que vous avez designez au point
posn. halign c'est l'alignement horizontale, valign est l'alignement verticale.
Halign peut prendre comme valeur :
- left
- center
- right
Valign peut prendre comme valeur :
- top
- center
- bottom
Par default (si ces attributs ne sont pas présents), la valeur de halign est left, et de valign top. Une image pour illustrer le tout :
Style est un attribut qui permet d'ajouter un style à votre texte, à votre image, et même à votre entry (Voir Partie VI). Style marche tout seul lorsqu'il est dans une balise texte, ou entry. Pour la balise Quad, il doit absolument être accompagné de l'attribut substyle.
Pour les styles des textes, rendez-vous sur le manialink [url=tmtp:///:example]example[/url] fait par smurf (TM Ladder). Vous pouvez choisir 2 types de styles pour vos labels :
- Styles normaux
- Styles boutons ! Eh oui ! Vous ne le saviez pas ? Ben maintenant oui, un label peut aussi être un bouton, le texte du bouton est celui de l'attribut
text, et le
style défini quel bouton.
Vous avez tout les exemples des différents styles (Sample Text), juste en dessous le nom du style, c'est à dire la valeur à mettre. Respectez bien les majuscules !
Pour les quads, style correspond à la catégorie de l'image, vous avez 10 catégories, ce sont les dix premiers boutons sur le manialink example. La valeur peut donc être :
- Bgs1
- BgsPlayerCard
- BgsChallengeMedals
- Bgs1InRace
- Icons128x128_1
- Icons128x32_1
- MedalsBig
- BgRaceScore2
- Icons128x128_Blink
(liste à mettre à jour)
Pour les entry, les styles sont les mêmes que les labels !
Substyle nous ait utile que dans les balises Quad, il nous permet de choisir l'image dans la catégorie de l'attribut
style. Vous pouvez choisir votre image en vous rendant sur [url=maniaplanet:///:example]example[/url]. Vous avez l'image, et juste en dessous la valeur à mettre pour l'attribut substyle.
Manialink vous permet de faire un lien vers un autre manialink, mettez son adresse URL, ou son code tout simplement, vous n'avez pas besoin de mettre tmtp:///:
Url vous permet de faire un lien externe, sur le navigateur favoris (IE, Firefox, Chrome,...). Mettez juste l'adresse URL
Textsize est un attribut pour la balise Label, elle n'est pas utilisable si vous avez mis un style. Les valeurs doivent être entières (1, 2, 3, [strike]3.5[/strike]).
Scale vous permet de modifier la taille d'un élément, 1 correspond à sa taille normal, si vous mettez 0.5, alors la taille de l'élément sera de 50% sa taille réél.
Id permet de lier un élement à un script ManiaScript. Vous pouvez en savoir plus sur le tutoriel du ManiaScript.