Ratio, Prozent oder Pixel
Die drei akzeptierten Schreibweisen für eine Position oder eine Größe.
Mehrere Eigenschaften werden mit zwei durch ein Leerzeichen getrennten Zahlen geschrieben: x y. Das gilt für pos, size, maxSize, origin, rotationOrigin, logoSize und reflection.
Jede Zahl akzeptiert drei Schreibweisen, und man darf sie im selben Paar mischen.
| Schreibweise | Beispiel | Bedeutung |
|---|---|---|
| Ratio (Standard) | 0.5 0.25 | ein Anteil des Bildschirms, von 0 bis 1 |
| Prozent | 50% 25% | dasselbe, anders geschrieben |
| Pixel | 960p 270p | echte Pixel, Suffix p |
<pos>0.5 0.5</pos> <!-- die Mitte -->
<pos>50% 50%</pos> <!-- genau dasselbe -->
<pos>960p 540p</pos> <!-- die Mitte… nur eines 1920×1080-Bildschirms -->Ratio oder Prozent: vorzuziehen
x ist ein Anteil der Breite, y der Höhe. Eine Komponente bei 0.5 0.5 ist auf einem 1920×1080 wie auf einem 640×480 in der Mitte. Das lässt ein Theme auf mehrere Bildschirme passen.
Pixel: eine feste Position
Ein Pixel ist ein Pixel. 960p sind 960 Pixel vom linken Rand, Punkt.
Das passt sich an nichts an: Auf einem Bildschirm mit weniger als 960 Pixeln Breite liegt die Komponente außerhalb des Bildschirms. Eine absolute Position, das Gegenteil des Ratios.
Pixel rechtfertigen sich nur für das, was unabhängig von der Auflösung fest bleiben muss: die Dicke einer Linie, ein Versatz von wenigen Punkten. Für alles andere nimm das Ratio.
Der Sonderfall fontSize
fontSize nimmt nur eine Zahl, und ihre Einheit hängt vom Wert ab:
| Wert | Bedeutung |
|---|---|
< 1 | ein Anteil der kurzen Seite des Bildschirms — 0.05 = 5 % der Höhe in 16:9 |
>= 1 | eine 240p-Referenzgröße, die Recalbox je nach Bildschirm multipliziert |
Über 1 ist der Wert keine Pixel. Es ist eine Größe für einen Bildschirm mit 240 Zeilen, bei jedem Auflösungsschritt eine Stufe multipliziert: ×1 bis 288 Pixel kurze Seite, ×2 bis 576, ×4 bei 1080p. <fontSize>8</fontSize> ergibt also 16 Pixel auf einem 480p-Bildschirm und 32 Pixel bei 1080p. Dieselbe Regel gilt überall — Menütexte eingeschlossen.
<fontSize>0.045</fontSize> <!-- 4,5 % der kurzen Seite: passt sich überall an, vorzuziehen -->
<fontSize>8</fontSize> <!-- „240p“-Größe: 16 px bei 480p, 32 px bei 1080p -->