Ein Recalbox-Theme erstellen

45 Seiten · 8 Abschnitte
FRENESDE Alles anzeigen Mein Theme erstellen

Die system-Ansicht — die Maschinen

Das Karussell, das Logo, die Informationszeile.

Der erste Bildschirm: die Liste deiner Maschinen.

Die reservierten Komponenten

NameTypAufgabe
systemcarouselcarouseldas Karussell — nur eines, nicht umbenennbar
logoimagedas Logo des Systems im Karussell
systemInfotextdie Zeile „510 Spiele verfügbar, 13 Favoriten“
bgsoundsounddie Hintergrundmusik des Themes
directorysoundder Musikordner des Themes

bgsound und directory sind die einzigen Namen, die <sound> akzeptiert, und nur in dieser Ansicht.

Zwei Fallen

systemInfo hat standardmäßig einen grauen Hintergrund. Um ihn zu entfernen:

<text name="systemInfo">
  <backgroundColor>00000000</backgroundColor>
</text>

Das Karussell ist einmalig. Ein zweites <carousel> wird ohne Fehler gelesen, aber nie gezeichnet.

Wenn das Theme kein Logo liefert, sucht Recalbox sein eigenes in dieser Reihenfolge:

<system>-<sprache_LAND>.svg   →   <system>-<sprache>.svg
      →   <system>-<region>.svg   →   <system>.svg

Das ermöglicht ein „Genesis“-Logo in den USA und „Mega Drive“ in Europa, ohne irgendetwas zu schreiben.

Das Karussell im Detail

EigenschaftStandardGenauer
typehorizontalhorizontal, vertical, vertical_wheel; jeder andere Wert fällt auf horizontal zurück
logoSizeberechnetVerhältnis zum Bildschirm, nicht zum Karussell
logoScale1.2Vergrößerung des gewählten Logos
maxLogoCount3auf die ganze Zahl gerundet — eine Dezimalzahl bringt nichts
colortransparentder Hintergrund des Karussells

Der Abstand der Logos berechnet sich so:

abstand = (laenge − logoSize × maxLogoCount) / maxLogoCount + logoSize

wobei laenge vertikal size.y ist, horizontal size.x.