Making a Recalbox theme

45 pages · 8 sections
FRENESDE Show everything Create my theme

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>
PropertyRole
typehorizontal, vertical, vertical_wheel
pos size originplacement
colorthe carousel's background
logoSizethe size of a logo (pair)
logoScalethe enlargement of the chosen logo
logoRotation logoRotationOriginlogo rotation (wheels)
logoAlignmentlogo alignment within their slot
maxLogoCounthow many logos visible at once
defaultTransitionfade or instant; any other value gives slide
fontPath fontSize fontColorthe text mode's font
forceUppercasesystem names all in capitals
textOnlywrite the names instead of the logos
primaryColor secondaryColorthe color of the names
selectedColorthe color of the chosen name
selectorColor selectorHeightthe text mode's highlighter
selectorOffsetX selectorOffsetYits offset
textOffsetXthe text offset
lineSpacing horizontalMarginline spacing and margins of the text mode
zIndexdepth
color — the carousel’s background chosen logoSize × logoScale maxLogoCount — how many are visible only the chosen logo is at full size: the others are shrunk

⚠️ 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:

⚠️ 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:

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, textOnly is ignored and the carousel shows the logos.