diff --git a/content/docs/user-guide/interactivity/user-interface/load-screens.md b/content/docs/user-guide/interactivity/user-interface/load-screens.md index e0177113fe5..996d11d15d5 100644 --- a/content/docs/user-guide/interactivity/user-interface/load-screens.md +++ b/content/docs/user-guide/interactivity/user-interface/load-screens.md @@ -45,6 +45,17 @@ game_load_screen_bink_path="Videos\GameLoadingScreen.bk2" game_load_screen_minimum_time=5 ``` +## Modifying a Splash Screen (Renderer Loading Screen) on Linux + +A splash screen serves as a loading screen for the renderer. Typically, the renderer takes a few seconds to boot up, during which time even the game's loading screen cannot be displayed. To prevent an awkward black screen during this period, you can use the splash screen settings to display a static PNG image. Please note that transparency will not be respected and should be replaced with black. + +It is required that `xdd` linux utility is installed for this feature to work. + +To set a custom splash screen, place your logo in your project under `Resources/Splash.png`. Alternatively, set the `SPLASH_FILE` environment variable to the path of such a file. The only image requirement is that it must be an 8-Bit PNG. This image will be injected into the O3DE code during compilation, so a rebuild is necessary for the change to take effect. + +For the best results, follow up this splash screen with a UI-based game loading screen, as it loads quickly. If you don't, you may still see a black screen during the period when Atom has started loading, taken control over the display, but has not yet begun to output the rendered scene. + + ## Defining a Level Loading Screen To define a level loading screen, first do one of the following: diff --git a/content/docs/welcome-guide/requirements.md b/content/docs/welcome-guide/requirements.md index e5f9850999d..3e4246d4757 100644 --- a/content/docs/welcome-guide/requirements.md +++ b/content/docs/welcome-guide/requirements.md @@ -218,6 +218,7 @@ O3DE also requires some additional library packages to be installed: * libxcb-xinput-dev * libxcb-xfixes0-dev * libxcb-xkb-dev +* libxcb-image0-dev * libxkbcommon-dev * libxkbcommon-x11-dev * libfontconfig1-dev @@ -231,7 +232,7 @@ O3DE also requires some additional library packages to be installed: You can download and install these packages through `apt`. ```shell -sudo apt install libglu1-mesa-dev libxcb-xinerama0 libxcb-xinput0 libxcb-xinput-dev libxcb-xfixes0-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev libfontconfig1-dev libpcre2-16-0 zlib1g-dev mesa-common-dev libunwind-dev libzstd-dev +sudo apt install libglu1-mesa-dev libxcb-xinerama0 libxcb-xinput0 libxcb-xinput-dev libxcb-xfixes0-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev libfontconfig1-dev libpcre2-16-0 zlib1g-dev mesa-common-dev libunwind-dev libzstd-dev libxcb-image0-dev ``` ### Ninja Build System (Optional)