From 5c0cf89ac1d9bd39669b27d20664e62bd7e2401b Mon Sep 17 00:00:00 2001 From: Leon Styhre Date: Wed, 14 Jul 2021 19:27:39 +0200 Subject: [PATCH] Documentation update. --- INSTALL-DEV.md | 32 ++++++++++++++++---------------- USERGUIDE-DEV.md | 6 +++++- 2 files changed, 21 insertions(+), 17 deletions(-) diff --git a/INSTALL-DEV.md b/INSTALL-DEV.md index 092ed7250..97245a23d 100644 --- a/INSTALL-DEV.md +++ b/INSTALL-DEV.md @@ -66,7 +66,7 @@ sudo pacman -S vlc **Raspberry Pi OS (Raspian)** -Note: The Raspberry Pi 4 is the minimum recommended model to use with ES-DE. As this type of device is quite weak and because the FFmpeg video player currently lacks hardware decoding/acceleration it is strongly adviced to build with the VLC player, which is hardware accelerated. +Note: The Raspberry Pi 4 is the minimum recommended model to use with ES-DE. As this type of device is quite weak and because the FFmpeg video player does not support hardware decoding on this platform, it's strongly adviced to build with the VLC player, which is hardware accelerated. All of the required packages can be installed with apt-get: ``` @@ -792,7 +792,7 @@ In the descriptions below it's assumed that all build steps for MinGW/GCC will b **Download the dependency packages:** -FFmpeg (choose a package with win64-gpl-shared in the filename, the latest snapshot build should generally be fine to use) \ +FFmpeg (choose the n4.4 package with win64-gpl-shared in the filename, the snapshot version will not work) \ [https://github.com/BtbN/FFmpeg-Builds/releases](https://github.com/BtbN/FFmpeg-Builds/releases) FreeImage (binary distribution) \ @@ -937,18 +937,18 @@ Copy the files to the `emulationstation-de` build directory. Most of them will c **Required files for MSVC:** ``` -avcodec-59.dll +avcodec-58.dll avcodec.lib avfilter.lib -avfilter-8.dll -avformat-59.dll +avfilter-7.dll +avformat-58.dll avformat.lib -avutil-57.dll +avutil-56.dll avutil.lib -postproc-56.dll -swresample-4.dll +postproc-55.dll +swresample-3.dll swresample.lib -swscale-6.dll +swscale-5.dll swscale.lib FreeImage.dll FreeImage.lib @@ -995,13 +995,13 @@ lib /def:libvlc.def /out:libvlc.lib /machine:x64 **Required files for MinGW:** ``` -avcodec-59.dll -avfilter-8.dll -avformat-59.dll -avutil-57.dll -postproc-56.dll -swresample-4.dll -swscale-6.dll +avcodec-58.dll +avfilter-7.dll +avformat-58.dll +avutil-56.dll +postproc-55.dll +swresample-3.dll +swscale-5.dll FreeImage.dll glew32.dll libcrypto-1_1-x64.dll (from the OpenSSL package, located in Git MinGW/MSYS2 under \mingw64\bin) diff --git a/USERGUIDE-DEV.md b/USERGUIDE-DEV.md index b23a3512a..6430e62c2 100644 --- a/USERGUIDE-DEV.md +++ b/USERGUIDE-DEV.md @@ -1180,6 +1180,10 @@ Enabling this option makes ES-DE continue to run while a game is launched. This There is an issue with launching games on some Windows computers, seemingly on those with AMD and Intel GPUs. The emulator will start and work correctly, but the screen will be blank. Enabling this option is a workaround for that problem, with the drawback that the screen will become white instead of black when the emulator is loading. This option is enabled by default, so experiment with disabling it for a slightly better experience. If you're using an Nvidia GPU, chances are high that it will then work fine. An alternative workaround is to enable the _Run in background (while game is launched)_ option described above, so test which gives the best result. The two options can however not be enabled at the same time. Hopefully this whole game launching issue can be resolved completely in a future ES-DE release. +**FFmpeg/Video hardware decoding (experimental)** _(All platforms except Raspberry Pi)_ + +Enabling this option offloads video decoding to the GPU. Whether this actually increases performance is another matter. As desktop-class CPUs are very capable of decoding the video streams directly, the performance may actually get worse as hardware decoding requires data to be passed back and forth between the CPU and GPU. This potential degradation is especially true for integrated GPUs, and even more so if the GPU is heavily utilized. In addition to this, most GPUs can only decode a subset of video codecs and profiles, meaning ES-DE will anyway have to fallback to software rendering when the GPU is unable to process the stream. With that said, there are still situations where hardware decoding can help, so experiment with the setting to see if it's useful for your configuration. Unfortunately hardware decoding for the FFmpeg video player is not supported on the Raspberry Pi, and it will probably stay this way unless FFmpeg starts to support the MMAL decoder internally. For this device, the VLC-based video player can be used instead, for which hardware decoding is available. + **Upscale video frame rate to 60 FPS (FFmpeg)** With this option enabled, videos with lower frame rates than 60 FPS, such as 24 and 30 will get upscaled to 60 FPS. This results in slightly smoother playback for some videos. There is a small performance hit from this option, so on weaker machines it may be necessary to disable it for fluent video playback. This setting has no effect when using the VLC video player. If the VLC video player is not included in the ES-DE build, the "(FFmpeg)" text is omitted from the setting name. @@ -1622,7 +1626,7 @@ Consider the table below a work in progress as it's obvioulsy not fully populate | apple2gs | Apple IIGS | | | | arcade | Arcade | RetroArch (MAME - Current)* | Single archive file following MAME name standard in root folder | | astrocade | Bally Astrocade | | | -| atari2600 | Atari 2600 | RetroArch (Stella) | Single archive or ROM file in root folder | +| atari2600 | Atari 2600 | RetroArch (Stella on macOS and Windows, Stella 2014 on Unix) | Single archive or ROM file in root folder | | atari5200 | Atari 5200 | | | | atari7800 | Atari 7800 ProSystem | | | | atari800 | Atari 800 | | |