diff --git a/CHANGELOG.md b/CHANGELOG.md index cf0183d1d..5067811a4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,12 +11,18 @@ * Added translations for Traditional Chinese (zh_TW) * Increased the roundness for all corners in the menu system and for the notification popups * Increased the background blur slightly when a menu is open +* Added an option to completely disable the game launch screen (via the UI settings menu) * Made the menu and launch screen scale up at the same speed regardless of the display refresh rate +* Added a screensaver-game-select custom event +* Added game-select and system-select custom events and a corresponding "Browsing custom events" menu option * Added the NooDS RetroArch core as an alternative emulator for the gba and nds systems * Added the Holani RetroArch core as an alternative emulator for the atarilynx system * (Android) Added Pizza Boy SC standalone as an alternative emulator for the gamegear, genesis, mastersystem, megadrive and megadrivejp systems * (Android) Changed all RetroArch core entries to use absolute paths (this makes the ancient Play store release work correctly) * (Android) Changed the target SDK version to 35 (Android 15) +* (Linux) Added support for the Flatpak release of Ruffle +* (Linux) Changed the AppImage find rule for Mandarine to mandarine-qt*.AppImage +* Added the .ruf file extension to the flash system * Added a "Display clock" setting to the UI settings menu to display an on screen clock (disabled by default) * Refactored the helpsystem code and added support for using an arbitrary amount of helpsystem elements * Added support for specifying which specific entries to display for the helpsystem elements diff --git a/INSTALL-DEV.md b/INSTALL-DEV.md index 9a5f476a8..2f5f8fdec 100644 --- a/INSTALL-DEV.md +++ b/INSTALL-DEV.md @@ -2171,23 +2171,30 @@ On Windows it's also possible to place .lnk shortcut files in the event director There are up to four parameters that will be passed to these scripts, as detailed below: -| Event | Parameters* | Description | -| :----------------------- | :------------------------------------------------- | :-------------------------------------------------------------------------- | -| startup | | Application startup | -| quit | | Application quit/shutdown | -| reboot | | System reboot (quit event triggered as well) | -| poweroff | | System power off (quit event triggered as well) | -| config-changed | | On saving application settings or controller configuration | -| settings-changed | | On saving application settings (config-changed event triggered as well) | -| controls-changed | | On saving controller configuration (config-changed event triggered as well) | -| theme-changed | New theme name, old theme name | When manually changing themes in the UI Settings menu | -| game-start | ROM path, game name, system name, system full name | On game launch | -| game-end | ROM path, game name, system name, system full name | On game end (or on application wakeup if running in the background) | -| screensaver-start | _timer_ or _manual_ | Screensaver started via timer or manually | -| screensaver-end | _cancel_ or _game-jump_ or _game-start_ | Screensaver ended via cancellation, jump to game or start/launch of game | +| Event | Parameters* | Description | +| :----------------------- | :------------------------------------------------- | :------------------------------------------------------------------------------------------------ | +| startup | | Application startup | +| quit | | Application quit/shutdown | +| reboot | | System reboot (quit event triggered as well) | +| poweroff | | System power off (quit event triggered as well) | +| config-changed | | On saving application settings or controller configuration | +| settings-changed | | On saving application settings (config-changed event triggered as well) | +| controls-changed | | On saving controller configuration (config-changed event triggered as well) | +| theme-changed | New theme name, old theme name | When manually changing themes in the UI Settings menu | +| game-start | ROM path, game name, system name, system full name | On game launch | +| game-end | ROM path, game name, system name, system full name | On game end (or on application wakeup if running in the background) | +| screensaver-start | _timer_ or _manual_ | Screensaver started via timer or manually | +| screensaver-end | _cancel_ or _game-jump_ or _game-start_ | Screensaver ended via cancellation, jump to game or start/launch of game | +| screensaver-game-select | ROM path, game name, system name, system full name | Screensaver selected a new random game | +| game-select | ROM path, game name, system name, system full name | On browsing games in the gamelist view, requires enabling of the _Browsing custom events_ setting | +| system-select | System name, system full name, system ROM path | On browsing systems in the system view, requires enabling of the _Browsing custom events_ setting | ***)** Parameters in _italics_ are literal strings. +Note that the _game-select_ and _system-select_ events require that the _Browsing custom events_ option in the Other settings menu is enabled. Also note that enabling this could lead to a lot of latency in the application as the event is triggered so frequently. So only enable these events if you really need them. And if you do, then make sure to execute scripts that run their activities in the background and immediately return to ES-DE, rather than blocking ES-DE during the script execution. + +For the _game-select_ event, when starting to fast scroll in the gamelist view, an event containing blank parameters will be triggered so that you can detect this state. + We'll go through two examples: * Creating a log file that will record the start and end time for each game we play, letting us see how much time we spend on retro-gaming * Changing the system resolution when launching and returning from a game in order to run the emulator at a lower resolution than ES-DE diff --git a/USERGUIDE-DEV.md b/USERGUIDE-DEV.md index 12901d327..df3d07dde 100644 --- a/USERGUIDE-DEV.md +++ b/USERGUIDE-DEV.md @@ -721,7 +721,7 @@ The following emulators are supported in AppImage format when using the bundled | macintosh | SheepShaver | SheepShaver*.AppImage | | n3ds | Citra | citra-qt*.AppImage | | n3ds | Lime3DS | lime3ds.AppImage | -| n3ds | Mandarine | mandarine-qt.AppImage | +| n3ds | Mandarine | mandarine-qt*.AppImage | | n3ds | Panda3DS | Alber-*.AppImage | | n64/n64dd | Rosalie's Mupen GUI | RMG*.AppImage | | nds | melonDS | melonDS*.AppImage | @@ -3321,7 +3321,7 @@ Animation to play when opening the main menu or the gamelist options menu. Also **Launch screen duration** -This configures for how long to display the game launch screen when starting a game. The options are _Normal_, _Brief_, _Long_ and _Disabled_. If set to _Disabled_, a simple notification popup will be displayed instead. +This configures for how long to display the game launch screen when starting a game. The options are _Normal_, _Brief_, _Long_, _Popup_ and _Disabled_. If set to _Popup_, a simple notification popup will be displayed instead of the launch screen and if set to _Disabled_ then game launching will be instantaneous. **UI mode** @@ -3686,6 +3686,10 @@ You can mark games as hidden in the metadata editor, which is useful for instanc It's possible to trigger custom scripts for a number of actions in ES-DE, as is discussed [below](USERGUIDE-DEV.md#custom-event-scripts), and this setting decides whether this functionality is enabled. +**Browsing custom events** + +This option, which depends on _Enable custom event scripts_ being activated, will also generate custom events when navigating the system and gamelist views. Note that this could introduce a lot of latency into the application so only enable it if you absolutely need it. + **Only show games from gamelist.xml files** If enabled, only games that have metadata saved to the gamelist.xml files will be shown in ES-DE. This option is intended primarily for testing and debugging purposes so it should normally not be enabled. When changing this setting ES-DE will automatically reload.