Ratio, porcentaje o píxeles
Las tres escrituras aceptadas para una posición o un tamaño.
Varias propiedades se escriben con dos números separados por un espacio: x y. Es el caso de pos, size, maxSize, origin, rotationOrigin, logoSize y reflection.
Cada número acepta tres escrituras, y se pueden mezclar en la misma pareja.
| Escritura | Ejemplo | Qué significa |
|---|---|---|
| Ratio (por defecto) | 0.5 0.25 | una proporción de la pantalla, de 0 a 1 |
| Porcentaje | 50% 25% | lo mismo, escrito de otra forma |
| Píxeles | 960p 270p | píxeles reales, sufijo p |
<pos>0.5 0.5</pos> <!-- el centro -->
<pos>50% 50%</pos> <!-- exactamente igual -->
<pos>960p 540p</pos> <!-- el centro… solo de una pantalla 1920×1080 -->Ratio o porcentaje: preferibles
x es una proporción del ancho, y de la altura. Un componente en 0.5 0.5 está en el centro de un 1920×1080 igual que de un 640×480. Eso es lo que permite a un tema caber en varias pantallas.
Los píxeles: una posición fija
Un píxel es un píxel. 960p son 960 píxeles desde el borde izquierdo, y punto.
No se adapta a nada: en una pantalla de menos de 960 píxeles de ancho, el componente queda fuera de la pantalla. Es una posición absoluta, lo contrario del ratio.
Los píxeles solo se justifican para lo que debe quedarse fijo sea cual sea la resolución: el grosor de un filete, un desplazamiento de unos puntos. Para todo lo demás, usa el ratio.
El caso particular de fontSize
fontSize solo toma un número, y su unidad depende de su valor:
| Valor | Qué significa |
|---|---|
< 1 | una proporción del lado corto de la pantalla — 0.05 = 5 % de la altura en 16:9 |
>= 1 | un tamaño de referencia 240p, que Recalbox multiplica según la pantalla |
Por encima de 1, el valor no son píxeles. Es un tamaño pensado para una pantalla de 240 líneas, multiplicado un escalón en cada salto de resolución: ×1 hasta 288 píxeles de lado corto, ×2 hasta 576, ×4 en 1080p. <fontSize>8</fontSize> hace por tanto 16 píxeles en una pantalla 480p y 32 píxeles en 1080p. La misma regla vale en todas partes — textos del menú incluidos.
<fontSize>0.045</fontSize> <!-- 4,5 % del lado corto: se adapta en todas partes, preferible -->
<fontSize>8</fontSize> <!-- tamaño «240p»: 16 px en 480p, 32 px en 1080p -->