The <image> object displays an image. Common formats are accepted: PNG, JPEG, non-animated GIF and SVG.
| View | Name | Element |
|---|---|---|
system |
logo |
The system logo, shown in the carousel |
detailed |
logo |
The system logo, as the game list header |
detailed |
md_image |
The scraped image of the selected game |
detailed |
default_image_path |
The image shown when the game has no scraped image |
detailed |
md_region1 to md_region4 |
The region flags of the selected game |
detailed |
md_folder_image_0 to md_folder_image_8 |
The nine thumbnails displayed on a folder |
detailed |
template_flag, template_genre, template_players |
The decorative list pictograms, colour-customisable only |
gameclip |
background |
The screensaver background layer |
gameclip |
logo |
The system logo |
gameclip |
md_image |
The scraped game image |
gameclip |
md_thumbnail |
The game thumbnail |
gameclip |
favoriteIcon |
The favourite icon |
gameclip |
recalboxLogo |
The Recalbox logo |
gameclip |
clippingImage |
The clipping image applied to the video |
For any other image, pick your own name and add extra="true".
The
consolename, found in Recalbox 9 themes, no longer exists in 10.1: an<image name="console">is ignored.
| Property | Type | Purpose |
|---|---|---|
pos |
Pair | Object position. See common properties. |
size |
Pair | Image size. If only one axis is given and the other left at 0, the missing one is computed to keep the aspect ratio. |
maxSize |
Pair | Maximum size, keeping the aspect ratio. |
keepratio |
Boolean | Preserves the aspect ratio together with size. |
origin |
Pair | Point of the object that pos refers to. |
rotation |
Float | Rotation angle in degrees, clockwise when positive. |
rotationOrigin |
Pair | Point the rotation happens around. Defaults to 0.5 0.5. |
path |
Path | Path of the image. |
tile |
Boolean | Tiles the image instead of stretching it. Useful for backgrounds. |
color |
Colour | Colour applied to the object. |
colorTop |
Colour | Top edge colour, for a gradient. |
colorBottom |
Colour | Bottom edge colour, for a gradient. |
colorLeft |
Colour | Left edge colour, for a gradient. |
colorRight |
Colour | Right edge colour, for a gradient. |
colorTopLeft |
Colour | Top left corner colour, for a gradient. |
colorTopRight |
Colour | Top right corner colour, for a gradient. |
colorBottomLeft |
Colour | Bottom left corner colour, for a gradient. |
colorBottomRight |
Colour | Bottom right corner colour, for a gradient. |
zIndex |
Float | Drawing order, from lowest to highest. |
disabled |
Boolean | Hides the object entirely. |
reflection |
Pair | Reflection under the object. Two values from 0 (transparent) to 1 (opaque): top and bottom of the reflection. |
<image name="logo" path="./art/logo.svg" pos="0.5 0.12" origin="0.5 0.5" maxSize="0.4 0.12" />
<image name="background" extra="true" path="./art/background.png" pos="0 0" size="1 1" zIndex="0" />
<image name="boxart" extra="true" path="${game.media.boxpath}" pos="0.8 0.45" origin="0.5 0.5" maxSize="0.25 0.4" reflection="0.6 0" />