User Tools

Site Tools


layouts

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
layouts [2020/09/24 13:05]
phulshof [<menu> Parameters]
layouts [2021/09/03 17:14]
phulshof [<reloadableScrollingText> Parameters]
Line 16: Line 16:
 The global settings.conf file contains the default layout used by RetroFE. It is however possible to give a collection a completely different layout by adding the layout.xml and layout artwork to the /​layouts/<​layout name>/​collections/<​collection name>/​layout/​ directory. A splash.xml is not required/​used for a collection'​s layout. This way you can give each collection a completely different look and feel. The global settings.conf file contains the default layout used by RetroFE. It is however possible to give a collection a completely different layout by adding the layout.xml and layout artwork to the /​layouts/<​layout name>/​collections/<​collection name>/​layout/​ directory. A splash.xml is not required/​used for a collection'​s layout. This way you can give each collection a completely different look and feel.
  
-RetroFE will first search for a layout XML file that matches the screen ratio, so e.g. layout 16x9.xml or layout 4x3.xml. If that file is not found, it will default to layout.xml. ​+RetroFE will first search for a layout XML file that matches the screen ratio, so e.g. "layout 16x9.xml" ​or layout 4x3.xml. If that file is not found, it will default to "layout.xml". Additionally,​ it will look for a layout file per monitor, e.g. "​layout 16x9 - 0.xml",​ "​layout - 1.xml",​ etc. 
 + 
 +When entering a collection, RetroFE will check the /​layouts/<​layout name>/​collections/<​collection name>/​layout/​ directory for the same layout XML files. If found, it will load that new layout, allowing you to set a different layout for each collection
 \\ \\
 \\ \\
Line 29: Line 31:
    <​image/>​    <​image/>​
    <​text/>​    <​text/>​
 +   <​reloadableAudio/>​
    <​reloadableVideo/>​    <​reloadableVideo/>​
    <​reloadableImage/>​    <​reloadableImage/>​
Line 161: Line 164:
 \\ \\
  
-=====<​reloadableVideo>​ Parameters=====+=====<​reloadableVideo> and <​reloadableAudio> Parameters=====
  
-The <​reloadableVideo>​ tag can be used to display a video of the selected item, and supports the following parameters:+The <​reloadableVideo> and <​reloadableAudio> tag can be used to display a video or audio (supported types are avi, mp4, wav, and mp3) of the selected item, and supports the following parameters:
  
-^<​reloadableVideo>​ tag parameters^^ +^<​reloadableVideo> and <​reloadableAudio> tag parameters^^ 
-|type |The type of video to display: “numberButtons”,​ “numberPlayers”,​ “ctrlType”,​ “numberJoyWays”,​ “rating”,​ “score”,​ “year”, “title”,​ “developer”,​ “manufacturer”,​ “genre”,​ “playlist”,​ “collectionName”,​ “collectionSize”,​ “collectionIndex”,​ “collectionIndexSize”,​ or any type you pick where the title will be used as the name of the file.|+|type |The type of video to display: “numberButtons”,​ “numberPlayers”,​ “ctrlType”,​ “numberJoyWays”,​ “rating”,​ “score”,​ “year”, “title”,​ “developer”,​ “manufacturer”,​ “genre”,​ “playlist”,​ “collectionName”,​ “collectionSize”,​ “collectionIndex”,​ “collectionIndexSize”, "​isFavorite"​, or any type you pick where the title will be used as the name of the file.|
 |imageType |The type of image to display if a video cannot be found: "​numberButtons",​ "​numberPlayers",​ "​year",​ "​title",​ "​manufacturer",​ "​genre"​.| |imageType |The type of image to display if a video cannot be found: "​numberButtons",​ "​numberPlayers",​ "​year",​ "​title",​ "​manufacturer",​ "​genre"​.|
 |mode |See mode attribute for more details.| |mode |See mode attribute for more details.|
