Repository navigation
Veshiru v1.9.0
The Legend of Zelda: Ocarina of Time & 4–8 GiB GPU Performance
- Play Report (
prepo) command10500support: ImplementedSaveReportcommand10500on
prepo(eliminating fatal guest IPC panic1A80Aduring Ocarina of Time sessions) and added
domain request error naming inhle_ipcfor 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 transientVK_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.0frame-time & streaming regression fixes: Replaced four per-frame full-LRU texture
walks (DeleteSupersededImages,RetireStaleTargets, andBadOverlapGC passes) with an O(1)
dense overlapping-image index, tracked in-flight backgroundvkFreeMemorybytes per heap so
async frees never trigger phantom VRAM eviction loops or false budget pressure, eliminated
duplicateVkImagecreation in render-target allocation and raised device-buffer pool blocks to
8 MiB, gated WindowsPrefaultGuestMemorywith aK32QueryWorkingSetExresidency check and
zero-allocation contiguous iteration, switched WindowsRealVfsFilesystemread hits to shared
locking withFILE_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 inPrepareImage, 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 (Autodefault: 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=0override 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 functionsDontInlineacross classic graphics stages while
keeping single-buffer routes (including NVIDIAOpSelectsingle-buffer compute shaders),
branch-routedCompute,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 quietA8B8G8R8_UNORMfallback 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.nupand.nxpackages, 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
20x0400...Program IDs onto HOME Menu-compatible IDs exclusively for system applets, fixed a
byte-indexing bug inListApplicationIconand 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, andfriend
calls (GetNintendoAccountUserResourceCache,GetPlayHistoryStatistics,IGlobalStateController
sleep/reboot handlers, rights/record/gamecard queries), guarded non-NCA manual provider lookups
and embeddedGRenderWindowhandle 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.