Ein Recalbox-Theme erstellen

45 Seiten · 8 Abschnitte
FRENESDE Alles anzeigen Mein Theme erstellen

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>
EigenschaftAufgabe
typehorizontal, vertical, vertical_wheel
pos size originPlatzierung
colorder Hintergrund des Karussells
logoSizedie Größe eines Logos (Paar)
logoScaledie Vergrößerung des gewählten Logos
logoRotation logoRotationOrigindie Rotation der Logos (Räder)
logoAlignmentdie Ausrichtung der Logos in ihrem Feld
maxLogoCountwie viele Logos gleichzeitig sichtbar sind
defaultTransitionfade oder instant; jeder andere Wert ergibt slide
fontPath fontSize fontColordie Schrift des Textmodus
forceUppercasedie Systemnamen in Großbuchstaben
textOnlydie Namen schreiben statt der Logos
primaryColor secondaryColordie Farbe der Namen
selectedColordie Farbe des gewählten Namens
selectorColor selectorHeightdie Markierung des Textmodus
selectorOffsetX selectorOffsetYihr Versatz
textOffsetXder Versatz des Textes
lineSpacing horizontalMarginZeilenabstand und Ränder des Textmodus
zIndexdie Tiefe
color — der Hintergrund des Karussells gewählt logoSize × logoScale maxLogoCount — wie viele sichtbar sind nur das gewählte Logo ist in voller Größe: die anderen sind verkleinert

⚠️ 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:

⚠️ 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:

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 textOnly ignoriert und das Karussell zeigt die Logos.