Line 177: Line 180:
 |backgroundAlpha |Background color transparency:​ 0 = 0% visible, 0.5=50% visible, 1=100% visible| |backgroundAlpha |Background color transparency:​ 0 = 0% visible, 0.5=50% visible, 1=100% visible|
 |volume |Audio volume of the video: 0 = mute, 1=100% volume| |volume |Audio volume of the video: 0 = mute, 1=100% volume|
 +|jukebox ​       |yes = enable jukebox mode. This will disable the attract mode for this layout, and in stead start scrolling after this video/audio is done playing. Default is no.|
 +|jukeboxNumLoops |Number of loops to play the jukebox element before the jukebox mode is activated. Default is 1.|
  
  
Line 229: Line 234:
 The <​reloadableScrollingText>​ tag can be used to display textual information about the selected item, loaded from a text file, and supports the following parameters: The <​reloadableScrollingText>​ tag can be used to display textual information about the selected item, loaded from a text file, and supports the following parameters:
  
-^<reloadableText> tag parameters^^ ​+^<reloadableScrollingText> tag parameters^^ ​
 |type |The type of text file to load. Files are generally placed as <​collection name>/​medium_artwork/<​type>/<​game name>​.txt or <​collection name>/​system_artwork/<​type>​.txt. In addition, the following meta fields are supported: “numberButtons”,​ “numberPlayers”,​ “ctrlType”,​ “numberJoyWays”,​ “rating”,​ “score”,​ “year”, “title”,​ “developer”,​ “manufacturer”,​ “genre”,​ “playlist”,​ “collectionName”,​ “collectionSize”,​ “collectionIndex”,​ or “collectionIndexSize”.| |type |The type of text file to load. Files are generally placed as <​collection name>/​medium_artwork/<​type>/<​game name>​.txt or <​collection name>/​system_artwork/<​type>​.txt. In addition, the following meta fields are supported: “numberButtons”,​ “numberPlayers”,​ “ctrlType”,​ “numberJoyWays”,​ “rating”,​ “score”,​ “year”, “title”,​ “developer”,​ “manufacturer”,​ “genre”,​ “playlist”,​ “collectionName”,​ “collectionSize”,​ “collectionIndex”,​ or “collectionIndexSize”.|
 |mode |See mode attribute for more details.| |mode |See mode attribute for more details.|
Line 243: Line 248:
 |alignment |The text alignment for vertical scrolls: left, right, centered, justified.| |alignment |The text alignment for vertical scrolls: left, right, centered, justified.|
  
-The text will scroll across the screen until it is no longer visible. Then it will be reset. ​For a vertical scroll: if the startPosition is 0, and the text fits within the defined size, the text will not scroll.+The text will scroll across the screen until it is no longer visible. Then it will be reset. ​If the startPosition is 0, and the text fits within the defined size, the text will not scroll.
  
 Example: Example:
Line 272: Line 277:
 |backgroundColor |Fill the component with a background color| |backgroundColor |Fill the component with a background color|
 |backgroundAlpha |Background color transparency:​ 0 = 0% visible, 0.5=50% visible, 1=100% visible| |backgroundAlpha |Background color transparency:​ 0 = 0% visible, 0.5=50% visible, 1=100% visible|
-|reflection |Location of the reflection compared to the original image: top, bottom, left, right.|+|reflection |Location of the reflection compared to the original image: top, bottom, left, right. Can be combined to show multiple reflections,​ e.g. topleft, leftright, topbottomright. |
 |reflectionDistance |Distance between the reflection and the original image in pixels.| |reflectionDistance |Distance between the reflection and the original image in pixels.|
 |reflectionScale |Scale in vertical (reflection top/bottom) or horizontal (reflection left/right) direction of the reflection compared to the original image.| |reflectionScale |Scale in vertical (reflection top/bottom) or horizontal (reflection left/right) direction of the reflection compared to the original image.|
Line 281: Line 286:
 |containerHeight|Height of the cropping container.| |containerHeight|Height of the cropping container.|
 |layer|Layer on which the item should be displayed: 0 = back, 19 = front | |layer|Layer on which the item should be displayed: 0 = back, 19 = front |
 +|monitor|Monitor number on which the element should be displayed, starting from monitor 0.|
 |menuScrollReload|Reload the art while the menu is scrolling when set to yes/true | |menuScrollReload|Reload the art while the menu is scrolling when set to yes/true |
  
layouts.txt · Last modified: 2021/09/03 17:14 by phulshof