From 2ad5d0fc29dd6b90debf5c9c9968d2ad236504ae Mon Sep 17 00:00:00 2001 From: Maschell Date: Sat, 22 Feb 2025 08:58:45 +0100 Subject: [PATCH 01/10] Bump version --- source/main.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/main.cpp b/source/main.cpp index bf5e13c..64fef0d 100644 --- a/source/main.cpp +++ b/source/main.cpp @@ -4,7 +4,7 @@ #include "utils/utils.h" #include "version.h" -#define MODULE_VERSION "v0.2" +#define MODULE_VERSION "v0.3" #define MODULE_VERSION_FULL MODULE_VERSION SPLASHSCREEN_MODULE_VERSION_EXTRA int32_t main(int32_t argc, char **argv) { From de9aff6d37b1008268ca67b7765f428f273cf40a Mon Sep 17 00:00:00 2001 From: "Daniel K. O." Date: Sat, 22 Feb 2025 05:03:50 -0300 Subject: [PATCH 02/10] Add JPEG support for loading splash screens (#7) * Added support for loading JPEG images. * Sorted headers. * Formatting for clang-format. --------- Co-authored-by: Daniel K. O. (dkosmari) --- Makefile | 2 +- README.md | 20 +++++--- source/gfx/JPEGTexture.cpp | 84 +++++++++++++++++++++++++++++++ source/gfx/JPEGTexture.h | 7 +++ source/gfx/SplashScreenDrawer.cpp | 16 ++++-- 5 files changed, 118 insertions(+), 11 deletions(-) create mode 100644 source/gfx/JPEGTexture.cpp create mode 100644 source/gfx/JPEGTexture.h diff --git a/Makefile b/Makefile index 1b10a26..3a59eae 100644 --- a/Makefile +++ b/Makefile @@ -38,7 +38,7 @@ CXXFLAGS := $(CFLAGS) -std=c++23 -fno-rtti ASFLAGS := -g $(ARCH) LDFLAGS = -g $(ARCH) $(RPXSPECS) --entry=_start -Wl,-Map,$(notdir $*.map) -LIBS := -lpng -lwut -lz +LIBS := -lpng -lturbojpeg -lwut -lz ifeq ($(DEBUG),1) CXXFLAGS += -DDEBUG -g diff --git a/README.md b/README.md index b52e6f5..d2c4f61 100644 --- a/README.md +++ b/README.md @@ -7,10 +7,11 @@ other modules of the environment are loading. Place the `01_splashscreen.rpx` in the `[ENVIRONMENT]/modules/setup` folder and run the EnvironmentLoader. The module will attempt to load the splash image, in this order: 1. `[ENVIRONMENT]/splash.png` - 2. `[ENVIRONMENT]/splash.tga` - 3. A random image from the directory `[ENVIRONMENT]/splashes/`. + 2. `[ENVIRONMENT]/splash.jpg` or `[ENVIRONMENT]/splash.jpeg` + 3. `[ENVIRONMENT]/splash.tga` + 4. A random image (PNG, JPEG or TGA) from the directory `[ENVIRONMENT]/splashes/`. -If no splash screen is found on the sd card, this module will effectively do nothing. +If no splash image is found on the sd card, this module will effectively do nothing. **Notes:** - `[ENVIRONMENT]` is the directory of the environment, for Aroma with would be `sd:/wiiu/enviroments/aroma/splash.png` @@ -22,14 +23,19 @@ If no splash screen is found on the sd card, this module will effectively do not ### Logging Building via `make` only logs errors (via OSReport). To enable logging via the [LoggingModule](https://github.com/wiiu-env/LoggingModule) set `DEBUG` to `1` or `VERBOSE`. -`make` Logs errors only (via OSReport). -`make DEBUG=1` Enables information and error logging via [LoggingModule](https://github.com/wiiu-env/LoggingModule). -`make DEBUG=VERBOSE` Enables verbose information and error logging via [LoggingModule](https://github.com/wiiu-env/LoggingModule). + - `make` Logs errors only (via OSReport). + - `make DEBUG=1` Enables information and error logging via [LoggingModule](https://github.com/wiiu-env/LoggingModule). + - `make DEBUG=VERBOSE` Enables verbose information and error logging via [LoggingModule](https://github.com/wiiu-env/LoggingModule). If the [LoggingModule](https://github.com/wiiu-env/LoggingModule) is not present, it'll fall back to UDP (Port 4405) and [CafeOS](https://github.com/wiiu-env/USBSerialLoggingModule) logging. ## Building -For building, you just need [wut](https://github.com/devkitPro/wut/) installed, then use the `make` command. +For building, you need to install (via devkitPro's `pacman`): + - [wut](https://github.com/devkitPro/wut/) + - ppc-libpng + - ppc-libjpeg-turbo + +Then use the `make` command. ## Building using the Dockerfile diff --git a/source/gfx/JPEGTexture.cpp b/source/gfx/JPEGTexture.cpp new file mode 100644 index 0000000..09ebf32 --- /dev/null +++ b/source/gfx/JPEGTexture.cpp @@ -0,0 +1,84 @@ +#include "JPEGTexture.h" +#include +#include +#include +#include + +GX2Texture *JPEG_LoadTexture(std::span data) { + GX2Texture *texture = nullptr; + + tjhandle handle = tjInitDecompress(); + if (!handle) { + return nullptr; + } + + int height; + int width; + int subsamp; + int colorspace; + if (tjDecompressHeader3(handle, + data.data(), data.size(), + &width, &height, + &subsamp, &colorspace)) { + goto error; + } + + texture = static_cast(std::malloc(sizeof(GX2Texture))); + if (!texture) { + goto error; + } + + std::memset(texture, 0, sizeof(GX2Texture)); + texture->surface.width = width; + texture->surface.height = height; + texture->surface.depth = 1; + texture->surface.mipLevels = 1; + texture->surface.format = GX2_SURFACE_FORMAT_UNORM_R8_G8_B8_A8; + texture->surface.aa = GX2_AA_MODE1X; + texture->surface.use = GX2_SURFACE_USE_TEXTURE; + texture->surface.dim = GX2_SURFACE_DIM_TEXTURE_2D; + texture->surface.tileMode = GX2_TILE_MODE_LINEAR_ALIGNED; + texture->surface.swizzle = 0; + texture->viewFirstMip = 0; + texture->viewNumMips = 1; + texture->viewFirstSlice = 0; + texture->viewNumSlices = 1; + texture->compMap = 0x0010203; + GX2CalcSurfaceSizeAndAlignment(&texture->surface); + GX2InitTextureRegs(texture); + + if (texture->surface.imageSize == 0) { + goto error; + } + + texture->surface.image = std::aligned_alloc(texture->surface.alignment, + texture->surface.imageSize); + if (!texture->surface.image) { + goto error; + } + + if (tjDecompress2(handle, + data.data(), data.size(), + static_cast(texture->surface.image), + width, + texture->surface.pitch * 4, + height, + TJPF_RGBA, + 0)) { + goto error; + } + + tjDestroy(handle); + + GX2Invalidate(GX2_INVALIDATE_MODE_CPU | GX2_INVALIDATE_MODE_TEXTURE, + texture->surface.image, texture->surface.imageSize); + return texture; + +error: + if (texture) { + std::free(texture->surface.image); + } + std::free(texture); + tjDestroy(handle); + return nullptr; +} diff --git a/source/gfx/JPEGTexture.h b/source/gfx/JPEGTexture.h new file mode 100644 index 0000000..d4cb56d --- /dev/null +++ b/source/gfx/JPEGTexture.h @@ -0,0 +1,7 @@ +#pragma once + +#include +#include +#include + +GX2Texture *JPEG_LoadTexture(std::span data); diff --git a/source/gfx/SplashScreenDrawer.cpp b/source/gfx/SplashScreenDrawer.cpp index 0cd1edf..e9f9793 100644 --- a/source/gfx/SplashScreenDrawer.cpp +++ b/source/gfx/SplashScreenDrawer.cpp @@ -1,4 +1,5 @@ #include "SplashScreenDrawer.h" +#include "JPEGTexture.h" #include "PNGTexture.h" #include "ShaderSerializer.h" #include "TGATexture.h" @@ -7,6 +8,7 @@ #include "utils/utils.h" #include #include +#include #include #include #include @@ -131,6 +133,8 @@ static GX2Texture *LoadImageAsTexture(const std::filesystem::path &filename) { auto ext = ToLower(filename.extension()); if (ext == ".png") { return PNG_LoadTexture(buffer); + } else if (ext == ".jpg" || ext == ".jpeg") { + return JPEG_LoadTexture(buffer); } else if (ext == ".tga") { return TGA_LoadTexture(buffer); } @@ -140,6 +144,12 @@ static GX2Texture *LoadImageAsTexture(const std::filesystem::path &filename) { SplashScreenDrawer::SplashScreenDrawer(const std::filesystem::path &splash_base_path) { mTexture = LoadImageAsTexture(splash_base_path / "splash.png"); + if (!mTexture) { + mTexture = LoadImageAsTexture(splash_base_path / "splash.jpg"); + } + if (!mTexture) { + mTexture = LoadImageAsTexture(splash_base_path / "splash.jpeg"); + } if (!mTexture) { mTexture = LoadImageAsTexture(splash_base_path / "splash.tga"); } @@ -152,7 +162,7 @@ SplashScreenDrawer::SplashScreenDrawer(const std::filesystem::path &splash_base_ continue; } auto ext = ToLower(entry.path().extension()); - if (ext == ".png" || ext == ".tga") { + if (ext == ".png" || ext == ".tga" || ext == ".jpg" || ext == ".jpeg") { candidates.push_back(entry.path()); } } @@ -241,10 +251,10 @@ SplashScreenDrawer::~SplashScreenDrawer() { GX2RDestroyBufferEx(&mTexCoordBuffer, GX2R_RESOURCE_BIND_NONE); if (mTexture) { if (mTexture->surface.image != nullptr) { - free(mTexture->surface.image); + std::free(mTexture->surface.image); mTexture->surface.image = nullptr; } - ::free(mTexture); + std::free(mTexture); mTexture = nullptr; } } From 7a3bba219e6fd43a07c7ae00895bcecfa0d818b4 Mon Sep 17 00:00:00 2001 From: "Daniel K. O." Date: Sat, 22 Feb 2025 15:05:02 -0300 Subject: [PATCH 03/10] Improved PNG reading (#8) * Use libpng's "simplified API", to automatically load all types of PNG as RGBA images. * Removed extra blank spaces. --------- Co-authored-by: Daniel K. O. (dkosmari) --- source/gfx/JPEGTexture.cpp | 7 +++ source/gfx/PNGTexture.cpp | 113 +++++++++++++------------------------ 2 files changed, 47 insertions(+), 73 deletions(-) diff --git a/source/gfx/JPEGTexture.cpp b/source/gfx/JPEGTexture.cpp index 09ebf32..5ef5afa 100644 --- a/source/gfx/JPEGTexture.cpp +++ b/source/gfx/JPEGTexture.cpp @@ -1,4 +1,5 @@ #include "JPEGTexture.h" +#include "utils/logger.h" #include #include #include @@ -20,11 +21,13 @@ GX2Texture *JPEG_LoadTexture(std::span data) { data.data(), data.size(), &width, &height, &subsamp, &colorspace)) { + DEBUG_FUNCTION_LINE_ERR("Failed to parse JPEG header\n"); goto error; } texture = static_cast(std::malloc(sizeof(GX2Texture))); if (!texture) { + DEBUG_FUNCTION_LINE_ERR("Failed to allocate texture\n"); goto error; } @@ -48,12 +51,14 @@ GX2Texture *JPEG_LoadTexture(std::span data) { GX2InitTextureRegs(texture); if (texture->surface.imageSize == 0) { + DEBUG_FUNCTION_LINE_ERR("Texture is empty\n"); goto error; } texture->surface.image = std::aligned_alloc(texture->surface.alignment, texture->surface.imageSize); if (!texture->surface.image) { + DEBUG_FUNCTION_LINE_ERR("Failed to allocate surface for texture\n"); goto error; } @@ -65,6 +70,7 @@ GX2Texture *JPEG_LoadTexture(std::span data) { height, TJPF_RGBA, 0)) { + DEBUG_FUNCTION_LINE_ERR("Failed to read JPEG image\n"); goto error; } @@ -72,6 +78,7 @@ GX2Texture *JPEG_LoadTexture(std::span data) { GX2Invalidate(GX2_INVALIDATE_MODE_CPU | GX2_INVALIDATE_MODE_TEXTURE, texture->surface.image, texture->surface.imageSize); + return texture; error: diff --git a/source/gfx/PNGTexture.cpp b/source/gfx/PNGTexture.cpp index f2808ff..f7725d1 100644 --- a/source/gfx/PNGTexture.cpp +++ b/source/gfx/PNGTexture.cpp @@ -1,67 +1,33 @@ #include "PNGTexture.h" +#include "utils/logger.h" +#include #include #include -#include #include -#include - -static void png_read_data(png_structp png_ptr, png_bytep outBytes, png_size_t byteCountToRead) { - void **data = (void **) png_get_io_ptr(png_ptr); - - memcpy(outBytes, *data, byteCountToRead); - *((uint8_t **) data) += byteCountToRead; -} - -void my_png_error_fn(png_structp png_ptr, png_const_charp error_msg) { - DEBUG_FUNCTION_LINE_ERR("libpng error: %s\n", error_msg); - longjmp(png_jmpbuf(png_ptr), 1); -} - -void my_png_warning_fn(png_structp png_ptr, png_const_charp warning_msg) { - DEBUG_FUNCTION_LINE_ERR("libpng warning: %s\n", warning_msg); -} GX2Texture *PNG_LoadTexture(std::span data) { - png_structp png_ptr = png_create_read_struct(PNG_LIBPNG_VER_STRING, nullptr, nullptr, nullptr); - if (png_ptr == nullptr) { - return nullptr; - } + GX2Texture *texture = nullptr; - png_infop info_ptr = png_create_info_struct(png_ptr); - if (info_ptr == nullptr) { - png_destroy_read_struct(&png_ptr, nullptr, nullptr); - return nullptr; - } + png_image image{}; + image.version = PNG_IMAGE_VERSION; - png_set_error_fn(png_ptr, nullptr, my_png_error_fn, my_png_warning_fn); - // Error handling using setjmp/longjmp - if (setjmp(png_jmpbuf(png_ptr))) { - DEBUG_FUNCTION_LINE_ERR("An error occurred while processing the PNG file\n"); - png_destroy_read_struct(&png_ptr, &info_ptr, nullptr); - return nullptr; + if (!png_image_begin_read_from_memory(&image, data.data(), data.size())) { + DEBUG_FUNCTION_LINE_ERR("Failed to parse PNG header: %s\n", image.message); + goto error; } - png_set_read_fn(png_ptr, (void *) &data, png_read_data); - - png_read_info(png_ptr, info_ptr); + // Request the output to always be RGBA + image.format = PNG_FORMAT_RGBA; - uint32_t width = 0; - uint32_t height = 0; - int bitDepth = 0; - int colorType = -1; - uint32_t retval = png_get_IHDR(png_ptr, info_ptr, &width, &height, &bitDepth, &colorType, nullptr, nullptr, nullptr); - if (retval != 1) { - return nullptr; + texture = static_cast(std::malloc(sizeof(GX2Texture))); + if (!texture) { + DEBUG_FUNCTION_LINE_ERR("Failed to allocate texture\n"); + goto error; } - uint32_t bytesPerRow = png_get_rowbytes(png_ptr, info_ptr); - auto *rowData = new uint8_t[bytesPerRow]; - - auto *texture = (GX2Texture *) malloc(sizeof(GX2Texture)); - *texture = {}; - - texture->surface.width = width; - texture->surface.height = height; + std::memset(texture, 0, sizeof(GX2Texture)); + texture->surface.width = image.width; + texture->surface.height = image.height; texture->surface.depth = 1; texture->surface.mipLevels = 1; texture->surface.format = GX2_SURFACE_FORMAT_UNORM_R8_G8_B8_A8; @@ -79,34 +45,35 @@ GX2Texture *PNG_LoadTexture(std::span data) { GX2InitTextureRegs(texture); if (texture->surface.imageSize == 0) { - return nullptr; + DEBUG_FUNCTION_LINE_ERR("Texture is empty\n"); + goto error; } - texture->surface.image = memalign(texture->surface.alignment, texture->surface.imageSize); + texture->surface.image = std::aligned_alloc(texture->surface.alignment, + texture->surface.imageSize); if (!texture->surface.image) { - return nullptr; + DEBUG_FUNCTION_LINE_ERR("Failed to allocate surface for texture\n"); + goto error; } - for (uint32_t y = 0; y < height; y++) { - uint32_t *out_data = (uint32_t *) texture->surface.image + (y * texture->surface.pitch); - png_read_row(png_ptr, (png_bytep) rowData, nullptr); - for (uint32_t x = 0; x < width; x++) { - if (colorType == PNG_COLOR_TYPE_RGB_ALPHA) { - uint32_t i = (x) *4; - *out_data = rowData[i] << 24 | rowData[i + 1] << 16 | rowData[i + 2] << 8 | rowData[i + 3]; - } else if (colorType == PNG_COLOR_TYPE_RGB) { - uint32_t i = (x) *3; - *out_data = rowData[i] << 24 | rowData[i + 1] << 16 | rowData[i + 2] << 8 | 0xFF; - } - out_data++; - } + if (!png_image_finish_read(&image, nullptr, + texture->surface.image, + texture->surface.pitch * 4, + nullptr)) { + DEBUG_FUNCTION_LINE_ERR("Failed to read PNG image: %s\n", image.message); + goto error; } - delete[] rowData; - png_destroy_read_struct(&png_ptr, &info_ptr, nullptr); - - // todo: create texture with optimal tile format and use GX2CopySurface to convert from linear to tiled format - GX2Invalidate(GX2_INVALIDATE_MODE_CPU | GX2_INVALIDATE_MODE_TEXTURE, texture->surface.image, texture->surface.imageSize); + GX2Invalidate(GX2_INVALIDATE_MODE_CPU | GX2_INVALIDATE_MODE_TEXTURE, + texture->surface.image, texture->surface.imageSize); return texture; -} \ No newline at end of file + +error: + if (texture) { + std::free(texture->surface.image); + } + std::free(texture); + png_image_free(&image); + return nullptr; +} From ade02997d47ee1bccb5301839ddff04f2708927a Mon Sep 17 00:00:00 2001 From: "Daniel K. O. (dkosmari)" Date: Sat, 20 Dec 2025 20:20:44 -0300 Subject: [PATCH 04/10] Fixed format string. --- source/gfx/gfx.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/gfx/gfx.c b/source/gfx/gfx.c index 5bc9078..df33e02 100644 --- a/source/gfx/gfx.c +++ b/source/gfx/gfx.c @@ -200,7 +200,7 @@ static BOOL initBucketHeap() { sGfxHeapForeground = MEMCreateExpHeapEx(base, size, 0); if (!sGfxHeapForeground) { - WHBLogPrintf("%s: MEMCreateExpHeapEx(0x%08X, 0x%X, 0)", __FUNCTION__, base, size); + WHBLogPrintf("%s: MEMCreateExpHeapEx(%p, 0x%X, 0)", __FUNCTION__, base, size); return FALSE; } @@ -476,4 +476,4 @@ BOOL GfxInitShaderAttribute(WHBGfxShaderGroup *group, attrib->mask = GfxGetAttribFormatSel(format); attrib->endianSwap = GX2_ENDIAN_SWAP_DEFAULT; return TRUE; -} \ No newline at end of file +} From 8f6e0ce46d1bad1440c4ec0bf81e5ea08c6f338f Mon Sep 17 00:00:00 2001 From: "Daniel K. O. (dkosmari)" Date: Sat, 20 Dec 2025 20:52:50 -0300 Subject: [PATCH 05/10] Try sd:/wiiu as a fallback path for loading splashes. --- source/gfx/SplashScreenDrawer.cpp | 54 ++++++++++++++++++------------- source/gfx/SplashScreenDrawer.h | 6 +++- source/main.cpp | 25 +++++++++++--- 3 files changed, 57 insertions(+), 28 deletions(-) diff --git a/source/gfx/SplashScreenDrawer.cpp b/source/gfx/SplashScreenDrawer.cpp index e9f9793..646fc98 100644 --- a/source/gfx/SplashScreenDrawer.cpp +++ b/source/gfx/SplashScreenDrawer.cpp @@ -142,7 +142,15 @@ static GX2Texture *LoadImageAsTexture(const std::filesystem::path &filename) { return nullptr; } +SplashScreenDrawer::SplashScreenDrawer() +{ + mTexture = PNG_LoadTexture(empty_png); + InitResources(); +} + SplashScreenDrawer::SplashScreenDrawer(const std::filesystem::path &splash_base_path) { + if (splash_base_path.empty()) + throw std::runtime_error{"empty base dir"}; mTexture = LoadImageAsTexture(splash_base_path / "splash.png"); if (!mTexture) { mTexture = LoadImageAsTexture(splash_base_path / "splash.jpg"); @@ -155,35 +163,35 @@ SplashScreenDrawer::SplashScreenDrawer(const std::filesystem::path &splash_base_ } if (!mTexture) { // try to load a random one from "splashes/*" - try { - std::vector candidates; - for (const auto &entry : std::filesystem::directory_iterator{splash_base_path / "splashes"}) { - if (!entry.is_regular_file()) { - continue; - } - auto ext = ToLower(entry.path().extension()); - if (ext == ".png" || ext == ".tga" || ext == ".jpg" || ext == ".jpeg") { - candidates.push_back(entry.path()); - } + std::vector candidates; + for (const auto &entry : std::filesystem::directory_iterator{splash_base_path / "splashes"}) { + if (!entry.is_regular_file()) { + continue; } - if (!candidates.empty()) { - auto t = static_cast(OSGetTime()); - std::seed_seq seed{static_cast(t), - static_cast(t >> 32)}; - std::minstd_rand eng{seed}; - std::uniform_int_distribution dist{0, candidates.size() - 1}; - auto selected = dist(eng); - mTexture = LoadImageAsTexture(candidates[selected]); + auto ext = ToLower(entry.path().extension()); + if (ext == ".png" || ext == ".tga" || ext == ".jpg" || ext == ".jpeg") { + candidates.push_back(entry.path()); } - } catch (std::exception &) {} - } - if (!mTexture) { - mTexture = PNG_LoadTexture(empty_png); + } + if (!candidates.empty()) { + auto t = static_cast(OSGetTime()); + std::seed_seq seed{static_cast(t), + static_cast(t >> 32)}; + std::minstd_rand eng{seed}; + std::uniform_int_distribution dist{0, candidates.size() - 1}; + auto selected = dist(eng); + mTexture = LoadImageAsTexture(candidates[selected]); + } } + if (!mTexture) { - return; + throw std::runtime_error{"failed to load texture"}; } + InitResources(); +} + +void SplashScreenDrawer::InitResources() { // create shader group mVertexShaderWrapper = DeserializeVertexShader(s_textureVertexShaderCompiled); mPixelShaderWrapper = DeserializePixelShader(s_texturePixelShaderCompiled); diff --git a/source/gfx/SplashScreenDrawer.h b/source/gfx/SplashScreenDrawer.h index 2576fa3..2375714 100644 --- a/source/gfx/SplashScreenDrawer.h +++ b/source/gfx/SplashScreenDrawer.h @@ -11,7 +11,9 @@ class SplashScreenDrawer { public: - explicit SplashScreenDrawer(const std::filesystem::path &meta_dir); + + SplashScreenDrawer(); + explicit SplashScreenDrawer(const std::filesystem::path &baseDir); void Draw(); @@ -47,4 +49,6 @@ class SplashScreenDrawer { GX2RBuffer mTexCoordBuffer = {}; GX2Texture *mTexture = nullptr; GX2Sampler mSampler = {}; + + void InitResources(); }; diff --git a/source/main.cpp b/source/main.cpp index 64fef0d..7e2db8b 100644 --- a/source/main.cpp +++ b/source/main.cpp @@ -1,5 +1,7 @@ +#include #include "gfx/SplashScreenDrawer.h" #include "gfx/gfx.h" +#include #include "utils/logger.h" #include "utils/utils.h" #include "version.h" @@ -11,15 +13,30 @@ int32_t main(int32_t argc, char **argv) { initLogging(); DEBUG_FUNCTION_LINE_INFO("Running SplashScreen Module " MODULE_VERSION_FULL ""); - std::filesystem::path basePath = "fs:/vol/external01/wiiu"; + using std::filesystem::path; + path envDir; if (argc >= 1) { - basePath = argv[0]; + envDir = argv[0]; } GfxInit(); { - SplashScreenDrawer splashScreenDrawer(basePath); - splashScreenDrawer.Draw(); + std::optional splashScreenDrawer; + for (const auto& dir : {envDir, path{"fs:/vol/external01/wiiu"}}) { + try { + splashScreenDrawer.emplace(dir); + break; + } + catch (std::exception &e) { + DEBUG_FUNCTION_LINE_INFO("Failed to use %s: %s", dir.c_str(), e.what()); + } + } + // Fallback: use built-in empty splash. + if (!splashScreenDrawer) { + splashScreenDrawer.emplace(); + } + splashScreenDrawer->Draw(); + } GfxShutdown(); From 9c114b88fd91f4a4b3b611d538cc5eff5df154b6 Mon Sep 17 00:00:00 2001 From: "Daniel K. O. (dkosmari)" Date: Sat, 20 Dec 2025 21:13:49 -0300 Subject: [PATCH 06/10] Updated README. --- README.md | 25 ++++++++++++++++--------- 1 file changed, 16 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index d2c4f61..857f56b 100644 --- a/README.md +++ b/README.md @@ -5,18 +5,25 @@ other modules of the environment are loading. ## Usage Place the `01_splashscreen.rpx` in the `[ENVIRONMENT]/modules/setup` folder and run the -EnvironmentLoader. The module will attempt to load the splash image, in this order: - 1. `[ENVIRONMENT]/splash.png` - 2. `[ENVIRONMENT]/splash.jpg` or `[ENVIRONMENT]/splash.jpeg` - 3. `[ENVIRONMENT]/splash.tga` - 4. A random image (PNG, JPEG or TGA) from the directory `[ENVIRONMENT]/splashes/`. +EnvironmentLoader. -If no splash image is found on the sd card, this module will effectively do nothing. +Place your splash images in the folder `SD:/wiiu/splashes/`. One of them will be randomly +loaded during boot. **Notes:** - - `[ENVIRONMENT]` is the directory of the environment, for Aroma with would be `sd:/wiiu/enviroments/aroma/splash.png` - - When using a `tga` make sure its 24 bit and uncompressed - - In theory any (reasonable) resolution is supported, something like 1280x720 is recommended + - `[ENVIRONMENT]` is the directory of the environment, for Aroma with would be `SD:/wiiu/enviroments/aroma`. + - When using a `tga` image, make sure its 24 bit and uncompressed, + - In theory any (reasonable) resolution is supported, something like 1280x720 is recommended. + +## Path priority +The module will attempt to load a splash image from multiple places, in this order: + 1. `[ENVIRONMENT]/splash.{png,jpg,jpeg,tga}` + 2. `[ENVIRONMENT]/splashes/*.{png,jpg,jpeg,tga}` + 3. `SD:/wiiu/splash.{png,jpg,jpeg,tga}` + 4. `SD:/wiiu/splashes/*.{png,jpg,jpeg,tga}` + +You should use the last path (`SD:/wiiu/splashes/`), and leave the others for when you +want to override the splash. ## Buildflags From 2af9ab1b785101ba1f545e79edeb6891c2c06c5f Mon Sep 17 00:00:00 2001 From: "Daniel K. O. (dkosmari)" Date: Sat, 20 Dec 2025 21:14:50 -0300 Subject: [PATCH 07/10] Better formatting. --- README.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 857f56b..116055e 100644 --- a/README.md +++ b/README.md @@ -4,11 +4,10 @@ This module is supposed to be loaded with the [EnvironmentLoader](https://github other modules of the environment are loading. ## Usage -Place the `01_splashscreen.rpx` in the `[ENVIRONMENT]/modules/setup` folder and run the -EnvironmentLoader. - -Place your splash images in the folder `SD:/wiiu/splashes/`. One of them will be randomly -loaded during boot. + 1. Place the `01_splashscreen.rpx` in the `[ENVIRONMENT]/modules/setup` folder and run + the EnvironmentLoader. + 2. Place your splash images in the folder `SD:/wiiu/splashes/`. One of them will be randomly + loaded during boot. **Notes:** - `[ENVIRONMENT]` is the directory of the environment, for Aroma with would be `SD:/wiiu/enviroments/aroma`. From 3260e255ed9775885c7907edeb8247274cc040b1 Mon Sep 17 00:00:00 2001 From: "Daniel K. O. (dkosmari)" Date: Sat, 20 Dec 2025 21:17:02 -0300 Subject: [PATCH 08/10] Simpler wording. --- README.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 116055e..a51e717 100644 --- a/README.md +++ b/README.md @@ -4,22 +4,20 @@ This module is supposed to be loaded with the [EnvironmentLoader](https://github other modules of the environment are loading. ## Usage - 1. Place the `01_splashscreen.rpx` in the `[ENVIRONMENT]/modules/setup` folder and run - the EnvironmentLoader. - 2. Place your splash images in the folder `SD:/wiiu/splashes/`. One of them will be randomly - loaded during boot. + 1. Place the `01_splashscreen.rpx` in the `[ENVIRONMENT]/modules/setup` folder. + 2. Place your splash images (PNG, TGA, JPEG)) in the folder `SD:/wiiu/splashes/`. **Notes:** - `[ENVIRONMENT]` is the directory of the environment, for Aroma with would be `SD:/wiiu/enviroments/aroma`. - - When using a `tga` image, make sure its 24 bit and uncompressed, + - When using a TGA image, make sure its 24 bit and uncompressed, - In theory any (reasonable) resolution is supported, something like 1280x720 is recommended. ## Path priority The module will attempt to load a splash image from multiple places, in this order: 1. `[ENVIRONMENT]/splash.{png,jpg,jpeg,tga}` - 2. `[ENVIRONMENT]/splashes/*.{png,jpg,jpeg,tga}` + 2. `[ENVIRONMENT]/splashes/*.{png,jpg,jpeg,tga}` (selected randomly) 3. `SD:/wiiu/splash.{png,jpg,jpeg,tga}` - 4. `SD:/wiiu/splashes/*.{png,jpg,jpeg,tga}` + 4. `SD:/wiiu/splashes/*.{png,jpg,jpeg,tga}` (selected randomly) You should use the last path (`SD:/wiiu/splashes/`), and leave the others for when you want to override the splash. From 92f5902fba0657bdaf1411afa6d8e49f7d71c553 Mon Sep 17 00:00:00 2001 From: "Daniel K. O. (dkosmari)" Date: Sat, 20 Dec 2025 21:17:42 -0300 Subject: [PATCH 09/10] Fixed typo. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a51e717..c2a631f 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ other modules of the environment are loading. ## Usage 1. Place the `01_splashscreen.rpx` in the `[ENVIRONMENT]/modules/setup` folder. - 2. Place your splash images (PNG, TGA, JPEG)) in the folder `SD:/wiiu/splashes/`. + 2. Place your splash images (PNG, TGA or JPEG) in the folder `SD:/wiiu/splashes/`. **Notes:** - `[ENVIRONMENT]` is the directory of the environment, for Aroma with would be `SD:/wiiu/enviroments/aroma`. From 0a219d52b0bd97a3bbd56f0ae4228e42e76f361f Mon Sep 17 00:00:00 2001 From: "Daniel K. O. (dkosmari)" Date: Sat, 20 Dec 2025 21:22:44 -0300 Subject: [PATCH 10/10] Formatting code. --- source/gfx/SplashScreenDrawer.cpp | 3 +-- source/gfx/SplashScreenDrawer.h | 1 - source/main.cpp | 10 ++++------ 3 files changed, 5 insertions(+), 9 deletions(-) diff --git a/source/gfx/SplashScreenDrawer.cpp b/source/gfx/SplashScreenDrawer.cpp index 646fc98..a87ae13 100644 --- a/source/gfx/SplashScreenDrawer.cpp +++ b/source/gfx/SplashScreenDrawer.cpp @@ -142,8 +142,7 @@ static GX2Texture *LoadImageAsTexture(const std::filesystem::path &filename) { return nullptr; } -SplashScreenDrawer::SplashScreenDrawer() -{ +SplashScreenDrawer::SplashScreenDrawer() { mTexture = PNG_LoadTexture(empty_png); InitResources(); } diff --git a/source/gfx/SplashScreenDrawer.h b/source/gfx/SplashScreenDrawer.h index 2375714..c4f7291 100644 --- a/source/gfx/SplashScreenDrawer.h +++ b/source/gfx/SplashScreenDrawer.h @@ -11,7 +11,6 @@ class SplashScreenDrawer { public: - SplashScreenDrawer(); explicit SplashScreenDrawer(const std::filesystem::path &baseDir); diff --git a/source/main.cpp b/source/main.cpp index 7e2db8b..e300f07 100644 --- a/source/main.cpp +++ b/source/main.cpp @@ -1,10 +1,10 @@ -#include #include "gfx/SplashScreenDrawer.h" #include "gfx/gfx.h" -#include #include "utils/logger.h" #include "utils/utils.h" #include "version.h" +#include +#include #define MODULE_VERSION "v0.3" #define MODULE_VERSION_FULL MODULE_VERSION SPLASHSCREEN_MODULE_VERSION_EXTRA @@ -22,12 +22,11 @@ int32_t main(int32_t argc, char **argv) { GfxInit(); { std::optional splashScreenDrawer; - for (const auto& dir : {envDir, path{"fs:/vol/external01/wiiu"}}) { + for (const auto &dir : {envDir, path{"fs:/vol/external01/wiiu"}}) { try { splashScreenDrawer.emplace(dir); break; - } - catch (std::exception &e) { + } catch (std::exception &e) { DEBUG_FUNCTION_LINE_INFO("Failed to use %s: %s", dir.c_str(), e.what()); } } @@ -36,7 +35,6 @@ int32_t main(int32_t argc, char **argv) { splashScreenDrawer.emplace(); } splashScreenDrawer->Draw(); - } GfxShutdown();