Add small_vector to CopyMSAA with reserve image on upload path

[TEST] Unify another section of the blits on MSAA path
color write meows
2026-09-11 14:24:20 +00:00 · 2026-08-22 23:18:10 -04:00 · 2026-08-22 23:13:20 -04:00 · 2026-08-22 21:55:02 -04:00 · 2026-08-22 21:41:04 -04:00 · 2026-08-22 21:40:47 -04:00
695 changed files with 24686 additions and 34071 deletions
@@ -63,6 +63,3 @@ artifacts
 /install*
 vulkansdk*.exe
 *.tar.zst
-
-# Build-time generated external sources
-externals/generated
@@ -1,11 +0,0 @@
--- a/source/effect_lexer.cpp
-+++ b/source/effect_lexer.cpp
-@@ -1181,7 +1181,7 @@
- 	}
- 	else
- 	{
-#if 0
-+#if !defined(__cpp_lib_to_chars)
- 		exponent += decimal_location - mantissa_size;
- 
- 		const bool exponent_negative = exponent < 0;
@@ -0,0 +1,26 @@
+From b3622608433c183ba868a1dc8dd9cf285eb3b916 Mon Sep 17 00:00:00 2001
+From: Dario Petrillo <dario.pk1@gmail.com>
+Date: Thu, 27 Nov 2025 23:12:38 +0100
+Subject: [PATCH] avoid extra memset when clearing an empty table
+
+---
+ include/ankerl/unordered_dense.h | 6 ++++--
+ 1 file changed, 4 insertions(+), 2 deletions(-)
+
+diff --git a/include/ankerl/unordered_dense.h b/include/ankerl/unordered_dense.h
+index 0835342..4938212 100644
+--- a/include/ankerl/unordered_dense.h
+++ b/include/ankerl/unordered_dense.h
+@@ -1490,8 +1490,10 @@ class table : public std::conditional_t<is_map_v<T>, base_table_type_map<T>, bas
+     // modifiers //////////////////////////////////////////////////////////////
+ 
+     void clear() {
+-        m_values.clear();
+-        clear_buckets();
+        if (!empty()) {
+            m_values.clear();
+            clear_buckets();
+        }
+     }
+ 
+     auto insert(value_type const& value) -> std::pair<iterator, bool> {
@@ -1,112 +0,0 @@
-diff --git a/include/vk_mem_alloc.h b/include/vk_mem_alloc.h
-index 8df0364..4856064 100644
--- a/include/vk_mem_alloc.h
-+++ b/include/vk_mem_alloc.h
-@@ -3017,7 +3017,7 @@ remove them if not needed.
- 
- #if defined(__ANDROID_API__) && (__ANDROID_API__ < 16)
- #include <cstdlib>
-static void* vma_aligned_alloc(size_t alignment, size_t size)
-+static inline void* vma_aligned_alloc(size_t alignment, size_t size)
- {
-     // alignment must be >= sizeof(void*)
-     if(alignment < sizeof(void*))
-@@ -3860,7 +3860,7 @@ Returned value is the found element, if present in the collection or place where
- new element with value (key) should be inserted.
- */
- template <typename CmpLess, typename IterT, typename KeyT>
-static IterT VmaBinaryFindFirstNotLess(IterT beg, IterT end, const KeyT& key, const CmpLess& cmp)
-+static inline IterT VmaBinaryFindFirstNotLess(IterT beg, IterT end, const KeyT& key, const CmpLess& cmp)
- {
-     size_t down = 0;
-     size_t up = size_t(end - beg);
-@@ -3898,7 +3898,7 @@ Warning! O(n^2) complexity. Use only inside VMA_HEAVY_ASSERT.
- T must be pointer type, e.g. VmaAllocation, VmaPool.
- */
- template<typename T>
-static bool VmaValidatePointerArray(uint32_t count, const T* arr)
-+static inline bool VmaValidatePointerArray(uint32_t count, const T* arr)
- {
-     for (uint32_t i = 0; i < count; ++i)
-     {
-@@ -4188,13 +4188,13 @@ static void VmaFree(const VkAllocationCallbacks* pAllocationCallbacks, void* ptr
- }
- 
- template<typename T>
-static T* VmaAllocate(const VkAllocationCallbacks* pAllocationCallbacks)
-+static inline T* VmaAllocate(const VkAllocationCallbacks* pAllocationCallbacks)
- {
-     return (T*)VmaMalloc(pAllocationCallbacks, sizeof(T), VMA_ALIGN_OF(T));
- }
- 
- template<typename T>
-static T* VmaAllocateArray(const VkAllocationCallbacks* pAllocationCallbacks, size_t count)
-+static inline T* VmaAllocateArray(const VkAllocationCallbacks* pAllocationCallbacks, size_t count)
- {
-     return (T*)VmaMalloc(pAllocationCallbacks, sizeof(T) * count, VMA_ALIGN_OF(T));
- }
-@@ -4204,14 +4204,14 @@ static T* VmaAllocateArray(const VkAllocationCallbacks* pAllocationCallbacks, si
- #define vma_new_array(allocator, type, count)   new(VmaAllocateArray<type>((allocator), (count)))(type)
- 
- template<typename T>
-static void vma_delete(const VkAllocationCallbacks* pAllocationCallbacks, T* ptr)
-+static inline void vma_delete(const VkAllocationCallbacks* pAllocationCallbacks, T* ptr)
- {
-     ptr->~T();
-     VmaFree(pAllocationCallbacks, ptr);
- }
- 
- template<typename T>
-static void vma_delete_array(const VkAllocationCallbacks* pAllocationCallbacks, T* ptr, size_t count)
-+static inline void vma_delete_array(const VkAllocationCallbacks* pAllocationCallbacks, T* ptr, size_t count)
- {
-     if (ptr != VMA_NULL)
-     {
-@@ -4658,13 +4658,13 @@ void VmaVector<T, AllocatorT>::remove(size_t index)
- #endif // _VMA_VECTOR_FUNCTIONS
- 
- template<typename T, typename allocatorT>
-static void VmaVectorInsert(VmaVector<T, allocatorT>& vec, size_t index, const T& item)
-+static inline void VmaVectorInsert(VmaVector<T, allocatorT>& vec, size_t index, const T& item)
- {
-     vec.insert(index, item);
- }
- 
- template<typename T, typename allocatorT>
-static void VmaVectorRemove(VmaVector<T, allocatorT>& vec, size_t index)
-+static inline void VmaVectorRemove(VmaVector<T, allocatorT>& vec, size_t index)
- {
-     vec.remove(index);
- }
-@@ -10620,19 +10620,19 @@ static void VmaFree(VmaAllocator hAllocator, void* ptr)
- }
- 
- template<typename T>
-static T* VmaAllocate(VmaAllocator hAllocator)
-+static inline T* VmaAllocate(VmaAllocator hAllocator)
- {
-     return (T*)VmaMalloc(hAllocator, sizeof(T), VMA_ALIGN_OF(T));
- }
- 
- template<typename T>
-static T* VmaAllocateArray(VmaAllocator hAllocator, size_t count)
-+static inline T* VmaAllocateArray(VmaAllocator hAllocator, size_t count)
- {
-     return (T*)VmaMalloc(hAllocator, sizeof(T) * count, VMA_ALIGN_OF(T));
- }
- 
- template<typename T>
-static void vma_delete(VmaAllocator hAllocator, T* ptr)
-+static inline void vma_delete(VmaAllocator hAllocator, T* ptr)
- {
-     if(ptr != VMA_NULL)
-     {
-@@ -10642,7 +10642,7 @@ static void vma_delete(VmaAllocator hAllocator, T* ptr)
- }
- 
- template<typename T>
-static void vma_delete_array(VmaAllocator hAllocator, T* ptr, size_t count)
-+static inline void vma_delete_array(VmaAllocator hAllocator, T* ptr, size_t count)
- {
-     if(ptr != VMA_NULL)
-     {
@@ -3,7 +3,6 @@

 cmake_minimum_required(VERSION 3.31)

-set(CMAKE_OSX_DEPLOYMENT_TARGET "15.0" CACHE STRING "macOS deployment target")
 project(yuzu)

 list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/CMakeModules")
@@ -85,8 +84,6 @@ option(ENABLE_WERROR "Enable -Werror diagnostics" ON)
 # Lossless Scaling frame generation. Only Android.
 cmake_dependent_option(ENABLE_LSFG "Enable Lossless Scaling frame generation" ON "ANDROID" OFF)

-option(ENABLE_RESHADE "Enable ReShade FX post-processing effects" ON)
-
 # non-linux bundled qt are static
 if (YUZU_USE_BUNDLED_QT AND (APPLE OR NOT UNIX))
    set(YUZU_STATIC_BUILD ON)
@@ -175,6 +172,8 @@ if (CXX_CLANG_CL)
        $<$<COMPILE_LANGUAGE:C,CXX>:-Wno-c++98-compat-pedantic>
        $<$<COMPILE_LANGUAGE:C,CXX>:-Wno-c++98-compat>
        $<$<COMPILE_LANGUAGE:C,CXX>:-Wno-c99-compat>
+        $<$<COMPILE_LANGUAGE:C,CXX>:-Wno-c98-compat>
+        $<$<COMPILE_LANGUAGE:C,CXX>:-Wno-c99-extensions>
        $<$<COMPILE_LANGUAGE:C,CXX>:/EHsc>)
    # REQUIRED CPU features IN Windows-amd64
    if (ARCHITECTURE_x86_64)
@@ -217,6 +216,8 @@ if(MSVC)
 endif()

 # TODO(crueter): Cleanup, each dep that has a bundled option should allow to choose between bundled, external, system
+cmake_dependent_option(YUZU_USE_BUNDLED_SDL3 "Download bundled SDL3 build" "${MSVC}" "NOT ANDROID" OFF)
+
 option(ENABLE_CUBEB "Enables the cubeb audio backend" ON)

 set(EXT_DEFAULT OFF)
@@ -224,8 +225,6 @@ if (MSVC OR ANDROID)
    set(EXT_DEFAULT ON)
 endif()

-option(YUZU_USE_BUNDLED_SDL3 "Download bundled SDL3 build" ${EXT_DEFAULT})
-
 # ffmpeg
 option(YUZU_USE_BUNDLED_FFMPEG "Download bundled FFmpeg" ${EXT_DEFAULT})
 cmake_dependent_option(YUZU_USE_EXTERNAL_FFMPEG "Build FFmpeg from external source" "${SOLARIS}" "NOT WIN32 AND NOT ANDROID" OFF)
@@ -241,7 +240,7 @@ option(YUZU_USE_BUNDLED_SIRIT "Download bundled sirit" ${BUNDLED_SIRIT_DEFAULT})
 # FreeBSD 15+ has libusb, versions below should disable it
 cmake_dependent_option(ENABLE_LIBUSB "Enable the use of LibUSB" ON "WIN32 OR LINUX OR FREEBSD OR APPLE" OFF)

-cmake_dependent_option(ENABLE_OPENGL "Enable OpenGL" ON "NOT (WIN32 AND ARCHITECTURE_arm64) AND NOT APPLE AND NOT ANDROID" OFF)
+cmake_dependent_option(ENABLE_OPENGL "Enable OpenGL" ON "NOT (WIN32 AND ARCHITECTURE_arm64) AND NOT APPLE" OFF)
 mark_as_advanced(FORCE ENABLE_OPENGL)

 option(ENABLE_WEB_SERVICE "Enable web services (telemetry, etc.)" ON)
@@ -515,7 +514,7 @@ endfunction()
 # =============================================

 if (APPLE)
-    foreach(fw Carbon Metal Cocoa IOKit CoreVideo CoreMedia Security UniformTypeIdentifiers Foundation)
+    foreach(fw Carbon Metal Cocoa IOKit CoreVideo CoreMedia Security UniformTypeIdentifiers)
        find_library(${fw}_LIBRARY ${fw} REQUIRED)
        list(APPEND PLATFORM_LIBRARIES ${${fw}_LIBRARY})
    endforeach()
@@ -543,6 +542,7 @@ add_subdirectory(externals)
 # pass targets from externals
 # TODO(crueter): CPMUtil Propagate func?
 find_package(enet)
+find_package(unordered_dense REQUIRED)

 if (ARCHITECTURE_x86 OR ARCHITECTURE_x86_64)
    find_package(xbyak)
@@ -552,6 +552,7 @@ macro(parse_object object)
    get_json_element("${object}" repo repo)
    get_json_element("${object}" ci ci OFF)
    get_json_element("${object}" version version)
+    get_json_element("${object}" min_version min_version)
    get_json_element("${object}" git_host git_host "github.com")

    if (NOT version)
@@ -570,8 +571,8 @@ macro(parse_object object)
            set(disabled_platforms "")
        endif()
    else()
+        # TODO: correct hash if missing
        get_json_element("${object}" hash hash)
-        get_json_element("${object}" min_version min_version)
        get_json_element("${object}" url url)
        get_json_element("${object}" artifact artifact)
        get_json_element("${object}" source_subdir source_subdir)
@@ -944,8 +945,8 @@ function(AddCIPackage)
        REPO
        PACKAGE
        EXTENSION
-        GIT_HOST
-        PKGNAME)
+        MIN_VERSION
+        GIT_HOST)

    set(multiValueArgs DISABLED_PLATFORMS)

@@ -995,104 +996,9 @@ function(AddCIPackage)
    set(ARTIFACT_REPO ${PKG_ARGS_REPO})
    set(ARTIFACT_PACKAGE ${PKG_ARGS_PACKAGE})

-    # plat/archname
-    if (DEFINED PKG_ARGS_PKGNAME)
-        set(pkgname ${PKG_ARGS_PKGNAME})
-    else()
-        if (MSVC)
-            set(platname windows)
-        elseif(MINGW)
-            set(platname mingw)
-        elseif(ANDROID)
-            set(platname android)
-        elseif(LINUX)
-            set(platname linux)
-        elseif(IOS)
-            set(platname ios)
-        elseif(APPLE)
-            set(platname macos)
-        else()
-            cpm_utils_message(WARNING
-                "Unsupported platform ${CMAKE_SYSTEM_NAME} for CI packages")
-        endif()
+    # TODO: Use amd64/aarch64 naming for everything.
+    # Also drop macos universal

-        if (CPMUTIL_AMD64)
-            set(archname amd64)
-        elseif(CPMUTIL_ARM64)
-            set(archname aarch64)
-        elseif(CPMUTIL_RISCV64)
-            set(archname riscv64)
-        endif()
-
-        if (APPLE AND NOT CPMUTIL_ARM64)
-            cpm_utils_message(WARNING
-                "Unsupported platform/arch combo for CI packages")
-        endif()
-
-        if (DEFINED platname AND DEFINED archname)
-            set(pkgname ${platname}-${archname})
-        endif()
-    endif()
-
-    if (DEFINED pkgname
-        AND NOT "${pkgname}" IN_LIST DISABLED_PLATFORMS)
-        set(ARTIFACT
-            "${ARTIFACT_NAME}-${pkgname}-${ARTIFACT_VERSION}.${ARTIFACT_EXT}")
-
-        if (PKG_ARGS_MODULE_PATH)
-            set(EXTRA_ARGS MODULE_PATH)
-        endif()
-
-        # download sha512sum file
-        # TODO: CI pkgs
-        set(sha512sum_url
-            "https://${ARTIFACT_GIT_HOST}/${ARTIFACT_REPO}/releases/download/${ARTIFACT_VERSION}/${ARTIFACT}.sha512sum")
-        set(sha512sum_file
-            "${CMAKE_CURRENT_BINARY_DIR}/.cpmutil_${ARTIFACT}_sha512sum")
-
-        file(DOWNLOAD "${sha512sum_url}" "${sha512sum_file}"
-            STATUS sha512sum_status)
-        list(GET sha512sum_status 0 sha512sum_error)
-
-        if(sha512sum_error)
-            message(FATAL_ERROR "[CPMUtil] Failed to download sha512sum "
-                "for ${ARTIFACT_NAME} from ${sha512sum_url}")
-        endif()
-
-        file(READ "${sha512sum_file}" sha512sum_hash)
-        string(STRIP "${sha512sum_hash}" sha512sum_hash)
-        file(REMOVE "${sha512sum_file}")
-
-        AddPackage(
-            NAME ${ARTIFACT_PACKAGE}
-            REPO ${ARTIFACT_REPO}
-            VERSION ${ARTIFACT_VERSION}
-            ARTIFACT ${ARTIFACT}
-            CUSTOM_KEY "${ARTIFACT_VERSION}-${pkgname}"
-            HASH ${sha512sum_hash}
-            FORCE_BUNDLED_PACKAGE ON
-            ${EXTRA_ARGS})
-
-        set(${ARTIFACT_PACKAGE}_ADDED TRUE PARENT_SCOPE)
-        Propagate(${ARTIFACT_PACKAGE}_SOURCE_DIR)
-        Propagate(CMAKE_PREFIX_PATH)
-    else()
-        cpm_utils_message(FATAL_ERROR "${ARTIFACT_NAME}:"
-            "Unsupported platform ${pkgname} for CI package")
-    endif()
-endfunction()
-
-# Utility function for Qt
-function(AddQt repo version)
-    if (NOT DEFINED repo)
-        message(FATAL_ERROR "[CPMUtil] AddQt: repo is required")
-    endif()
-
-    if (NOT DEFINED version)
-        message(FATAL_ERROR "[CPMUtil] AddQt: version is required")
-    endif()
-
-    # TODO: update Qt
    if (MSVC)
        set(platname windows)
    elseif(MINGW)
@@ -1129,6 +1035,64 @@ function(AddQt repo version)
        set(pkgname ${platname}-${archname})
    endif()

+    if (DEFINED pkgname
+        AND NOT "${pkgname}" IN_LIST DISABLED_PLATFORMS)
+        set(ARTIFACT
+            "${ARTIFACT_NAME}-${pkgname}-${ARTIFACT_VERSION}.${ARTIFACT_EXT}")
+
+        if (PKG_ARGS_MODULE_PATH)
+            set(EXTRA_ARGS MODULE_PATH)
+        endif()
+
+        # download sha512sum file
+        # TODO: CI pkgs
+        set(sha512sum_url
+            "https://${ARTIFACT_GIT_HOST}/${ARTIFACT_REPO}/releases/download/v${ARTIFACT_VERSION}/${ARTIFACT}.sha512sum")
+        set(sha512sum_file
+            "${CMAKE_CURRENT_BINARY_DIR}/.cpmutil_${ARTIFACT}_sha512sum")
+
+        file(DOWNLOAD "${sha512sum_url}" "${sha512sum_file}"
+            STATUS sha512sum_status)
+        list(GET sha512sum_status 0 sha512sum_error)
+
+        if(sha512sum_error)
+            message(FATAL_ERROR "[CPMUtil] Failed to download sha512sum "
+                "for ${ARTIFACT_NAME} from ${sha512sum_url}")
+        endif()
+
+        file(READ "${sha512sum_file}" sha512sum_hash)
+        string(STRIP "${sha512sum_hash}" sha512sum_hash)
+        file(REMOVE "${sha512sum_file}")
+
+        AddPackage(
+            NAME ${ARTIFACT_PACKAGE}
+            REPO ${ARTIFACT_REPO}
+            VERSION "v${ARTIFACT_VERSION}"
+            ARTIFACT ${ARTIFACT}
+            CUSTOM_KEY "${ARTIFACT_VERSION}-${pkgname}"
+            HASH ${sha512sum_hash}
+            FORCE_BUNDLED_PACKAGE ON
+            ${EXTRA_ARGS})
+
+        set(${ARTIFACT_PACKAGE}_ADDED TRUE PARENT_SCOPE)
+        Propagate(${ARTIFACT_PACKAGE}_SOURCE_DIR)
+        Propagate(CMAKE_PREFIX_PATH)
+    else()
+        cpm_utils_message(FATAL_ERROR "${ARTIFACT_NAME}:"
+            "Unsupported platform ${pkgname} for CI package")
+    endif()
+endfunction()
+
+# Utility function for Qt
+function(AddQt repo version)
+    if (NOT DEFINED repo)
+        message(FATAL_ERROR "[CPMUtil] AddQt: repo is required")
+    endif()
+
+    if (NOT DEFINED version)
+        message(FATAL_ERROR "[CPMUtil] AddQt: version is required")
+    endif()
+
    AddCIPackage(
        NAME qt
        PACKAGE Qt6
@@ -1136,8 +1100,7 @@ function(AddQt repo version)
        REPO ${repo}
        DISABLED_PLATFORMS
            android-x86_64 android-aarch64
-        MODULE_PATH
-        PKGNAME ${pkgname})
+        MODULE_PATH)

    find_package(Qt6 REQUIRED PATHS ${Qt6_SOURCE_DIR} NO_DEFAULT_PATH)

@@ -15,9 +15,8 @@
  <br>
 </h1>

-<h4 align="center"><b>Eden</b> is a free and open-source (FOSS) Switch 1 emulator started by developer Camille LaVey.
-<br>
-Written in C++, with builds for Windows, Linux, macOS, Android, FreeBSD and more.
+<h4 align="center"><b>Eden</b> is a free and opensource (FOSS) Switch 1 emulator, derived from Yuzu and Sudachi - started by developer Camille LaVey.
+It's written in C++ with portability in mind, with builds for Windows, Linux, macOS, Android, FreeBSD and more.
 </h4>

 <p align="center">
@@ -74,17 +73,3 @@ Save us some bandwidth! We have [mirrors available](./docs/user/ThirdParty.md#mi
 ## License

 Eden is licensed under the GPLv3 (or any later version). Refer to the [LICENSE.txt](https://git.eden-emu.dev/eden-emu/eden/src/branch/master/LICENSE.txt) file.
-
-## Special thanks
-
-Super special thanks to Cloudflare for preventing the git server from blowing up.
-
- Yuzu
- Ryujinx
- Sudachi
- Citron
- Torzu
- Suyu
- Ryubing
-
-And everyone who continues or had contributed to the project! <3
@@ -60,10 +60,10 @@
    },
    "discord-rpc": {
        "find_args": "MODULE",
-        "hash": "8d680b3a16d6f6bf292ad823cf8635595ff986f2a49f758e3009f505b540a9d75194a8cf44cddea75736a8c3e3b5160166e716a0939ce3f18cc463cf648753fe",
+        "hash": "8213c43dcb0f7d479f5861091d111ed12fbdec1e62e6d729d65a4bc181d82f48a35d5fd3cd5c291f2393ac7c9681eabc6b76609755f55376284c8a8d67e148f3",
        "package": "DiscordRPC",
        "repo": "eden-emulator/discord-rpc",
-        "version": "76616d8675"
+        "version": "0d8b2d6a37"
    },
    "enet": {
        "find_args": "MODULE",
@@ -79,10 +79,11 @@
    },
    "ffmpeg-ci": {
        "ci": true,
+        "min_version": "4.1",
        "name": "ffmpeg",
        "package": "FFmpeg",
        "repo": "crueter-ci/FFmpeg",
-        "version": "9.0.1-1788120736-bf1b838f2a"
+        "version": "8.0.1-c7b5f1537d"
    },
    "fmt": {
        "hash": "f0da82c545b01692e9fd30fdfb613dbb8dd9716983dcd0ff19ac2a8d36f74beb5540ef38072fdecc1e34191b3682a8542ecbf3a61ef287dbba0a2679d4e023f2",
@@ -178,6 +179,12 @@
        "repo": "eden-emulator/oaknut",
        "version": "v2.0.3"
    },
+    "oboe": {
+        "bundled": true,
+        "hash": "ce4011afe7345370d4ead3b891cd69a5ef224b129535783586c0ca75051d303ed446e6c7f10bde8da31fff58d6e307f1732a3ffd03b249f9ef1fd48fd4132715",
+        "repo": "google/oboe",
+        "version": "1.10.0"
+    },
    "openssl": {
        "hash": "29002ce50cb95a4f4f1d0e9d3f684401fbd4eac34203dc2eef3b6334af5d44aa46bf788b63a6f5c139c383eafb7269ae87a58a9a3ad5912903b9773e545ccc0a",
        "min_version": "3.0.0",
@@ -190,10 +197,11 @@
    },
    "openssl-ci": {
        "ci": true,
+        "min_version": "3.0.0",
        "name": "openssl",
        "package": "OpenSSL",
        "repo": "crueter-ci/OpenSSL",
-        "version": "4.0.1-1788234794-b64f68a94e"
+        "version": "4.0.0-11b7b6ea3b"
    },
    "openssl-cmake": {
        "bundled": true,
@@ -238,14 +246,6 @@
        "repo": "stachenov/quazip",
        "version": "2e95c9001b"
    },
-    "reshade": {
-        "hash": "6fc9b39821ca6e2d91160f05846b3a42159fec759f5d6fba91d1a57801a1bdaf6047740578c136f0b1a60a9c29ad160d87dbfe0dbfbcdf6ea879a8a078377b8c",
-        "patches": [
-            "0001-from-chars-fallback.patch"
-        ],
-        "repo": "crosire/reshade",
-        "version": "v6.8.0"
-    },
    "sdl3": {
        "hash": "df5a323af7ac366661a3c0e887969c72584d232f3cc211419d59b0487b620b6b2859d4549c9e8df002ee489290062e466fcfddf7edc0872a37b1f2845e81c0f3",
        "min_version": "3.2.10",
@@ -255,10 +255,11 @@
    },
    "sdl3-ci": {
        "ci": true,
+        "min_version": "3.2.10",
        "name": "SDL3",
        "package": "SDL3",
        "repo": "crueter-ci/SDL3",
-        "version": "3.4.14-1788231389-147a8ee32d"
+        "version": "3.4.8-d57c3b685c"
    },
    "simpleini": {
        "find_args": "MODULE",
@@ -281,7 +282,7 @@
        "name": "sirit",
        "package": "sirit",
        "repo": "eden-emulator/sirit",
-        "version": "v1.0.7"
+        "version": "1.0.5"
    },
    "spirv-headers": {
        "hash": "d624371dd455c66a300344c89812598ffe11b5eedba555779f789e85c29dc67317741858c60e0744a1e6755cc0d2759b8659f0674f4cc31479c4cb6fc25ed23b",
@@ -300,6 +301,17 @@
        "repo": "eden-emu/tzdb_to_nx",
        "version": "230326"
    },
+    "unordered-dense": {
+        "bundled": true,
+        "find_args": "CONFIG",
+        "hash": "d2106f6640f6bfb81755e4b8bfb64982e46ec4a507cacdb38f940123212ccf35a20b43c70c6f01d7bfb8c246d1a16f7845d8052971949cea9def1475e3fa02c8",
+        "package": "unordered_dense",
+        "patches": [
+            "0001-avoid-memset-when-clearing-an-empty-table.patch"
+        ],
+        "repo": "martinus/unordered_dense",
+        "version": "7b55cab841"
+    },
    "vulkan-headers": {
        "hash": "d2846ea228415772645eea4b52a9efd33e6a563043dd3de059e798be6391a8f0ca089f455ae420ff22574939ed0f48ed7c6ff3d5a9987d5231dbf3b3f89b484b",
        "min_version": "1.4.317",
@@ -311,9 +323,6 @@
        "find_args": "CONFIG",
        "hash": "deb5902ef8db0e329fbd5f3f4385eb0e26bdd9f14f3a2334823fb3fe18f36bc5d235d620d6e5f6fe3551ec3ea7038638899db8778c09f6d5c278f5ff95c3344b",
        "package": "VulkanMemoryAllocator",
-        "patches": [
-            "0001-macos-clang.patch"
-        ],
        "repo": "GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator",
        "version": "v3.3.0"
    },
@@ -331,10 +340,10 @@
        "version": "vulkan-sdk-%NUMERIC_VERSION%"
    },
    "xbyak": {
-        "hash": "e0aa0a603dd3ac1a39d82213df1e73c042831aec2d6b2fe382c899651eaae4ed7e8aeb6be9c41ea0097087c9d091961ab18f313cd6a9e10d621715ffd49bfe36",
+        "hash": "b6475276b2faaeb315734ea8f4f8bd87ededcee768961b39679bee547e7f3e98884d8b7851e176d861dab30a80a76e6ea302f8c111483607dde969b4797ea95a",
        "package": "xbyak",
        "repo": "herumi/xbyak",
-        "version": "v7.40.1"
+        "version": "v7.35.2"
    },
    "zlib": {
        "hash": "16fea4df307a68cf0035858abe2fd550250618a97590e202037acd18a666f57afc10f8836cbbd472d54a0e76539d0e558cb26f059d53de52ff90634bbf4f47d4",
@@ -11,12 +11,12 @@ SPDX-License-Identifier: CC0-1.0
 -->

 <component type="desktop-application">
-  <id>dev.eden_emu.eden</id>
+  <id>org.eden_emu.eden</id>
  <metadata_license>CC0-1.0</metadata_license>
  <name>eden</name>
  <summary>Nintendo Switch emulator</summary>
  <description>
-    <p>Eden is a free and open-source (FOSS) Switch 1 emulator started by developer Camille LaVey. Written in C++, with builds for Windows, Linux, macOS, Android, FreeBSD and more.</p>
+    <p>Multiplatform FOSS Switch 1 emulator written in C++, derived from Yuzu and Sudachi</p>
  </description>
  <categories>
    <category>Game</category>
@@ -28,14 +28,14 @@ SPDX-License-Identifier: CC0-1.0
  </keywords>
  <url type="homepage">https://eden-emu.dev/</url>
  <url type="bugtracker">https://git.eden-emu.dev/eden-emu/eden/issues</url>
-  <url type="faq">https://eden-emu.dev/about</url>
-  <url type="help">https://git.eden-emu.dev/eden-emu/eden/src/branch/master/docs/user/README.md</url>
-  <url type="donation">https://liberapay.com/crueter</url>
+  <url type="faq">https://eden-emu.dev/docs</url>
+  <url type="help">https://eden-emu.dev/docs</url>
+  <url type="donation">https://eden-emu.dev/donations</url>
  <url type="translate">https://explore.transifex.com/edenemu/eden-emulator</url>
-  <url type="contact">https://discord.gg/HstXbPch7X</url>
+  <url type="contact">https://discord.gg/edenemu</url>
  <url type="vcs-browser">https://git.eden-emu.dev</url>
  <url type="contribute">https://git.eden-emu.dev/eden-emu/eden</url>
-  <launchable type="desktop-id">dev.eden_emu.eden.desktop</launchable>
+  <launchable type="desktop-id">org.eden_emu.eden.desktop</launchable>
  <provides>
    <binary>yuzu</binary>
    <binary>yuzu-cmd</binary>
@@ -44,7 +44,6 @@ SPDX-License-Identifier: CC0-1.0
    <control>pointing</control>
    <control>keyboard</control>
    <control>gamepad</control>
-    <internet>offline-only</internet>
  </supports>
  <requires>
    <memory>8192</memory>
@@ -14,7 +14,7 @@ SPDX-License-Identifier: GPL-2.0-or-later
    <mime-type type="application/x-nx-nro">
        <comment>Nintendo Switch homebrew executable</comment>
        <acronym>NRO</acronym>
-        <icon name="dev.eden_emu.eden"/>
+        <icon name="org.eden_emu.eden"/>
        <glob pattern="*.nro"/>
        <magic><match value="NRO" type="string" offset="16"/></magic>
    </mime-type>
@@ -22,7 +22,7 @@ SPDX-License-Identifier: GPL-2.0-or-later
    <mime-type type="application/x-nx-nso">
        <comment>Nintendo Switch homebrew executable</comment>
        <acronym>NSO</acronym>
-        <icon name="dev.eden_emu.eden"/>
+        <icon name="org.eden_emu.eden"/>
        <glob pattern="*.nso"/>
        <magic><match value="NSO" type="string" offset="0"/></magic>
    </mime-type>
@@ -30,7 +30,7 @@ SPDX-License-Identifier: GPL-2.0-or-later
    <mime-type type="application/x-nx-nsp">
        <comment>Nintendo Switch Package</comment>
        <acronym>NSP</acronym>
-        <icon name="dev.eden_emu.eden"/>
+        <icon name="org.eden_emu.eden"/>
        <glob pattern="*.nsp"/>
        <magic><match value="PFS" type="string" offset="0"/></magic>
    </mime-type>
@@ -38,7 +38,7 @@ SPDX-License-Identifier: GPL-2.0-or-later
    <mime-type type="application/x-nx-xci">
        <comment>Nintendo Switch Card Image</comment>
        <acronym>XCI</acronym>
-        <icon name="dev.eden_emu.eden"/>
+        <icon name="org.eden_emu.eden"/>
        <glob pattern="*.xci"/>
    </mime-type>
 </mime-info>
@@ -2,7 +2,6 @@

 Qt has "Translation Rules for Plurals", small example

-```cpp
    // Take a source line like
    tr("Building: %n shader(s)", "", i)

@@ -10,9 +9,8 @@ Qt has "Translation Rules for Plurals", small example
    Building: 1 shader
    // i = 2:
    Building: 2 shaders
-```

-For Yuzu the source language used is English, for all other languages handling of plurals is handled by Qt and the translation collaboration site. Handling plurals in the source language (English) requires special consideration.
+For yuzu the source language used is English, for all other languages handling of plurals is handled by Qt and the translation collaboration site. Handling plurals in the source language (English) requires special consideration.

 With CMake flag GENERATE_QT_TRANSLATION a generated_en.ts file is created from the source. It ignored by git (`.gitignore` in the project root). It is placed in this directory so that the relative refrences with the source code is correct.

@@ -1,6 +1,6 @@
 # Translating

-This directory stores translation patches (TS files) for Yuzu Qt frontend. This directory is linked with the [Eden project on Transifex](https://app.transifex.com/edenemu/eden-emulator), so you can update the translation by executing `tx pull -t -a` in the root of this repository. If you want to contribute to the translation, please go the Transifex link and submit your translation there.
+This directory stores translation patches (TS files) for yuzu Qt frontend. This directory is linked with the [Eden project on transifex](https://app.transifex.com/edenemu/eden-emulator), so you can update the translation by executing `tx pull -t -a` in the root of this repository. If you want to contribute to the translation, please go the transifex link and submit your translation there.

 When creating/improving translations, please keep in mind:

@@ -1,3 +0,0 @@
-name=Anime
-description=Cel shaded look: the picture is cleaned first, then the lighting is collapsed into flat bands with inked edges, finished with a small glow.
-chain=Denoise.fx|Denoise|Strength=0.18,Radius=1.2;CelShading.fx|CelShading|Bands=5,BandContrast=0.35,BandEdge=0.2,Detail=0.7,OutlineStrength=0.7,OutlineThreshold=0.2,Saturation=1.3;Bloom.fx|Bloom|Radius=1.2,Amount=0.25
@@ -1,3 +0,0 @@
-name=Cinematic
-description=Film look: soft glow on the highlights, a filmic contrast curve, cool shadows against warm highlights, fine grain and a gentle vignette.
-chain=Bloom.fx|Bloom|Radius=1.6,Amount=0.35;FilmicCurve.fx|FilmicCurve|Toe=1.35,Shoulder=1.3,Amount=0.85;SplitToning.fx|SplitToning|ShadowHue=210,ShadowStrength=0.25,HighlightHue=38,HighlightStrength=0.3;FilmGrain.fx|FilmGrain|Intensity=0.022;Vignette.fx|Vignette|Strength=0.5
@@ -1,3 +0,0 @@
-name=Clean
-description=Cleans up a low internal resolution: removes dithering and compression noise, smooths banded skies and brings edge detail back. The safe starting point if you are not sure what you want.
-chain=Denoise.fx|Denoise|Strength=0.14,Curve=1.2;Deband.fx|Deband|;Sharpen.fx|Sharpen|Amount=0.75
@@ -1,3 +0,0 @@
-name=Dreamy
-description=Soft focus: the centre of the screen stays sharp while everything around it blurs, with a wide glow over the highlights. Good for slower games and cutscenes.
-chain=Blur.fx|Blur|Radius=6,Strength=0.85,FocusSize=0.28,FocusSoftness=0.5;Bloom.fx|Bloom|Radius=2.0,Amount=0.55
@@ -1,3 +0,0 @@
-name=Retro
-description=Old television look: colour fringing at the edges of the screen, curved scanlines with a phosphor mask, and darkened corners. The scanline roll is switched off so it does not crawl.
-chain=ChromaticAberration.fx|ChromaticAberration|Strength=1.0;CRT.fx|CRT|RollSpeed=0,Bleed=1.2;Vignette.fx|Vignette|Strength=0.7
@@ -1,3 +0,0 @@
-name=Vivid
-description=Punchier colour without stylising the image: warmer and more saturated, blacks and whites pushed to the ends of the range, and a light sharpen.
-chain=NaturalColors.fx|NaturalColors|Luma=1.15,Chroma=1.35;Levels.fx|Levels|InputBlack=0.02,InputWhite=0.98;Sharpen.fx|Sharpen|Amount=0.5
@@ -1,70 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-// SPDX-FileCopyrightText: Copyright 2012 PPSSPP Project
-// SPDX-License-Identifier: GPL-2.0-or-later
-// Ported from bloomnoblur.fsh in PPSSPP.
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Radius <
-    ui_type = "slider";
-    ui_label = "Radius";
-    ui_tooltip = "How far the glow spreads from bright areas.";
-    ui_min = 0.0; ui_max = 4.0; ui_step = 0.05;
-> = 1.0;
-
-uniform float Amount <
-    ui_type = "slider";
-    ui_label = "Amount";
-    ui_tooltip = "Strength of the glow added on top of the image.";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.05;
-> = 0.6;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float Weight(float3 color)
-{
-    float gray = (color.r + color.g + color.b) / 3.0;
-    float saturation = (abs(color.r - gray) + abs(color.g - gray) + abs(color.b - gray)) / 3.0;
-    return gray * gray / max(saturation, 0.25);
-}
-
-float4 PS_Bloom(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float3 color = tex2D(BackBuffer, uv).rgb;
-
-    float gray = (color.r + color.g + color.b) / 3.0;
-    float saturation = (abs(color.r - gray) + abs(color.g - gray) + abs(color.b - gray)) / 3.0;
-    float spread = 0.002 * gray / max(saturation, 0.25) * Radius;
-
-    float3 sum = float3(0.0, 0.0, 0.0);
-    [unroll] for (int x = -3; x <= 3; x += 2)
-    {
-        [unroll] for (int y = -3; y <= 3; y += 2)
-        {
-            float3 tap = tex2D(BackBuffer, uv + float2(x, y) * spread).rgb;
-            sum += tap * Weight(tap);
-        }
-    }
-    sum /= 16.0;
-
-    return float4(saturate(color + sum * Amount), 1.0);
-}
-
-technique Bloom <
-    ui_label = "Bloom";
-    ui_tooltip = "Bleeds light out of the brightest areas into a soft halo, the way a camera does when pointed at something too bright.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_Bloom;
-    }
-}
@@ -1,87 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Radius <
-    ui_type = "slider";
-    ui_label = "Radius";
-    ui_tooltip = "How far the blur reaches, in pixels.";
-    ui_min = 1.0; ui_max = 12.0; ui_step = 0.5;
-> = 4.0;
-
-uniform float Strength <
-    ui_type = "slider";
-    ui_label = "Strength";
-    ui_tooltip = "Blend between the original image and the blurred one.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 1.0;
-
-uniform float FocusSize <
-    ui_type = "slider";
-    ui_label = "Sharp Centre";
-    ui_tooltip = "Size of the region left in focus at the centre of the screen. At zero the whole image is blurred evenly.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 0.0;
-
-uniform float FocusSoftness <
-    ui_type = "slider";
-    ui_label = "Focus Falloff";
-    ui_tooltip = "How gradually the sharp centre gives way to the blur.";
-    ui_min = 0.05; ui_max = 1.0; ui_step = 0.05;
-> = 0.4;
-
-static const int TAPS = 17;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_Blur(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float2 texel = float2(BUFFER_RCP_WIDTH, BUFFER_RCP_HEIGHT);
-    float3 original = tex2D(BackBuffer, uv).rgb;
-
-    float2 centred = (uv - 0.5) * float2(BUFFER_WIDTH * BUFFER_RCP_HEIGHT, 1.0) * 2.0;
-    float distance_from_centre = length(centred);
-    float no_focus = 1.0 - step(0.001, FocusSize);
-    float focus = max(smoothstep(FocusSize, FocusSize + FocusSoftness, distance_from_centre), no_focus);
-    float amount = Strength * focus;
-
-    float angle = frac(sin(dot(pos.xy, float2(12.9898, 78.233))) * 43758.5453) * 6.2831853;
-    float2 spoke = float2(cos(angle), sin(angle));
-
-    const float2 turn = float2(cos(2.39996323), sin(2.39996323));
-    const float decay = exp(-2.0 / float(TAPS));
-    float weight = exp(-1.0 / float(TAPS));
-
-    float3 sum = float3(0.0, 0.0, 0.0);
-    float total = 0.0;
-    [unroll] for (int i = 0; i < TAPS; ++i)
-    {
-        float reach = sqrt((float(i) + 0.5) / float(TAPS));
-        sum += tex2D(BackBuffer, uv + spoke * reach * texel * Radius).rgb * weight;
-        total += weight;
-        weight *= decay;
-        spoke = float2(spoke.x * turn.x - spoke.y * turn.y,
-                       spoke.x * turn.y + spoke.y * turn.x);
-    }
-
-    float3 blurred = sum / total;
-    return float4(lerp(original, blurred, amount), 1.0);
-}
-
-technique Blur <
-    ui_label = "Blur";
-    ui_tooltip = "Gaussian blur with an optional sharp centre, for softening the picture or faking depth of field.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_Blur;
-    }
-}
@@ -1,74 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-// SPDX-FileCopyrightText: Copyright 2012 PPSSPP Project
-// SPDX-License-Identifier: GPL-2.0-or-later
-// Ported from crt.fsh in PPSSPP, by KillaMaaki.
-
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Timer < source = "timer"; > = 0.0;
-
-uniform float Density <
-    ui_type = "slider";
-    ui_label = "Line Density";
-    ui_min = 60.0; ui_max = 720.0; ui_step = 10.0;
-> = 272.0;
-
-uniform float RollSpeed <
-    ui_type = "slider";
-    ui_label = "Roll Speed";
-    ui_tooltip = "Speed of the rolling bar. Zero disables it.";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.05;
-> = 1.0;
-
-uniform float Bleed <
-    ui_type = "slider";
-    ui_label = "Colour Bleed";
-    ui_tooltip = "Horizontal separation of the red and green channels.";
-    ui_min = 0.0; ui_max = 4.0; ui_step = 0.1;
-> = 1.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_CRT(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float seconds = Timer * 0.001;
-    float scan = floor((uv.y + seconds * RollSpeed * 0.5) * Density);
-    float line_intensity = frac(scan * 0.5) * 2.0;
-
-    float2 shift = float2(line_intensity * 0.0005, 0.0);
-    float2 bleed = float2(BUFFER_RCP_WIDTH * Bleed, 0.0);
-
-    float r = tex2D(BackBuffer, uv + bleed + shift).r;
-    float g = tex2D(BackBuffer, uv - bleed + shift).g;
-    float b = tex2D(BackBuffer, uv).b;
-
-    float3 color = float3(r, g * 0.99, b) * clamp(line_intensity, 0.85, 1.0);
-
-    if (RollSpeed > 0.0)
-    {
-        float rollbar = sin((uv.y + seconds * RollSpeed) * 4.0);
-        color += rollbar * 0.02;
-    }
-
-    return float4(saturate(color), 1.0);
-}
-
-technique CRT <
-    ui_label = "CRT";
-    ui_tooltip = "Curved scanlines and the phosphor mask of a CRT television, for games that were drawn with that kind of screen in mind.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_CRT;
-    }
-}
@@ -1,79 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-// SPDX-FileCopyrightText: Copyright 2012 PPSSPP Project
-// SPDX-FileCopyrightText: guest(r)
-// SPDX-License-Identifier: GPL-2.0-or-later
-// Ported from cartoon.fsh in PPSSPP, Advanced Cartoon shader I by guest(r).
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float EdgeStrength <
-    ui_type = "slider";
-    ui_label = "Edge Strength";
-    ui_tooltip = "Darkness of the ink outline drawn around detected edges.";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.05;
-> = 0.5;
-
-uniform float Levels <
-    ui_type = "slider";
-    ui_label = "Colour Levels";
-    ui_tooltip = "How many bands the colours are quantised into.";
-    ui_min = 2.0; ui_max = 16.0; ui_step = 1.0;
-> = 4.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_Cartoon(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float2 texel = float2(BUFFER_RCP_WIDTH, BUFFER_RCP_HEIGHT);
-
-    float3 c00 = tex2D(BackBuffer, uv + texel * float2(-1.0, -1.0)).rgb;
-    float3 c10 = tex2D(BackBuffer, uv + texel * float2( 0.0, -1.0)).rgb;
-    float3 c20 = tex2D(BackBuffer, uv + texel * float2( 1.0, -1.0)).rgb;
-    float3 c01 = tex2D(BackBuffer, uv + texel * float2(-1.0,  0.0)).rgb;
-    float3 c11 = tex2D(BackBuffer, uv).rgb;
-    float3 c21 = tex2D(BackBuffer, uv + texel * float2( 1.0,  0.0)).rgb;
-    float3 c02 = tex2D(BackBuffer, uv + texel * float2(-1.0,  1.0)).rgb;
-    float3 c12 = tex2D(BackBuffer, uv + texel * float2( 0.0,  1.0)).rgb;
-    float3 c22 = tex2D(BackBuffer, uv + texel * float2( 1.0,  1.0)).rgb;
-
-    const float3 dt = float3(1.0, 1.0, 1.0);
-
-    float d1 = dot(abs(c00 - c22), dt);
-    float d2 = dot(abs(c20 - c02), dt);
-    float hl = dot(abs(c01 - c21), dt);
-    float vl = dot(abs(c10 - c12), dt);
-    float edge = EdgeStrength * (d1 + d2 + hl + vl) / (dot(c11, dt) + 0.15);
-
-    float lc = Levels * length(c11);
-    float f = frac(lc);
-    f *= f;
-    lc = (floor(lc) + f * f) / Levels + 0.05;
-
-    float3 unit = normalize(max(c11, 0.0001));
-    float3 quant = Levels * unit;
-    float3 frct = frac(quant);
-    frct *= frct;
-    quant = floor(quant) + 0.05 * dt + frct * frct;
-
-    float3 color = lc * (1.1 - edge * sqrt(edge)) * quant / Levels;
-    return float4(saturate(color), 1.0);
-}
-
-technique Cartoon <
-    ui_label = "Cartoon";
-    ui_tooltip = "Ink outlines and flat colour bands. Faithful port of the PPSSPP shader; the outline gets heavy in dark scenes, so try Cartoon Soft or Cel Shading if the blacks smear.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_Cartoon;
-    }
-}
@@ -1,100 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-// SPDX-FileCopyrightText: Copyright 2012 PPSSPP Project
-// SPDX-FileCopyrightText: guest(r)
-// SPDX-License-Identifier: GPL-2.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float EdgeStrength <
-    ui_type = "slider";
-    ui_label = "Edge Strength";
-    ui_tooltip = "Darkness of the ink outline drawn around detected edges.";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.05;
-> = 0.45;
-
-uniform float ShadowGuard <
-    ui_type = "slider";
-    ui_label = "Shadow Guard";
-    ui_tooltip = "Holds the outline back in dark areas. Raise it if shadows turn into black blobs.";
-    ui_min = 0.1; ui_max = 2.0; ui_step = 0.05;
-> = 0.8;
-
-uniform float Levels <
-    ui_type = "slider";
-    ui_label = "Colour Levels";
-    ui_tooltip = "How many bands the colours are quantised into.";
-    ui_min = 2.0; ui_max = 16.0; ui_step = 1.0;
-> = 6.0;
-
-uniform float Smoothing <
-    ui_type = "slider";
-    ui_label = "Banding";
-    ui_tooltip = "How far the picture is pushed towards flat bands.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 0.75;
-
-uniform float Saturation <
-    ui_type = "slider";
-    ui_label = "Saturation";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.05;
-> = 1.15;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_CartoonSoft(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float2 texel = float2(BUFFER_RCP_WIDTH, BUFFER_RCP_HEIGHT);
-
-    float3 c00 = tex2D(BackBuffer, uv + texel * float2(-1.0, -1.0)).rgb;
-    float3 c10 = tex2D(BackBuffer, uv + texel * float2( 0.0, -1.0)).rgb;
-    float3 c20 = tex2D(BackBuffer, uv + texel * float2( 1.0, -1.0)).rgb;
-    float3 c01 = tex2D(BackBuffer, uv + texel * float2(-1.0,  0.0)).rgb;
-    float3 c11 = tex2D(BackBuffer, uv).rgb;
-    float3 c21 = tex2D(BackBuffer, uv + texel * float2( 1.0,  0.0)).rgb;
-    float3 c02 = tex2D(BackBuffer, uv + texel * float2(-1.0,  1.0)).rgb;
-    float3 c12 = tex2D(BackBuffer, uv + texel * float2( 0.0,  1.0)).rgb;
-    float3 c22 = tex2D(BackBuffer, uv + texel * float2( 1.0,  1.0)).rgb;
-
-    const float3 dt = float3(1.0, 1.0, 1.0);
-    const float3 luma_weights = float3(0.299, 0.587, 0.114);
-
-    float d1 = dot(abs(c00 - c22), dt);
-    float d2 = dot(abs(c20 - c02), dt);
-    float hl = dot(abs(c01 - c21), dt);
-    float vl = dot(abs(c10 - c12), dt);
-
-    float luma = dot(c11, luma_weights);
-    float response = (d1 + d2 + hl + vl) / (luma * 2.0 + ShadowGuard);
-    float ink = 1.0 - saturate(response * EdgeStrength);
-
-    float scaled = luma * Levels;
-    float step_position = frac(scaled);
-    float eased = step_position * step_position * (3.0 - 2.0 * step_position);
-    float banded = (floor(scaled) + eased) / Levels;
-    float target = lerp(luma, banded, Smoothing);
-
-    float3 tinted = c11 * (target / max(luma, 0.001));
-    float3 grey = dot(tinted, luma_weights);
-    float3 color = lerp(grey, tinted, Saturation) * ink;
-
-    return float4(saturate(color), 1.0);
-}
-
-technique CartoonSoft <
-    ui_label = "Cartoon Soft";
-    ui_tooltip = "Ink outlines and flat colour bands, with the outline held back in the shadows so dark scenes do not turn into black blobs.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_CartoonSoft;
-    }
-}
@@ -1,120 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Bands <
-    ui_type = "slider";
-    ui_label = "Shading Bands";
-    ui_tooltip = "How many flat steps the lighting is collapsed into. Three or four gives the classic look.";
-    ui_min = 2.0; ui_max = 8.0; ui_step = 1.0;
-> = 4.0;
-
-uniform float BandContrast <
-    ui_type = "slider";
-    ui_label = "Band Contrast";
-    ui_tooltip = "Spreads the bands towards pure black and white. Lower it if the shadows crush.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 0.5;
-
-uniform float BandEdge <
-    ui_type = "slider";
-    ui_label = "Band Edge";
-    ui_tooltip = "Width of the transition between bands. Low values give hard cel steps.";
-    ui_min = 0.02; ui_max = 1.0; ui_step = 0.02;
-> = 0.15;
-
-uniform float Detail <
-    ui_type = "slider";
-    ui_label = "Texture Detail";
-    ui_tooltip = "How much surface texture survives the flattening. At zero the bands are completely flat.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 0.6;
-
-uniform float OutlineStrength <
-    ui_type = "slider";
-    ui_label = "Outline Strength";
-    ui_tooltip = "Opacity of the ink line drawn along detected edges.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 0.8;
-
-uniform float OutlineThreshold <
-    ui_type = "slider";
-    ui_label = "Outline Threshold";
-    ui_tooltip = "How strong an edge has to be before it is inked. Raise it to keep ink off textures and specular highlights.";
-    ui_min = 0.01; ui_max = 0.4; ui_step = 0.01;
-> = 0.18;
-
-uniform float Saturation <
-    ui_type = "slider";
-    ui_label = "Saturation";
-    ui_tooltip = "Colour intensity of the flat regions.";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.05;
-> = 1.25;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_CelShading(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    const float3 luma_weights = float3(0.2126, 0.7152, 0.0722);
-    float2 texel = float2(BUFFER_RCP_WIDTH, BUFFER_RCP_HEIGHT);
-
-    float3 centre = tex2D(BackBuffer, uv).rgb;
-    float luma = dot(centre, luma_weights);
-
-    float2 near = texel * 1.5;
-    float2 far = texel * 3.5;
-
-    float a00 = dot(tex2D(BackBuffer, uv + near * float2(-1.0, -1.0)).rgb, luma_weights);
-    float a20 = dot(tex2D(BackBuffer, uv + near * float2( 1.0, -1.0)).rgb, luma_weights);
-    float a02 = dot(tex2D(BackBuffer, uv + near * float2(-1.0,  1.0)).rgb, luma_weights);
-    float a22 = dot(tex2D(BackBuffer, uv + near * float2( 1.0,  1.0)).rgb, luma_weights);
-
-    float b00 = dot(tex2D(BackBuffer, uv + far * float2(-1.0, -1.0)).rgb, luma_weights);
-    float b20 = dot(tex2D(BackBuffer, uv + far * float2( 1.0, -1.0)).rgb, luma_weights);
-    float b02 = dot(tex2D(BackBuffer, uv + far * float2(-1.0,  1.0)).rgb, luma_weights);
-    float b22 = dot(tex2D(BackBuffer, uv + far * float2( 1.0,  1.0)).rgb, luma_weights);
-
-    float gx = (a00 + a02) - (a20 + a22);
-    float gy = (a00 + a20) - (a02 + a22);
-    float gradient = sqrt(gx * gx + gy * gy);
-    float ink = smoothstep(OutlineThreshold, OutlineThreshold + 0.04, gradient);
-
-    float lighting = (a00 + a20 + a02 + a22 + b00 + b20 + b02 + b22) * 0.125;
-    float detail = luma - lighting;
-
-    float softness = max(BandEdge, 0.001);
-    float coord = lighting * Bands - softness * 0.5;
-    float index = floor(coord) + smoothstep(1.0 - softness, 1.0, frac(coord));
-
-    float centred = (index + 0.5) / Bands;
-    float stretched = index / max(Bands - 1.0, 1.0);
-    float banded = saturate(lerp(centred, stretched, BandContrast));
-
-    float target = saturate(banded + detail * Detail);
-
-    float gain = min(target / max(luma, 0.001), 4.0);
-    float3 shaded = centre * gain;
-    float3 grey = dot(shaded, luma_weights);
-    float3 color = lerp(grey, shaded, Saturation);
-    color *= 1.0 - ink * OutlineStrength;
-
-    return float4(saturate(color), 1.0);
-}
-
-technique CelShading <
-    ui_label = "Cel Shading";
-    ui_tooltip = "Collapses the lighting into a few hard steps and inks the edges, keeping texture detail and hue intact.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_CelShading;
-    }
-}
@@ -1,53 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Strength <
-    ui_type = "slider";
-    ui_label = "Strength";
-    ui_tooltip = "Channel separation in pixels, measured at the edge of the screen.";
-    ui_min = 0.0; ui_max = 8.0; ui_step = 0.1;
-> = 1.5;
-
-uniform float Falloff <
-    ui_type = "slider";
-    ui_label = "Falloff";
-    ui_tooltip = "How fast the separation grows away from the centre. Higher keeps the middle clean.";
-    ui_min = 1.0; ui_max = 4.0; ui_step = 0.1;
-> = 2.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_ChromaticAberration(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float2 texel = float2(BUFFER_RCP_WIDTH, BUFFER_RCP_HEIGHT);
-
-    float2 direction = uv - float2(0.5, 0.5);
-    float radius = length(direction);
-    float2 unit = direction / max(radius, 0.0001);
-    float2 offset = unit * Strength * pow(radius * 2.0, Falloff) * texel;
-
-    float red = tex2D(BackBuffer, uv + offset).r;
-    float green = tex2D(BackBuffer, uv).g;
-    float blue = tex2D(BackBuffer, uv - offset).b;
-
-    return float4(red, green, blue, 1.0);
-}
-
-technique ChromaticAberration <
-    ui_label = "Chromatic Aberration";
-    ui_tooltip = "Splits the colour channels apart towards the edges of the screen, the way a cheap lens fails to focus every colour on the same spot.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_ChromaticAberration;
-    }
-}
@@ -1,64 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-// SPDX-FileCopyrightText: Copyright 2012 PPSSPP Project
-// SPDX-License-Identifier: GPL-2.0-or-later
-// Based on colorcorrection.fsh in PPSSPP.
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Saturation <
-    ui_type = "slider";
-    ui_label = "Saturation";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.01;
-> = 1.0;
-
-uniform float Brightness <
-    ui_type = "slider";
-    ui_label = "Brightness";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.01;
-> = 1.0;
-
-uniform float Contrast <
-    ui_type = "slider";
-    ui_label = "Contrast";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.01;
-> = 1.0;
-
-uniform float Gamma <
-    ui_type = "slider";
-    ui_label = "Gamma";
-    ui_min = 0.5; ui_max = 2.0; ui_step = 0.01;
-> = 1.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_ColorGrade(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float3 rgb = tex2D(BackBuffer, uv).rgb;
-
-    float luma = dot(rgb, float3(0.2126, 0.7152, 0.0722));
-    rgb = lerp(float3(luma, luma, luma), rgb, Saturation);
-    rgb *= Brightness;
-    rgb = (rgb - 0.5) * Contrast + 0.5;
-    rgb = pow(max(rgb, 0.0), 1.0 / max(Gamma, 0.0001));
-
-    return float4(saturate(rgb), 1.0);
-}
-
-technique ColorGrade <
-    ui_label = "Colour Grade";
-    ui_tooltip = "The four basic colour controls in one pass: saturation, brightness, contrast and gamma. Reach for this before anything more specialised.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_ColorGrade;
-    }
-}
@@ -1,91 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-// SPDX-FileCopyrightText: Copyright 2015 Niklas Haas
-// SPDX-License-Identifier: MIT
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Threshold <
-    ui_type = "slider";
-    ui_label = "Threshold";
-    ui_tooltip = "How flat a neighbourhood must be before it gets smoothed. Raise it to catch wider bands, lower it to keep more detail.";
-    ui_min = 0.002; ui_max = 0.05; ui_step = 0.001;
-> = 0.012;
-
-uniform float Radius <
-    ui_type = "slider";
-    ui_label = "Radius";
-    ui_tooltip = "How far the sampling reaches, in pixels. Wider gradients need a larger radius.";
-    ui_min = 1.0; ui_max = 32.0; ui_step = 1.0;
-> = 8.0;
-
-uniform float Grain <
-    ui_type = "slider";
-    ui_label = "Dither";
-    ui_tooltip = "Noise added to break up whatever banding survives the smoothing.";
-    ui_min = 0.0; ui_max = 0.02; ui_step = 0.001;
-> = 0.004;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float Hash(float2 p)
-{
-    float3 scattered = frac(float3(p.x, p.y, p.x) * 0.1031);
-    scattered += dot(scattered, scattered.yzx + 33.33);
-    return frac((scattered.x + scattered.y) * scattered.z);
-}
-
-float4 PS_Deband(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float2 texel = float2(BUFFER_RCP_WIDTH, BUFFER_RCP_HEIGHT);
-
-    float3 centre = tex2D(BackBuffer, uv).rgb;
-    float base = Hash(pos.xy) * 6.2831853;
-
-    float3 total = float3(0.0, 0.0, 0.0);
-    float3 deviation = float3(0.0, 0.0, 0.0);
-
-    [unroll] for (int ring = 1; ring <= 2; ++ring)
-    {
-        float angle = base + float(ring) * 2.3999632;
-        float reach = Radius * float(ring) * 0.5;
-        float2 along = float2(cos(angle), sin(angle)) * reach;
-        float2 across = float2(-along.y, along.x);
-
-        float3 s0 = tex2D(BackBuffer, uv + along * texel).rgb;
-        float3 s1 = tex2D(BackBuffer, uv - along * texel).rgb;
-        float3 s2 = tex2D(BackBuffer, uv + across * texel).rgb;
-        float3 s3 = tex2D(BackBuffer, uv - across * texel).rgb;
-
-        total += s0 + s1 + s2 + s3;
-        deviation = max(deviation, max(max(abs(s0 - centre), abs(s1 - centre)),
-                                       max(abs(s2 - centre), abs(s3 - centre))));
-    }
-
-    float3 average = total * 0.125;
-    float3 flatness = float3(1.0, 1.0, 1.0) -
-                      smoothstep(Threshold * 0.5, Threshold, deviation);
-    float3 result = lerp(centre, average, flatness);
-
-    float dither = (Hash(pos.xy + float2(71.3, 41.7)) - 0.5) * Grain;
-
-    return float4(saturate(result + dither), 1.0);
-}
-
-technique Deband <
-    ui_label = "Deband";
-    ui_tooltip = "Smooths the visible steps in gradients such as skies, then dithers whatever survives. Worth adding whenever large flat areas show rings.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_Deband;
-    }
-}
@@ -1,83 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-// SPDX-FileCopyrightText: Copyright 2019-2021 bloc97
-// SPDX-License-Identifier: MIT
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Strength <
-    ui_type = "slider";
-    ui_label = "Strength";
-    ui_min = 0.01; ui_max = 0.5; ui_step = 0.01;
-> = 0.1;
-
-uniform float Radius <
-    ui_type = "slider";
-    ui_label = "Radius";
-    ui_min = 0.3; ui_max = 2.0; ui_step = 0.05;
-> = 1.0;
-
-uniform float Curve <
-    ui_type = "slider";
-    ui_label = "Shadow Bias";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.05;
-> = 1.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float3 IntensityWeight(float3 value, float3 sigma, float3 centre)
-{
-    float3 scaled = (value - centre) / sigma;
-    return exp(-0.5 * scaled * scaled);
-}
-
-float SpatialWeight(float distance, float sigma)
-{
-    float scaled = distance / sigma;
-    return exp(-0.5 * scaled * scaled);
-}
-
-float4 PS_Denoise(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float2 texel = float2(BUFFER_RCP_WIDTH, BUFFER_RCP_HEIGHT);
-
-    float3 centre = tex2D(BackBuffer, uv).rgb;
-    float3 intensity_sigma = max(pow(centre + 0.0001, Curve) * Strength, 0.0001);
-    float spatial_sigma = max(Radius, 0.05);
-
-    float3 sum = float3(0.0, 0.0, 0.0);
-    float3 total = float3(0.0, 0.0, 0.0);
-
-    [unroll] for (int y = -2; y <= 2; ++y)
-    {
-        [unroll] for (int x = -2; x <= 2; ++x)
-        {
-            float2 offset = float2(x, y);
-            float3 tap = tex2D(BackBuffer, uv + offset * texel).rgb;
-            float3 weight = IntensityWeight(tap, intensity_sigma, centre) *
-                            SpatialWeight(length(offset), spatial_sigma);
-            sum += weight * tap;
-            total += weight;
-        }
-    }
-
-    return float4(sum / total, 1.0);
-}
-
-technique Denoise <
-    ui_label = "Denoise";
-    ui_tooltip = "Edge preserving blur that clears dithering and compression noise while leaving outlines sharp. Ported from Anime4K.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_Denoise;
-    }
-}
@@ -1,65 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Intensity <
-    ui_type = "slider";
-    ui_label = "Intensity";
-    ui_min = 0.0; ui_max = 0.2; ui_step = 0.005;
-> = 0.03;
-
-uniform float Size <
-    ui_type = "slider";
-    ui_label = "Size";
-    ui_tooltip = "Grain cell size in pixels.";
-    ui_min = 1.0; ui_max = 4.0; ui_step = 1.0;
-> = 1.0;
-
-uniform float Colored <
-    ui_type = "slider";
-    ui_label = "Colour";
-    ui_tooltip = "Zero gives monochrome grain, one gives independent noise per channel.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.01;
-> = 0.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float Hash(float2 p)
-{
-    float3 scattered = frac(float3(p.x, p.y, p.x) * 0.1031);
-    scattered += dot(scattered, scattered.yzx + 33.33);
-    return frac((scattered.x + scattered.y) * scattered.z);
-}
-
-float4 PS_FilmGrain(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float3 rgb = tex2D(BackBuffer, uv).rgb;
-
-    float2 cell = floor(pos.xy / max(Size, 1.0));
-    float mono = Hash(cell) - 0.5;
-    float3 chroma = float3(Hash(cell + 11.7), Hash(cell + 23.1), Hash(cell + 37.5)) - 0.5;
-    float3 noise = lerp(float3(mono, mono, mono), chroma, Colored);
-
-    float luma = dot(rgb, float3(0.2126, 0.7152, 0.0722));
-    float response = 1.0 - abs(luma * 2.0 - 1.0);
-
-    return float4(saturate(rgb + noise * Intensity * response), 1.0);
-}
-
-technique FilmGrain <
-    ui_label = "Film Grain";
-    ui_tooltip = "Adds photographic grain, strongest in the midtones and fading out in blacks and whites.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_FilmGrain;
-    }
-}
@@ -1,60 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Exposure <
-    ui_type = "slider";
-    ui_label = "Exposure";
-    ui_min = 0.5; ui_max = 2.0; ui_step = 0.01;
-> = 1.0;
-
-uniform float Toe <
-    ui_type = "slider";
-    ui_label = "Toe";
-    ui_tooltip = "Above 1.0 deepens the shadows, below 1.0 lifts them.";
-    ui_min = 0.5; ui_max = 2.0; ui_step = 0.01;
-> = 1.2;
-
-uniform float Shoulder <
-    ui_type = "slider";
-    ui_label = "Shoulder";
-    ui_tooltip = "Above 1.0 opens up the highlights, below 1.0 compresses them.";
-    ui_min = 0.5; ui_max = 2.0; ui_step = 0.01;
-> = 1.2;
-
-uniform float Amount <
-    ui_type = "slider";
-    ui_label = "Amount";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.01;
-> = 0.7;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_FilmicCurve(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float3 rgb = tex2D(BackBuffer, uv).rgb;
-
-    float3 curved = saturate(rgb * Exposure);
-    curved = pow(max(curved, 0.0), Toe);
-    curved = 1.0 - pow(max(1.0 - curved, 0.0), Shoulder);
-
-    return float4(saturate(lerp(rgb, curved, Amount)), 1.0);
-}
-
-technique FilmicCurve <
-    ui_label = "Filmic Curve";
-    ui_tooltip = "Filmic contrast curve. Deepens the shadows and opens the highlights without clipping either end.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_FilmicCurve;
-    }
-}
@@ -1,53 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Distortion <
-    ui_type = "slider";
-    ui_label = "Distortion";
-    ui_tooltip = "Positive bulges the picture outwards, negative pinches it inwards.";
-    ui_min = -0.5; ui_max = 0.5; ui_step = 0.01;
-> = 0.1;
-
-uniform float Zoom <
-    ui_type = "slider";
-    ui_label = "Zoom";
-    ui_tooltip = "Scales the picture to hide the edges the warp pulls in.";
-    ui_min = 0.5; ui_max = 1.5; ui_step = 0.01;
-> = 1.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_LensDistortion(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float aspect = BUFFER_WIDTH * BUFFER_RCP_HEIGHT;
-    float2 half_size = float2(aspect, 1.0);
-    float2 unit = half_size / length(half_size);
-
-    float2 centred = (uv - 0.5) * 2.0 * unit;
-    float r2 = dot(centred, centred);
-    centred *= 1.0 + Distortion * r2;
-    centred /= max(Zoom, 0.001);
-
-    float2 source = centred / (2.0 * unit) + 0.5;
-
-    return float4(tex2D(BackBuffer, source).rgb, 1.0);
-}
-
-technique LensDistortion <
-    ui_label = "Lens Distortion";
-    ui_tooltip = "Barrel or pincushion warp, like looking through a wide angle lens.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_LensDistortion;
-    }
-}
@@ -1,66 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float InputBlack <
-    ui_type = "slider";
-    ui_label = "Input Black";
-    ui_tooltip = "Input level mapped to black. Raise it to deepen washed out shadows.";
-    ui_min = 0.0; ui_max = 0.5; ui_step = 0.005;
-> = 0.0;
-
-uniform float InputWhite <
-    ui_type = "slider";
-    ui_label = "Input White";
-    ui_min = 0.5; ui_max = 1.0; ui_step = 0.005;
-> = 1.0;
-
-uniform float Gamma <
-    ui_type = "slider";
-    ui_label = "Gamma";
-    ui_min = 0.2; ui_max = 3.0; ui_step = 0.01;
-> = 1.0;
-
-uniform float OutputBlack <
-    ui_type = "slider";
-    ui_label = "Output Black";
-    ui_tooltip = "Lifts crushed shadows so detail stops collapsing into one flat black.";
-    ui_min = 0.0; ui_max = 0.5; ui_step = 0.005;
-> = 0.0;
-
-uniform float OutputWhite <
-    ui_type = "slider";
-    ui_label = "Output White";
-    ui_min = 0.5; ui_max = 1.0; ui_step = 0.005;
-> = 1.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_Levels(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float3 rgb = tex2D(BackBuffer, uv).rgb;
-
-    rgb = saturate((rgb - InputBlack) / max(InputWhite - InputBlack, 0.001));
-    rgb = pow(max(rgb, 0.0), 1.0 / max(Gamma, 0.001));
-    rgb = lerp(OutputBlack, OutputWhite, rgb);
-
-    return float4(saturate(rgb), 1.0);
-}
-
-technique Levels <
-    ui_label = "Levels";
-    ui_tooltip = "Black point, white point, gamma and output range. Use it to fix crushed or washed out shadows.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_Levels;
-    }
-}
@@ -1,88 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Length <
-    ui_type = "slider";
-    ui_label = "Length";
-    ui_tooltip = "How far the streaks reach, as a percentage of screen height.";
-    ui_min = 0.0; ui_max = 20.0; ui_step = 0.5;
-> = 5.0;
-
-uniform float Zoom <
-    ui_type = "slider";
-    ui_label = "Zoom";
-    ui_tooltip = "Streaks running out from the centre of the screen, as if rushing forward. The centre stays sharp.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 1.0;
-
-uniform float Pan <
-    ui_type = "slider";
-    ui_label = "Pan";
-    ui_tooltip = "Streaks running in one fixed direction, as if the camera were sweeping across.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 0.0;
-
-uniform float Angle <
-    ui_type = "slider";
-    ui_label = "Pan Angle";
-    ui_tooltip = "Direction of the sweep, in degrees.";
-    ui_min = 0.0; ui_max = 360.0; ui_step = 5.0;
-> = 0.0;
-
-uniform float Spin <
-    ui_type = "slider";
-    ui_label = "Spin";
-    ui_tooltip = "Streaks curling around the centre, as if the camera were rolling. Negative turns the other way.";
-    ui_min = -1.0; ui_max = 1.0; ui_step = 0.05;
-> = 0.0;
-
-static const int TAPS = 24;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_MotionBlur(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float aspect = BUFFER_WIDTH * BUFFER_RCP_HEIGHT;
-    float2 to_screen = float2(aspect, 1.0);
-
-    float2 centred = (uv - 0.5) * to_screen * 2.0;
-    float2 outward = centred;
-    float2 around = float2(-centred.y, centred.x);
-
-    float radians_angle = Angle * 0.01745329;
-    float2 sweep = float2(cos(radians_angle), sin(radians_angle));
-
-    float2 velocity = sweep * Pan + outward * Zoom + around * Spin;
-    velocity *= Length * 0.01;
-    velocity /= to_screen;
-
-    float jitter = frac(sin(dot(pos.xy, float2(12.9898, 78.233))) * 43758.5453);
-
-    float3 sum = float3(0.0, 0.0, 0.0);
-    [unroll] for (int i = 0; i < TAPS; ++i)
-    {
-        float t = (float(i) + jitter) / float(TAPS) - 0.5;
-        sum += tex2D(BackBuffer, uv + velocity * t).rgb;
-    }
-
-    return float4(sum / float(TAPS), 1.0);
-}
-
-technique MotionBlur <
-    ui_label = "Motion Blur";
-    ui_tooltip = "Camera style motion blur: streaks the picture outwards, sideways or around, without touching still detail at the centre.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_MotionBlur;
-    }
-}
@@ -1,60 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-// SPDX-FileCopyrightText: Copyright 2012 PPSSPP Project
-// SPDX-License-Identifier: GPL-2.0-or-later
-// Ported from naturalA.fsh in PPSSPP, by ShadX, modified by SimoneT.
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Luma <
-    ui_type = "slider";
-    ui_label = "Luma Curve";
-    ui_tooltip = "Gamma applied to the luminance channel in YIQ space.";
-    ui_min = 0.5; ui_max = 2.0; ui_step = 0.01;
-> = 1.2;
-
-uniform float Chroma <
-    ui_type = "slider";
-    ui_label = "Chroma Gain";
-    ui_tooltip = "Boost applied to the two colour difference channels.";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.01;
-> = 1.2;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_Natural(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    const float3x3 RGBtoYIQ = float3x3(0.299, 0.587, 0.114,
-                                       0.596, -0.275, -0.321,
-                                       0.212, -0.523, 0.311);
-
-    const float3x3 YIQtoRGB = float3x3(1.0, 0.95568806, 0.61985809,
-                                       1.0, -0.27158180, -0.64687382,
-                                       1.0, -1.10817733, 1.70506456);
-
-    float3 rgb = tex2D(BackBuffer, uv).rgb;
-    float3 yiq = mul(RGBtoYIQ, rgb);
-
-    yiq.x = pow(max(yiq.x, 0.0), Luma);
-    yiq.yz *= Chroma;
-
-    return float4(saturate(mul(YIQtoRGB, yiq)), 1.0);
-}
-
-technique NaturalColors <
-    ui_label = "Natural Colours";
-    ui_tooltip = "Warms the picture and lifts saturation for a less washed out look. Ported from the PPSSPP shader.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_Natural;
-    }
-}
@@ -1,90 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Timer < source = "timer"; > = 0.0;
-
-uniform float Horizon <
-    ui_type = "slider";
-    ui_label = "Reflection Line";
-    ui_tooltip = "Height on screen where the reflective floor begins. Everything above it is left untouched.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.01;
-> = 0.55;
-
-uniform float Amount <
-    ui_type = "slider";
-    ui_label = "Amount";
-    ui_tooltip = "How strongly the reflection shows through the floor.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 0.35;
-
-uniform float Falloff <
-    ui_type = "slider";
-    ui_label = "Falloff";
-    ui_tooltip = "How quickly the reflection fades as the floor comes towards the viewer. At zero it stays even.";
-    ui_min = 0.0; ui_max = 4.0; ui_step = 0.1;
-> = 1.2;
-
-uniform float Perspective <
-    ui_type = "slider";
-    ui_label = "Perspective";
-    ui_tooltip = "Stretches or squashes the mirrored image. One is a true mirror, higher values pull it towards the line.";
-    ui_min = 0.2; ui_max = 2.0; ui_step = 0.05;
-> = 1.0;
-
-uniform float Ripple <
-    ui_type = "slider";
-    ui_label = "Ripple";
-    ui_tooltip = "Amplitude of the waves disturbing the reflection. At zero the mirror is perfectly still.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 0.0;
-
-uniform float RippleSpeed <
-    ui_type = "slider";
-    ui_label = "Ripple Speed";
-    ui_tooltip = "How fast the waves travel.";
-    ui_min = 0.0; ui_max = 4.0; ui_step = 0.1;
-> = 1.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_Reflections(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float3 color = tex2D(BackBuffer, uv).rgb;
-
-    float depth = uv.y - Horizon;
-    float on_floor = step(0.0, depth);
-    float span = max(1.0 - Horizon, 0.001);
-    float distance_down = saturate(depth / span);
-
-    float seconds = Timer * 0.001;
-    float wave = sin(uv.x * 38.0 + seconds * RippleSpeed * 2.0) *
-                 sin(uv.y * 21.0 - seconds * RippleSpeed * 1.3);
-    float2 disturbance = float2(wave * 0.004, wave * 0.002) * Ripple * distance_down;
-
-    float2 mirrored = float2(uv.x, Horizon - depth * Perspective) + disturbance;
-    float3 reflection = tex2D(BackBuffer, saturate(mirrored)).rgb;
-
-    float fade = pow(max(1.0 - distance_down, 0.0001), Falloff);
-    float strength = Amount * fade * on_floor;
-
-    return float4(lerp(color, reflection, strength), 1.0);
-}
-
-technique Reflections <
-    ui_label = "Reflections";
-    ui_tooltip = "Mirrors the picture into a reflective floor below a line you choose, with optional water ripples.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_Reflections;
-    }
-}
@@ -1,66 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-// SPDX-FileCopyrightText: Copyright 2012 PPSSPP Project
-// SPDX-License-Identifier: GPL-2.0-or-later
-// Ported from scanlines.fsh in PPSSPP.
-
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Density <
-    ui_type = "slider";
-    ui_label = "Line Density";
-    ui_tooltip = "Number of scanline pairs across the screen.";
-    ui_min = 60.0; ui_max = 720.0; ui_step = 10.0;
-> = 340.0;
-
-uniform float Intensity <
-    ui_type = "slider";
-    ui_label = "Intensity";
-    ui_tooltip = "How dark the gaps between lines become.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 0.5;
-
-uniform float Tint <
-    ui_type = "slider";
-    ui_label = "Phosphor Tint";
-    ui_tooltip = "Strength of the green-warm phosphor cast.";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.05;
-> = 1.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_Scanlines(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float line_pos = uv.y * Density * 0.5;
-    float gate = cos((frac(line_pos) - 0.5) * 3.1415926 * Intensity) * 1.5;
-
-    float3 rgb = tex2D(BackBuffer, uv).rgb;
-    float3 color = rgb * 0.5 + 0.5 * rgb * rgb * 1.2;
-
-    float3 phosphor = lerp(float3(1.0, 1.0, 1.0), float3(0.9, 1.0, 0.7), Tint);
-    color *= phosphor;
-
-    float2 diff = uv - 0.5;
-    color *= 1.1 - 0.6 * (dot(diff, diff) * 2.0);
-
-    return float4(saturate(color * saturate(gate)), 1.0);
-}
-
-technique Scanlines <
-    ui_label = "Scanlines";
-    ui_tooltip = "Darkens alternating rows of pixels to imitate the horizontal scanlines of a CRT. Cheaper than the full CRT effect when you only want the lines.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_Scanlines;
-    }
-}
@@ -1,43 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Amount <
-    ui_type = "slider";
-    ui_label = "Amount";
-    ui_min = 0.0; ui_max = 3.0; ui_step = 0.01;
-> = 0.6;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_Sharpen(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float2 texel = float2(BUFFER_RCP_WIDTH, BUFFER_RCP_HEIGHT);
-
-    float3 centre = tex2D(BackBuffer, uv).rgb;
-    float3 blur = tex2D(BackBuffer, uv + float2(-texel.x, 0.0)).rgb;
-    blur += tex2D(BackBuffer, uv + float2(texel.x, 0.0)).rgb;
-    blur += tex2D(BackBuffer, uv + float2(0.0, -texel.y)).rgb;
-    blur += tex2D(BackBuffer, uv + float2(0.0, texel.y)).rgb;
-    blur *= 0.25;
-
-    return float4(centre + (centre - blur) * Amount, 1.0);
-}
-
-technique Sharpen <
-    ui_label = "Sharpen";
-    ui_tooltip = "Unsharp mask that brings back edge detail lost to scaling. Most useful after upscaling a low internal resolution.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_Sharpen;
-    }
-}
@@ -1,75 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float ShadowHue <
-    ui_type = "slider";
-    ui_label = "Shadow Hue";
-    ui_min = 0.0; ui_max = 360.0; ui_step = 1.0;
-> = 210.0;
-
-uniform float ShadowStrength <
-    ui_type = "slider";
-    ui_label = "Shadow Strength";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.01;
-> = 0.0;
-
-uniform float HighlightHue <
-    ui_type = "slider";
-    ui_label = "Highlight Hue";
-    ui_min = 0.0; ui_max = 360.0; ui_step = 1.0;
-> = 45.0;
-
-uniform float HighlightStrength <
-    ui_type = "slider";
-    ui_label = "Highlight Strength";
-    ui_min = 0.0; ui_max = 1.0; ui_step = 0.01;
-> = 0.0;
-
-uniform float Balance <
-    ui_type = "slider";
-    ui_label = "Balance";
-    ui_tooltip = "Moves the split between what counts as shadow and what counts as highlight.";
-    ui_min = -0.5; ui_max = 0.5; ui_step = 0.01;
-> = 0.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float3 HueToRGB(float hue)
-{
-    float h = frac(hue / 360.0) * 6.0;
-    return saturate(float3(abs(h - 3.0) - 1.0, 2.0 - abs(h - 2.0), 2.0 - abs(h - 4.0)));
-}
-
-float4 PS_SplitToning(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float3 rgb = tex2D(BackBuffer, uv).rgb;
-
-    float luma = saturate(dot(rgb, float3(0.2126, 0.7152, 0.0722)) + Balance);
-
-    float3 shadow_tint = HueToRGB(ShadowHue) - 0.5;
-    float3 highlight_tint = HueToRGB(HighlightHue) - 0.5;
-
-    rgb += shadow_tint * ShadowStrength * 0.25 * (1.0 - luma);
-    rgb += highlight_tint * HighlightStrength * 0.25 * luma;
-
-    return float4(saturate(rgb), 1.0);
-}
-
-technique SplitToning <
-    ui_label = "Split Toning";
-    ui_tooltip = "Tints the shadows and the highlights towards two different hues.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_SplitToning;
-    }
-}
@@ -1,52 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-// SPDX-FileCopyrightText: Copyright 2012 PPSSPP Project
-// SPDX-License-Identifier: GPL-2.0-or-later
-// Ported from vignette.fsh in PPSSPP, by Henrik Rydgard.
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Strength <
-    ui_type = "slider";
-    ui_label = "Strength";
-    ui_tooltip = "How dark the corners become.";
-    ui_min = 0.0; ui_max = 2.0; ui_step = 0.01;
-> = 0.6;
-
-uniform float Aspect <
-    ui_type = "slider";
-    ui_label = "Aspect";
-    ui_min = 0.5; ui_max = 2.0; ui_step = 0.01;
-> = 1.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float4 PS_Vignette(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float2 diff = uv - 0.5;
-    diff.x *= Aspect;
-    diff.y /= max(Aspect, 0.0001);
-
-    float falloff = 1.0 - min(1.0, Strength * dot(diff, diff) * 2.0);
-    float3 rgb = tex2D(BackBuffer, uv).rgb;
-
-    return float4(rgb * falloff, 1.0);
-}
-
-technique Vignette <
-    ui_label = "Vignette";
-    ui_tooltip = "Darkens the corners of the screen to pull the eye towards the middle, the way a camera lens falls off at its edges.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_Vignette;
-    }
-}
@@ -1,76 +0,0 @@
-// SPDX-FileCopyrightText: Copyright 2026 Eden Emulator Project
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-texture BackBufferTex : COLOR;
-sampler BackBuffer { Texture = BackBufferTex; };
-
-uniform float Temperature <
-    ui_type = "slider";
-    ui_label = "Temperature";
-    ui_tooltip = "Negative cools the picture towards blue, positive warms it towards orange.";
-    ui_min = -100.0; ui_max = 100.0; ui_step = 1.0;
-> = 0.0;
-
-uniform float Tint <
-    ui_type = "slider";
-    ui_label = "Tint";
-    ui_tooltip = "Negative shifts towards green, positive towards magenta.";
-    ui_min = -100.0; ui_max = 100.0; ui_step = 1.0;
-> = 0.0;
-
-void VS_PostProcess(in uint id : SV_VertexID, out float4 pos : SV_Position, out float2 uv : TEXCOORD)
-{
-    uv = float2(float(id & 2), float((id & 1) << 1));
-    pos = float4(uv * float2(2.0, -2.0) + float2(-1.0, 1.0), 0.0, 1.0);
-}
-
-float3 WhitePointLMS(float t1, float t2)
-{
-    float shift = 0.05;
-    if (t1 < 0.0)
-    {
-        shift = 0.10;
-    }
-    float x = 0.31271 - t1 * shift;
-    float y = 2.87 * x - 3.0 * x * x - 0.27509507 + t2 * 0.05;
-
-    float big_y = 1.0;
-    float big_x = big_y * x / y;
-    float big_z = big_y * (1.0 - x - y) / y;
-
-    return float3( 0.7328 * big_x + 0.4296 * big_y - 0.1624 * big_z,
-                  -0.7036 * big_x + 1.6975 * big_y + 0.0061 * big_z,
-                   0.0030 * big_x + 0.0136 * big_y + 0.9834 * big_z);
-}
-
-float4 PS_WhiteBalance(float4 pos : SV_Position, float2 uv : TEXCOORD) : SV_Target
-{
-    float3 rgb = pow(max(tex2D(BackBuffer, uv).rgb, 0.0), 2.2);
-
-    float3 balance = float3(0.949237, 1.03542, 1.08728) /
-                     WhitePointLMS(Temperature / 65.0, Tint / 65.0);
-
-    const float3x3 rgb_to_lms = float3x3(0.390405, 0.549941, 0.008926,
-                                         0.070841, 0.963172, 0.001358,
-                                         0.023108, 0.128021, 0.936245);
-    const float3x3 lms_to_rgb = float3x3( 2.858470, -1.628790, -0.024891,
-                                         -0.210182,  1.158200,  0.000324,
-                                         -0.041812, -0.118169,  1.068670);
-
-    float3 lms = mul(rgb_to_lms, rgb) * balance;
-    rgb = mul(lms_to_rgb, lms);
-
-    return float4(saturate(pow(max(rgb, 0.0), 1.0 / 2.2)), 1.0);
-}
-
-technique WhiteBalance <
-    ui_label = "White Balance";
-    ui_tooltip = "Corrects a picture that looks too cool, too warm or tinted.";
->
-{
-    pass
-    {
-        VertexShader = VS_PostProcess;
-        PixelShader = PS_WhiteBalance;
-    }
-}
@@ -509,8 +509,6 @@ QWidget#contentRichDialog QLabel#label_title_rich {
 }

 QWidget#contentDialog QLabel#label_dialog {
