Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
decoration [2021/01/24 12:30] – ↷ Links adapted because of a move operation fishou | decoration [2023/10/24 00:53] (current) – lbrpdx | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ~~NOTOC~~ | + | ====== Decorations ====== |
- | ===== DECORATION | + | |
- | In the 80s and 90s, most video game screens had a 4/3 aspect ratio. Nowadays, screens mostly use a 16/9 ratio, which means that they provide extra space on the sides compared | + | Recommended |
- | Rather than stretching out the 4/3 image to fit into a 16/9 model, you can fill the extra space with a "background" | + | In the 80s and 90s, most video game screens had a 4:3 aspect ratio. Nowadays, screens mostly use a 16:9 ratio, which means that they provide extra space on the sides compared to a 4:3 aspect ratio. |
+ | |||
+ | Rather than stretching out the 4:3 image to fit into a 16:9 model, you can fill the extra space with a background image that provides an even more immersive experience. You can simulate the looks of an old TV set, or even a background that matches the game you are playing. | ||
+ | |||
+ | <WRAP center round info> | ||
+ | On SBCs, not every system and emulator supports bezels. Most Retroarch cores should support the right bezel out-of-the-box. Standalone cores and more modern system often do not support bezels or do not need any, because the systems already use 16:9 ratio. | ||
+ | |||
+ | Since **v33**, decorations on x86_64 and RPi 4 can be used on most emulators! | ||
+ | </ | ||
The '' | The '' | ||
* several '' | * several '' | ||
- | * integration with [[https:// | + | * integration with [[https:// |
+ | The Bezel Project bezels do **not** provide viewport co-ordinate information. They are designed to be used with integer scaling turned //on// on a standard 16:9 1080p display and will not scale properly with alternate resolutions as the other provided decorations do. | ||
+ | </ | ||
- | You can also [[customize_decorations_bezels|add your own bezels]] to Batocera. | + | You can also [[# |
Example of a well known arcade game, with theBezelProject on (and '' | Example of a well known arcade game, with theBezelProject on (and '' | ||
Line 16: | Line 25: | ||
{{ : | {{ : | ||
+ | If you have a nice TV with a 4K resolution 3840x2160, or if you use an ultra-wide monitor, or if you basically use emulators with a resolution that is above 1920x1080 (larger, or taller), you might have distorted bezels, The reason is that Batocera shipts default bezels with a HD 1920x1080 resolution. To fix that, several options, you can either: | ||
+ | |||
+ | - switch to a lower resolution (like 1920x1080) - which might not look good for non 16:9 monitors and TV. | ||
+ | - or turn on the **STRETCH BEZELS** option in the **GAMES SETTINGS** -> **DECORATIONS** menu. | ||
+ | - or add a line '' | ||
+ | |||
+ | <WRAP center round important> | ||
+ | Turning on bezel stretching for high resolutions has a significant impact on emulation performance. | ||
+ | </ | ||
+ | |||
+ | ===== Decoration (bezels) customization ===== | ||
+ | |||
+ | ==== Create a new decoration set ==== | ||
+ | |||
+ | * Connect to your batocera.linux box, [[add_games_bios|via the network]] for example | ||
+ | * In the ''/ | ||
+ | |||
+ | {{bezel1.png? | ||
+ | |||
+ | * Inside the '' | ||
+ | * From the main batocera.linux menu go to **GAMES SETTINGS** -> **DECORATIONS** | ||
+ | * Check that the '' | ||
+ | |||
+ | {{bezel2.png? | ||
+ | |||
+ | * Note 1: default bezels are available at [[https:// | ||
+ | * Note 2: if you create a " | ||
+ | |||
+ | ==== Create a new bezel ==== | ||
+ | |||
+ | In Batocera, you can create: | ||
+ | |||
+ | * bezels for specific games on specific systems (mario on SNES) | ||
+ | * bezels for specific games on all systems (mario on all systems) | ||
+ | * bezels for specific system (a bezel for SNES, one for GB ...) | ||
+ | * a default bezel for all | ||
+ | |||
+ | You can have all four at the same time. In case your ROM/system selection matches more than one option, Batocera will apply the rules in the order listed above. If there is no suitable bezel, no bezel will be displayed. | ||
+ | |||
+ | A bezel is composed of 2 files. A '' | ||
+ | |||
+ | <WRAP center round tip> | ||
+ | TVsIan has created a script which can automatically calculate the required '' | ||
+ | </ | ||
+ | |||
+ | === Specific games on specific systems === | ||
+ | |||
+ | Bezels for a specific game on a specific system must be placed in the '' | ||
+ | |||
+ | Example: '' | ||
+ | |||
+ | With this example, your bezel will be used for the game ROM '' | ||
+ | |||
+ | === Specific games === | ||
+ | Bezels for specific games on all systems must be placed in the '' | ||
+ | |||
+ | Example: '' | ||
+ | |||
+ | In that case, if you have two ROM files named '' | ||
+ | |||
+ | === Specific systems === | ||
+ | Bezels for specific systems must be placed in the '' | ||
+ | |||
+ | Example: '' | ||
+ | |||
+ | === Default bezel === | ||
+ | The default bezel must be at top level and have the name '' | ||
+ | |||
+ | Example: | ||
+ | Create the file '' | ||
+ | A size of 1920x1080 is recommended. | ||
+ | The bezel will be drawn over the emulator rendering. Thus, you must keep transparent parts on the image. | ||
+ | |||
+ | {{bezel3.png? | ||
+ | |||
+ | === the .info file === | ||
+ | The '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | |||
+ | ===== Custom tattoo image (additional overlays) ===== | ||
+ | |||
+ | Batocera **v33** and higher now support being able to use a custom image overlaid on top of your decoration: | ||
+ | |||
+ | {{: | ||
+ | |||
+ | This can be useful for two applications: | ||
+ | * remember what is the button mapping for the system you are playing (where on Earth are those Megadrive/ | ||
+ | * streamers putting their metadata/ | ||
+ | |||
+ | To set the tattoo globally, press '' | ||
+ | |||
+ | This can also be configured manually in '' | ||
+ | |||
+ | < | ||
+ | # Enable tattoos for all systems: you can choose between ' | ||
+ | global.bezel.tattoo=system | ||
+ | # Display the tattoo in the upper left corner (can be either NW, NE, SW or SE): | ||
+ | global.bezel.tattoo_corner=NW | ||
+ | # PNG (transparent backgrounds work best) location: | ||
+ | global.bezel.tattoo_file=/ | ||
+ | # Specify a different tattoo for a specific system (overriding the default): | ||
+ | gbc.bezel.tattoo_file=/ | ||
+ | # Disable the tattoo for a specific system (overriding the default): | ||
+ | snes.bezel.tattoo=0 | ||
+ | </ | ||
+ | |||
+ | The corner selection can be different for each system: look at the example below with '' | ||
+ | |||
+ | {{: | ||
+ | |||
+ | <WRAP center round tip> | ||
+ | In case you'd like to make your own, the source for the system controller tattoos can be found here: https:// | ||
+ | </ | ||
+ | |||
+ | ===== Troubleshooting ===== | ||
+ | |||
+ | ==== There' | ||
+ | |||
+ | It is possible that this may happen if you have a special custom command for mounting the ROMs folder, such as: | ||
+ | |||
+ | < | ||
+ | sharenetwork_cmd1=mount.cifs -o username=mylogin, | ||
+ | </ | ||
- | If you have a nice TV and ask for a 4K 3840x2160 resolution to the emulators, but with a bezel that is HD 1920x1080: by default Batocera will add black borders around | + | this could interfere |
- | - switch to a lower resolution (like 1920x1080) | + | Using the regular |
- | - add a line '' | + | |
- decoration.1611487851.txt.gz
- Last modified: 3 years ago
- by fishou