These parameters define a rectangular area. All parts of the image that fall within that area are shown on screen; all parts that fall outside of that area are omitted.
- numberButtons
- numberPlayers
- year
- title
- manufacturer
- genre
- ctrlType
- joyWays
- rating
These files, if supported, used to be in directories starting with _ in the collections directory, e.g. collections/_manufacturer. They should now be placed in collections/_common/medium_artwork/manufacturer etc.
Two modes were added to support this:
- mode="common"
- mode="commonlayout"
This last mode forces RetroFE to expect the files in the selected layout directory, so e.g. layouts/Aeon Nox 16x9/collections/_common/medium_artwork/manufacturer/.
So, where before you would use <reloadableImage type="manufacturer", you should now use <reloadableImage type="manufacturer" mode="common", and the files are expected in collections/_common/medium_artwork/manufacturer/ in stead of collections/_manufacturer. It may seem like more work, but at least it's a generic way for all common art to be handled.
direction: horizontal | vertical
horizontal scrolling will scroll over a single line.
vertical scrolling will scroll multiple lines if the text does not fit inside the box.
alignment: left | right | centered | justified
Defines the alignment of the vertical scrolling text inside the box.
scrollingSpeed:
Defines the scrolling speed in pixels per second.
startPosition:
Defines the horizontal starting position of the text compared to the left of the box.
Defines the vertical starting position of the text compared to the top of the box.
startTime:
Defines how many seconds the text will wait before it starts scrolling.
endTime:
Defines how many seconds the text will take to reappear after it's done scrolling.
printed text = 0: singlePrefix text pluralPostfix
printed text = 1: singlePrefix text singlePostfix
otherwise : pluralPrefix text pluralPostfix
This allows support for themes in different languages or simply textual printing freedom.
reflection: top, bottom, left or right
reflectionDistance: distance between the image and the reflected image
reflectionScale: scaling of the image in the direction of the reflection
reflectionAlpha: transparency factor of the reflection
menus animated the scaled width/height rather than the real width/height,
which caused their internal state to become corrupted, which showed when
the item was then animated using maxWidth/maxHeight.
RetroFE will look for layout.xml and corresponding art in the
collections/<collection name>/layout/ subdirectory of your chosen layout,
and load that layout if it is available.
from the layout directory rather than the collections directory. Their
standard counter modes are no mode attribute, and mode="system".
Example:
no mode: load collections/MAME/medium_artwork/video/mslug.mp4
mode "layout": load layouts/<layout name>/collections/MAME/medium_artwork/video/mslug.mp4
Example:
mode "system": load collections/MAME/system_artwork/device.png
mode "systemlayout": load layouts/<layout name>/collections/MAME/system_artwork/device.png