Skip to content

Veshiru v1.9.0

Choose a tag to compare

@github-actions github-actions released this 19 Nov 03:49
· 55 commits to main since this release
a4767d5

The Legend of Zelda: Ocarina of Time & 4–8 GiB GPU Performance

  • Play Report (prepo) command 10500 support: Implemented SaveReport command 10500 on
    prepo (eliminating fatal guest IPC panic 1A80A during Ocarina of Time sessions) and added
    domain request error naming in hle_ipc for clearer diagnostics.
  • Anti-gloom async pipeline & compute protection: Stopped asynchronous draw and compute skip
    policies from dropping unbuilt storage-image-writing graphics draws or image-only tonemapping,
    auto-exposure, and lighting compute dispatches, preventing temporarily dark or gloomy scene
    transitions while shaders compile in the background.
  • 4 GiB VRAM ASTC→BCn chunked transcoding & staging safety: Split large multi-layer GPU
    ASTC→BCn transcodes into VRAM-tiered 32/48/64 MiB layer chunks with post-decode in-flight
    throttling (fixing cold-cache staging buffer reuse corruption and mid-batch pipeline stalls),
    automatic queue-drain retry on transient VK_ERROR_OUT_OF_DEVICE_MEMORY, and inter-chunk staging
    flushes on sub-5 GiB GPUs, while keeping dedicated transient RGBA8 scratch allocations from
    falsely triggering persistent texture pressure eviction.
  • Unified-RAM / iGPU budget scaling (no more 2,048 MiB UMA & 4 GiB caps): Sized integrated and
    unified-memory GPUs across both BIOS UMA carveouts and shared system GPU heaps scaled to total
    unified RAM (plus full dedicated BIOS UMA utilization on handhelds and 24–128 GiB APUs), unlocked
    the Texture Cache Memory Limit UI spinbox up to the full unified memory ceiling instead of
    clamping at 512/2,048/4,096 MiB, and expanded live iGPU budgets cleanly when an explicit cache
    limit is configured while preserving host commit-room protection.
  • v1.8.0 frame-time & streaming regression fixes: Replaced four per-frame full-LRU texture
    walks (DeleteSupersededImages, RetireStaleTargets, and BadOverlap GC passes) with an O(1)
    dense overlapping-image index, tracked in-flight background vkFreeMemory bytes per heap so
    async frees never trigger phantom VRAM eviction loops or false budget pressure, eliminated
    duplicate VkImage creation in render-target allocation and raised device-buffer pool blocks to
    8 MiB, gated Windows PrefaultGuestMemory with a K32QueryWorkingSetEx residency check and
    zero-allocation contiguous iteration, switched Windows RealVfsFilesystem read hits to shared
    locking with FILE_SKIP_SET_EVENT_ON_HANDLE, short-circuited capped speculative readback walks,
    and stopped shared-cache JIT invalidations of uncompiled pages from halting running CPU cores.
  • Transient render-target & texture cache optimizations: Skipped redundant guest uploads for
    new single-level 2D render targets completely covered by prior GPU-written images, added a fast
    path with per-frame LRU deduplication in PrepareImage, cached graphics descriptor table host
    page pointers with 64-bit word comparison, and enabled depth/stencil-write render-pass tracking
    to avoid unneeded feedback-loop transitions.
  • DMA pushbuffer, staging pool & cyclic readback speedups: Restricted per-entry pushbuffer
    writer sync waits to titles requiring them, skipped unnecessary dirty checks when record reads
    are bypassed, switched deferred Vulkan staging buffer reclamation to sorted tick binary search,
    and pre-armed sequential GPU-to-CPU ring-buffer readback pages on step detection to cut first-hit
    synchronous CPU readback stalls.
  • Configurable VRAM Reserve (vram_reserve_mib) & Ocarina of Time AA tip: Added a VRAM
    Reserve
    setting under Settings → Graphics → Advanced (Auto default: 1/8 of driver budget
    up to 1,024 MiB) so 4–8 GiB GPUs can reclaim extra headroom for textures, and added an
    EDEN_NX2_OOT_AA=0 override matching Settings → Graphics → Ocarina of Time anti-aliasing → No
    sharpening
    (recommended on 4–6 GiB GPUs such as GTX 1650 to bypass three post-process compute
    passes for substantial GPU frame-time savings).

Vulkan, SPIR-V & Texture Compatibility

  • Lean multi-buffer SPIR-V global-memory helpers: Marked generated multi-buffer global-memory
    load, store, atomic, and CAS helper functions DontInline across classic graphics stages while
    keeping single-buffer routes (including NVIDIA OpSelect single-buffer compute shaders),
    branch-routed Compute, Task, Mesh, and emulated mesh-as-compute shaders inline, slashing
    SPIR-V bloat and pipeline compile times while preserving Ocarina of Time foliage and tree
    accuracy.
  • AMD mesh-shader fallback & NVIDIA driver reporting: Enabled compute mesh-shader fallback
    properly on AMD hardware where needed, formatted NVIDIA proprietary driver versions using their
    10-8-8-6 bit scheme, added a quiet A8B8G8R8_UNORM fallback for zeroed guest texture headers,
    and gated byte-offset texture header handles strictly to titles that use them.

Switch HOME Menu (qlaunch) Full Library & .nup / .nx Integration

  • Full .nup, .nx, NSP, XCI & NRO discovery on HOME Menu: Synthesized decrypted Control NCAs
    with locale-normalized NACP metadata, cached HD artwork fallback, and strict ≤128 KiB baseline
    JPEG icons (with automatic PNG/JPEG transcoding and procedural fallback tiles) so Switch 1 and
    Switch 2 .nup and .nx packages, uninstalled containers, and homebrew appear on HOME Menu with
    titles, publishers, display versions, real occupied sizes, and artwork — including via -qlaunch
    and regardless of external-content directory settings.
  • Switch 2 title aliasing & seamless frontend launch handoff: Deterministically aliased Switch
    2 0x0400... Program IDs onto HOME Menu-compatible IDs exclusively for system applets, fixed a
    byte-indexing bug in ListApplicationIcon and transfer-memory handling in
    ListApplicationTitle, deduplicated multi-source application records, and routed HOME Menu game
    launches through the frontend with preselected user profile preservation, full per-game settings,
    and Switch 2 extended DRAM.
  • HOME Menu, User Page & Power Menu polish: Implemented missing ns, am, acc, and friend
    calls (GetNintendoAccountUserResourceCache, GetPlayHistoryStatistics, IGlobalStateController
    sleep/reboot handlers, rights/record/gamecard queries), guarded non-NCA manual provider lookups
    and embedded GRenderWindow handle connections, eliminated duplicate HLE shutdown stops, added
    friendly log names for firmware applets, and cleaned up false-alarm avatar and network log spam.

Veshiru is a Windows-exclusive emulator: it is built and tested for 64-bit Windows 10 and 11 only.

Extract the entire zip and run veshiru.exe, or veshiru-cmd.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 zip PGO zip Both built with clang-cl and ThinLTO; the PGO zip uses a balanced multi-game Switch 1 & Switch 2 profile

The PGO build is compiled with profile-guided optimization using a balanced multi-game Switch 1 & Switch 2 runtime profile (veshiru-windows.profdata). Prefer it on modern x86_64 CPUs.