carousel — das System-Karussell
Das Band, das die Systeme vorbeiziehen lässt: Richtung, Logogröße, und der Textmodus.
Das Karussell zeigt die Systeme, Logo für Logo. Es existiert nur in der Systeme-Ansicht, unter dem reservierten Namen systemcarousel, und die Engine baut nur eines. Anderswo, oder unter einem anderen Namen, wird es gar nicht aufgebaut.
Die Laufrichtung
type akzeptiert horizontal (Standard), vertical und vertical_wheel — das Rad. Ein horizontales Rad gibt es nicht: jeder andere Wert fällt stillschweigend auf horizontal zurück.
Die Eigenschaften (28)
<carousel name="systemcarousel">
<type>vertical</type>
<pos>0 0</pos>
<size>0.25 1</size>
<color>00000020</color>
<logoSize>0.12 0.075</logoSize>
<logoScale>1.5</logoScale>
<maxLogoCount>7</maxLogoCount>
<logoAlignment>center</logoAlignment>
<defaultTransition>instant</defaultTransition>
</carousel>
| Eigenschaft | Aufgabe |
|---|---|
type | horizontal, vertical, vertical_wheel |
pos size origin | Platzierung |
color | der Hintergrund des Karussells |
logoSize | die Größe eines Logos (Paar) |
logoScale | die Vergrößerung des gewählten Logos |
logoRotation logoRotationOrigin | die Rotation der Logos (Räder) |
logoAlignment | die Ausrichtung der Logos in ihrem Feld |
maxLogoCount | wie viele Logos gleichzeitig sichtbar sind |
defaultTransition | fade oder instant; jeder andere Wert ergibt slide |
fontPath fontSize fontColor | die Schrift des Textmodus |
forceUppercase | die Systemnamen in Großbuchstaben |
textOnly | die Namen schreiben statt der Logos |
primaryColor secondaryColor | die Farbe der Namen |
selectedColor | die Farbe des gewählten Namens |
selectorColor selectorHeight | die Markierung des Textmodus |
selectorOffsetX selectorOffsetY | ihr Versatz |
textOffsetX | der Versatz des Textes |
lineSpacing horizontalMargin | Zeilenabstand und Ränder des Textmodus |
zIndex | die Tiefe |
⚠️ Kein disabled: das Karussell schaltet sich nicht ab.
⚠️ maxLogoCount ist keine Anzahl angezeigter Logos. Es steuert nur Abstand und Zentrierung: die Engine zeichnet mehr davon, die überstehen und abgeschnitten werden. Und der Wert wird auf die ganze Zahl gerundet — eine Dezimalzahl (2.5) ist daher nutzlos.
Logos, oder Namen
Im Abschnitt Systemliste wählt „WAS VORBEIZIEHT“ zwischen:
- Logos — das übliche Verhalten;
- Namen — das Karussell schreibt den Namen jedes Systems.
⚠️ Es ist keine vierte Laufrichtung: der Textmodus kombiniert sich mit horizontal, vertikal und Rad. Ein Karussell aus Namen kann also in jede Richtung laufen.
Die Eigenschaften, die dazugehören
Im Textmodus werden die Schrift, ihre Größe und ihre Farbe im Abschnitt Text eingestellt. Zwei karusselleigene Versätze kommen hinzu:
- Horizontaler Versatz der Markierung (
selectorOffsetX); - Horizontaler Versatz des Textes (
textOffsetX).
Was es schreibt
<carousel name="systemcarousel" type="vertical">
<textOnly>true</textOnly>
<textOffsetX>0.02</textOffsetX>
</carousel>
Verfügbar ab Recalbox 10.1. Auf einer älteren Maschine wird
textOnlyignoriert und das Karussell zeigt die Logos.