carousel — the system carousel
The strip that scrolls the systems: direction, logo size, and the text mode.
The carousel displays the systems, logo by logo. It only exists in the Systems view, under the reserved name systemcarousel, and the engine builds only one. Elsewhere, or under another name, it is not built at all.
The scrolling direction
type accepts horizontal (the default), vertical and vertical_wheel — the wheel. There is no horizontal wheel: any other value silently falls back to horizontal.
The properties (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>
| Property | Role |
|---|---|
type | horizontal, vertical, vertical_wheel |
pos size origin | placement |
color | the carousel's background |
logoSize | the size of a logo (pair) |
logoScale | the enlargement of the chosen logo |
logoRotation logoRotationOrigin | logo rotation (wheels) |
logoAlignment | logo alignment within their slot |
maxLogoCount | how many logos visible at once |
defaultTransition | fade or instant; any other value gives slide |
fontPath fontSize fontColor | the text mode's font |
forceUppercase | system names all in capitals |
textOnly | write the names instead of the logos |
primaryColor secondaryColor | the color of the names |
selectedColor | the color of the chosen name |
selectorColor selectorHeight | the text mode's highlighter |
selectorOffsetX selectorOffsetY | its offset |
textOffsetX | the text offset |
lineSpacing horizontalMargin | line spacing and margins of the text mode |
zIndex | depth |
⚠️ No disabled: the carousel does not switch off.
⚠️ maxLogoCount is not a number of displayed logos. It only drives spacing and centering: the engine draws more of them, which overflow and get clipped. And the value is rounded to the integer — a decimal (2.5) is therefore useless.
Logos, or names
In the System list section, “WHAT SCROLLS BY” picks between:
- Logos — the usual behavior;
- Names — the carousel writes each system's name.
⚠️ It is not a fourth scrolling direction: the text mode combines with horizontal, vertical and wheel. A carousel of names can therefore scroll in any direction.
The properties that go with it
In text mode, the font, its size and its color are set in the Text section. Two offsets specific to the carousel are added:
- Highlighter horizontal offset (
selectorOffsetX); - Text horizontal offset (
textOffsetX).
What it writes
<carousel name="systemcarousel" type="vertical">
<textOnly>true</textOnly>
<textOffsetX>0.02</textOffsetX>
</carousel>
Available from Recalbox 10.1. On an older machine,
textOnlyis ignored and the carousel shows the logos.