-    background: #2E2E2E;
-
    padding: 20px 65px;
 }

@@ -5,15 +5,6 @@

 This is a full-fledged guide to build Eden on all supported platforms.

-If you already have a development environment set up:
-
-```sh
-cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -G Ninja
-cmake --build build
-```
-
-On Linux, macOS, and MinGW/MSYS2, make sure to read the [dependencies guide](Deps.md). On Android, read its [dedicated page](build/Android.md).
-
 ## Dependencies

 First, you must [install some dependencies](Deps.md).
@@ -134,13 +125,13 @@ cmake -S . -B build -G "<GENERATOR>" -DCMAKE_C_COMPILER=clang-cl -DCMAKE_CXX_COM

 <img src="https://user-images.githubusercontent.com/42481638/216899164-6cee8482-3d59-428f-b1bc-e6dc793c9b20.png" width="500">

- Click OK; now CLion will build a directory and index your code to allow for IntelliSense. Please be patient.
- Once this process has been completed (No loading bar bottom right), you can now build Eden
- In the top right, click on the drop-down menu, select all configurations, then select Eden
+- Click OK; now Clion will build a directory and index your code to allow for IntelliSense. Please be patient.
+- Once this process has been completed (No loading bar bottom right), you can now build eden
+- In the top right, click on the drop-down menu, select all configurations, then select eden

 <img src="https://user-images.githubusercontent.com/42481638/216899226-975048e9-bc6d-4ec1-bc2d-bd8a1e15ed04.png" height="500" >

