Making a Recalbox theme

45 pages · 8 sections
FRENESDE Show everything Create my theme

A layer present on every view

A shared backdrop written once, instead of being copied into each view.

The problem

A CRT veil, a brand logo, a frame: you want it on the system list and on the game list and on the menu. Copying it into each view works… until the day you edit only one of them. The others stay behind, and nothing tells you.

The solution

Right-click the layer (or the inspector's ) → “Present on every view”.

The layer leaves its view and joins the shared layers: there is now only one, shared. Adjusting it from anywhere adjusts it everywhere.

To go back: “Keep only on this view”.

What it writes in the theme

A single block, whose name lists the views:

<!-- global.xml -->
<view name="system, basic, detailed, menu, gameclip">
    <extras>
        <image name="voileCRT" extra="true">…</image>
    </extras>
</view>

The machine splits this name on the commas and places the element in each view. The file is loaded before the views: what applies everywhere is a base, which a view can still correct.

Not to be confused

“Duplicate to another layout…” is something else: it copies the layer into another layout of the same view (for example “Vertical left” and “Horizontal”), and the two copies are then independent.

⚠️ The view name menu is written because the theme asks for it, but the engine reads no free component there: the layer does not show in the menus.

At import, a theme that already writes a block covering every view gets its shared layer back. A block that only covers some of them stays split per view: it only applies where the theme put it.