L'objet <carousel> décrit la liste des systèmes, l'écran d'accueil d'EmulationStation. Il fonctionne en deux modes : le carrousel de logos classique, et une liste textuelle activée par textOnly.
| Vue | Nom | Élément |
|---|---|---|
system |
systemcarousel |
La liste des systèmes |
Cet objet ne peut pas être créé en extra="true".
| Propriété | Type | Rôle |
|---|---|---|
type |
Chaîne | Sens de défilement du carrousel : horizontal, vertical ou vertical_wheel. |
size |
Couple | Taille de l'objet. |
pos |
Couple | Position de l'objet. Voir les propriétés communes. |
origin |
Couple | Point de l'objet auquel pos se rapporte. |
color |
Couleur | Couleur du fond du carrousel. |
fontPath |
Chemin | Police utilisée pour le mode textOnly et pour les systèmes sans logo. |
fontSize |
Flottant | Taille de police, en fraction de la hauteur d'écran. Utilisée pour le mode textOnly et pour les systèmes sans logo. |
fontColor |
Couleur | Couleur du texte de repli du carrousel classique. |
logoScale |
Flottant | Facteur d'agrandissement du logo sélectionné. |
logoRotation |
Flottant | Angle de rotation des logos, en degrés. |
logoRotationOrigin |
Couple | Point autour duquel les logos pivotent. |
logoSize |
Couple | Taille des logos dans le carrousel. |
textOnly |
Booléen | Remplace le carrousel par une liste textuelle des systèmes. |
forceUppercase |
Booléen | Affiche les noms de systèmes en majuscules. Mode textOnly uniquement. |
logoAlignment |
Chaîne | Alignement des logos dans le carrousel. En mode textOnly, alignement horizontal du texte. |
maxLogoCount |
Flottant | Nombre de logos affichés simultanément. |
selectorColor |
Couleur | Couleur de la barre de sélection. Mode textOnly uniquement. |
selectedColor |
Couleur | Couleur du système sélectionné. Mode textOnly uniquement. |
primaryColor |
Couleur | Couleur des systèmes non sélectionnés, lignes paires. Mode textOnly uniquement. |
secondaryColor |
Couleur | Couleur des systèmes non sélectionnés, lignes impaires. Mode textOnly uniquement. |
selectorHeight |
Flottant | Hauteur de la barre de sélection. 0 = hauteur d'une ligne. Mode textOnly uniquement. |
selectorOffsetX |
Flottant | Décalage horizontal de la barre de sélection. Mode textOnly uniquement. |
selectorOffsetY |
Flottant | Décalage vertical de la barre de sélection. Mode textOnly uniquement. |
textOffsetX |
Flottant | Décalage horizontal des noms de systèmes. Mode textOnly uniquement. |
lineSpacing |
Flottant | Hauteur de ligne, en multiple de la hauteur de police. Mode textOnly uniquement. |
horizontalMargin |
Flottant | Retrait gauche/droite du texte. Mode textOnly uniquement. |
defaultTransition |
Chaîne | Force le style de transition entre systèmes : instant, fade ou slide. |
zIndex |
Flottant | Ordre de dessin, du plus petit au plus grand. |
<carousel name="systemcarousel"
type="horizontal" pos="0 0.38375" size="1 0.2325" origin="0 0"
color="FFFFFFD8" logoSize="0.25 0.155" logoScale="1.2" maxLogoCount="5"
logoAlignment="center" defaultTransition="slide" zIndex="40" />
C'est le mode par défaut. La propriété type fixe le sens de défilement :
| Valeur | Effet |
|---|---|
horizontal |
Les logos défilent horizontalement. Valeur par défaut |
vertical |
Les logos défilent verticalement |
vertical_wheel |
Les logos défilent verticalement en arc de cercle |
logoAlignment accepte top, bottom ou center quand type vaut horizontal, et left, right ou center quand type vaut vertical ou vertical_wheel.
logoRotation et logoRotationOrigin ne s'appliquent qu'au mode vertical_wheel.
Les systèmes qui n'ont pas de logo dans le thème sont affichés en texte, avec la police de fontPath / fontSize et la couleur fontColor.
Avec textOnly="true", le carrousel est remplacé par une liste verticale des noms de systèmes, rendue exactement comme la liste des jeux : une barre de sélection derrière le système sélectionné, et des couleurs distinctes pour les entrées sélectionnées et non sélectionnées.
Le mode
textOnlyest une nouveauté de Recalbox 10.1.
La liste remplit le cadre défini par pos, size et origin. Dans ce mode, type, logoSize, logoScale, logoRotation et maxLogoCount sont ignorés, et logoAlignment sert d'alignement horizontal du texte (left, right, center).
Les propriétés suivantes ne servent qu'à ce mode : primaryColor, secondaryColor, selectedColor, selectorColor, selectorHeight, selectorOffsetX, selectorOffsetY, lineSpacing, horizontalMargin, textOffsetX et forceUppercase.
<carousel name="systemcarousel" textOnly="true"
pos="0.05 0.15" size="0.4 0.7" origin="0 0"
color="00000000" fontPath="./art/Exo2-Bold.otf" fontSize="0.045" lineSpacing="1.6"
primaryColor="E6E6E6FF" secondaryColor="C6C6C6FF" selectedColor="FFFFFFFF"
selectorColor="FFFFFF33" selectorHeight="0" selectorOffsetX="0" selectorOffsetY="0"
logoAlignment="left" horizontalMargin="0.02" textOffsetX="0" forceUppercase="true" />
| Propriété | Défaut |
|---|---|
type |
horizontal |
pos |
0 0.38375 |
size |
1 0.2325 |
origin |
0 0 |
color |
FFFFFFD8 |
logoSize |
0.25 0.155 |
logoScale |
1.2 |
logoRotation |
7.5 |
logoRotationOrigin |
-5 0.5 |
logoAlignment |
center |
maxLogoCount |
3 |
zIndex |
40 |
textOnly |
false |
forceUppercase |
false |
fontColor |
E6E6E6FF |
primaryColor |
E6E6E6FF |
secondaryColor |
C6C6C6FF |
selectedColor |
FFFFFFFF |
selectorColor |
FFFFFF33 |
selectorHeight |
0 (hauteur d'une ligne) |
selectorOffsetX, selectorOffsetY, textOffsetX, horizontalMargin |
0 |
lineSpacing |
1.5 |
defaultTransition impose le style de transition entre systèmes et grise l'option correspondante dans les menus. Sans cette propriété, c'est le réglage de l'utilisateur qui s'applique.