- Now run by clicking the play button or pressing Shift+F10, and Eden will auto-launch once built.
+- Now run by clicking the play button or pressing Shift+F10, and eden will auto-launch once built.

 <img src="https://user-images.githubusercontent.com/42481638/216899275-d514ec6a-e563-470e-81e2-3e04f0429b68.png" width="500">
 </details>
@@ -162,7 +153,7 @@ If your initial configure failed:
 - *Carefully* re-read the [dependencies guide](Deps.md)
 - Clear the CPM cache (`.cache/cpm`) and CMake cache (`<build directory>/CMakeCache.txt`)
 - Evaluate the error and find any related settings
- See the [CPM docs](CPMUtil.md) to see if you may need to forcefully bundle any packages
+- See the [CPM docs](CPM.md) to see if you may need to forcefully bundle any packages

 Otherwise, feel free to ask for help in Stoat or Discord.

@@ -12,6 +12,10 @@
 - [NetBSD](#netbsd)
 - [MSYS2](#msys2)
 - [RedoxOS](#redoxos)
+- [Windows](#windows)
+  - [Windows 7, Windows 8 and Windows 8.1](#windows-7-windows-8-and-windows-81)
+  - [Windows Vista and below](#windows-vista-and-below)
+  - [Windows on ARM](#windows-on-arm)
 <!-- /TOC -->

 ## Arch Linux
@@ -67,7 +71,7 @@ export LIBGL_ALWAYS_SOFTWARE=1

 Install `developer/gcc14` on OmniOS using pkgsrc.

-Since so many dependencies are missing on `OmniOS`, you may wish to use `-DCPMUTIL_FORCE_BUNDLED=ON` and `-DYUZU_USE_BUNDLED_OPENSSL=OFF`.
+Since so many dependencies are missing on `OmniOS`, you may wish to use `-DCPMUTIL_FORCE_BUNDLED=ON`

 For OmniOS you are required to build glslang yourself:
 ```sh
@@ -82,13 +86,11 @@ cmake --install build

 It may be tempting to specify `-t glslang`, but this will cause installation to fail. So don't.

-Using `--parallel` on CMake incorrectly passes `dmake ... -jn` instead of `dmake ... -j n`, this is a bug with OmniOS's CMake, it's recommended to not use this option until it's fixed.
+Using `--parallel` on CMake incorrectly passes `dmake ... -jn` instead of `dmake ... -j n`, this is a bug with OmniOS's CMake, and as such it's recommended to not use this option until it's fixed.

 You may also need to install `gmake` in order to properly build FFmpeg, this is provided by the `build-essential` package.

-If it wasn't obvious already, you require a X11 server to properly run the emulator within OmniOS, [this guide](https://web.archive.org/web/20260424200928/https://geekblood.wordpress.com/2017/10/26/installing-x11-and-a-desktop-environment-on-omnios/) is a great starting point for that, the links to pkgsrc are outdated so follow [this exemplar](https://pkgsrc.smartos.org/install-on-illumos/) as well.
-
-For Solaris based OSes, `${CMAKE_SYSTEM_NAME}` isn't properly set on CMake (it's set to i686 on AMD64), you may find issues when building OpenSSL from `openssl-cmake`.
+If it wasn't obvious already, you require a X11 server to properly run the emulator within OmniOS, [this guide](https://web.archive.org/web/20260424200928/https://geekblood.wordpress.com/2017/10/26/installing-x11-and-a-desktop-environment-on-omnios/) is a great starting point for that, the links to pkgsrc are outdated so follow [this exemplar](https://pkgsrc.smartos.org/install-on-illumos/) as well:

 ## HaikuOS

@@ -242,3 +244,19 @@ find ./*/ -name "*.dll" | while read -r dll; do deps "$dll"; done
 The package install may randomly hang at times, in which case it has to be restarted. ALWAYS do a `sudo pkg update` or the chances of it hanging will be close to 90%. If "multiple" installs fail at once, try installing 1 by 1 the packages.

 When CMake invokes certain file syscalls - it may sometimes cause crashes or corruptions on the (kernel?) address space - so reboot the system if there is a "hang" in CMake.
+
+## Windows
+
+### Windows 7, Windows 8 and Windows 8.1
+
+DirectX 12 is not available - simply copy and paste a random DLL and name it `d3d12.dll`.
+
+Install [Qt6 compatibility libraries](github.com/ANightly/qt6windows7) specifically Qt 6.9.5.
+
+### Windows Vista and below
+
+No support for Windows Vista (or below) is present at the moment. Check back later.
+
+### Windows on ARM
+
+If you're using Snapdragon X or 8CX, use the [the Vulkan translation layer](https://apps.microsoft.com/detail/9nqpsl29bfff?hl=en-us&gl=USE) only if the stock drivers do not work. And of course always keep your system up-to-date.
@@ -6,7 +6,7 @@ When reporting issues or finding bugs, we often need backtraces, debug logs, or

 ### Graphics Debugging

-If your bug is related to a graphical issue -- e.g. mismatched colors, vertex explosions, flickering, etc. -- then you are required to include graphical debugging logs in your issue reports.
+If your bug is related to a graphical issue--e.g. mismatched colors, vertex explosions, flickering, etc.--then you are required to include graphical debugging logs in your issue reports.

 Graphics Debugging is found in General -> Debug on desktop, and Advanced Settings -> Debug on Android. Android users are all set; however, desktop users may need to install the Vulkan Validation Layers:

@@ -17,7 +17,7 @@ Once Graphics Debugging is enabled, run the problematic game again and continue.

 ### Debug Logs

-Debug logs can be found in `General -> Debug -> Open Log Location` on desktop, and `Share Debug Logs` on Android. This MUST be included in all bug reports, except for certain UI bugs -- but we still highly recommend them even for UI bugs.
+Debug logs can be found in General -> Debug -> Open Log Location on desktop, and Share Debug Logs on Android. This MUST be included in all bug reports, except for certain UI bugs--but we still highly recommend them even for UI bugs.

 ## Debugging (host code)

@@ -38,7 +38,7 @@ You must have GDB installed for aarch64 to debug the target. Install it through
  - `sudo emerge --ask crossdev`
  - `sudo crossdev -t aarch64-unknown-linux-gnu --ex-gdb`

-Run `./build/bin/eden-cli -c <path to your config file (see logs where you run Eden normally to see where it is)> -d -g <path to game>`, or `Enable GDB Stub` at General > Debug, then hook up an aarch64-gdb:
+Run `./build/bin/eden-cli -c <path to your config file (see logs where you run eden normally to see where it is)> -d -g <path to game>`, or `Enable GDB Stub` at General > Debug, then hook up an aarch64-gdb:

 - `target remote localhost:6543`

@@ -69,55 +69,6 @@ Expressions can be `variable_names` or `1234` (numbers) or `*var` (dereference o

 For more information type `info gdb` and read [the man page](https://man7.org/linux/man-pages/man1/gdb.1.html).

-# RenderDoc
+# RenderDoc (Graphic Debugging Tool)

-RenderDoc is a free, cross platform, multi-graphics API debugger. It is an invaluable tool for diagnosing issues with graphics applications, and includes support for Vulkan. Get it from [renderdoc.org](https://renderdoc.org).
-
-RenderDoc can capture Eden's Vulkan output when its Vulkan layer is loaded before Eden creates the Vulkan device. Before using RenderDoc to diagnose issues, it's always good to make sure there are no validation errors. Any errors means the behavior of the application is undefined. That said, RenderDoc can help debug validation errors if you do have them.
-
-## Usage on Windows 
-
-You can either use RenderDoc UI to launch Eden, or you can make Eden attach it internally:
-
-On Windows PowerShell:
-```powershell
-$env:ENABLE_VULKAN_RENDERDOC_CAPTURE='1'
-.\eden.exe
-```
-When RenderDoc is attached, Eden logs the default Windows capture folder:
-```text
-%LOCALAPPDATA%\Temp\RenderDoc
-```
-
-Press RenderDoc's capture hotkey, usually `F12`, to capture a frame. To stop using RenderDoc, close Eden and launch it again without `ENABLE_VULKAN_RENDERDOC_CAPTURE`.
-
-## Eden Hotkey
-
-Eden also has a separate `Toggle Renderdoc Capture` hotkey behind the debug setting `renderdoc_hotkey`.
-That hotkey does not load or unload RenderDoc. It only toggles Eden's own manual capture through RenderDoc's API:
-
- First press: Starts a capture
- Second press: Ends that capture
-
-## Simple checklist for debugging black screens using Renderdoc
-
-When debugging a black screen, there are many ways the application could have setup Vulkan wrong.
-Here is a short checklist of items to look at to make sure are appropriate:
-
- Draw call counts are correct (aka not zero, or if rendering many triangles, not 3)
- Vertex buffers are bound
- vertex attributes are correct - Make sure the size & offset of each attribute matches what should it should be
- Any bound push constants and descriptors have the right data - including:
-  - Matrices have correct values - double check the model, view, & projection matrices are uploaded correctly
- Pipeline state is correct
-  - viewport range is correct - x,y are 0,0; width & height are screen dimensions, minDepth is 0, maxDepth is 1, NDCDepthRange is 0,1
-  - Fill mode matches expected - usually solid
-  - Culling mode makes sense - commonly back or none
-  - The winding direction is correct - typically CCW (counter clockwise)
-  - Scissor region is correct - usually same as viewport's x,y,width, &height
- Blend state is correct
- Depth state is correct - typically enabled with Function set to Less than or Equal
- Swapchain images are bound when rendering to the swapchain
- Image being rendered to is the same as the one being presented when rendering to the swapchain
-
-Alternatively, a [RenderDoc Extension](https://github.com/baldurk/renderdoc-contrib/tree/main/baldurk/whereismydraw) ([Archive](https://web.archive.org/web/20250000000000*/https://github.com/baldurk/renderdoc-contrib/tree/main/baldurk/whereismydraw)) exists which automates doing a lot of these manual steps.
+Guidelines for graphical debugging using RenderDoc: **[RenderDoc usage](./RenderDoc.md)**
@@ -80,6 +80,7 @@ Certain other dependencies will be fetched by CPM regardless. System packages *c
 * [httplib](https://github.com/yhirose/cpp-httplib) - if `ENABLE_UPDATE_CHECKER` or `ENABLE_WEB_SERVICE` are on
  * This package is known to be broken on the AUR.
 * [cpp-jwt](https://github.com/arun11299/cpp-jwt) 1.4+ - if `ENABLE_WEB_SERVICE` is on
+* [unordered-dense](https://github.com/martinus/unordered_dense)

 On amd64:

@@ -118,7 +119,7 @@ Now, install all deps:
 sudo emerge -a \
    app-arch/lz4 app-arch/zstd app-arch/unzip \
    dev-libs/libfmt dev-libs/libusb dev-libs/mcl dev-libs/sirit \
-    dev-libs/boost dev-libs/openssl dev-libs/discord-rpc \
+    dev-libs/unordered_dense dev-libs/boost dev-libs/openssl dev-libs/discord-rpc \
    dev-util/spirv-tools dev-util/spirv-headers dev-util/vulkan-headers \
    dev-util/vulkan-utility-libraries dev-util/glslang \
    media-gfx/renderdoc media-libs/libva media-libs/opus media-video/ffmpeg \
@@ -259,10 +260,7 @@ brew install molten-vk
 <details>
 <summary>FreeBSD</summary>

-As root run:
-```sh
-pkg install devel/cmake devel/sdl3 devel/boost-libs devel/catch2 devel/libfmt devel/nlohmann-json devel/ninja devel/nasm devel/autoconf devel/pkgconf devel/qt6-base x11-toolkits/qt6-charts devel/simpleini net/enet multimedia/ffnvcodec-headers multimedia/ffmpeg audio/opus archivers/liblz4 lang/gcc12 graphics/glslang graphics/vulkan-utility-libraries graphics/spirv-tools www/cpp-httplib graphics/vulkan-utility-libraries graphics/vulkan-headers graphics/spirv-headers quazip-qt6
-```
+As root run: `pkg install devel/cmake sdl3 devel/boost-libs devel/catch2 devel/libfmt devel/nlohmann-json devel/ninja devel/nasm devel/autoconf devel/pkgconf devel/qt6-base devel/qt6-charts devel/simpleini net/enet multimedia/ffnvcodec-headers multimedia/ffmpeg audio/opus archivers/liblz4 lang/gcc12 graphics/glslang graphics/vulkan-utility-libraries graphics/spirv-tools www/cpp-httplib devel/unordered-dense vulkan-headers quazip-qt6`

 If using FreeBSD 12 or prior, use `devel/pkg-config` instead.

@@ -275,7 +273,7 @@ If using FreeBSD 12 or prior, use `devel/pkg-config` instead.
 For NetBSD +10.1:

 ```sh
-pkgin install git cmake boost fmtlib SDL3 catch2 libjwt spirv-headers spirv-tools ffmpeg7 libva nlohmann-json jq libopus qt6-qtbase qt6-qtcharts qt6-qtmultimedia qt6-qttools cpp-httplib lz4 vulkan-headers nasm autoconf enet pkg-config libusb1 libcxx frozen
+pkgin install git cmake boost fmtlib SDL3 catch2 libjwt spirv-headers spirv-tools ffmpeg7 libva nlohmann-json jq libopus qt6 cpp-httplib lz4 vulkan-headers nasm autoconf enet pkg-config libusb1 libcxx frozen
 ```

 [Caveats](./Caveats.md#netbsd).
@@ -296,7 +294,7 @@ pkg_add cmake nasm git boost unzip--iconv autoconf-2.72p0 bash ffmpeg glslang gm
 <summary>DragonFlyBSD</summary>

 ```sh
-pkg install gcc14 git cmake unzip nasm autoconf bash pkgconf ffmpeg glslang gmake jq nlohmann-json enet spirv-tools sdl3 vulkan-utility-libraries vulkan-headers catch2 libfmt openssl liblz4 boost-libs cpp-httplib qt6-base qt6-charts quazip-qt6 libva-vdpau-driver libva-utils libva-intel-driver
+pkg install gcc14 git cmake unzip nasm autoconf bash pkgconf ffmpeg glslang gmake jq nlohmann-json enet spirv-tools sdl3 vulkan-utility-libraries vulkan-headers catch2 libfmt openssl liblz4 boost-libs cpp-httplib qt6-base qt6-charts quazip-qt6 unordered-dense libva-vdpau-driver libva-utils libva-intel-driver
 ```

 [Caveats](./Caveats.md#dragonflybsd).
@@ -330,7 +328,7 @@ sudo pkgin install git cmake autoconf build-essential libusb-1 nasm gcc13

 ```sh
 BASE="git make autoconf libtool automake-wrapper jq patch"
-MINGW="qt6-base qt6-charts qt6-tools qt6-translations qt6-svg cmake toolchain clang python-pip openssl vulkan-memory-allocator vulkan-devel glslang boost fmt lz4 nlohmann-json zlib zstd enet opus libusb openssl SDL3"
+MINGW="qt6-base qt6-charts qt6-tools qt6-translations qt6-svg cmake toolchain clang python-pip openssl vulkan-memory-allocator vulkan-devel glslang boost fmt lz4 nlohmann-json zlib zstd enet opus libusb unordered_dense openssl SDL3"
 # Either x86_64 or clang-aarch64 (Windows on ARM)
 packages="$BASE"
 for pkg in $MINGW; do
@@ -1,47 +0,0 @@
-# Design Overview
-
-Modern game consoles require heavy power to be emulated appropriately. This is why the emulator uses an approach known as HLE (High-Level-Emulation), in a nutshell: Instead of accurately emulating every subsystem that forms part of a component, emulate the resulting visible I/O interface instead.
-
-For example, take a disk write, instead of emulating a proper SD card we instead use the C++ standard library for I/O. Additionally we use the abstractions provided by the `fs` service to "lie" to programs about certain SD card properties. Notably this includes making up sizes for the fake SD card, giving "realistic" values or expected outputs for a given card, and so on. And instead of writing to an actual SD card, the emulator simply writes to a file.
-
-This also means grand part of the emulator consists of just re-implementing firmware but using HLE primitives; for example audio doesn't go to an emulated audio device, but rather gets processed on the fly by a dedicated service and then passed to SDL3/cubeb/etc.
-
-As such, many of the systems implemented are not 100% accurate to the original software, but they're "good enough" to pass as being so. While we do strive to maintain high compatibility (especially with homebrew), there are realistic limitations to these approaches.
-
-No formal fuzzing or formal verification has been done on the emulator as a whole, this means there may be hundreds of bugs hiding in each subsystem. As such, output may also not correctly match due to those aforementioned issues.
-
-## src/android/
-
-Entire Android frontend, written mostly in Kotlin and generally having asinine hacks (thanks Android) due to the particularly horrific (and particular way) to do things.
-
-## src/audio_core/
-
-Handles everything related to audio, this is where most of the filtering and processing occurs (CPU intensive task!).
-
-## src/common/
-
-The [common](../src/common) folder contains just your basic polyfills for whatever missing functionality. We heavily encourage new PRs to make use of one of the dependencies, or the standard C++ library. Minimizing the amount of things we reinvent the wheel for is always a good thing.
-
-## src/core/
-
-The [core folder](../src/core) is the main heart of the emulator, while we don't officially support having other frontends out of the box (RetroArch, for example); any prospective developer can reuse this library (compiled as one by CMake) to stitch up their own RetroArch core, for example.
-
-## src/dynarmic/
-
-See [Dynarmic](./dynarmic).
-
-## src/hid_core/
-
-Input, joysticks, controllers and everything related to input devices.
-
-## src/shader_recompiler/
-
-Dedicated shader recompiler to translate Maxwell assembly code to either SPIR-V, GLSL or GLASM.
-
-## src/video_core/
-
-Most of the things here have their own dedicated section. In short this is basically the entire Tegra NVIDIA Maxwell GPU emulation. Additionally it includes some [extra effects](../src/video_core/host_shaders/opengl_smaa.glsl) to emulate MSAA, D24 copies or as polyfill.
-
-Available backends are: Null, Vulkan, and OpenGL.
-
-See [NVIDIA GPU](./NvidiaGpu.md).
@@ -91,7 +91,7 @@ You may additionally need the `Qt Extension Pack` extension if building Qt.

 # Build speedup

-If you have an HDD, use ramdisk (build in RAM), approximately you need 4GB for a full build with debug symbols:
+If you have an HDD, use ramdisk (build in RAM), approximatedly you need 4GB for a full build with debug symbols:

 ```sh
 mkdir /tmp/ramdisk
@@ -110,7 +110,7 @@ A general rule of thumb, before uploading files:
 - PNG files: Use [optipng](https://web.archive.org/web/20240325055059/https://optipng.sourceforge.net/).
 - SVG files: Use [svgo](https://github.com/svg/svgo).

-May not be used but worth mentioning nonetheless:
+May not be used but worth mentioning nonethless:

 - OGG files: Use [OptiVorbis](https://github.com/OptiVorbis/OptiVorbis).
 - Video files: Use ffmpeg, preferably re-encode as AV1.
@@ -76,7 +76,7 @@ The following options are desktop only.

 - `ENABLE_LIBUSB` (ON) Enable the use of the libusb input backend (HIGHLY RECOMMENDED)
 - `ENABLE_OPENGL` (ON) Enable the OpenGL graphics backend
-  - Unavailable on Windows/ARM64 and on Android
+  - Unavailable on Windows/ARM64
  - You probably shouldn't turn this off.

 ### Qt
@@ -2,9 +2,9 @@

 Are you just a casual user? Take a look at our [User Handbook](./user) then!

-If you want to register/signup as a contributor, take a gander at [CONTRIBUTING.md](../CONTRIBUTING.md).
+If you want to register/signup as a contributor, take a gander at the [signup guide](./SIGNUP.md).

-This contains documentation created by developers, build instructions, guidelines, instructions/layouts for [cool stuff we made](./CPMUtil.md), and more.
+This contains documentation created by developers. This contains build instructions, guidelines, instructions/layouts for [cool stuff we made](./CPMUtil), and more.

 - **[General Build Instructions](./Build.md)**
 - **[CMake Options](./Options.md)**
@@ -12,14 +12,14 @@ This contains documentation created by developers, build instructions, guideline
 - **[Development Guidelines](./Development.md)**
 - **[Dependencies](./Deps.md)**
 - **[Debug Guidelines](./Debug.md)**
-  - **[RenderDoc](./Debug.md#renderdoc)**
- **[CPM - CMake Package Manager](./CPMUtil.md)**
+- **[RenderDoc usage](./RenderDoc.md)**
+- **[CPM - CMake Package Manager](./CPMUtil)**
 - **[Platform-Specific Caveats](./Caveats.md)**
 - **[The NVIDIA SM86 (Maxwell) GPU](./NvidiaGpu.md)**
+- **[Cross compilation](./CrossCompile.md)**
 - **[Driver Bugs](./DriverBugs.md)**
 - **[Building Older Commits](./build/OlderCommits.md)**
 - Subsystems:
-  - **[Design Overview](./DesignOverview.md)**
  - **[Dynarmic](./dynarmic/README.md)**
  - **[HOS Kernel](./HosKernel.md)**
  - **[Settings](./Settings.md)**
@@ -0,0 +1,52 @@
+# RenderDoc
+
+Renderdoc is a free, cross platform, multi-graphics API debugger. It is an invaluable tool for diagnosing issues with graphics applications, and includes support for Vulkan. Get it at [renderdoc.org](https://renderdoc.org).
+
+RenderDoc can capture Eden's Vulkan output when its Vulkan layer is loaded before Eden creates the Vulkan device. Before using renderdoc to diagnose issues, it is always good to make sure there are no validation errors. Any errors means the behavior of the application is undefined. That said, renderdoc can help debug validation errors if you do have them.
+
+## Usage on Windows 
+
+You can either use RenderDoc UI to launch eden, or you can make eden attach it internally:
+
+On Windows PowerShell:
+```powershell
+$env:ENABLE_VULKAN_RENDERDOC_CAPTURE='1'
+.\eden.exe
+```
+When RenderDoc is attached, Eden logs the default Windows capture folder:
+```text
+%LOCALAPPDATA%\Temp\RenderDoc
+```
+
+Press RenderDoc's capture hotkey, usually `F12`, to capture a frame. To stop using RenderDoc, close Eden and launch it again without `ENABLE_VULKAN_RENDERDOC_CAPTURE`.
+
+## Eden Hotkey
+
+Eden also has a separate `Toggle Renderdoc Capture` hotkey behind the debug setting `renderdoc_hotkey`.
+That hotkey does not load or unload RenderDoc. It only toggles Eden's own manual capture through RenderDoc's API:
+
+- first press: starts a capture
+- second press: ends that capture
+
+## Simple checklist for debugging black screens using Renderdoc
+
+When debugging a black screen, there are many ways the application could have setup Vulkan wrong.
+Here is a short checklist of items to look at to make sure are appropriate:
+
+- Draw call counts are correct (aka not zero, or if rendering many triangles, not 3)
+- Vertex buffers are bound
+- vertex attributes are correct - Make sure the size & offset of each attribute matches what should it should be
+- Any bound push constants and descriptors have the right data - including:
+  - Matrices have correct values - double check the model, view, & projection matrices are uploaded correctly
+- Pipeline state is correct
+  - viewport range is correct - x,y are 0,0; width & height are screen dimensions, minDepth is 0, maxDepth is 1, NDCDepthRange is 0,1
+  - Fill mode matches expected - usually solid
+  - Culling mode makes sense - commonly back or none
+  - The winding direction is correct - typically CCW (counter clockwise)
+  - Scissor region is correct - usually same as viewport's x,y,width, &height
+- Blend state is correct
+- Depth state is correct - typically enabled with Function set to Less than or Equal
+- Swapchain images are bound when rendering to the swapchain
+- Image being rendered to is the same as the one being presented when rendering to the swapchain
+
+Alternatively, a [RenderDoc Extension](https://github.com/baldurk/renderdoc-contrib/tree/main/baldurk/whereismydraw) ([Archive](https://web.archive.org/web/20250000000000*/https://github.com/baldurk/renderdoc-contrib/tree/main/baldurk/whereismydraw)) exists which automates doing a lot of these manual steps.
@@ -1,11 +1,11 @@
 # Settings

 > [!WARNING]
-> This guide is intended for developers ONLY. If you're looking for configuring the emulator itself, read **[the user handbook](./user/README.md)**.
+> This guide is intended for developers ONLY. If you're looking for configuring the emulator itself, please read **[the user handbook](./user/README.md)**.

 Settings on the emulator are very important, toggles and such can be used to guard and/or add branches to paths where some games may crash while others won't, and viceversa.

-However, this process can be tedious for those unfamiliar; this document serves as an outline/documentation for the settings subsystem.
+However, this process can be tedious for those unfamiliar; this document serves as a outline/documentation for the settings subsystem.

 ## Index

@@ -43,7 +43,6 @@ This guide will walk you through adding a new boolean toggle setting to Eden's c
 Firstly add your desired toggle:

 Example: `src/common/setting.h`
-
 ```cpp
 SwitchableSetting<bool> your_setting_name{linkage, false, "your_setting_name", Category::RendererExtensions};
 ```
@@ -68,7 +67,6 @@ Common Categories:
 Add the toggle to the Qt UI, where you wish for it to appear and place it there.

 Example: `src/qt_common/config/shared_translation.cpp`
-
 ```cpp
 INSERT(Settings,
       your_setting_name,
@@ -80,7 +78,7 @@ INSERT(Settings,

 #### Make sure to:

-* Keep display naming consistent
+* Keep display naming consistant
 * Put detailed info in the description
 * Use `\n` for line breaks in descriptions

@@ -93,7 +91,6 @@ INSERT(Settings,
 Add where it should be in the settings.

 Example: `src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/model/BooleanSetting.kt`
-
 ```kts
 RENDERER_YOUR_SETTING_NAME("your_setting_name"),
 ```
@@ -109,7 +106,6 @@ RENDERER_YOUR_SETTING_NAME("your_setting_name"),
 Add the toggle to the Kotlin (Android) UI

 Example: `src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/model/view/SettingsItem.kt`
-
 ```kts
 put(
    SwitchSetting(
@@ -127,7 +123,6 @@ put(
 Add your setting within the right category.

 Example: `src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/ui/SettingsFragmentPresenter.kt`
-
 ```kts
 add(BooleanSetting.RENDERER_YOUR_SETTING_NAME.key)
 ```
@@ -142,7 +137,6 @@ add(BooleanSetting.RENDERER_YOUR_SETTING_NAME.key)
 Add your setting and description in the appropriate place.

 Example: `src/android/app/src/main/res/values/strings.xml`
-
 ```xml
 <string name="your_setting_name">Your Setting Display Name</string>
 <string name="your_setting_name_description">Detailed description of what this setting does. Explain any caveats, requirements, or warnings here.</string>
@@ -156,7 +150,6 @@ Now the UI part is done find a place in the code for the toggle,
 And use it to your heart's desire!

 Example:
-
 ```cpp
 const bool your_value = Settings::values.your_setting_name.GetValue();

@@ -191,7 +184,7 @@ The setting ranges from 0 to 65535 (0x0000 to 0xFFFF), where each bit represents

 ### Advantages

-The main advantage is to avoid deploying new disposable toggles (those made only for testing stage, and are disposed once new feature gets good to merge). This empowers devs to be free of all frontend bureaucracy and hassle of new toggles.
+The main advantage is to avoid deploying new disposable toggles (those made only for testing stage, and are disposed once new feature gets good to merge). This empowers devs to be free of all frontend burocracy and hassle of new toggles.

 Common advantages recap:

@@ -203,31 +196,25 @@ Common advantages recap:

 #### Accessing Debug Knobs (dev side)

-Use the `Settings::GetDebugKnobAt(u8 i)` function to check if a specific bit is set:
+Use the `Settings::getDebugKnobAt(u8 i)` function to check if a specific bit is set:

 ```cpp
 //cpp side
 #include "common/settings.h"

-//To use it as a general purpose uint var:
-unsigned int debug_knobs = Settings::values.debug_knobs.GetValue();
-
 // Check if bit 0 is set
-bool feature_enabled = Settings::GetDebugKnobAt(0);
+bool feature_enabled = Settings::getDebugKnobAt(0);

 // Check if bit 15 is set
-bool another_feature = Settings::GetDebugKnobAt(15);
+bool another_feature = Settings::getDebugKnobAt(15);
 ```

 ```kts
 //kotlin side
 import org.yuzu.yuzu_emu.features.settings.model.Settings

-//To use it as a general purpose uint var
-val debug_knobs: Int = UShortSetting.DEBUG_KNOBS.getInt()
-
 // Check if bit x is set
-bool feature_enabled = Settings.GetDebugKnobAt(x); //x as integer from 0 to 15
+bool feature_enabled = Settings.getDebugKnobAt(x); //x as integer from 0 to 15
 ```

 The function returns `true` if the specified bit (0-15) is set in the `debug_knobs` value, `false` otherwise.
@@ -260,7 +247,6 @@ There are two main confusions when talking about knobs:
 Sometimes when an user reports: knobs 1 and 2 gets better performance, dev may get confuse whether he means the knobs 1 and 2 literally, or the 1st and 2nd knobs (knobs 0 and 1).

 Debug knobs are **zero-based**, which means:
-
 * The first knob is the knob(0) (or knob0 henceforth), and the last one is the 15 (knob15, likewise)
 * You can talk: "knob0 is enabled/disabled", "In this video i was using only knobs 0 and 2", etc.

@@ -273,7 +259,6 @@ Whenever you're instructing tests or reporting results, be precise about whether

 ALWAYS use the word in PLURAL (knobs), without mentioning which one, to refer to the setting, aka multiple knobs at once:
 Examples:
-
 - **knobs=0**: no knobs enabled
 - **knobs=1**: knob0 enabled, others disabled
 - **knobs=2**: knob1 enabled, others disabled
@@ -285,7 +270,6 @@ Examples:

 Use the word in SINGULAR (knob), or in plural but referring which ones, when meaning multiple knobs at once:
 Examples:
-
 - **knob0**: knob 0 enabled, others disabled
 - **knob1**: knob 1 enabled, others disabled
 - **knobs 0 and 1**: knobs 0 and 1 enabled, others disabled
@@ -298,12 +282,12 @@ Examples:

 ```cpp
 void SomeFunction() {
-    if (Settings::GetDebugKnobAt(0)) {
+    if (Settings::getDebugKnobAt(0)) {
        LOG_DEBUG(Common, "Debug feature 0 is enabled");
        // Additional debug code here
    }
-  
-    if (Settings::GetDebugKnobAt(1)) {
+    
+    if (Settings::getDebugKnobAt(1)) {
        LOG_DEBUG(Common, "Debug feature 1 is enabled");
        // Different debug behavior
    }
@@ -315,7 +299,7 @@ void SomeFunction() {
 ```cpp
 bool UseOptimizedPath() {
    // Skip optimization if debug bit 2 is set for testing
-    return !Settings::GetDebugKnobAt(2);
+    return !Settings::getDebugKnobAt(2);
 }
 ```

@@ -324,13 +308,13 @@ bool UseOptimizedPath() {
 ```cpp
 void ExperimentalFeature() {
    static constexpr u8 EXPERIMENTAL_FEATURE_BIT = 3;
-  
-    if (!Settings::GetDebugKnobAt(EXPERIMENTAL_FEATURE_BIT)) {
+    
+    if (!Settings::getDebugKnobAt(EXPERIMENTAL_FEATURE_BIT)) {
        // Fallback to stable implementation
        StableImplementation();
        return;
    }
-  
+    
    // Experimental implementation
    ExperimentalImplementation();
 }
@@ -1,44 +1,44 @@
 # Dynarmic Design Documentation

-Dynarmic is a dynamic recompiler for the ARMv6K architecture. Future plans for Dynarmic include
+Dynarmic is a dynamic recompiler for the ARMv6K architecture. Future plans for dynarmic include
 support for other versions of the ARM architecture, having a interpreter mode, and adding support
 for other architectures.

 Users of this library interact with it primarily through the interface provided in
-[`src/dynarmic/interface`](../../src/dynarmic/src/dynarmic/interface). Users specify how Dynarmic's CPU core interacts with
+[`src/dynarmic/interface`](../src/dynarmic/interface). Users specify how dynarmic's CPU core interacts with
 the rest of their system providing an implementation of the relevant `UserCallbacks` interface.
 Users setup the CPU state using member functions of `Jit`, then call `Jit::Execute` to start CPU
 execution. The callbacks defined on `UserCallbacks` may be called from dynamically generated code,
 so users of the library should not depend on the stack being in a walkable state for unwinding.

-* A32: [`Jit`](../../src/dynarmic/src/dynarmic/interface/A32/a32.h), [`UserCallbacks`](../../src/dynarmic/src/dynarmic/interface/A32/config.h)
-* A64: [`Jit`](../../src/dynarmic/src/dynarmic/interface/A64/a64.h), [`UserCallbacks`](../../src/dynarmic/src/dynarmic/interface/A64/config.h)
+* A32: [`Jit`](../src/dynarmic/interface/A32/a32.h), [`UserCallbacks`](../src/dynarmic/interface/A32/config.h)
+* A64: [`Jit`](../src/dynarmic/interface/A64/a64.h), [`UserCallbacks`](../src/dynarmic/interface/A64/config.h)

 Dynarmic reads instructions from memory by calling `UserCallbacks::MemoryReadCode`. These
 instructions then pass through several stages:

 1. Decoding (Identifying what type of instruction it is and breaking it up into fields)
 2. Translation (Generation of high-level IR from the instruction)
-3. Optimization (Elimination of redundant microinstructions, other speed improvements)
+3. Optimization (Eliminiation of redundant microinstructions, other speed improvements)
 4. Emission (Generation of host-executable code into memory)
 5. Execution (Host CPU jumps to the start of emitted code and runs it)

 Using the A32 frontend with the x64 backend as an example:

 * Decoding is done by [double dispatch](https://en.wikipedia.org/wiki/Visitor_pattern) in
-  [`src/frontend/A32/decoder/{arm.h,thumb16.h,thumb32.h}`](../../src/dynarmic/src/dynarmic/frontend/A32/decoder/).
-* Translation is done by the visitors in [`src/dynarmic/frontend/A32/translate/translate_{arm,thumb}.cpp`](../../src/dynarmic/src/dynarmic/frontend/A32/translate/).
-  The function [`Translate`](../../src/dynarmic/src/dynarmic/frontend/A32/translate/a32_translate.cpp) takes a starting memory location,
+  [`src/frontend/A32/decoder/{arm.h,thumb16.h,thumb32.h}`](../src/dynarmic/frontend/A32/decoder/).
+* Translation is done by the visitors in [`src/dynarmic/frontend/A32/translate/translate_{arm,thumb}.cpp`](../src/dynarmic/frontend/A32/translate/).
+  The function [`Translate`](../src/dynarmic/frontend/A32/translate/translate.h) takes a starting memory location,
  some CPU state, and memory reader callback and returns a basic block of IR.
-* The IR can be found under [`src/frontend/ir/`](../../src/dynarmic/src/dynarmic/ir/).
-* Optimizations can be found under [`src/ir/opt_passes.cpp`](../../src/dynarmic/src/dynarmic/ir/opt_passes.cpp).
-* Emission is done by `EmitX64` which can be found in [`src/dynarmic/backend/x64/emit_x64.{h,cpp}`](../../src/dynarmic/src/dynarmic/backend/x64/).
-* Execution is performed by calling `BlockOfCode::RunCode` in [`src/dynarmic/backend/x64/block_of_code.{h,cpp}`](../../src/dynarmic/src/dynarmic/backend/x64/).
+* The IR can be found under [`src/frontend/ir/`](../src/dynarmic/ir/).
+* Optimizations can be found under [`src/ir_opt/`](../src/dynarmic/ir/opt/).
+* Emission is done by `EmitX64` which can be found in [`src/dynarmic/backend/x64/emit_x64.{h,cpp}`](../src/dynarmic/backend/x64/).
+* Execution is performed by calling `BlockOfCode::RunCode` in [`src/dynarmic/backend/x64/block_of_code.{h,cpp}`](../src/dynarmic/backend/x64/).

 ## Decoder

 The decoder is a double dispatch decoder. Each instruction is represented by a line in the relevant
-instruction table. Here is an example line from [`arm.h`](../../src/dynarmic/src/dynarmic/frontend/A32/decoder/arm.h):
+instruction table. Here is an example line from [`arm.h`](../src/dynarmic/frontend/A32/decoder/arm.h):

    INST(&V::arm_ADC_imm,     "ADC (imm)",           "cccc0010101Snnnnddddrrrrvvvvvvvv")

@@ -61,7 +61,7 @@ error results.
 ## Translator

 The translator is a visitor that uses the decoder to decode instructions. The translator generates IR code with the
-help of the [`IREmitter` class](../../src/dynarmic/src/dynarmic/ir/ir_emitter.h). An example of a translation function follows:
+help of the [`IREmitter` class](../src/dynarmic/ir/ir_emitter.h). An example of a translation function follows:

    bool ArmTranslatorVisitor::arm_ADC_imm(Cond cond, bool S, Reg n, Reg d, int rotate, Imm8 imm8) {
        u32 imm32 = ArmExpandImm(rotate, imm8);
@@ -107,7 +107,7 @@ function analyser in the medium-term future.
 Dynarmic's intermediate representation is typed. Each microinstruction may take zero or more arguments and may
 return zero or more arguments. A subset of the microinstructions available is documented below.

-A complete list of microinstructions can be found in [src/dynarmic/ir/opcodes.inc](../../src/dynarmic/src/dynarmic/ir/opcodes.inc).
+A complete list of microinstructions can be found in [src/dynarmic/ir/opcodes.inc](../src/dynarmic/ir/opcodes.inc).

 The below lists some commonly used microinstructions.

@@ -273,7 +273,7 @@ Exclusive OR (i.e.: XOR)

 ### Callback: {Read,Write}Memory{8,16,32,64}

-```cpp
+```c++
 <u8> ReadMemory8(<u32> vaddr)
 <u8> ReadMemory16(<u32> vaddr)
 <u8> ReadMemory32(<u32> vaddr)
@@ -288,7 +288,7 @@ Memory access.

 ### Terminal: ReturnToDispatch

-```cpp
+```c++
 SetTerm(IR::Term::ReturnToDispatch{})
 ```

@@ -297,7 +297,7 @@ The dispatcher will use the value in R15 to determine what comes next.

 ### Terminal: LinkBlock

-```cpp
+```c++
 SetTerm(IR::Term::LinkBlock{next})
 ```

@@ -307,7 +307,7 @@ dispatcher, which will return control to the host.

 ### Terminal: LinkBlockFast

-```cpp
+```c++
 SetTerm(IR::Term::LinkBlockFast{next})
 ```

@@ -316,7 +316,7 @@ This promises guarantees that must be held at runtime - i.e that the program won

 ### Terminal: PopRSBHint

-```cpp
+```c++
 SetTerm(IR::Term::PopRSBHint{})
 ```

@@ -328,7 +328,7 @@ this optimization or doesn't have a RSB may choose to implement this exactly as

 ### Terminal: If

-```cpp
+```c++
 SetTerm(IR::Term::If{cond, term_then, term_else})
 ```

@@ -366,7 +366,7 @@ Do NEVER modify `%r15`, we must make it clear that this register is "immutable"

 ### `Scratch`

-```cpp
+```c++
 Xbyak::Reg64 ScratchGpr(HostLocList desired_locations = any_gpr);
 Xbyak::Xmm ScratchXmm(HostLocList desired_locations = any_xmm);
 ```
@@ -375,7 +375,7 @@ At runtime, allocate one of the registers in `desired_locations`. You are free t

 ### Pure `Use`

-```cpp
+```c++
 Xbyak::Reg64 UseGpr(Argument& arg);
 Xbyak::Xmm UseXmm(Argument& arg);
 OpArg UseOpArg(Argument& arg);
@@ -391,7 +391,7 @@ This register **must not** have it's value changed.

 ### `UseScratch`

-```cpp
+```c++
 Xbyak::Reg64 UseScratchGpr(Argument& arg);
 Xbyak::Xmm UseScratchXmm(Argument& arg);
 void UseScratch(Argument& arg, HostLoc host_loc);
@@ -409,7 +409,7 @@ You are free to modify the value in the register. The register is discarded at t

 A `Define` is the defintion of a value. This is the only time when a value may be set.

-```cpp
+```c++
 void DefineValue(IR::Inst* inst, const Xbyak::Reg& reg);
 ```

@@ -420,7 +420,7 @@ value to the specified register `reg`.

 Adding a `Define` to an existing value.

-```cpp
+```c++
 void DefineValue(IR::Inst* inst, Argument& arg);
 ```

@@ -458,7 +458,7 @@ One complication dynarmic has is that a compiled block is not uniquely identifia
 the PC alone, but bits in the FPSCR and CPSR are also relevant. We resolve this by
 computing a 64-bit `UniqueHash` that is guaranteed to uniquely identify a block.

-```cpp
+```c++
 u64 LocationDescriptor::UniqueHash() const {
    // This value MUST BE UNIQUE.
    // This calculation has to match up with EmitX64::EmitTerminalPopRSBHint
@@ -482,18 +482,18 @@ point. Each element in `rsb_location_descriptors` is a `UniqueHash` and they
 each correspond to an element in `rsb_codeptrs`. `rsb_codeptrs` contains the
 host addresses for the corresponding the compiled blocks.

-`RSB_SIZE` was chosen by performance testing. Note that this is bigger than the
+`RSBSize` was chosen by performance testing. Note that this is bigger than the
 size of the real RSB in hardware (which has 3 entries). Larger RSBs than 8
 showed degraded performance.

-```cpp
+```c++
 struct JitState {
    // ...

-    static constexpr size_t RSB_SIZE = 8; // MUST be a power of 2.
+    static constexpr size_t RSBSize = 8; // MUST be a power of 2.
    u32 rsb_ptr = 0;
-    std::array<u64, RSB_SIZE> rsb_location_descriptors;
-    std::array<u64, RSB_SIZE> rsb_codeptrs;
+    std::array<u64, RSBSize> rsb_location_descriptors;
+    std::array<u64, RSBSize> rsb_codeptrs;
    void ResetRSB();

    // ...
@@ -505,7 +505,7 @@ struct JitState {
 We insert our prediction at the insertion point iff the RSB doesn't already
 contain a prediction with the same `UniqueHash`.

-```cpp
+```c++
 void EmitX64::EmitPushRSB(IR::Block&, IR::Inst* inst) {
    using namespace Xbyak::util;

@@ -521,7 +521,7 @@ void EmitX64::EmitPushRSB(IR::Block&, IR::Inst* inst) {

    code->mov(index_reg, dword[code.ABI_JIT_PTR + offsetof(JitState, rsb_ptr)]);
    code->add(index_reg, 1);
-    code->and_(index_reg, u32(JitState::RSB_SIZE - 1));
+    code->and_(index_reg, u32(JitState::RSBSize - 1));

    code->mov(loc_desc_reg, u64(imm64));
    CodePtr patch_location = code->getCurr<CodePtr>();
@@ -530,7 +530,7 @@ void EmitX64::EmitPushRSB(IR::Block&, IR::Inst* inst) {
    code->EnsurePatchLocationSize(patch_location, 10);

    Xbyak::Label label;
-    for (size_t i = 0; i < JitState::RSB_SIZE; ++i) {
+    for (size_t i = 0; i < JitState::RSBSize; ++i) {
        code->cmp(loc_desc_reg, qword[code.ABI_JIT_PTR + offsetof(JitState, rsb_location_descriptors) + i * sizeof(u64)]);
        code->je(label, code->T_SHORT);
    }
@@ -544,12 +544,12 @@ void EmitX64::EmitPushRSB(IR::Block&, IR::Inst* inst) {

 In pseudocode:

-```cpp
-    for (i := 0 .. RSB_SIZE-1)
+```c++
+    for (i := 0 .. RSBSize-1)
        if (rsb_location_descriptors[i] == imm64)
        goto label;
    rsb_ptr++;
-    rsb_ptr %= RSB_SIZE;
+    rsb_ptr %= RSBSize;
    rsb_location_desciptors[rsb_ptr] = imm64; //< The UniqueHash
    rsb_codeptr[rsb_ptr] = /* codeptr corresponding to the UniqueHash */;
 label:
@@ -559,7 +559,7 @@ label:

 To check if a predicition is in the RSB, we linearly scan the RSB.

-```cpp
+```c++
 void EmitX64::EmitTerminalPopRSBHint(IR::Term::PopRSBHint, IR::LocationDescriptor initial_location) {
    using namespace Xbyak::util;

@@ -571,7 +571,7 @@ void EmitX64::EmitTerminalPopRSBHint(IR::Term::PopRSBHint, IR::LocationDescripto
    code->or_(rbx, rcx);

    code->mov(rax, u64(code->GetReturnFromRunCodeAddress()));
-    for (size_t i = 0; i < JitState::RSB_SIZE; ++i) {
+    for (size_t i = 0; i < JitState::RSBSize; ++i) {
        code->cmp(rbx, qword[code.ABI_JIT_PTR + offsetof(JitState, rsb_location_descriptors) + i * sizeof(u64)]);
        code->cmove(rax, qword[code.ABI_JIT_PTR + offsetof(JitState, rsb_codeptrs) + i * sizeof(u64)]);
    }
@@ -582,10 +582,10 @@ void EmitX64::EmitTerminalPopRSBHint(IR::Term::PopRSBHint, IR::LocationDescripto

 In pseudocode:

-```cpp
+```c++
 rbx := ComputeUniqueHash()
 rax := ReturnToDispatch
-for (i := 0 .. RSB_SIZE-1)
+for (i := 0 .. RSBSize-1)
    if (rbx == rsb_location_descriptors[i])
        rax = rsb_codeptrs[i]
 goto rax
@@ -3,20 +3,175 @@ Dynarmic

 A dynamic recompiler for ARM.

-*Note that an adversarial guest program [can determine if it's being ran under Dynarmic](#disadvantages-of-dynarmic). Preventing this is not a goal of this project.*
+Highlight features:

-Cortex-A57 (32 and 64 bit) is the emulated guest target. See [ArchVersion](../../src/dynarmic/src/dynarmic/interface/A32/arch_version.h).
+- Fast dynamic binary translation via Just-in-Time compilation
+- Clean API
+- Implemented in modern C++20
+- Hooks exposed for easy code instrumentation
+- Code injection support for very fine-grained instrumentation
+- Support for unusual address space setups (bring-your-own memory system)
+- Native support for most popular operating systems (Windows, macOS, Linux, FreeBSD, OpenBSD, NetBSD, Android)

-The only supported host architectures are x86-64, and AArch64. There are no plans to support any 32-bit architectures.
+*Please note that an adversarial guest program [can determine if it is being run under dynarmic](#disadvantages-of-dynarmic). Preventing this is not a goal of this project.*

-See [an example usage](../../src/dynarmic/tests/print_info.cpp).
+### Supported guest architectures
+
+* v3
+* v4
+* v4T
+* v5TE
+* v6K
+* v6T2
+* v7A
+* 32-bit v8
+* 64-bit v8
+
+You can specify the specific guest version using [ArchVersion](src/dynarmic/interface/A32/arch_version.h).
+
+There are no plans to support v1 or v2.
+
+### Supported host architectures
+
+* x86-64
+* AArch64
+
+There are no plans to support any 32-bit architecture.
+
+Important API Changes in v6.x Series
+------------------------------------
+
+* **v6.7.0**
+  * To support use cases where one wants to have the guest to have the same address space as the host, `nullptr` is now a valid value for `fastmem_pointer`.
+    **This change is not backwards-compatible.** If you were previously using `nullptr` to represent an invalid fastmem arena, you will now have to use `std::nullopt`.
+
+
+Documentation
+-------------

 Design documentation can be found at [./Design.md](./Design.md).

+
+Usage Example
+-------------
+
+The below is a minimal example. Bring-your-own memory system.
+
+```cpp
+#include <array>
+#include <cstdint>
+#include <cstdio>
+#include <exception>
+
+#include "dynarmic/interface/A32/a32.h"
+#include "dynarmic/interface/A32/config.h"
+
+using u8 = std::uint8_t;
+using u16 = std::uint16_t;
+using u32 = std::uint32_t;
+using u64 = std::uint64_t;
+
+class MyEnvironment final : public Dynarmic::A32::UserCallbacks {
+public:
+    u64 ticks_left = 0;
+    std::array<u8, 2048> memory{};
+
+    u8 MemoryRead8(u32 vaddr) override {
+        if (vaddr >= memory.size()) {
+            return 0;
+        }
+        return memory[vaddr];
+    }
+
+    u16 MemoryRead16(u32 vaddr) override {
+        return u16(MemoryRead8(vaddr)) | u16(MemoryRead8(vaddr + 1)) << 8;
+    }
+
+    u32 MemoryRead32(u32 vaddr) override {
+        return u32(MemoryRead16(vaddr)) | u32(MemoryRead16(vaddr + 2)) << 16;
+    }
+
+    u64 MemoryRead64(u32 vaddr) override {
+        return u64(MemoryRead32(vaddr)) | u64(MemoryRead32(vaddr + 4)) << 32;
+    }
+
+    void MemoryWrite8(u32 vaddr, u8 value) override {
+        if (vaddr >= memory.size()) {
+            return;
+        }
+        memory[vaddr] = value;
+    }
+
+    void MemoryWrite16(u32 vaddr, u16 value) override {
+        MemoryWrite8(vaddr, u8(value));
+        MemoryWrite8(vaddr + 1, u8(value >> 8));
+    }
+
+    void MemoryWrite32(u32 vaddr, u32 value) override {
+        MemoryWrite16(vaddr, u16(value));
+        MemoryWrite16(vaddr + 2, u16(value >> 16));
+    }
+
+    void MemoryWrite64(u32 vaddr, u64 value) override {
+        MemoryWrite32(vaddr, u32(value));
+        MemoryWrite32(vaddr + 4, u32(value >> 32));
+    }
+
+    void CallSVC(u32 swi) override {
+        // Do something.
+    }
+
+    void ExceptionRaised(u32 pc, Dynarmic::A32::Exception exception) override {
+        // Do something.
+    }
+
+    void AddTicks(u64 ticks) override {
+        if (ticks > ticks_left) {
+            ticks_left = 0;
+            return;
+        }
+        ticks_left -= ticks;
+    }
+
+    u64 GetTicksRemaining() override {
+        return ticks_left;
+    }
+};
+
+int main(int argc, char** argv) {
+    MyEnvironment env;
+    Dynarmic::A32::UserConfig user_config;
+    user_config.callbacks = &env;
+    Dynarmic::A32::Jit cpu{user_config};
+
+    // Execute at least 1 instruction.
+    // (Note: More than one instruction may be executed.)
+    env.ticks_left = 1;
+
+    // Write some code to memory.
+    env.MemoryWrite16(0, 0x0088); // lsls r0, r1, #2
+    env.MemoryWrite16(2, 0xE7FE); // b +#0 (infinite loop)
+
+    // Setup registers.
+    cpu.Regs()[0] = 1;
+    cpu.Regs()[1] = 2;
+    cpu.Regs()[15] = 0; // PC = 0
+    cpu.SetCpsr(0x00000030); // Thumb mode
+
+    // Execute!
+    cpu.Run();
+
+    // Here we would expect cpu.Regs()[0] == 8
+    printf("R0: %u\n", cpu.Regs()[0]);
+
+    return 0;
+}
+```
+
 Alternatives to Dynarmic
 ------------------------

-Here are some projects with the same goals as Dynarmic:
+Here are some projects with the same goals as dynarmic:

 * [Unicorn](https://www.unicorn-engine.org/) - Recompiling multi-architecture CPU emulator, based on QEMU
 * [SkyEye](http://skyeye.sourceforge.net) - Cached interpreter for ARM
@@ -34,8 +189,8 @@ More general alternatives:
 Disadvantages of Dynarmic
 -------------------------

-In the pursuit of speed, some behavior not commonly depended upon is elided. Hence this emulator doesn't match spec.
-Note that this would mean that a guest application can easily determine if it's being ran under instrumentation.
+In the pursuit of speed, some behavior not commonly depended upon is elided. Therefore this emulator does not match spec.
+Please note that this would mean that a guest application can easily determine if it is being run under instrumentation.

 Known examples:

@@ -50,6 +205,182 @@ Use this code base at your own risk.
 Legal
 -----

-Dynarmic is under a GPLv3 license, check the relevant file headers for more information.
+dynarmic is under a 0BSD license. See LICENSE.txt for more details.

-Dynarmic uses several open-source libraries, whose licenses are included inside thereof.
+dynarmic uses several other libraries, whose licenses are included below:
+
+### biscuit
+
+```
+Copyright 2021 Lioncash/Lioncache
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.
+```
+
+### catch
+
+```
+Boost Software License - Version 1.0 - August 17th, 2003
+
+Permission is hereby granted, free of charge, to any person or organization
+obtaining a copy of the software and accompanying documentation covered by
+this license (the "Software") to use, reproduce, display, distribute,
+execute, and transmit the Software, and to prepare derivative works of the
+Software, and to permit third-parties to whom the Software is furnished to
+do so, all subject to the following:
+
+The copyright notices in the Software and this entire statement, including
+the above license grant, this restriction and the following disclaimer,
+must be included in all copies of the Software, in whole or in part, and
+all derivative works of the Software, unless such copies or derivative
+works are solely in the form of machine-executable object code generated by
+a source language processor.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
+SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
+FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+```
+
+### fmt
+
+```
+Copyright (c) 2012 - 2016, Victor Zverovich
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+```
+
+### mcl & oaknut
+
+```
+MIT License
+
+Copyright (c) 2022 merryhime <https://mary.rs>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+### unordered_dense
+
+```
+MIT License
+
+Copyright (c) 2022 Martin Leitner-Ankerl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+### xbyak
+
+```
+Copyright (c) 2007 MITSUNARI Shigeo
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+Neither the name of the copyright owner nor the names of its contributors may
+be used to endorse or promote products derived from this software without
+specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
+THE POSSIBILITY OF SUCH DAMAGE.
+-----------------------------------------------------------------------------
+ソースコード形式かバイナリ形式か、変更するかしないかを問わず、以下の条件を満た
+す場合に限り、再頒布および使用が許可されます。
+
+ソースコードを再頒布する場合、上記の著作権表示、本条件一覧、および下記免責条項
+を含めること。
+バイナリ形式で再頒布する場合、頒布物に付属のドキュメント等の資料に、上記の著作
+権表示、本条件一覧、および下記免責条項を含めること。
+書面による特別の許可なしに、本ソフトウェアから派生した製品の宣伝または販売促進
+に、著作権者の名前またはコントリビューターの名前を使用してはならない。
+本ソフトウェアは、著作権者およびコントリビューターによって「現状のまま」提供さ
+れており、明示黙示を問わず、商業的な使用可能性、および特定の目的に対する適合性
+に関する暗黙の保証も含め、またそれに限定されない、いかなる保証もありません。
+著作権者もコントリビューターも、事由のいかんを問わず、 損害発生の原因いかんを
+問わず、かつ責任の根拠が契約であるか厳格責任であるか（過失その他の）不法行為で
+あるかを問わず、仮にそのような損害が発生する可能性を知らされていたとしても、
+本ソフトウェアの使用によって発生した（代替品または代用サービスの調達、使用の
+喪失、データの喪失、利益の喪失、業務の中断も含め、またそれに限定されない）直接
+損害、間接損害、偶発的な損害、特別損害、懲罰的損害、または結果損害について、
+一切責任を負わないものとします。
+```
@@ -24,7 +24,7 @@ All code, AI or not, is held under a **strict standard of excellence**. AI/LLM-g

 ## Licensing concerns

-This is an area of ongoing litigation, and as such, is still very iffy. For the time being, know that allowing AI to ingest the codebase may end up with its copyleft code regurgitated into incompatibly-licensed proprietary or permissive software. For you, this means to **not** feed code into LLMs.
+This is an area of ongoing litigation, and as such is still very iffy. For the time being, know that allowing AI to ingest the codebase may end up with its copyleft code regurgitated into incompatibly-licensed proprietary or permissive software. For you, this means to **not** feed code into LLMs.

 AI models may have also ingested AGPLv3 code, which is license-incompatible with our codebase.

@@ -24,8 +24,8 @@ Everyone has their own way of viewing good/bad C++ practices, my general outline
 - Exploit the fact `std::atomic<uint32_t>/std::atomic<int32_t>` is basically free on most arches that matter.
  - In x86_64, an atomic `uint32_t` is basically `mov [m32], r32`, which is essentially free/cheap.
 - Avoid template parameters unless you really need them.
-  - For small inline-able functions this is fine, for more complex ones, consider the generated assembly.
- Don't make your own memcpy/memset/strcpy/strncpy/etc.
+  - For small inlineable functions this is fine, for more complex ones, please consider the generated assembly.
+- Dont make your own memcpy/memset/strcpy/strncpy/etc.
  - Seriously DON'T DO THIS. You will NOT beat the compiler.
  - Nor 30 years of writing optimized `mem*`.
  - If your code is slow, don't blame `mem*`, blame your code.
@@ -37,7 +37,7 @@ Everyone has their own way of viewing good/bad C++ practices, my general outline
 - Function parameters are cheap. Don't be afraid to use as many as needed (API usability permitting).
 - Don't save a reference in structures of a parent object, i.e:

-    ```cpp
+    ```c++
    struct Child {
        Parent& parent;
        void Mehod() {
@@ -48,7 +48,7 @@ Everyone has their own way of viewing good/bad C++ practices, my general outline

  - Instead you can do the following:

-    ```cpp
+    ```c++
    struct Child {
        void Mehod(Parent& parent) {
            parent.Something();
@@ -66,6 +66,6 @@ Programming, alongside the physical act of writing code, also consists of archit
  - Dependencies that are legitimately useful to have are few and far between.
  - At the same time, NIHing your own implementations of widely adopted algorithms or standards can be quite subpar.
  - For dependencies that are very large but contain something you need, consider cherry-picking the individual files it needs (or writing a smaller version of it)
- Try to rely less on indirection for architecting systems
+- Try to rely less on indirection for architecturing systems
  - If the underlying HLE kernel emulation requires it, try making a solution that keeps things local
    - For example, there isn't a need for file descriptors to each be a pointer, when they could be a fixed table size with elements that may be emplaced at will.
@@ -2,7 +2,7 @@

 Use this guide whenever you want to modify the Date or Time that Eden reports to games. This can be useful for modifying RNG elements, skipping wait times in games, etc.

-**[See here](https://evilperson1337.notion.site/Setting-a-Custom-Date-Time-in-Eden-2b357c2edaf680acb8d4e63ccc126564) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Setting-a-Custom-Date-Time-in-Eden-2b357c2edaf680acb8d4e63ccc126564) for a version of this guide with images & visual elements.**

 ---

@@ -44,7 +44,7 @@ Only Fedora/riscv64 has been tested, but in theory, every riscv64 distribution t

 ## Other

-Other architectures, such as SPARC, MIPS, PowerPC, Loong, and all 32-bit architectures are completely unsupported, as there is no JIT backend or emitter thereof. If you want support for it -- submit patches!
+Other architectures, such as SPARC, MIPS, PowerPC, Loong, and all 32-bit architectures are completely unsupported, as there is no JIT backend or emitter thereof. If you want support for it--submit patches!

 IA-64 (Itanium) support is completely unknown. Existing amd64 packages will not run on IA-64 (assuming you can even find a supported Windows/Linux distribution)

@@ -52,32 +52,28 @@ IA-64 (Itanium) support is completely unknown. Existing amd64 packages will not

 The vast majority of Eden's testing is done on Windows, Linux, and Android. However, first-class support is also provided for:

- FreeBSD (amd64, aarch64)
- HaikuOS (amd64)
- OpenBSD (amd64)
- NetBSD (amd64)
- macOS (aarch64)
- OpenIndiana aka. OpenSolaris (amd64)
+- HaikuOS
+- FreeBSD
+- OpenBSD
+- NetBSD
+- OpenIndiana (Solaris)
+- macOS

 ## Linux

 While all modern Linux distributions are supported (Fedora >40, Ubuntu >24.04, Debian >12, Arch, Gentoo, etc.), the vast majority of testing and development for Linux is on Arch and Gentoo. Most major build system changes are tested on Gentoo first and foremost, so if builds fail on any modern distribution no matter what you do, it's likely a bug and should be reported.

-Intel and NVIDIA GPU support is limited. AMD (RADV) drivers receive first-class testing and are known to provide the most stable Eden experience possible.
+Intel and Nvidia GPU support is limited. AMD (RADV) drivers receive first-class testing and are known to provide the most stable Eden experience possible.

 Wayland is not recommended. Testing has shown significantly worse performance on most Wayland compositors compared to X11, alongside mysterious bugs and compatibility errors. For now, set `QT_QPA_PLATFORM=xcb` when running Eden, or pass `-platform xcb` to the launch arguments.

 ## Windows

-Windows 10 and 11 are supported. Anything below is unsupported.
+Windows 10 and 11 are supported. Support for Windows 8.x is unknown, and Windows 7 support is unlikely to ever be added.

-To run Eden, you'll need to install [Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170).
+In order to run Eden, you will probably need to install the [Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170).

-Neither AMD/NVIDIA drivers work nearly as well as Linux's RADV drivers. Compatibility is still largely the same, but performance and some hard-to-run games may suffer compared to Linux.
-
-### Windows on ARM
-
-If you're using Snapdragon X or 8CX, install the [Vulkan translation layer](https://apps.microsoft.com/detail/9nqpsl29bfff?hl=en-us&gl=USE) only if the stock drivers don't work. And of course always keep your system up-to-date.
+Neither AMD nor Nvidia drivers work nearly as well as Linux's RADV drivers. Compatibility is still largely the same, but performance and some hard-to-run games may suffer compared to Linux.

 ## Android

@@ -127,13 +123,13 @@ Do note that building the GUI version with Qt versions higher than 6.7.3 will ca

 ## *BSD, Solaris

-BSD and Solaris distributions tend to lag behind Linux in terms of Vulkan and ports. For example, OpenIndiana (Solaris) does not properly package Qt, meaning the recommended method of usage is to use `eden-cli` for now. Solaris also generally works better with OpenGL.
+BSD and Solaris distributions tend to lag behind Linux in terms of Vulkan and other library compatibility. For example, OpenIndiana (Solaris) does not properly package Qt, meaning the recommended method of usage is to use `eden-cli` only for now. Solaris also generally works better with OpenGL.

-AMD GPU support on these platforms is limited or nonexistent, bar for OpenBSD which has a dedicated AMD GPU stack.
+AMD GPU support on these platforms is limited or nonexistent.

 ## HaikuOS

-HaikuOS supports (see below) Vulkan 1.3 and has Mesa 24.0. Because OpenGL ES is used instead of the desktop flavour of OpenGL the OpenGL backend is actually worse than the Vulkan one in terms of stability and system support. OpenGL is highly not recommended due to it being out of tree builds of Mesa and generally unstable ones at that. Users are advised to use Vulkan instead.
+HaikuOS supports (see below) Vulkan 1.3 and has Mesa 24.0. Because OpenGL ES is used instead of the desktop flavour of OpenGL the OpenGL backend is actually worse than the Vulkan one in terms of stability and system support. OpenGL is highly not recommended due to it being: out of tree builds of Mesa and generally unstable ones at that. Users are advised to use Vulkan whenever possible.

 - Additionally system drivers for NVIDIA and Intel iGPUs exist and provide a native Vulkan ICD with the `Xcb` interface as opposed to the native `BView`
 - In order to obtain Vulkan 1.3 support with native `BView` support; Swiftshader can be compiled from source [see this thread](https://discuss.haiku-os.org/t/swiftshader-vulkan-software-renderer-on-haiku/11526/6).
@@ -2,13 +2,13 @@

 ## Introduction

-Eden is a very complicated piece of software, there are many knobs and toggles that can be configured. Most of these are invisible to normal users, however, power users may be able to leverage them to their advantage.
+Eden is a very complicated piece of software, and as such there are many knobs and toggles that can be configured. Most of these are invisible to normal users, however power users may be able to leverage them to their advantage.

 This handbook primarily describes such knobs and toggles. Normal configuration options are described within the emulator itself and will not be covered in detail.

 ## Requirements

-The emulator is very demanding on hardware and requires a decent mid-range computer/cellphone.
+The emulator is very demanding on hardware, and as such requires a decent mid-range computer/cellphone.

 See [the requirements page](https://archive.is/sv83h) for recommended and minimum specs.

@@ -22,8 +22,8 @@ If your GPU doesn't support or is just behind by a minor version, see Mesa envir
    - RC releases: Release candidate, generally "less stable but still stable" versions.
    - Full release: "The stablest possible you could get".
 - Nightly: Builds done around 2PM UTC (if there are any changes), generally stable, but not recommended for the average user. These contain daily updates and may contain critical fixes for some games.
- Master: Unstable builds, can range from games working exceptionally well to instantly crashing. These contain straight from the oven fixes, don't use them unless you plan to contribute something! They're very experimental! Still 95% of the time they will work just fine.
- PR builds: Highly experimental builds, testers may grab from these. The average user should treat them the same as master builds.
+- Master: Unstable builds, can lead from a game working exceptionally fine to absolute crashing in some systems because someone forgot to check if NixOS or Solaris worked. These contain straight from the oven fixes, please don't use them unless you plan to contribute something! They're very experimental! Still 95% of the time it will work just fine.
+- PR builds: Highly experimental builds, testers may grab from these. The average user should treat them the same as master builds, except sometimes they straight up don't build/work.

 ## User configuration

@@ -36,7 +36,7 @@ Eden will store configuration files in the following directories:
 - **Linux, macOS, FreeBSD, Solaris, OpenBSD**: `$XDG_DATA_HOME`, `$XDG_CACHE_HOME`, `$XDG_CONFIG_HOME`.
 - **HaikuOS**: `/boot/home/config/settings/eden`

-If a `user` directory is present in the current working directory, that will override all global configuration directories and the emulator will use the `user` directory instead.
+If a `user` directory is present in the current working directory, that will override all global configuration directories and the emulator will use that instead.

 ### Environment variables

@@ -64,4 +64,4 @@ Then just running `chmod +x script.sh && source script.sh`.

 ## Compatibility list

-Eden doesn't maintain a compatibility list. However, [EmuReady](https://www.emuready.com/) has a more fine-grained compatibility information for multiple emulators/forks as well.
+Eden doesn't mantain a compatibility list. However, [EmuReady](https://www.emuready.com/) has a more fine-grained compatibility information for multiple emulators/forks as well.
@@ -12,7 +12,7 @@ If they don't run - then that's a bug!

 ## Atmosphere

-Fusée Gelée, the bootloader and other low-level mechanisms are not emulated at the moment.
+Fusee Galee, the bootloader and other low-level mechanisms are not emulated at the moment.

 Having OFW is recommended, but may not be required (untested).

@@ -4,7 +4,7 @@ There are two main applications, an SDL-based app (`eden-cli`) and a Qt based ap

 ## eden

- `./eden <path>`: Running with a single argument and nothing else, will make the emulator look for the given file and load it, this behavior is similar to `eden-cli`; allows dragging and dropping games into the application.
+- `./eden <path>`: Running with a single argument and nothing else, will make the emulator look for the given file and load it, this behaviour is similar to `eden-cli`; allows dragging and dropping games into the application.
 - `-g <path>`: Alternate way to specify what to load, overrides. However let it be noted that arguments that use `-` will be treated as options/ignored, if your game, for some reason, starts with `-`, in order to safely handle it you may need to specify it as an argument.
 - `-f`: Use fullscreen.
 - `-u <number>`: Select the index of the user to load as.
@@ -1,12 +1,12 @@
 # User Handbook - Controllers

-Most of the controls should work out of the box. If not, use a joystick calibrator to ensure it's not an issue with your own controller, for example:
+Most of the controls should work out of the box. If not, please use a joystick calibrator to ensure it's not an issue with your own controller, for example:

 - https://github.com/dkosmari/calibrate-joystick

 ## Using external controllers on the Steamdeck

-In desktop mode ignore your Pro controller/XBOX controller external controller and use **Steam Virtual Gamepad 0 as Player 1**. If you have multiple external controllers set **Player 2 to Steam Virtual Gamepad 1**. Steam app must not be closed on desktop mode.
+In desktop mode ignore your pro controller/xbox contoller external controller and use **Steam Virtual Gamepad 0 as Player 1**. If you have multiple external controllers set **Player 2 to Steam Virtual Gamepad 1**. Steam app must not be closed on desktop mode.

 Here's the annoying part of it. When waking up the steam deck from sleep try not to touch any button on the Steamdeck and turn on your external controller. Then open the Eden.AppImage. If you're lucky you can get your external controller to be position 0 and also Steam Virtual Gamepad 0 in desktop mode. If not that is ok too unless you need to configure player 1 to have gyro. You might need to repeat this to get your external controller as Steam Virtual Gamepad 0 so you can config Player 1 having gyro. You might be able to config player 1 to have gyro with the Steamdeck itself. Or you can also config player 1, 2, 3, etc, to have gyro somehow. Make sure they are all using Virtual Gamepads though.

@@ -18,7 +18,7 @@ Basically the Steamdeck or the external controller is fighting for position 0 an

 Use this guide for when you want to configure specific controller settings to be reused.

-**[See here](https://evilperson1337.notion.site/Configuring-Controller-Profiles-2be57c2edaf680eabc3ac8c333ec75c4) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Configuring-Controller-Profiles-2be57c2edaf680eabc3ac8c333ec75c4) for a version of this guide with images & visual elements.**

 ---

@@ -30,8 +30,8 @@ Use this guide for when you want to configure specific controller settings to be

 #### Steps
 1. Launch Eden and wait for it to load.
-2. Navigate to `Emulation > Configure...`
-3. Select **Controls** from the left-hand menu and configure your controller for the way you want it to be in-game.
+2. Navigate to *Emulation > Configure...*
+3. Select **Controls** from the left-hand menu and configure your controller for the way you want it to be in game.
 4. Select **New** and enter a name for the profile in the box that appears. Press **OK** to save the profile settings.
 5. Select **OK** to close the settings menu.

@@ -39,7 +39,7 @@ Use this guide for when you want to configure specific controller settings to be

 Use this guide when you want to set up specific controller profiles for specific games. This can be useful for certain games like *Captain Toad Treasure Tracker* where a blue dot appears in the middle of the screen when you have docked mode enabled, but not handheld mode.

-**[See here](https://evilperson1337.notion.site/Setting-Controller-Profiles-By-Game-2b057c2edaf681658a57f0c199cb6083) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Setting-Controller-Profiles-By-Game-2b057c2edaf681658a57f0c199cb6083) for a version of this guide with images & visual elements.**

 ---

@@ -47,6 +47,7 @@ Use this guide when you want to set up specific controller profiles for specific

 - Eden Emulator set up and fully configured
 - Controller Profile Created
+    - See [*Configuring Controller Profiles*](./ControllerProfiles.md) for instructions on how to do this if needed.

 ---

@@ -100,7 +100,7 @@ HaikuOS bundles a Mesa library that doesn't support full core OpenGL 4.6 (requir
 ### Fixes for Windows 10 and above having "Device loss"

 Run the following batch script *inside* the Eden folder:
-```bat
+```cmd
@echo off
 pushd "%~dp0"
 if exist "%temp%\FixFullScreen.reg" (
@@ -1,7 +1,7 @@
 # Getting Gyro/Motion Controls Working on Steam Deck
 Use this guide when you want to use the Steam Deck's native gyro functionality for motion controls in Eden.

-**[See here](https://evilperson1337.notion.site/Getting-Gyro-Motion-Controls-Working-on-Steam-Deck-2b057c2edaf681a1aaade35db6e0fd1b) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Getting-Gyro-Motion-Controls-Working-on-Steam-Deck-2b057c2edaf681a1aaade35db6e0fd1b) for a version of this guide with images & visual elements.**

 ## Steamdeck

@@ -2,7 +2,7 @@

 Use this when you need to review the logs to determine an issue or provide them to a member of the Eden team.

-**[See here](https://evilperson1337.notion.site/How-to-Access-Logs-2b057c2edaf68105a281fe1688a332d4) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/How-to-Access-Logs-2b057c2edaf68105a281fe1688a332d4) for a version of this guide with images & visual elements.**

 ---

@@ -2,7 +2,7 @@

 Use this guide when you want to manually import save files for use in the Eden emulator.

-**[See here](https://evilperson1337.notion.site/Importing-Saves-Into-Eden-2b057c2edaf681fe968df8d63821ccae) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Importing-Saves-Into-Eden-2b057c2edaf681fe968df8d63821ccae) for a version of this guide with images & visual elements.**

 ### Pre-Requisites
 - Eden emulator already set up and configured.
@@ -2,7 +2,7 @@

 Use this guide for when you want to install an Atmosphere-based mod for use in Eden.

-**[See here](https://evilperson1337.notion.site/Installing-Atmosphere-Mods-2b057c2edaf681fe8d39cbfc2d0cc799) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Installing-Atmosphere-Mods-2b057c2edaf681fe8d39cbfc2d0cc799) for a version of this guide with images & visual elements.**

 ---

@@ -8,7 +8,7 @@ Use this guide when you want to install Updates or DLC for your games in Eden.

 </aside>

-**[See here](https://evilperson1337.notion.site/Working-with-Updates-DLC-in-Eden-2b057c2edaf681dfb65dfc4dd96980c0) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Working-with-Updates-DLC-in-Eden-2b057c2edaf681dfb65dfc4dd96980c0) for a version of this guide with images & visual elements.**

 ---

@@ -4,7 +4,7 @@ Use this guide to answer questions regarding and to start using the multiplayer
 ## Multiplayer FAQ
 This FAQ will serve as a general quick question and answer simple questions.

-**[See here](https://evilperson1337.notion.site/Multiplayer-FAQ-2c357c2edaf680fca2e9ce59969a220f) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Multiplayer-FAQ-2c357c2edaf680fca2e9ce59969a220f) for a version of this guide with images & visual elements.**

 ### Can Eden Play Games with a Switch Console?
 No - The only emulator that has this kind of functionality is *Ryujinx* and it's forks.  This solution requires loading a custom module on a modded switch console to work.
@@ -40,7 +40,7 @@ While it would be nice if everything always worked perfectly - that is not reali
 1. Emulator Version Mismatches
    1. Occasionally updates to the emulator of choice alter how the LDN functionality is handled.  In these situations, unexpected behavior can occur when trying to establish LDN connections.  This is a good first step to check if you are having issues playing a game together, but can join the same lobby without issue.
 2. Game Version Mismatches
-    1. It is best practice to have the game version be identical to each other in order to ensure that there is no difference in how the programs are handling the LDN logic.  Games are black boxes that the dev team can't see into to ensure the logic handling operates the same way.  For this reason, it is highly advised that the game versions match across all the players.  This would be a good 2nd step to check if you are having issues playing a game together, but can join the same lobby without issue.
+    1. It is best practice to have the game version be identical to each other in order to ensure that there is no difference in how the programs are handling the LDN logic.  Games are black boxes that the dev team cannot see into to ensure the logic handling operates the same way.  For this reason, it is highly advised that the game versions match across all the players.  This would be a good 2nd step to check if you are having issues playing a game together, but can join the same lobby without issue.
 3. Latency
    1. Because this implementation is emulating a LAN/Local Wireless connection - it is extremely sensitive to network latency and drops.  Eden has done a good job of trying to account for this and not immediately drop users out - but it is not infallible.  If latency is a concern or becomes an issue - consider hosting a room.

@@ -49,7 +49,7 @@ While it would be nice if everything always worked perfectly - that is not reali
 ## Joining a Multiplayer Room
 Use this when you need to connect to a multiplayer room for LDN functionality inside of Eden.  This does not cover how to host a room, only joining existing ones.

-**[See here](https://evilperson1337.notion.site/Access-Your-Multiplayer-Room-Externally-2c357c2edaf681c0ab2ce2ee624d809d) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Access-Your-Multiplayer-Room-Externally-2c357c2edaf681c0ab2ce2ee624d809d) for a version of this guide with images & visual elements.**

 ### Pre-Requisites
 - Eden set up and functioning
@@ -66,7 +66,7 @@ There are 2 primary methods that you can use to connect to an existing room, dep

 <aside>

-***NOTE:*** Just because a lobby appears on the public lobby list, does not mean that the host has properly configured the necessary port forwarding/firewall rules to allow a connection.  If you can't connect to a lobby, move onto another entry as the issue is probably not on your end.  Start looking at your environment if you are unable to connect to multiple/any lobbies.
+***NOTE:*** Just because a lobby appears on the public lobby list, does not mean that the hoster has properly configured the necessary port forwarding/firewall rules to allow a connection.  If you cannot connect to a lobby, move onto another entry as the issue is probably not on your end.  Start looking at your environment if you are unable to connect to multiple/any lobbies.

 </aside>

@@ -82,10 +82,10 @@ There are 2 primary methods that you can use to connect to an existing room, dep
 3. You will now see a window showing everyone on the lobby, or an error message.

 ### Direct Connecting to a Room
-If the host has not made the lobby public, or you don't want to find it in the public game browser - use this option to connect.
+If the hoster has not made the lobby public, or you don't want to find it in the public game browser - use this option to connect.

 1. Open Eden and navigate to *Multiplayer > Direct Connect*.
-2. Enter the *Server Address, Port*, *Nickname* (what your user will be called in the room), and a *Password* (if the host set one, otherwise leave it blank) and hit **Connect.**
+2. Enter the *Server Address, Port*, *Nickname* (what your user will be called in the room), and a *Password* (if the hoster set one, otherwise leave it blank) and hit **Connect.**
 3. You will now see a window showing everyone on the lobby, or an error message.

 ---
@@ -93,7 +93,7 @@ If the host has not made the lobby public, or you don't want to find it in the p
 ## Hosting a Multiplayer Room
 Use this guide for when you want to host a multiplayer lobby to play with others in Eden.  In order to have someone access the room from outside your local network, see the *Access Your Multiplayer Room Externally* section for next steps.

-**[See here](https://evilperson1337.notion.site/Hosting-a-Multiplayer-Room-2c357c2edaf6819481dbe8a99926cea2) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Hosting-a-Multiplayer-Room-2c357c2edaf6819481dbe8a99926cea2) for a version of this guide with images & visual elements.**

 ### Pre-Requisites
 - Eden set up and Functioning
@@ -123,7 +123,7 @@ Use this guide for when you want to host a multiplayer lobby to play with others
 ## Access Your Multiplayer Room Externally
 Quite often the person with whom you want to play is located off of your internal network (LAN).  If you want to host a room and play with them you will need to get your devices to communicate with each other.  This guide will go over your options on how to do this so that you can play together.

-**[See here](https://evilperson1337.notion.site/Access-Your-Multiplayer-Room-Externally-2c357c2edaf681c0ab2ce2ee624d809d) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Access-Your-Multiplayer-Room-Externally-2c357c2edaf681c0ab2ce2ee624d809d) for a version of this guide with images & visual elements.**

 ### Pre-Requisites
 - Eden set up and Functioning
@@ -137,7 +137,7 @@ Quite often the person with whom you want to play is located off of your interna
    
    <aside>
    
-    Use this option if you want the greatest performance/lowest latency, don't want to install any software, and have the ability to modify your networking equipment's configuration (most notably - your router). Avoid this option if you can't modify your router's configuration or are uncomfortable with looking up things on your own.
+    Use this option if you want the greatest performance/lowest latency, don't want to install any software, and have the ability to modify your networking equipment's configuration (most notably - your router).  Avoid this option if you cannot modify your router's configuration or are uncomfortable with looking up things on your own.
    
    </aside>
    
@@ -155,7 +155,7 @@ Remember you can't have one port open for multiple devices at the same time - yo
    
    <aside>
    
-    Use this option if you don't want to have to worry about other users machine/configuration settings, but also can't do port forwarding. This will still require that you as the host install a program and sign up for an account - but will prevent you from having to deal with port forwards or networking equipment. Avoid this option if there is not a close relay and you are getting issues with latency.
+    Use this option if you don't want to have to worry about other users machine/configuration settings, but also cannot do port forwarding.  This will still require that you as the hoster install a program and sign up for an account - but will prevent you from having to deal with port forwards or networking equipment. Avoid this option if there is not a close relay and you are getting issues with latency.
    
    </aside>
    
@@ -193,7 +193,7 @@ The VPN solution is a good compromise between the tunnelling solution and port f
 ## Finding the Server Information for a Multiplayer Room
 Use this guide when you need to determine the connection information for the Public Multiplayer Lobby you are connected to.

-**[See here](https://evilperson1337.notion.site/Finding-the-Server-Information-for-a-Multiplayer-Room-2c557c2edaf6809e94e8ed3429b9eb26) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Finding-the-Server-Information-for-a-Multiplayer-Room-2c557c2edaf6809e94e8ed3429b9eb26) for a version of this guide with images & visual elements.**

 ### Pre-Requisites
 - Eden set up and configured
@@ -256,7 +256,7 @@ Use this guide when you need to determine the connection information for the Pub
 ## Multiplayer for Local Co-Op Games
 Use this guide when you want to play with a friend on a different system for games that only support local co-op.

-**[See here](https://evilperson1337.notion.site/Multiplayer-for-Local-Co-Op-Games-2c657c2edaf680c59975ec6b52022a2d) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Multiplayer-for-Local-Co-Op-Games-2c657c2edaf680c59975ec6b52022a2d) for a version of this guide with images & visual elements.**

 Occasionally you will want to play a game with a friend on a game that does not support LDN multiplayer, and only offer local co-op (multiple controllers connected to a single console), such as with *New Super Mario Bros. U Deluxe.*  Emulation solutions have developed 2 primary methods for handling these cases.

@@ -1,9 +1,9 @@
 # User Handbook - Native Application Development

-Debugging on physical hardware can get tedious and time consuming. Users are empowered with the debugging capabilities of the emulator to ensure their applications run as-is on the system. To the greatest extent possible at least.
+Debugging on physical hardware can get tedious and time consuming. Users are empowered with the debugging capabilities of the emulator to ensure their applications run as-is on the system. To the greatest extent possible atleast.

 ## Debugging

 **Standard key prefix**: Allows to redirect the key manager to a file other than `prod.keys` (for example `other` would redirect to `other.keys`). This is useful for testing multiple keysets. Default is `prod`.

-**Changing serial**: Very basic way to set debug values for the serial (and battery number). Developers do not need to write the full serial as only the first digits (excluding the last) will be accounted for. Region settings will affect the generated serial. The serial corresponds to a non-OLED/Lite console.
+**Changing serial**: Very basic way to set debug values for the serial (and battery number). Developers do not need to write the full serial as only the first digits (excluding the last) will be accoutned for. Region settings will affect the generated serial. The serial corresponds to a non-OLED/Lite console.
@@ -2,7 +2,7 @@

 Use this guide to get starting using the Eden emulator.

-**[See here](https://evilperson1337.notion.site/Eden-Quick-Start-2b057c2edaf6817b9859d8bcdb474017) for an illustrated guide.**
+**Click [Here](https://evilperson1337.notion.site/Eden-Quick-Start-2b057c2edaf6817b9859d8bcdb474017) for a version of this guide with images & visual elements.**

 ## Windows

@@ -77,41 +77,3 @@ Use this guide to get starting using the Eden emulator.
 8. Double-Click the main window to add the folder containing your games.
 9. Go to *Emulation > Configure > Input* and set up your controller. Click **OK** to close the dialog window.
 10. Double-Click a game to run it.
-
-## macOS
-
-Current macOS support is still experimental and very reliant on MoltenVK developments, plans have shifted to properly provide support for KosmicKrisp and similar new GPU endeavors, but macOS users still are bound to MoltenVK itself.
-
-Users of macOS may wish to use [Asahi Linux](https://wiki.gentoo.org/wiki/Project:Asahi/Guide) for the rising KosmicKrisp support.
-
-As of writing, neither macOS nor Asahi has support for NCE; additionally Asahi has extraneous paging bugs with fastmem.
-
-### Allowing Eden to Run on MacOS
-
-Use this guide when you need to allow Eden to run on a Mac system, but are being blocked by Apple Security policy.
-
-**[See here](https://evilperson1337.notion.site/Allowing-Eden-to-Run-on-MacOS-2b057c2edaf681fea63dc81027efeffd) for an illustrated guide.**
-
---
-
-##### Pre-Requisites
-
- Permissions to modify settings in MacOS
-
---
-
-#### Why am I Seeing This?
-
-Recent versions of MacOS (Catalina & newer) introduced the **Gatekeeper** security functionality, requiring software to be signed by Apple or a trusted (aka - paying) developer.  If the signature isn't on the list of trusted ones, it will stop the program from executing and display the message above.
-
---
-
-#### Steps
-
-1. Open the *System Settings* panel.
-2. Navigate to *Privacy & Security*.
-3. Scroll down and observe the following message under the **Security** settings.
-4. Select **Open Anyway** to tell your Mac that you trust the application.
-5. You will now get another window appearing to verify you want to open Eden.  Select **Open Anyway**.
-6. You will be prompted for your password to authorize the request.  Enter the credentials of an account that has permission to modify settings and press **OK**.
-7. Eden will now open and any subsequent launches of the program will not prompt this.
@@ -10,15 +10,13 @@ A copy of this handbook is [available online](https://git.eden-emu.dev/eden-emu/

 - **[The Basics](Basics.md)**
 - **[Quickstart](./QuickStart.md)**
-    - **[Windows](./QuickStart.md#windows)**
-    - **[Steamdeck](./QuickStart.md#steamdeck)**
-    - **[macOS](./QuickStart.md#macos)**
 - **[Settings](./Settings.md)**
 - **[Controllers](./Controllers.md)**
    - **[Controller profiles](./Controllers.md#configuring-controller-profiles)**
 - **[Audio](Audio.md)**
 - **[Graphics](Graphics.md)**
 - **[Installing Mods](./Mods.md)**
+- **[Run On macOS](./RunOnMacOS.md)**
 - **[Data, Savefiles and Storage](Storage.md)**
 - **[Orphaned Profiles](Orphaned.md)**
 - **[Troubleshooting](./Troubleshoot.md)**
@@ -49,4 +47,6 @@ A copy of this handbook is [available online](https://git.eden-emu.dev/eden-emu/
 - **[Gyro Controls](./GyroControls.md)**
 - **[Platforms and Architectures](./Architectures.md)**
 - **[Native Application Development](./Native.md)**
+- **[Adding Boolean Settings Toggles](./AddingBooleanToggles.md)**
+- **[Adding Debug Knobs](./AddingDebugKnobs.md)**
 - **[Testing](./Testing.md)**
@@ -0,0 +1,37 @@
+# User Handbook - Run on macOS
+
+Current macOS support is still experimental and very reliant on MoltenVK developments, plans have shifted to properly provide support for KosmicKrisp and similar new GPU endeavours, but macOS users still are bound to MoltenVK itself.
+
+Users of macOS may wish to use [Asahi Linux](https://wiki.gentoo.org/wiki/Project:Asahi/Guide) for the rising KosmicKrisp support.
+
+As of writing, neither macOS nor Asahi has support for NCE; additionally Asahi has extraneous paging bugs with fastmem.
+
+## Allowing Eden to Run on MacOS
+
+Use this guide when you need to allow Eden to run on a Mac system, but are being blocked by Apple Security policy.
+
+**Click [Here](https://evilperson1337.notion.site/Allowing-Eden-to-Run-on-MacOS-2b057c2edaf681fea63dc81027efeffd) for a version of this guide with images & visual elements.**
+
+---
+
+#### Pre-Requisites
+
+- Permissions to modify settings in MacOS
+
+---
+
+### Why am I Seeing This?
+
+Recent versions of MacOS (Catalina & newer) introduced the **Gatekeeper** security functionality, requiring software to be signed by Apple or a trusted (aka - paying) developer.  If the signature isn't on the list of trusted ones, it will stop the program from executing and display the message above.
+
+---
+
+### Steps
+
+1. Open the *System Settings* panel.
+2. Navigate to *Privacy & Security*.
+3. Scroll down and observe the following message under the **Security** settings.
+4. Select **Open Anyway** to tell your Mac that you trust the application.
+5. You will now get another window appearing to verify you want to open Eden.  Select **Open Anyway**.
+6. You will be prompted for your password to authorize the request.  Enter the credentials of an account that has permission to modify settings and press **OK**.
+7. Eden will now open and any subsequent launches of the program will not prompt this.
@@ -11,7 +11,7 @@ This guide explains how to set up a public/private self hosted Eden server/lobby
 - Next, under Server OS Images, select Ubuntu 24.04 LTS. Configure CPU/RAM/specs as desired for your server. Complete the creation process.

 - Enable the Kamatera firewall and set default policy: IN: DROP, OUT: ACCEPT.
- - After setting the default policy, add the three following rules: #1: SSH Access - Direction: IN, Interface: net0, Macro: SSH - Secure Shell Traffic, Source: ANY, Port: Blank/Auto (Handled by SSH), Destination: Blank/Auto (Handled by SSH), Policy: ACCEPT, leave a comment: SSH access.
+ - After setting the default policy, add the three following rules: #1: SSH Access - Direction: IN, Interface: net0, Macro: SSH - Secure Shell Traffic, Source: ANY, Port: Blank/Auto (Handeld by SSH), Destination: Blank/Auto (Handeld by SSH), Policy: ACCEPT, leave a comment: SSH access.
 - Then, after creating the first rule, add TCP & UDP Ports for Eden - Direction: IN, Interface: net0, Protocol: TCP or UDP (for respective rule), Source: ANY, Destination Port: 24872, Policy: ACCEPT, leave a comment: Eden server port.
 - Note: Only UDP is required for Eden; opening TCP is optional.

--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
CamilleLaVey	e46c19391d	Add small_vector to CopyMSAA with reserve image on upload path	2026-08-22 23:18:10 -04:00
CamilleLaVey	3d453e6236	[TEST] Unify another section of the blits on MSAA path	2026-08-22 23:13:20 -04:00
CamilleLaVey	9392ccf124	color write meows	2026-08-22 21:55:02 -04:00
CamilleLaVey	16b9b5aa0c	Revert "[TEST] Save space with Sync2"	2026-08-22 21:41:04 -04:00
CamilleLaVey	2df4744b53	Some meows	2026-08-22 21:40:47 -04:00
CamilleLaVey	faf82ccdd7	[TEST] Unify paths on MSAA part 2	2026-08-22 20:13:10 -04:00
CamilleLaVey	8f18e82931	[TEST] Unify blit helpers of msaa and depth stencil msaa	2026-08-22 16:03:44 -04:00
CamilleLaVey	7102ff8ecb	Disable msaa tiler resolve + removal dead code from branch	2026-08-22 15:27:03 -04:00
CamilleLaVey	385b844e2a	Remove additional feedback loop checks	2026-08-22 14:58:23 -04:00
CamilleLaVey	518f571fcf	[TEST] Save space with Sync2	2026-08-22 04:42:36 -04:00
CamilleLaVey	e0d4318042	Fix build	2026-08-22 03:51:12 -04:00
CamilleLaVey	06ac01adb0	[TEST] MSAA unification paths on MSAA and DepthMSAA	2026-08-22 03:41:54 -04:00
CamilleLaVey	a6d49872a1	[TEST] Adjustments on the pipeline cache + optimized vertex buffer refinement	2026-08-22 03:34:01 -04:00
CamilleLaVey	b0b4817162	[TEST] Adjustments on MSAA	2026-08-22 02:49:06 -04:00
CamilleLaVey	9f776cfca7	[TEST] Adjustments on color write enable	2026-08-22 01:22:01 -04:00
CamilleLaVey	5b1613087c	Changes requested by reviewer meower	2026-08-22 01:07:34 -04:00
CamilleLaVey	b22a796f4b	Remove strings from rescale hack	2026-08-22 00:51:44 -04:00
CamilleLaVey	04cfc60756	Fix licenses	2026-08-22 00:48:13 -04:00
CamilleLaVey	6a3ff818e0	Revert "Extract pitch unswizzle pass from vk-experiments7"	2026-08-22 00:45:54 -04:00
CamilleLaVey	22b51d0c61	Extract pitch unswizzle pass from vk-experiments7	2026-08-21 23:19:49 -04:00
CamilleLaVey	78ce48e4ca	add finish on block linear pass	2026-08-21 23:00:15 -04:00
CamilleLaVey	9510516e68	Fix build	2026-08-21 22:41:03 -04:00
CamilleLaVey	33ae95f4ae	[TEST] Add Exchange initialization on 3D pass for linear unswizzling	2026-08-21 22:30:07 -04:00
CamilleLaVey	1cd118eccc	[TEST] Return FP16 + FP32 SZ nan-preserve on QCOM	2026-08-21 21:32:19 -04:00
CamilleLaVey	4bf30b41a6	ASDÑlasfu mfudgh rq	2026-08-20 19:49:12 -04:00
CamilleLaVey	6390edb76d	Remove FP32 sz nan preserve on QCOM	2026-08-20 16:33:14 -04:00
CamilleLaVey	f0ba93d75f	Here we go again	2026-08-20 15:36:22 -04:00
CamilleLaVey	68ff82679f	GIVE ME SOMETHING	2026-08-20 02:54:02 -04:00
CamilleLaVey	543d4dfc8e	[TEST] Bypass unresolved render	2026-08-20 01:48:16 -04:00
CamilleLaVey	e3be392b8a	[TEST] Wondering around cbuf live route	2026-08-19 23:58:21 -04:00
CamilleLaVey	b754fcc49c	[TEST] Ensure resolve shadow reads on msaa + shader extencil fallback	2026-08-19 22:40:54 -04:00
CamilleLaVey	a4c37b5117	Flush deferred clears tied to scissor entries on framebuffer	2026-08-19 20:49:54 -04:00
CamilleLaVey	8206c7abac	[TEST] Add clipping distances to GS	2026-08-19 19:05:47 -04:00
CamilleLaVey	faacc62b10	[TEST] Prune on passthrough stores	2026-08-19 17:42:09 -04:00
CamilleLaVey	b0a01ca629	[TEST] Add varyings to the legacy fallback when no gemoetry shader passthrough is available	2026-08-19 15:43:19 -04:00
CamilleLaVey	945d5c373b	[TEST] Added another MSAA depth stencil shaders to convert into non msaa + sanitize MSAA UINT/SINT path	2026-08-19 03:13:47 -04:00
CamilleLaVey	cb04b133ea	[TEST] Ported fix from tiled-gpu-v2 for ZBCTable	2026-08-19 02:54:25 -04:00
CamilleLaVey	ff3de66bab	Quick adjustment on deferred clears order	2026-08-19 02:33:19 -04:00
CamilleLaVey	3ce788b09c	Forcing off rescale hack	2026-08-19 01:55:02 -04:00
CamilleLaVey	2a1b9278b9	[TEST] MSAA depth stencil discard again	2026-08-19 00:41:14 -04:00
CamilleLaVey	842b5e0b3a	[TEST] New MSAA shader for UINT/SINT color	2026-08-18 23:03:37 -04:00
CamilleLaVey	2f83399798	[TEST] Removal of IsSafeDownload death path	2026-08-18 22:35:04 -04:00
CamilleLaVey	2e52ca5753	[TEST] Corroborating the dowload/copy on MSAA path	2026-08-18 21:22:25 -04:00
CamilleLaVey	69cd5ee0d1	[TEST] Improve the geometry shader handling	2026-08-18 20:51:29 -04:00
CamilleLaVey	1f0605c35d	[TEST] Remove the whole geometry shader changes	2026-08-18 20:07:28 -04:00
CamilleLaVey	b9c28ef6a1	[TEST] Return the previous geometry shader passthrough handling	2026-08-18 16:25:31 -04:00
CamilleLaVey	809a61f600	[TEST] Quick revert on MSAA clamp	2026-08-17 22:11:43 -04:00
CamilleLaVey	c7b24bad1a	[TEST] Vertex, Samplers limits adjustments based on hardware support + MSAA Sample Counts degradation	2026-08-17 20:00:06 -04:00
CamilleLaVey	4244a6418d	Fix license header + removal of ternary on depth stencil routes for msaa uploads	2026-08-17 17:57:13 -04:00
CamilleLaVey	26044e18e1	Re-apply commit	2026-08-17 00:57:17 -04:00
CamilleLaVey	04d08f0cf1	[TEST] Blitting on MSAA	2026-08-16 22:41:06 -04:00
CamilleLaVey	2bf037c7bb	[TEST] Swizzling adjustment on the new fast path	2026-08-16 20:52:37 -04:00
CamilleLaVey	f6668ef01b	[TEST] Adjustments over the vkformat undefined and border color swizzle	2026-08-16 19:59:23 -04:00
CamilleLaVey	20a775ed08	Another meow	2026-08-16 19:34:45 -04:00
CamilleLaVey	3379556d89	[TEST] Return Xenoblade workaround + extend srgb handling on border colors	2026-08-16 18:57:37 -04:00
CamilleLaVey	8e687924b8	Funny meows	2026-08-16 18:38:56 -04:00
CamilleLaVey	d3e8c5e977	[TEST] CustomBoderColor changes	2026-08-16 18:38:56 -04:00
CamilleLaVey	95e67e6533	[TEST] Aniso fixes	2026-08-16 18:38:56 -04:00
CamilleLaVey	bdd1785b04	[TEST] Quick change on depth's handling	2026-08-16 18:38:56 -04:00
CamilleLaVey	f9e5ac191e	[TEST] Depth stencil resolve + MSAA depth stencil	2026-08-16 18:38:56 -04:00
CamilleLaVey	f3a674c064	[TEST] MSAA uploads	2026-08-16 18:38:56 -04:00
CamilleLaVey	4aa35bc835	[TEST] Fix vkFormat accessors	2026-08-16 18:38:56 -04:00
CamilleLaVey	894f2544a0	[TEST] Geometry shader changes + barrier fixes	2026-08-16 18:38:56 -04:00
CamilleLaVey	ceffda663c	[TEST] Fix TFB subdependency	2026-08-16 18:38:56 -04:00
CamilleLaVey	27e7fa10d9	[TEST] Fix missing barrier + removal of required aligments checks inside swizzle textures	2026-08-16 18:38:56 -04:00
CamilleLaVey	d3bd4f42cf	[TEST] Adjustments on pipeline hash collisions	2026-08-16 18:38:56 -04:00
CamilleLaVey	5a8fb951dd	[TEST] Remove subpass dependency	2026-08-16 18:38:56 -04:00
CamilleLaVey	27942142cf	[TEST] Ported PSO optimizations from tiled-gpu-v2	2026-08-16 18:38:56 -04:00
CamilleLaVey	db647f9a40	[TEST] Another bind vertex buffer optimization from previous handling	2026-08-16 18:38:56 -04:00
CamilleLaVey	35aeb0cf55	[TEST] Playing with SGSR	2026-08-16 18:38:56 -04:00
CamilleLaVey	3423d3c6a5	[TEST] fast path on swizzle decoding	2026-08-16 18:38:56 -04:00
CamilleLaVey	607bc18ad4	[TEST] Bring the unswizzle work from tiled-gpu-v2	2026-08-16 18:38:55 -04:00