L'objet <box> dessine un rectangle de couleur. Il évite de créer une image pour un simple aplat, un bandeau ou un dégradé, et reste net à toutes les résolutions.
<box>est apparu en Recalbox 10.
Cet objet n'a pas de nom imposé : vous choisissez le vôtre et vous ajoutez extra="true".
| Propriété | Type | Rôle |
|---|---|---|
pos |
Couple | Position de l'objet. Voir les propriétés communes. |
size |
Couple | Taille de l'objet. |
origin |
Couple | Point de l'objet auquel pos se rapporte. |
rotation |
Flottant | Angle de rotation en degrés, horaire si positif. |
rotationOrigin |
Couple | Point autour duquel la rotation s'effectue. Par défaut 0.5 0.5. |
color |
Couleur | Couleur appliquée à l'objet. |
colorTop |
Couleur | Couleur du bord haut, pour un dégradé. |
colorBottom |
Couleur | Couleur du bord bas, pour un dégradé. |
colorLeft |
Couleur | Couleur du bord gauche, pour un dégradé. |
colorRight |
Couleur | Couleur du bord droit, pour un dégradé. |
colorTopLeft |
Couleur | Couleur du coin haut gauche, pour un dégradé. |
colorTopRight |
Couleur | Couleur du coin haut droit, pour un dégradé. |
colorBottomLeft |
Couleur | Couleur du coin bas gauche, pour un dégradé. |
colorBottomRight |
Couleur | Couleur du coin bas droit, pour un dégradé. |
zIndex |
Flottant | Ordre de dessin, du plus petit au plus grand. |
disabled |
Booléen | Masque complètement l'objet. |
<box name="bandeauBas" extra="true" pos="0 0.85" size="1 0.15" color="000000A0" zIndex="8" />
<box name="degrade" extra="true" pos="0 0" size="1 0.3" colorTop="000000FF" colorBottom="00000000" zIndex="6" />
Si vous ne renseignez que color, le rectangle est uni. Les autres propriétés de couleur permettent de construire un dégradé : colorTop et colorBottom pour un dégradé vertical, colorLeft et colorRight pour un dégradé horizontal, et les quatre colorXXX de coin pour un dégradé libre.
Comme partout, le canal alpha se règle sur les deux derniers caractères : 000000A0 est un noir aux deux tiers opaque, 00000000 est totalement transparent — ce qui permet de faire disparaître un dégradé en douceur.