From b0366cfe49d67e72381b19cb434716fb048f875d Mon Sep 17 00:00:00 2001 From: Leon Styhre Date: Mon, 14 Dec 2020 17:18:35 +0100 Subject: [PATCH] Documentation update. --- README.md | 3 +++ USERGUIDE.md | 17 +++++++++++++++++ 2 files changed, 20 insertions(+) diff --git a/README.md b/README.md index 5c79292bf..465962076 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,7 @@ Although there are multiple forks of EmulationStation in existence, the goal of The current version 1.0 has been tested on the following operating systems (all for the x86 architecture): * Ubuntu 20.04 +* Ubuntu 20.10 * * Linux Mint 20 * Manjaro * Fedora 33 Workstation @@ -22,6 +23,8 @@ The current version 1.0 has been tested on the following operating systems (all * Windows 10 * Windows 8.1 +***)** For Ubuntu 20.10, the included VLC version 3.0.11.1-2 is broken so ES-DE will crash when attempting to play videos. This can be fixed by manually replacing the file /lib/x86_64-linux-gnu/libvlccore.so.9.0.0 with the corresponding file from version 3.0.9.2-1 from Ubuntu 20.04. Make sure that the /lib/x86_64-linux-gnu/libvlccore.so.9 symlink points to this file as well. Hopefully this issue will soon be patched so that this manual workaround is not required. + At the moment Raspberry Pi is not supported, but this is planned for future releases. It may still be possible to compile and run ES-DE on this device, but as of v1.0 it's not actively used during development and therefore not tested. FreeBSD, NetBSD and OpenBSD are only partially supported. Although the application should work correctly on these operating systems, there is no plan to distribute installation packages as it wouldn't make much sense. The goal is rather to have ES-DE added to the ports/package collections of these systems. diff --git a/USERGUIDE.md b/USERGUIDE.md index 4dafb2665..ae00b29a7 100644 --- a/USERGUIDE.md +++ b/USERGUIDE.md @@ -13,6 +13,7 @@ Getting started with EmulationStation is easy, just make sure to install the sof The following operating systems have been tested (all for the x86 architecture): * Ubuntu 20.04 +* Ubuntu 20.10 * * Linux Mint 20 * Manjaro * Fedora 33 Workstation @@ -25,6 +26,7 @@ The following operating systems have been tested (all for the x86 architecture): * Windows 10 * Windows 8.1 +***)** For Ubuntu 20.10, the included VLC version 3.0.11.1-2 is broken so ES-DE will crash when attempting to play videos. This can be fixed by manually replacing the file /lib/x86_64-linux-gnu/libvlccore.so.9.0.0 with the corresponding file from version 3.0.9.2-1 from Ubuntu 20.04. Make sure that the /lib/x86_64-linux-gnu/libvlccore.so.9 symlink points to this file as well. Hopefully this issue will soon be patched so that this manual workaround is not required. The installation procedure is just covered briefly here and may differ a bit for your specific operating system, so in case of problems refer to your system documentation. @@ -84,6 +86,21 @@ After ES-DE finds at least one game file, it will populate that game system and _This is the error dialog shown if no game files were found. It also lets you configure the ROM directory if you don't want to use the default one. Note that the directory is the real physical path, and that your operating system may present this as a localized path if you are using a language other than English._ +## Running on 4K displays + +ES-DE fully supports 4K displays, but some emulators such as RetroArch will start with the same resolution as the calling program, meaning the emulation will also run in 4K. On slower computers and where expensive shaders are in use, the performance may be quite bad. A workaround for this is to start ES-DE with the **--resolution** option. For example, to set the resolution to 1920x1080 run the following: + +``` +emulationstation --resolution 1920 1080 +``` + +This can of course be set in the ES-DE launcher entry for the desktop environment so that the normal menu entry can be used. + +A drawback with this approach is that the complete system resolution will be switced temporarily, meaning alt-tab switching between application will display them also in this lower resolution. Upon exiting ES-DE the previous 4K resolution will however be restored. + +Note though that this only works well for Unix/Linux at the moment as Windows and macOS will run in windowed mode due to technical limitations in these operating systems. But there may be workarounds for the actual emulator as well that I'm not aware of, making it possible to force a specific resolution while still running ES-DE in 4K. + + ## Input device configuration When first starting ES-DE, the application will look for any attached controllers (joysticks and gamepads). If no devices are found, it will be assumed that only keyboard navigation is to be used and the default keyboard mappings will be applied. It's recommended to change these default values, and a message will be displayed describing just this. It's however possible to hide this notification permanently and continue to use the default keyboard mappings indefinitely if you're happy with them.