Compare commits

...

200 Commits

Author SHA1 Message Date
ParantezTech 0666071f79 [Tests] Cover backward red-zone spans, direct memory no-space results and the mount info size 2026-10-09 01:27:52 +03:00
ParantezTech ee9660d81d [Loader] Patch red-zone sites from the previous instruction when every indirect branch is resolved 2026-10-09 01:27:52 +03:00
ParantezTech 28b2f5709d [Kernel] Add sceKernelSync
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-09 01:01:48 +03:00
ParantezTech f7e8f54dbc [Stubs] Add sceTextToSpeech2Cancel and sceTextToSpeech2GetSpeechStatus
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-09 01:01:48 +03:00
ParantezTech afd0dffcf6 [SaveData] Write the mount info structure at its 48-byte guest size 2026-10-09 01:01:48 +03:00
ParantezTech cde859c5e5 [Tests] Cover random devices, POSIX open, UDS initialization, pad class data and exception contexts
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:41 +03:00
ParantezTech 757567bd15 [Pad] Add scePadDeviceClassParseData
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:41 +03:00
ParantezTech 62bbf51bbc [Pad] Write the device class extended information at its guest size
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:40 +03:00
ParantezTech c1a0da742f [NP] Reset Universal Data System state with the runtime
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:40 +03:00
ParantezTech ad0fd8be7b [NP] Create Universal Data System contexts before explicit initialization
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:40 +03:00
ParantezTech 6f2937936a [NP] Keep Universal Data System handles across repeated initialization
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:40 +03:00
ParantezTech 13b77eedcb [Cpu] Expose the guest exception context writer to tests
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:40 +03:00
ParantezTech a7bfef97ac [Cpu] Report the flags and Sony stack alias in guest exception contexts
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:40 +03:00
ParantezTech 10254a3c7e [Cpu] Place the guest exception mcontext at the start of the context
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:40 +03:00
ParantezTech 3d65921eb7 [Kernel] Report random device descriptors in fstat
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:40 +03:00
ParantezTech cd77a68c87 [Kernel] Close random device descriptors
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:39 +03:00
ParantezTech a662295409 [Kernel] Read random device descriptors from the host RNG
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:39 +03:00
ParantezTech 4d8f5a75d5 [Kernel] Open /dev/random and /dev/urandom as host RNG descriptors
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:39 +03:00
ParantezTech d3deab28aa [Kernel] Return POSIX results from _open and keep sceKernelOpen raw
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:39 +03:00
ParantezTech 8c0ca1a2a7 [Kernel] Clear the outputs and report no space when no direct memory span is free
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 23:44:39 +03:00
ParantezTech 9d530f63f9 [Tests] Cover controller ports, user exports, trials and open-file renames
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 18:25:29 +03:00
ParantezTech f945215935 [Kernel] Allow renaming and unlinking open guest files
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 18:25:29 +03:00
ParantezTech c37f76f12d [NP] Expose the game trials flag 2026-10-08 18:25:28 +03:00
ParantezTech 73666f529e [UserService] Add user number and termination exports
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 18:25:27 +03:00
ParantezTech 0e55fa924c [Pad] Track independent standard, special and remote port handles
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 18:25:26 +03:00
ParantezTech d3f584a2f1 [Tests] Match red-zone coverage to forward-only patching 2026-10-08 18:25:26 +03:00
ParantezTech dd6a936a12 [Tests] Cover Gen5 tiling, DCC clears and offline authentication
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:32:02 +03:00
ParantezTech c0028d304b [GPU] Materialize DCC slice clears from guest metadata
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:32:01 +03:00
ParantezTech ef10b4a1d8 [GPU] Track DCC metadata coverage for color targets and volume textures
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:32:00 +03:00
ParantezTech 7be8a4b389 [GPU] Decode DCC fixed and register clear values
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:31:58 +03:00
ParantezTech 1984901a31 [GPU] Use Gen5 render-target tile equations on the CPU and GPU
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:31:57 +03:00
ParantezTech 7b30868b03 [SpirvTranslator] Preserve F32 signed zero, infinity and NaN when supported
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:31:37 +03:00
ParantezTech dc3b1d305d [Loader] Report patching progress for large executables 2026-10-08 17:31:36 +03:00
ParantezTech 7866bd4217 [Loader] Preserve switch targets while patching guest red-zone accesses
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:31:35 +03:00
ParantezTech 30429400ed [PlayGo] Add install and optional chunk queries
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:30:10 +03:00
ParantezTech 78792d7a5a [PlayGo] Expose runtime state reset
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:30:09 +03:00
ParantezTech 7c08757173 [PlayGo] Keep chunk metadata parsing in the metadata loader
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:30:07 +03:00
ParantezTech 2a2ea5a35a [PlayGo] Keep unknown chunk lists empty
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:28:29 +03:00
ParantezTech 34e8900035 [Pad] Trace input state changes when requested 2026-10-08 17:28:28 +03:00
ParantezTech 923f75d340 [Pad] Add the n3kSX62fgNo compatibility export 2026-10-08 17:28:27 +03:00
ParantezTech 946bd0a777 [Json] Add the special-float format setter
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:28:26 +03:00
ParantezTech d31138fcca [Json] Track the global special-float handler
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:28:24 +03:00
ParantezTech 077c9a940f [Network] Add Ethernet address string conversion
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:28:23 +03:00
ParantezTech ea1dcbcea1 [Network] Close POSIX socket descriptors through sceNetSocketClose
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:28:22 +03:00
ParantezTech 53f233da9b [Network] Add socket epoll registration and readiness waits
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:28:05 +03:00
ParantezTech b368247d64 [SpirvTranslator] Match guest F32 denormal and trigonometric semantics
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:26:59 +03:00
ParantezTech c566dba5a1 [VideoOut] Add deduplicated volume texture binding traces 2026-10-08 17:26:58 +03:00
ParantezTech 8d884f2692 [GPU] Skip piece hashing for stencil association proxies 2026-10-08 17:26:56 +03:00
ParantezTech 679ea0f355 [Kernel] Warn when APR cannot resolve a resource path 2026-10-08 17:26:55 +03:00
ParantezTech 124dfa8afd [Np] Complete offline authentication requests as signed out 2026-10-08 17:26:54 +03:00
ParantezTech 1b66707daf [SharePlay] Report inactive share-play state
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:26:53 +03:00
ParantezTech 619ac2b367 [Network] Add the RUDP context lifecycle
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:26:52 +03:00
ParantezTech a1c0d7d36d [Videodec2] Decode guest access units into pitched NV12 frames
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:26:51 +03:00
ParantezTech 6cc753e0fc [AppContent] Report missing add-on content entitlements
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:26:50 +03:00
ParantezTech beedb746d9 [Kernel] Expose the process argument count and vector
Co-authored-by: Sekai <140012992+SekaixX@users.noreply.github.com>
2026-10-08 17:26:49 +03:00
ParantezTech 82c9731f74 [Libc] Add file-lock compatibility exports 2026-10-08 17:26:48 +03:00
ParantezTech d708227541 [Cpu] Prefer LLE for libc FILE-object exports 2026-10-08 17:26:47 +03:00
Berk b02c06181a
Unity fixes 1016p2 (#1062)
* [Audio] Snapshot AudioOut2 PCM when the guest submits it

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Audio] Drop the ports of a destroyed AudioOut2 context

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Audio] Accept sceAudioOut2MasteringSetParam

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Audio] Resolve AudioOut2 out-buffers from either ABI slot

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Audio] Report the AudioOut2 context memory size through its out pointer

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Audio] Keep the AudioOut2 queue level and availability pointers apart

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Audio] Report full volume in the AudioOut2 port state

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Audio] Trace AudioOut2 port, attribute and bed calls

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Audio] Let tests replace the AudioOut2 host streams

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Audio] Add the AudioOut2 vibration port type

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [SaveData] Lay out save data events with their title ID

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [SaveData] Add sceSaveDataBackup

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [SaveData] Add sceSaveDataDirNameSearch2

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Network] Track Http2 template and request options

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Network] Add Http2 option, cookie and request exports

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [CommonDialog] Add the web browser dialog lifecycle

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Json] Add the InitParameter2 base constructor

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Json] Add InitParameterRtti2::setAllocatorRtti

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [AvPlayer] Accept available bandwidth hints

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Tests] Cover the AudioOut2, save data, Http2 and dialog exports

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

---------

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>
2026-10-07 18:47:42 +03:00
kuba e1edda7772
Revert the 18 Silent Hill rendering and performance merges (#1065)
Restore review-only delivery at the user request. Reverts #1024, #1025, #1031, #1032, #1033, #1034, #1035, #1036, #1037, #1038, #1039, #1040, #1041, #1051, #1054, #1055, #1058, and #1059. The resulting tree matches 3e2ad633 exactly.
2026-10-07 12:15:45 +02:00
kuba 775141d58c
[GPU] Sweep CPU writes at memory visibility points instead of before every device-address program (#1033)
* [GPU] Sweep CPU writes for device-address programs at memory visibility points

A device-address program may read any mapped page, so before each such
draw or dispatch the buffer cache uploaded every CPU-dirty page whenever
the global CPU-dirty epoch had moved. A guest that streams its per-draw
ring while the command stream is being translated moves the epoch between
almost every pair of draws, and each upload ended the rendering scope and
drained the GPU with an ALL_COMMANDS barrier pair - about 670 times per
frame in Silent Hill: The Short Message's menu.

CPU writes only need to be visible at memory visibility points: when a
submission slice starts, when a wait packet is satisfied, and after a
command-processor memory write (later commands may read those bytes through
device addresses). The sweep now runs at the first device-address program
after such a point, and its uploads share one barrier pair instead of one
per buffer. SHARPEMU_BDA_SWEEP_EVERY_DRAW=1 restores the per-draw sweep.
Menu GPU time drops from about 435 to 290 ms per frame.

(cherry picked from commit fafe92b71271cf750dd89251891bac20fb87f1ff)

* [GPU] Let command-processor DMA writes turn pages CPU-dirty instead of copying

A DMA fill or copy into memory without GPU-written bytes is executed on
the CPU, and the bytes were then pushed into every overlapping cache
buffer through a staging copy and a barrier pair, which ends the
rendering scope (~60 per frame in Silent Hill: The Short Message's menu).

When no GPU-written byte shares the written pages, the pages now simply
turn CPU-dirty: every later GPU reader synchronizes CPU-dirty pages before
reading (bound buffers on obtain, device-address programs at the next
memory visibility point, which the write now raises), so the bytes still
arrive in command order. Pages that hold GPU-written bytes keep the
staging copy. SHARPEMU_DEFER_HOST_WRITES=0 restores the copy.

(cherry picked from commit 3fe21faa3821551fa99b9398064f0652e45d2e84)

* [GPU] Keep hot CPU-written pages writable across device-address sweeps

A page the guest rewrites every frame turns hot after two upload/write
cycles, and the bound-buffer path then serves it from the stream ring so
the page stays writable. The device-address sweep and the range
synchronization still re-protected hot pages after every upload, so the
guest's next write to each ring page took a protection fault - about
5,000 faults per second on Silent Hill: The Short Message's render
thread, each a signal round trip under Rosetta plus page-guard lock
traffic shared with the command worker.

Both sweeps now preserve hot pages: they stay dirty and writable and are
copied again on the next sweep, a few hundred KiB of ring memory per
sweep. Faults drop to a third and the menu goes from 3.8 to 4.2 FPS.
SHARPEMU_BDA_SWEEP_REPROTECT_HOT=1 restores the re-protection.

(cherry picked from commit 65d2b55ddc07644d52e5ad3112cbe323a2421abd)

* [GPU] Refresh writable hot pages at every BDA visibility point
2026-10-07 11:52:12 +02:00
kuba 38f7196470
[GPU] Add internal render resolution scaling (#1038)
* [VideoOut] Add an internal render resolution scale option

Adds the host-side setting an internal-resolution implementation needs:
--render-scale on the command line, SHARPEMU_RENDER_SCALE for scripted
runs, and a global and per-game choice in the GUI. The value is a host
resolution multiplier of the guest render targets, normalized to a
hundredth in [0.25, 2] so the command line, the GUI and the environment
agree bit for bit; the renderer compares scales when it decides whether
two views of the same guest memory match.

RenderScalePolicy holds the decision rule. It is a pure function of the
guest image description, so every view, alias, copy and descriptor of
one guest range reaches the same answer without consulting the cache.
Only screen-class, single-level, single-sample, uncompressed 2D render
and depth targets scale; block grids, multisample footprints, HTile and
DCC coverage, mip chains, cube and array faces, asset tilings and small
surfaces (shadow maps, lookup tables, eye-adaptation readbacks) keep
their guest resolution. The environment variable wins over the stored
setting so test runs do not depend on the user's configuration.

No renderer consumes the scale yet; a scale of one is the current
behaviour everywhere.

* [GPU] Hold scalable guest images at a host render resolution

The backing of an image the scaling rules accept is created at
ceil(guest * scale) while its ImageDescription keeps the guest geometry,
so the cache, the overlap rules and the page tracker go on reasoning in
guest bytes.

Everything that moves guest bytes now goes through a guest-resolution
twin of the scaled image: an upload fills the twin from the copy regions
the tiler built and blits into the backing, a download blits the backing
into the twin and copies out of it. A copy whose two images disagree on
host resolution runs at guest resolution the same way, so callers keep
describing rectangles in guest pixels; the destination seeds its twin
first because a partial copy is blitted back whole. The multisample
depth conversion takes a guest-sized source for the same reason, and the
resolve region crosses into the destination's resolution instead of
silently resolving the top-left corner.

Two fallbacks keep correctness ahead of the saving. A format that cannot
blit keeps its guest resolution, since the twin could never reach it.
A storage image drops back to guest resolution the first time a compute
shader binds it: the dispatch grid does not shrink with the host image,
so the shader would write it with holes above 1.0 and redundantly below.
The guest range is remembered, so every later image over that memory is
created unscaled too.

* [GPU] Scale the render area, viewport and scissor with the attachments

A resolved target now reports the host extent of its attachment beside
the guest one, and the three places that size rasterization follow it:
the dynamic rendering area, which also bounds every load-op clear; the
guest viewport transform; and the guest scissor, whose edges round
outward so no guest pixel the game asked for loses host coverage.

All attachments of a pass share one rule, so the first bound target
decides the factor.

The clip-disable path needs care because the vertex program bakes the
viewport transform against a reference extent. Dividing that reference
by an upscale keeps the host viewport (reference x scale) inside the
device limit while the baked transform stays scale independent, so the
same program maps guest pixels onto host positions at either resolution.
At a scale of one the reference is the device limit, exactly as before.

* [SpirvTranslator] Translate pixel positions and image coordinates across the render scale

A program expresses its pixel position, its integer image coordinates
and the sizes it queries in guest pixels, but the host may hold the
image behind any of them at another size. Which images are scaled is a
per-draw fact, so the factors travel in shader data rather than in a
permutation: the coordinate factor, its reciprocal, a 64-bit mask of
scaled image resources and the factor the pixel position is divided by.

With that:

- gl_FragCoord is divided by the attachments' factor as it is loaded, so
  POS_X/POS_Y, POS_FIXED_PT and everything derived from them - screen
  UVs above all - stay in guest pixels.
- An integer image coordinate is mapped onto host texels through the
  bound image's factor. Only the two scaled axes move; an array layer or
  a volume slice is not a pixel.
- A resource-info query reports the guest size, because the program
  derives coordinates and loop bounds from it.

A select against the mask makes an unscaled binding cost one
instruction, and the layout only carries the dwords when the scale is
not one, so nothing changes at native resolution.

* [GPU] Keep one host resolution across the attachments of a pass

A rendering scope has one render area, one viewport and one scissor, so
its attachments have to agree on a host resolution. They disagree when
one of them cannot be scaled at all - a depth target with a stencil
plane next to a scalable colour target, say - and the pass then renders
a fraction of its area. The draw now drops every scaled attachment back
to guest resolution and resolves its targets again; the guest ranges are
remembered, so the decision converges after one draw and cannot
oscillate.

That fallback only works if the executor knows what the cache actually
gave it, which is not what the scaling rules would answer: a demoted
range still looks scalable to them. The resolved targets therefore carry
the image's own factor, and the render area, viewport, scissor and the
depth/stencil copy extent read it from there.

Two rules change with it. DCC only describes guest bytes the host never
stores, so a colour target that carries it can still be scaled; HTile
encodes guest depth blocks the renderer reads back as clear state and
stays native. And a storage image only drops back when the program
actually writes it, since a read-only load is mapped correctly.

Scaling now also requires a backend that installed the format
predicate - the Vulkan device - so the Metal host is unaffected.

* [Docs] Describe internal resolution scaling and its limits

Replaces the note saying arbitrary internal resolution scaling is not
implemented: it is, for screen-class render and depth targets. Records
what the renderer translates (rasterization, shader coordinates, guest
transfers, presentation), the exact rule for what scales, every case
that falls back to guest resolution, the artefacts measured on Silent
Hill, and the per-scope GPU times at 50, 100 and 200 percent.

* [SpirvTranslator] Preserve guest texel offsets at scaled resolutions
2026-10-07 11:47:58 +02:00
kuba 8acc081205
[GPU/HLE] Cut per-draw and per-call managed allocations on hot paths (#1054)
* [GPU/HLE] Cut per-draw and per-call allocations on hot paths

* [HLE] Keep nested tracker uploads from sharing rollback scratch
2026-10-07 11:36:27 +02:00
kuba 98f223ce69
[GPU] Restore scene visibility and half-wave shuffles (#1025)
* [Agc] Emit addressed draw events for occlusion query counters

* [Gpu] Keep fallback occlusion results coherent and conservatively visible

* [Gpu] Honor disabled color buffers during depth-only draws

* [Gpu] Upload complete unchecked constant vertex attributes

* [Agc] Emit direct draws for every draw modifier

sceAgcDcbDrawIndex and sceAgcDcbDrawIndexAuto returned without writing a
packet unless the modifier was exactly 0x40000000. The modifier names the
shader stage and user registers of the bound pipeline, so any other
pipeline lost its draws without a trace. Unreal bakes its color-grading
LUT through a geometry-stage pipeline, which left the LUT unwritten and
tinted every 3D frame of Poppy Playtime blue.

Both draws now emit their packets for any modifier. Modifiers other than
the vertex-stage default are logged once each.

(cherry picked from commit 8d46a6068b7d1a999662eeac1ee17f9e6d87c2eb)

* [VideoOut] Separate guest display mode from presentation buffer dimensions

* [GPU] Map half-wave shuffle lanes into the host subgroup

* [Docs] Explain display modes and internal resolution limitations

* [GUI] Translate guest display mode settings in all supported languages
2026-10-07 11:21:15 +02:00
kuba 8b631d3b03
[GPU] Avoid command-worker readbacks for clean bytes on GPU-dirty pages (#1059)
* [GPU] Read clean command bytes without faulting on neighbouring GPU data

* [Tests] Enable portable Vulkan devices and release fixture slabs
2026-10-07 11:21:09 +02:00
kuba a9356eb8d2
[GPU] Read guest buffers back from unified memory without a copy (#1058)
A CPU read of GPU-written guest memory recorded a copy at the tail of
the current command buffer and waited for it, so it also waited for
every draw recorded after the writer. In Silent Hill's title menu most
of those reads targeted buffers whose writer had retired long before,
and UE's render thread spent a third of its time in them.

On a device with device-local, host-visible, coherent memory (Apple
GPUs), guest buffers are now allocated there. A readback whose writers
retired copies straight out of the buffer's mapping; one whose writer
is submitted but still running waits for that submission alone and then
copies; the command worker submits a writer that is still recording
and reads after it. A guest-thread wait also marks its window hot, so
the next GPU write there is submitted right after its command.
SHARPEMU_UNIFIED_BUFFERS=0 keeps device-local buffers.
2026-10-07 11:02:22 +02:00
kuba a73e424a27
[macOS] Fix the Rosetta GC wedge, a CPU-flip buffer-wait deadlock and frozen host movies (#1051)
* [CLI] Restart under Rosetta with a 64 MiB gen0 GC budget

Every collection suspends the runtime through FlushProcessWriteBuffers,
which Rosetta 2 services by parking each thread in its runtime
(notify_thread_waiters). A signal that reaches a parked thread trips
Rosetta's "expected saved LR to be in translated code" assertion and
wedges the process; Demon's Souls hit it in about half of its 3-5 minute
runs while collecting almost twice a second. The gen0 budget is only read
from the environment, so the process re-executes itself once with
DOTNET_GCgen0size set (same pid). With 64 MiB, Demon's Souls collects
about once every 6 seconds, gen0 and gen1 only, 0.26 s of pauses in
110 s. A 512 MiB budget made every collection a blocking gen1/gen2 pass
of about a second. SHARPEMU_ROSETTA_GC_BUDGET=0 opts out.

* [VideoOut] Let a buffer wait ignore CPU flips the graphics queue has not reached

sceVideoOutSubmitFlip reserves its flip request, may sleep for pacing,
and only then queues the flip preparation on the graphics queue. A
command buffer submitted before it that starts with
sceAgcDcbWaitUntilSafeForRendering on the same display buffer saw the
reserved request as pending and waited for a preparation queued behind
itself: the graphics queue never advanced and every compute queue waiting
on its labels stalled with it. Demon's Souls hung this way on the boot
splash in about one run in three.

A CPU flip now counts for the wait only once the graphics queue runs its
preparation; GPU flips are ordered from their packet.

(cherry picked from commit 8915df35abad5fe8b15cc6418f1e563785d6e008)

* [Media] Expire a host movie only once its playback stops advancing

Host playback follows the guest's own Bink decode and audio clock, so on
a slow host a movie plays slower than real time. The watchdog fired at
the movie's duration plus a minute regardless, marked the file timed out
and forced EOF on the guest's reads while its decoder was still
mid-stream: Demon's Souls' 171 s attract movie froze on its last
host frame for good. The watchdog now re-arms while frames keep
advancing and expires a movie only after a minute without progress.

(cherry picked from commit daad0f097d0c6369097aeef32b55c9f2d171110a)

* [CLI] Preserve the managed entry point when restarting under Rosetta
2026-10-07 11:02:17 +02:00
kuba a0fd9dcb83
[GPU] Restore half-float arithmetic and image readback state (#1024)
* [Gpu] Cover the whole tile plan when a buffer reads back an image

TrySynchronizeBufferFromImage sized the copy from the mip layout, but the
tile plan of a fully fitting image can extend past it; Silent Hill hit a
128x128 slice planned at the exact end of the mip chain and the tiler
aborted the process. Grow the copy to the plan's tiled end when the
buffer holds it, otherwise keep the guest bytes.

* [SpirvTranslator] Read half-selected V_FMA_MIX literals as f16

op_sel_hi marks a V_FMA_MIX operand as f16 for literals too, but literals
were always read as f32 bit patterns. Silent Hill's deferred lighting
weights a luminance with the f16 literals 0x34CD/0x38B8/0x2F0A (0.30, 0.59,
0.11); as f32 denormals they made the luminance zero, the shader clamped it
to 1e-4 and divided by it, and the title-menu scene came out thousands of
times too bright, which auto exposure then turned black.

* [Gpu] Materialize every fixed DCC clear code on a sampled image

A DCC fast clear stays pending until the surface binds as a colour target;
when a shader samples the surface first, only the clear-to-zero code was
materialized. The other fixed codes (alpha 1, rgb 1, rgba 1) carry their
own colour too. Silent Hill fast-clears UE's separate-translucency target
to (0,0,0,1) and only samples it, so the post composite read stale zeros
and the whole title-menu scene came out black.

* [SpirvTranslator] Keep wave64 LDS phase barriers when a half-mask plan applies

The half-mask plan's barriers order its own mask exchanges, not the
program's shared-memory traffic, yet planning a program switched the LDS
phase ordering off. UE's FFT bloom (wave64, 512 threads, LDS butterflies)
then read half-written rows: Silent Hill's convolution output collapsed
into a flat haze (max 56 for a scene peaking above 1500) and the histogram
fed by it never adapted exposure.

* [Gpu] Publish linear GPU-written images to guest memory by default

Unreal reads its eye-adaptation result back on the CPU through a linear
staging texture (FRHIGPUTextureReadback) and derives View.PreExposure from
it. The image cache was built with linear readback disabled, so the CPU
always read zeros, PreExposure stayed 1.0 and the scene rendered without
pre-exposure. FFT bloom's bright-pixel prefilter, which works in
pre-exposed space, then flattened every pixel to its max luma and the
Silent Hill title menu came out nearly black. SHARPEMU_READBACK_LINEAR_IMAGES=0
restores the old behaviour.

* [Tests] Enable MoltenVK portability devices in headless harness

* [SpirvTranslator] Saturate V_CVT_PKRTZ_F16_F32 at 65504 instead of overflowing to infinity

Rounding toward zero never produces infinity from a finite value: past the
f16 range the result is +-65504. We truncated the mantissa and let
packHalf2x16 round, so large values became infinite. Silent Hill's deferred
lighting packs title-menu values past 65504; its height fog then multiplies
scene color by a tiny transmittance, which keeps 65504 finite but leaves an
infinity infinite, a later pass turns it into NaN and the whole 3D menu
background renders black. Subnormal results now also keep whole 2^-24 steps.
A MoltenVK device test covers overflow, truncation, subnormals, NaN and inf.

* [Tests] Wait for the blocked worker before publishing its signal
2026-10-07 10:59:57 +02:00
kuba 4e6d1e0d9a
[HLE/Cpu] Remove host lock contention from POSIX memory queries, thread resumes and timed waits (#1031)
* [HLE] Answer POSIX host memory queries without the mapping lock

Every HLE import that reads stack arguments queries the guest stack's
protection first. On POSIX the query took the same lock Protect holds
across its mprotect call, and GPU write tracking protects pages
constantly, so each query waited tens of microseconds; Silent Hill: The
Short Message spent up to a second of every five seconds in queries.

Regions are now also published as an immutable snapshot (replaced under
the lock when a region is added or removed), and a query of untracked
memory or of a region without per-page overrides is answered from it
without the lock. Regions with overrides keep the locked path, which now
finds where a protection run ends through an ordered set of overridden
pages instead of visiting every override (write tracking leaves tens of
thousands), and the next region by binary search. Query time drops from
200-1000 ms to 5-50 ms per 5 s.

This is the POSIX counterpart of replacing page-by-page VirtualQuery
scans on Windows.

(cherry picked from commit b6ffe31f28fa93842726b71315c7731f97b5fda8)

* [Cpu] Sleep through nanosleep, resumed on EINTR, in the POSIX Sleep stub

The POSIX stand-in for kernel32!Sleep (which the native sceKernelUsleep
intrinsic calls with milliseconds) converted to microseconds and called
usleep. macOS rejects usleep(>= 1 s) with EINVAL and returns at once, so
every guest sleep of a second or more came back immediately; and a
signal (the runtime's thread activations, for one) ended any sleep early
through an error the stub never looked at.

The stub now builds a timespec and calls nanosleep, and when nanosleep
returns EINTR it resumes with the remaining time. A test exercises the
stub with the Win64 argument register for both a 1.2 s and a 20 ms
sleep.

(cherry picked from commit 43b770f86b5e3aa2332121f1bc2ddf2acc9d2968)

* [HLE] Query POSIX view regions from a lock-free snapshot

Every HLE import first queries the guest stack's protection, and the
view-region query took the same gate the GPU write tracker holds across
its mprotect calls, so each import waited on page-protection traffic
from other threads (the main guest thread spent ~2% of its time in that
wait at Silent Hill: The Short Message's menu).

The region list is now also published as an array snapshot whenever it
changes, and queries read the snapshot without the gate. Per-page
protections already changed in place and were read racily; nothing
changes there.

(cherry picked from commit d7e72cb4974388883696516420b2e9d462778715)

* [Cpu] Skip the scheduler gate when a host thread re-registers the same guest context

scePthreadSelf on a guest thread the scheduler does not own registers
the thread's context on every call, and that took the scheduler-wide
gate each time - tens of thousands of times a second on Silent Hill:
The Short Message's main thread, contending with the dispatcher and
every blocked-thread wake.

Each host thread remembers the handle and context it registered last;
a repeat registration only refreshes the external-handle hint and
returns. New or changed registrations still take the gate.

(cherry picked from commit d1991b2b75261cd1f1ccb4e005b10805f0da24c1)

* [Cpu] Keep each thread's guest continuation stub instead of mapping one per resume

Every resume of a blocked guest thread allocated a 512-byte executable
stub page and a host-RSP slot, and released both when the thread blocked
again: an mmap/munmap pair plus two acquisitions of the host-memory gate
per resume, which the GPU write tracker holds across its own protection
changes. Contended on that gate, resumes were 62% of all lock waiting in
Silent Hill: The Short Message's menu.

Each host thread now keeps a stub page and slot per nesting depth for its
lifetime; a resume reopens the page for writing with mprotect directly
(the page is emulator-private, so it bypasses the tracked host-memory
layer), re-emits the stub and seals it again. Lock waiting across threads
halves (13.6 s to 6.5 s per 30 s).

(cherry picked from commit 2c2293abdd5d19dd1be3d6941dcedf9b482c6420)

* [Kernel] Round host condvar waits up to whole milliseconds

Monitor.Wait truncates its timeout to milliseconds, so a timed wait with
less than 1 ms left became a zero timeout and spun until the deadline.
UE's game thread waits for the render fence in 1 ms slices, which kept a
host core busy for the whole wait and contended the condvar lock with the
signaling threads. Timed waits may wake late, so round up instead.
SH menu 4.29 -> 4.64 fps together with the readback retry change.

(cherry picked from commit 66eaa0095fe594ff8e285cbf31c32bd84274ac85)

* [Tests] Run the POSIX Sleep stub test only in x64 processes

The stub is x86-64 machine code; a native arm64 test host cannot map or run
it, so the macOS arm64 CI runner failed to allocate the stub page.
2026-10-07 10:56:03 +02:00
kuba d809f84491
[SpirvTranslator] Share one EXEC test across a run of vector ALU writes (#1040)
A vector register write is modelled as select(EXEC, result, old value), so the
old value of every register the shader writes stays live across the write. That
guard is the translator's largest per-instruction cost: dropping it altogether
(wrong results) takes Silent Hill's volumetric-fog compute from 13.43 to 10.64
ms, and the exec-full analysis can only prove 194 of its 875 instructions run
with every lane set.

A run of instructions whose only effect is their vector destination can instead
run inside one if (EXEC). The masked-off lanes skip the whole run, which is what
the hardware does to them anyway, and only the join needs the old values. A run
stops at anything the wave runs even where this lane is masked off: SALU is not
EXEC masked and every invocation keeps its own copy of the scalar registers, a
compare writes VCC or EXEC (GFX10 keeps that destination in the instruction's
control, not in its destination list), a cross-lane read needs its neighbours to
have run, and LDS, memory and the DPP encodings reach outside the register. Six
instructions is where the branch starts paying for itself.

Compute only: the same grouping made the deferred lighting pixel program 28%
slower (11.03 -> 14.11 ms per scope), where a wave already runs with helper
lanes. SHARPEMU_EXEC_RUN=0 turns it off, SHARPEMU_EXEC_RUN_MIN sets the length.

Silent Hill title menu, same build, SHARPEMU_EXEC_RUN=0 vs on:
  offline replay min ms   fog D5DF9DC46C4E35EA  13.42 -> 12.21 (-9.0%)
                          FFT 674E5A7163897BC9  16.37..17.38 -> 17.06 (flat)
                          NGG B482CD3A01A37F0F   0.494 ->  0.492 (unchanged)
  in-game ms per dispatch fog D5DF9DC46C4E35EA  16.59 -> 15.34 (-7.5%)
                          FFT 674E5A7163897BC9  13.81 -> 13.77
                              2BFB24830D8FCFAA   4.78 ->  4.58 (-4%)
  in-game ms per scope    848AFAD7/9D180B8A     11.03 -> 11.36 (unchanged SPIR-V)
                          F987C1A4/379BE850      1.90 ->  1.72 (unchanged SPIR-V)

spirv-val passes on the fog, FFT and NGG modules; the menu image is unchanged
with Anita present.
2026-10-07 10:52:01 +02:00
kuba da0953845b
[SpirvTranslator/Vk] Cheaper guest buffer loads and f16 conversion, gated on device probes (#1035)
* [SpirvTranslator] Load dword-aligned 32-bit formatted buffer components as words

A formatted untyped buffer load decodes the descriptor format at run time,
reading every component byte by byte through the generic layout select
chain. For dword-aligned 32-bit data formats (32, 32_32, 32_32_32,
32_32_32_32) with a raw-bit number format (UINT, SINT, FLOAT) a component is
one buffer word; that branch loads it directly and applies the same swizzle
and bounds rules. The descriptor is uniform, so the branch does not diverge.
UE GPU-skinning vertex shaders fetch bone data this way; Silent Hill: The
Short Message's menu goes from 1.3 to 2.0 FPS.

(cherry picked from commit 20540cd153855964d817daf065de3e243fd547bd)

* [SpirvTranslator] Convert f16 with the native pack/unpack when the host measured it exact

Every packed-f16 (VOP3P) lane widens its operands to f32 and rounds the
result back, and both conversions were the branchless integer sequences in
EmitHalfToFloat / EmitFloatToHalf: about twenty scalar ops each, because
GLSL UnpackHalf2x16 / PackHalf2x16 have no guaranteed rounding or subnormal
behaviour without float-controls execution modes. A device capability bit
does not settle it either - MoltenVK on Apple silicon reports
shaderRoundingModeRTEFloat16 and shaderSignedZeroInfNanPreserveFloat16 yet
not shaderDenormPreserveFloat16 - so only a measurement can.

ShaderCompileRequest.NativeHalfConversionExact, which the host sets only
after measuring the two ext instructions against these sequences on the
running device, swaps both helpers for the single ext instruction the
driver lowers to one hardware convert. It defaults to false, so an
unmeasured device keeps the exact emulation.

Silent Hill f2 volumetric fog dispatch: 30.7 -> 21.9 ms per dispatch in
replay, output unchanged.

(cherry picked from commit 10f76eeac0d4306172e41ecff86b737f6a3c9634)
(cherry picked from commit 7f18cc96ae58ac5fd47da6562c4ba3abe22ccb4a)
(cherry picked from commit 972f658033f8339effe42c5d305af87bcbab93f0)

* [Vk] Probe f16 conversion at device setup and report the verdict

A one-time compute pass at device setup measures the device's GLSL
UnpackHalf2x16 / PackHalf2x16 against the translator's own f16 conversion
before any guest shader is compiled, and only a clean measurement lets the
translator use them (ShaderCompileRequest.NativeHalfConversionExact). The
vectors cover all 65536 f16 bit patterns, every f16 value widened to f32,
the midpoint between adjacent f16 values and that midpoint one f32 ulp
either way, the overflow edge, signed zeroes, infinities, NaNs and f32
subnormals, and each is measured in both directions: 643200 comparisons.

Every finite value, zero and infinity must be bit-exact, sign included. A
NaN only has to stay a NaN, because neither side defines its payload: the
emulation picks sign | 0x7C00 | 0x200 narrowing and carries the f16 payload
widening, while the measured hardware convert canonicalizes to a positive
quiet NaN. On an Apple M4 that is the only disagreement - 2314 of 643200,
every one a negative NaN whose sign the hardware cleared - and f16
subnormals convert exactly despite shaderDenormPreserveFloat16 being false.

The probe never fails device setup: any error leaves the exact emulation in
place and says so on the reported line. SHARPEMU_NATIVE_HALF=0 forces the
emulation, =1 takes native without measuring. The result is one line:
  [VK][F16] native half conversion exact=True mismatches=0 tested=643200

The flag reaches the translator through IShaderPipelineHost, so it is
process-constant and cannot mix two translations of one program; the saved
driver pipeline cache keys its entries by the module it was given, and the
Metal host does not probe and keeps the emulation. Offline replays run the
same probe, so a case translates the way the game would.

(cherry picked from commit 6a343683d890b4c6d123c84fdacb41e718ec4c19)
(cherry picked from commit 65ca663aa2bfb1fcc69709c73ab6189b07ead3c1)
(cherry picked from commit 003b1216bd311e5c5fb1d48ca01a66efa3fc51de)

* [SpirvTranslator] Read an unaligned buffer word as a funnel shift of two words

The byte-wise decode of a formatted buffer load read each byte of a component
from its own bounds-checked word load: four loads, four range tests and a byte
assembly for a value that spans at most two words. One funnel shift of those
two words is the same value, including out of range, where a word reads zero on
both paths and so contributes zero bytes. Every sub-dword buffer load goes
through the same helper.

The decode is the branch a formatted load takes when its address is not dword
aligned, so its size also sets the register pressure of the aligned branch next
to it. Silent Hill: The Short Message's volumetric fog dispatch
(0xD5DF9DC46C4E35EA, 8 formatted loads in its light loop) goes from 8.68 to
7.28 ms in offline replay, and the module from 394 to 360 KiB. An experiment
that dropped the byte-wise branch entirely measured 7.35 ms, so the funnel
shift is worth all of what the branch cost.

(cherry picked from commit 0c996ffab38144d795517e68cb2ca9d8d48e8988)

* [SpirvTranslator] Load a guest buffer word unchecked where the device zeroes out-of-range reads

Every guest buffer word is read through a range test, an address clamp and a
zero select: three operations whose only purpose is to produce the zero the
hardware returns past the end of a V#. A device with robustBufferAccess2 that
honours it returns that zero itself, so the three are pure overhead there -
dropping them measured about 12% of Silent Hill's volumetric fog dispatch, 482
checked words in one program.

ShaderCompileRequest.ZeroOutOfBoundsBufferReads turns them off and defaults to
false: an out-of-range read is undefined without the promise, so only a host
that measured the device may set it. It is set from a device probe, never from
a capability bit, because MoltenVK runs on Metal, which has no hardware bounds
checking.

(cherry picked from commit 2ba626a0ac7157f93f348cfe7573ff1092762d8c)

* [Vk] Probe out-of-range buffer reads at device setup and report the verdict

A one-time compute pass binds 1 KiB of a 4 KiB allocation that carries a
sentinel everywhere and reads all 4 KiB back through the descriptor: the words
inside the range must still read their sentinel and the words past it must read
zero. Only a clean measurement lets the translator drop the range test, address
clamp and zero select it puts around every guest buffer word
(ShaderCompileRequest.ZeroOutOfBoundsBufferReads).

The probe only runs where the device enabled robustBufferAccess2, because an
out-of-range read is undefined without it and can fault the device; everywhere
else it reports the reason and the checks stay. On this Apple M4 through
MoltenVK the feature is not supported at all, so nothing changes:
  [VK][OOB] out-of-range buffer reads zero=False mismatches=unprobed tested=0
      note=robustBufferAccess2 is not enabled on this device

SHARPEMU_ZERO_OOB_READS=0 keeps the checks, =1 drops them without measuring.
The flag reaches the translator through IShaderPipelineHost, so it is
process-constant and cannot mix two translations of one program.

(cherry picked from commit e81d924349042acc1122a66d4c767268bd6ef2a4)
2026-10-07 10:51:57 +02:00
kuba db32c9d882
[SpirvTranslator] Cut emulated-wave64 and private-LDS overhead in translated shaders (#1034)
* [SpirvTranslator] Keep pure scalar lane spills in private slots under emulated wave64

A wave64 program run as a 64-thread workgroup on a 32-lane host emulates
v_readlane with an LDS exchange and a workgroup barrier. Compilers use
constant-lane v_writelane/v_readlane pairs on a VGPR as SGPR spill slots;
when that VGPR is written only by constant-lane writelanes and read only by
constant-lane readlanes, each (vgpr, lane) pair is a private scalar, so the
readlane loads the slot instead of exchanging through LDS. This halves the
heaviest compute dispatch in Silent Hill: The Short Message's menu.

(cherry picked from commit 9915b88e68b6b69d6b74ea931a22eb0589c56f1a)

* [SpirvTranslator] Zero private LDS lazily through a written-dword bitmap

Graphics stages model LDS as a per-invocation private array that must
read zero where the invocation has not written. The array carried a zero
initializer, but Metal keeps a dynamically indexed private array in stack
memory, so every invocation cleared all of it: an NGG vertex shader (the
PS5 default, with in-shader culling through LDS) cleared 8 KiB per vertex.

The array is now uninitialized and a zero-initialized bitmap of written
dwords (1/32 of the size) records which slots were addressed; LdsPointer
zeroes a slot the first time it is addressed, so loads, stores and atomics
keep the zero-read semantics. Compute LDS stays workgroup memory.
Silent Hill: The Short Message's menu, dominated by ~45M shadow-pass
vertices per frame, goes from about 2.0 to 3.1 FPS.

(cherry picked from commit 5738b8574397cf2be08cd4e1518b33057c8867b5)

* [SpirvTranslator] Test the lane's mask bit in one register under emulated wave64

VCC and EXEC keep a per-lane boolean that every mask write refreshes, and the
refresh composed the 64-bit mask from its two registers, built a 64-bit lane
bit and masked them. A host without 64-bit integer arithmetic (Apple GPUs
through MoltenVK) emulates each of those with a pair of 32-bit operations. The
bit lives in exactly one of the two registers, so selecting that register and
shifting inside it is the same test in 32-bit arithmetic.

Only the emulated-wave64 path changes; wave32 already tested one register, and
a native wave64 host keeps the existing form, which also clears the bit for
lanes outside the guest wave.

(cherry picked from commit 1b2651047fdf232304142c82168e487244dda4ef)

* [SpirvTranslator] Let s_barrier publish only what the guest waited for

Every compute s_barrier became an OpControlBarrier with AcquireRelease
over uniform, workgroup and image memory, on the assumption that the
guest had drained vector memory first. s_barrier only orders execution;
what it publishes is whatever the preceding s_waitcnt drained. A barrier
that follows an LDS-only wait (lgkmcnt(0)) publishes LDS, and ordering
device memory there costs a cache flush the guest never asked for: UE's
FFT bloom convolution barriers 48 times per group, all LDS-only.

The translator now tracks, per block, whether any wait drained vector
memory - SOPP vmcnt(0), or the GFX10 SOPK vscnt(0)/vmcnt(0) forms, since
stores are counted by vscnt there - and a barrier after an LDS-only wait
carries workgroup memory only. A drained counter stays drained for the
rest of the block, and a barrier with no wait in its block keeps the
full semantics (the wait may be in a block this one cannot be ordered
against).

(cherry picked from commit 1f81df59bc07d05f2baa6283da95f4901dada444)
2026-10-07 10:51:52 +02:00
kuba 30321142cb
[GPU/Vk] Keep guest readbacks of GPU-written memory off the command worker (#1032)
* [Vk] Run async readbacks on a second general queue family when no dedicated one exists

The async readback queue was only taken from a family without graphics,
so drivers that expose several general families (each its own hardware
queue) kept every guest readback on the main queue and the command
worker. Any other family with transfer support now qualifies after the
dedicated transfer and compute families.

(cherry picked from commit 7b04d6185dfc1711f0fbdf5c75c842a065acd1fa)

* [GPU] Let guest reads of GPU-written memory wait on the main queue off the worker

A guest thread reading memory the GPU wrote hands the download to the
command worker, which recorded the copies, submitted and then waited for
the whole GPU before handing the bytes back - unless a dedicated readback
queue existed, where the download ran asynchronously and only the guest
thread waited. MoltenVK exposes one queue family in-process, so on macOS
every such read idled the worker for tens of milliseconds, several times
per frame in Silent Hill: The Short Message's menu (a quarter of the
worker's time).

Without a readback queue the worker now copies the pieces into a buffer
of their own, submits without waiting and returns a pending download
carrying the submission tick; the guest thread waits for that tick on the
timeline (safe from any thread) and completes the read back on the
worker, as the readback-queue path does. The worker's GPU wait time drops
to zero; SHARPEMU_MAIN_QUEUE_PENDING_READS=0 restores the synchronous
path.

(cherry picked from commit 6c9ad44bcea7f9396a7564621fcbda3841834052)

* [GPU] Re-issue a stale pending readback instead of reading synchronously on the worker

A guest read of GPU-written memory records a copy and waits for its tick
off the queue. When another GPU write lands first, the completion fell
back to a synchronous read on the command worker, which stalled it until
the GPU drained (up to half of SH's readbacks). The guest thread now
re-issues the pending read and waits again; only the fourth attempt falls
back to the synchronous read.

(cherry picked from commit 17bf5bb958ebfd4dd980dbf241cbe9e77fffd938)
2026-10-07 10:51:48 +02:00
kuba 1e784a035f
[SpirvTranslator] Keep the packed-half vector registers in one variable per register (#1041)
The f16 fast path shadowed the whole vector register file with a 512-entry
private array of vec2 and zero-initialised it, even though every access uses a
constant register number. That is the array shape Metal keeps in thread memory
instead of registers - the same trap V_MOVREL's dynamically indexed register
file hit (Octopath's instanced vertex shader, 112 -> 6.4 ms/draw) - and it also
left AMD with an unused 4 KiB .bss global that broke two-stage links. One
private variable per register, declared on first use, removes it.

308 of the 1019 shaders Silent Hill's title menu translates used the array,
including the two hottest pixel programs. The generated Metal for the
volumetric-fog compute D5DF9DC46C4E35EA drops from 282 KB to 269 KB and no
longer declares a 4 KiB thread array. Measured GPU time on the menu is
unchanged within run-to-run noise (fog 18.2/19.9 -> 20.1 ms per dispatch,
pixel 934F121D8F666572 0.048/0.061 -> 0.041 ms per scope), so this is a
code-shape fix that removes the spill risk rather than a measured win.
2026-10-07 10:49:01 +02:00
kuba 7ab6de1b93
[GPU] Cut per-draw command-worker cost in resource materialization and pixel input setup (#1039)
* [ShaderCompiler] Materialize directly for plans whose cached inputs never repeat

The materialization cache records every guest word a draw reads and keys
the result on the draw's user data. Most Silent Hill draws point their
user data at per-draw constants, so only 8% of lookups hit and every miss
still paid for recording the reads and storing an entry. A plan now
counts its lookups and hits; after 64 lookups with fewer than one hit in
eight it walks its resources directly and probes the cache again on every
64th draw. On the SH title menu the command worker's busy time per draw
fell from ~125 to ~111 us (cache hit rate of the remaining lookups 70%).

* [GPU] Scan a pixel program's interpolated attributes once per decoded program

Every draw scanned all instructions of its pixel program twice, once
through a LINQ chain with Distinct/Order/ToArray, to count interpolated
attributes and the vertex outputs they read. The sorted attribute set
is a property of the decoded program, so it is computed once and kept
beside it. Pixel input resolution on the SH menu dropped from ~14 us to
a few us per draw.
2026-10-07 10:48:57 +02:00
kuba 70dcbe4e05
[GPU] Keep sampled depth attachments in one rendering scope (#1037)
Draws that sample the depth attachment need its read-only layout; every
other draw got the writable layout, even one that only tests depth. A run
of depth-sampling particles between test-only draws flipped the layout on
every draw, and each flip ended the rendering scope. Image state tracking
also recorded a barrier whenever the access changed, even from one read
to another in the same layout.

A draw that neither samples nor writes the attachment now keeps the
read-only layout it is already in, and reads after reads in one layout
record no barrier: the tracked state accumulates every reader, so the next
writer still waits for all of them. Depth-transition scope breaks in
Silent Hill: The Short Message's menu drop from ~1250 to ~820 per 5 s.

(cherry picked from commit 5563417d72fadefb115b300291b1e019b3171466)
2026-10-07 10:48:52 +02:00
kuba 0aa611e317
[GPU] Draw non-indexed indirect draws from their arguments on the GPU (#1036)
Indexed indirect draws already let vkCmdDrawIndexedIndirect read their
counts, but a non-indexed DRAW_INDIRECT read its four arguments on the
CPU. When a compute pass had just written them (UE writes rectangle-list
draw arguments this way every frame), the read downloaded the buffer and
waited for the whole GPU: about one 20-50 ms stall per frame in Silent
Hill: The Short Message's menu.

The interpreter now hands the argument address to the host when it draws
non-indexed indirect draws on the GPU (deferring the instance count read
as the indexed path does), and the executor records vkCmdDrawIndirect.
The guest layout (vertexCount, instanceCount, firstVertex, firstInstance)
is VkDrawIndirectCommand. Rectangle lists use the general rectangle-list
variant, since the count is unknown; fans, polygons, legacy lists and
targetless draws (which may be retained and replayed) still read the
arguments on the CPU. SHARPEMU_CPU_INDIRECT_DRAW=1 keeps the CPU path.

(cherry picked from commit f2b91befb7dd27d65a35546f1e57dc88f04a5c82)
2026-10-07 10:48:47 +02:00
kuba 435bbd4844
[Cpu] Copy page-sized guest memcpys on the managed path (#1055)
The native memcpy fast path copies with rep movsb straight into guest
memory. Pages the GPU reads are write-protected so CPU writes can be
tracked, so a copy into them takes one protection fault per page, and
under Rosetta each fault is a signal round trip of about 0.2 ms. The
managed memcpy marks the whole destination written before it copies and
takes no faults. Copies of at least 4 KiB now leave the stub for the
managed export; smaller ones keep the native copy, where one import
transition would cost more than the copy. SHARPEMU_MEMCPY_MANAGED_MIN
overrides the threshold.

Demon's Souls, 230 s through the PlayStation Studios intro: 536k
write-tracking faults become 71k, and the intro presents about a fifth
more frames.
2026-10-07 10:48:00 +02:00
ParantezTech 3e2ad63303 [readme] New screenshots v2 2026-10-06 19:07:24 +03:00
ParantezTech ac8608449f [readme] New screenshots 2026-10-06 19:07:06 +03:00
Berk 2df6f5b0a0
Unity fixes 1016p1 (#1043)
* [HLE] Let schedulers report guest thread stack bounds

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Core] Report the mapped stack of each guest thread

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Validate pthread stack bounds before reporting them

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Report every guest thread's stack in pthread attributes

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Publish semaphore handles as 64-bit values

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Accept zero-count semaphore signals

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Route semaphore waits through one core

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Poll host semaphore waits and deliver guest exceptions

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Add scePthreadSemTimedwait

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Remove every pending copy of a deleted event

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Block timed event queue waits in the guest scheduler

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Refresh pending user data when an event is re-added

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Keep every end-of-pipe interrupt event

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Track deadlines and POSIX results on sync waiters

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Poll host sync waits in bounded slices

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Share the sync-on-address wait and wake cores

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Kernel] Add _umtx_op wait and wake

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Np] Track WebApi2 user contexts and push filters

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Np] Add sceNpWebApi2PushEventDeleteHandle

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Np] Add sceNpWebApi2PushEventRegisterCallback

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Tests] Cover kernel sync, pthread stack bounds and NpWebApi2

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [GPU] Accept HTile-backed compressed stencil targets

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Tests] Cover HTile-backed compressed stencil targets

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [GPU] Accept stencil targets with or without HTile backing

* [Tests] Cover stencil compression with and without HTile

* [ShaderCompiler] Treat V_CMPX as an EXEC write in every encoding

* [Tests] Cover SDWA V_CMPX in the EXEC-full analysis

* [GPU] Give images first found without metadata the DCC metadata of a texture request

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Tests] Cover DCC metadata adopted from a texture request

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [GPU] Number command stream submissions in admission order

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [GPU] Queue control barriers behind accepted command streams

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [GPU] Cancel pending control barriers when the command stream fails

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [GPU] Cancel pending control barriers when the command stream is discarded

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [GPU] Run relay work after accepted command streams

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [VideoOut] Order relay work behind the presenter command stream

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [GPU] Let backends run work after pending command streams

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [VideoOut] Run state changes after pending command streams

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Metal] Run state changes after pending command streams

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [VideoOut] Close ports after pending command streams

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [VideoOut] Unregister buffers after pending command streams

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

* [Tests] Cover ordered video-out state changes

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>

---------

Co-authored-by: Sekai <140012992+igettingit@users.noreply.github.com>
2026-10-06 18:43:21 +03:00
Berk a17aaca533
Astro playroom shaders (#1030)
* [Vulkan] Enable shader clip and cull distances

* [Vulkan] Track shader clip distance support

* [ShaderCompiler] Add a clip distance support flag to compile requests

* [GPU] Expose host clip distance support to pipelines

* [GPU] Pass clip distance support to shader compilation

* [ShaderCompiler] Reserve a clip plane for position exports

* [ShaderCompiler] Cull primitives with a zero position

* [GPU] Bind vertex buffers with their guest descriptor sizes

* [GPU] Accept B10G11R11 float vertex attributes

* [GPU] Spill oversized image readbacks to a temporary buffer

* [GPU] Carry DCC metadata on compressed textures

* [GPU] Mark sampled DCC clears through the metadata fill path

* [Tests] Cover vertex descriptor bounds and oversized image readbacks

* [GPU] Revert binding vertex buffers with their guest descriptor sizes

* [GPU] Carry DCC metadata only on single-layer 2D textures

* [Tests] Cover DCC metadata on 2D, 3D and array textures
2026-10-06 01:32:13 +03:00
ParantezTech 83abe47b6e [readme] re-order 2026-10-05 16:29:03 +03:00
ParantezTech d6c4778218 [readme] added warning for not official sites, donations etc. 2026-10-05 16:27:41 +03:00
ParantezTech 5965b07c7b [Logging] Skip "tbb_thead" without LogThreadMode 2026-10-05 16:18:27 +03:00
ParantezTech 4a822aedb9 Merge branch 'main' of https://github.com/sharpemu/sharpemu 2026-10-05 15:36:18 +03:00
ParantezTech 22bbcb1415 [readme] update screenshot 2026-10-05 15:36:01 +03:00
T 9e99769ce5
[GPU] Report mip statistics for sampled textures so streamed textures reach full detail (#1029) 2026-10-05 14:39:40 +03:00
Berk 41a1912cd9
[SRT] Compile shader resource plans in the background (#1028)
Each shader resource plan is compiled once to a DynamicMethod that evaluates
its resource table graph with plan-local value slots instead of the
interpreter's hashed cache. ASTRO's PLAYROOM goes from about 20 to 60 fps.

Compilation runs on a low-priority "SRT compiler" thread; until a plan is
ready, the interpreter evaluates it, so a new shader no longer stalls the
render thread while its plan is JIT-compiled. A plan whose compilation fails
stays on the interpreter. SHARPEMU_SRT_NATIVE=0 turns the compiled path off;
it is also off when the runtime does not support dynamic code.
2026-10-05 01:19:33 +03:00
Berk 0163750e7e
Page fixes (#1023)
* [DeS] Fixes for page faults and stack bounds issues in the emulator and audio fixes

* [ShaderPrewarm] Hold the game until the prewarm finishes and resume interrupted runs

The prewarm compiled thousands of compute pipelines on background threads
while the now faster boot ran beside it, so logos, Bink movies and the first
scenes raced the compile and dropped frames.

- Hold the guest at its first splash hide, GPU submission or CPU flip until
  the prewarm is decided and done; the render thread keeps presenting the
  splash. SHARPEMU_SHADER_PREWARM_WAIT=0 opts out.
- Stamp only the shader translators, the compiler type and the driver, so a
  Libs-only build no longer triggers a full prewarm.
- Record finished pipelines in shader-prewarm.progress so an interrupted
  prewarm resumes with the remaining ones.

* [AudioOut2] Block a blocking push only until a queue slot frees

A blocking sceAudioOut2ContextPush waited only when the host stream hit its
128 KiB cap, so a title rendering faster than real time kept about 680 ms
queued and every sound played that far behind (GTA V: queue=2 context,
queued_ms avg=678). The push now waits until the device holds the cushion
plus QueueDepth-1 grains, the level GetQueueLevel already reports as full;
the host cap stays as the limit for non-blocking bursts. GTA V now holds
about 41 ms with no underruns.

* [GPU] Run bounded modulo copies of plain words on the host

Demon's Souls copies its per-frame constant and descriptor tables with a
compute kernel (dst[i] = src[i % N] for i < count). Run on the GPU, the
destinations stay GPU-dirty, and every draw whose resource tables read them
waits for a readback: about 19% of the render thread in the title scene,
for values that never changed.

The kernel is now recognized by its instruction sequence. When both
descriptors are plain 32-bit words of the same format and neither range is
GPU-dirty or GPU image memory, the copy is written to guest memory through
the host DMA path and the dispatch is skipped; anything else still runs on
the GPU. SHARPEMU_HOST_BOUNDED_COPY=0 turns it off.

Title scene with profiling: 7.4-8.6 -> 11.8-15.9 fps.

* [Diagnostics] Summarize synchronized table reads and trace several writer addresses

SHARPEMU_TRACE_GPU_READS=1 now also reports, every five seconds, the guest
words resource planning read through a GPU synchronization: read count, how
often the value changed, and the first and last value. SHARPEMU_TRACE_WRITER_ADDRESS
accepts a comma-separated list.
2026-10-04 19:07:37 +03:00
Berk 57e0da2150
Revert "[DeS] Fixes for page faults and stack bounds issues in the emulator a…" (#1022)
This reverts commit ec0198f2d0.
2026-10-04 05:57:24 +03:00
kuba cb42e849d7
[VideoOut] Keep guests on SDR output under Auto HDR on macOS (#1020)
Upstream e7a4f0a0 started reporting HDR to the guest whenever the display
has HDR enabled. On an HDR Mac, Silent Hill switches its output to HDR,
a guest pipeline then fails to compile in MoltenVK (ushort4 output to a
BGRA8 attachment) and the process crashes inside MoltenVK on every run.
Auto now stays SDR on macOS; --hdr=on still opts in.
2026-10-04 05:39:24 +03:00
Berk ec0198f2d0
[DeS] Fixes for page faults and stack bounds issues in the emulator and audio fixes (#1021) 2026-10-04 05:38:49 +03:00
ParantezTech 8903e3760b [readme] update screenshot 2026-10-04 04:28:03 +03:00
T d4891229e9
[SpirvTranslator] Shader fixes (#1019)
* [ShaderCompiler] Fix packed 10 and 11 bit buffer format layouts

* [SpirvTranslator] Pass W as the pixel position input instead of its reciprocal

* [SpirvTranslator] Keep lane spills in per invocation slots for all 64 lanes

* [SpirvTranslator] Match the hardware float conversion and NaN rules

* [SpirvTranslator] Apply VOP3 sign modifiers to conditional mask sources

* [GPU] Download guest DCC metadata before a known target is sampled

* [ShaderCompiler] End bit scan image tables at a sampler loaded from the same base

* [ShaderCompiler] Treat image table candidates with unsupported formats as null
2026-10-04 01:17:02 +03:00
Berk 6fe8b87f48
chore: bump version to 0.0.5-nexus (#1018) 2026-10-03 05:15:35 +03:00
ParantezTech 375d434353 [readme] update game order and screenshot 2026-10-03 05:13:13 +03:00
Berk 0c616d80ff
[Font] Fix font face creation (#1010) 2026-10-03 05:04:56 +03:00
Berk ddaf7ffe5b
Perf computed shaders (#1013)
* [Gpu] Recognize AGC's loaded-value buffer fill as an image/metadata clear

Octopath clears its DCC with a shader that s_buffer_load_dwords the fill value
from a one-record buffer and stores it at every thread index; only the variant
with the value in user data was recognized, so the DCC fast clear of UE's
translucency layer was lost and the layer kept stale alpha 0, which erased the
world map under it in the composite.

* [Vk] Bind descriptor sets instead of push descriptors on MoltenVK

MoltenVK returns zero from OpArrayLength for storage buffers bound through
push descriptors, so every bounds-checked buffer load read zero and every
store was dropped. In Poppy Playtime this left UE's motion blur indirect
dispatch arguments unwritten; the GPU then ran a 4294967295x1612x1490
dispatch and hung, and the game aborted on the render thread timeout.

* [ShaderCompiler] Size compute LDS to the dispatch's allocation

Every compute module declared the full 32 KiB of workgroup memory, which on
Apple GPUs leaves one workgroup resident per core. Declare the dispatch's
COMPUTE_PGM_RSRC2.LDS_SIZE (plus the wave64 bridge dwords), rounded to a power
of two so the index mask still bounds accesses. Silent Hill's heaviest per-pixel
pass (LDS_SIZE=4) replays in 11 ms instead of 46 ms.

* [Loader] Guard frame-pointer spill slots that live in the guest red zone

Host signal frames are pushed onto the guest stack, so GuestRedZonePatcher
protects functions that keep live data in the 128-byte red zone. It only
recognized RSP-relative accesses. Clang spills just as often through the frame
pointer: after 'push rbp; mov rbp, rsp' and N callee-saved pushes, RSP sits at
RBP-N and every [rbp-d] with d > N is below RSP. A fault taken there (lazy
commit, write tracking) overwrote those slots, which showed up as garbage
pointers on random threads in Poppy Playtime's level load.

Derive RBP-to-RSP from the standard prologue (leading pushes and the first
'sub rsp, imm') and treat [rbp-d] in (delta, delta + 128] as red-zone use. An
under-estimated delta only widens the guarded window. In Poppy's eboot this
protects 787 functions instead of 485.

* [AvPlayer] Report a loaded source as active before playback starts

sceAvPlayerIsActive answered true only after sceAvPlayerStart. Titles poll it
after adding a source and before starting playback; Superliminal waits for it
to turn true before it calls Start, so New Game never left the loading screen.
Report a player as active from the moment its source is loaded until it is
stopped or reaches its end, and track Stop explicitly so a stopped player
stays inactive.

* [Gpu] Copy the mips of a GFX10 mip tail block written through its own view into the chain

GFX10 packs every mip smaller than half a swizzle block into one block at the
start of the chain. A title can render into that block through a single-level
view exactly the size of the block: Unity's screen-space reflection blur writes
mips 3 and up of its 1024x512 color pyramid through one 128x64 view. The cache
keeps that view as its own image, so the chain's tail mips kept stale data and
sampling them produced rainbow blobs over Superliminal's menu.

When a chain is acquired with data, look for a GPU-written single-level image
at the chain's address with the tail block's extent, format and tile mode, and
copy each tail mip out of it at its placement inside the block. A per-image GPU
write sequence makes the copy happen once per new write.

* [SpirvTranslator] Give each used register its own private variable

The translator kept the scalar and vector register files as two private arrays
(128 and 512 uints) in every module. MoltenVK lowers a private array that size
to per-thread memory, so every register read and write in every invocation went
through memory. Declare one private variable per register the program touches,
on first use; the SPIR-V is otherwise unchanged.

* [ShaderCompiler] Resolve V_MOVREL* with selects instead of a spilled VGPR array

A program with any V_MOVREL* instruction declared its whole VGPR file as a
512-entry private array indexed at run time, which Metal spills to thread
memory, so every register access became a memory access. Keep one variable
per register and resolve relative accesses with a select over the registers
the program names. Octopath's instanced vertex shader (1536 x 8124): 112 ms ->
6.4 ms per draw in replay, output byte-identical.

* [AvPlayer] Start a player on its own when the title registers no event callback

Reporting a loaded source as active before Start regressed Quake, which
waits for its player to go inactive before starting its queued intro
videos. A player left loaded but unstarted stays active forever. Only a
title that registers an event callback can see the ready state and call
sceAvPlayerStart itself, so a player whose title asks for autoStart or
registers no callback now plays by itself once its source is ready,
reaches the end of the stream and reports inactive. Titles that start
playback themselves keep seeing a loaded source as active.

* [Gpu] Recognize AGC's constant buffer fill as an image/metadata clear

Octopath clears the DCC of its 1920x2200 DOF/bokeh accumulation target with a
third fill kernel: v_mov_b32 v1, 0 and buffer_store_format_x v1 at the thread
index, with only the destination descriptor in user data. It was not
recognized, the DCC fast clear was lost, and the additive bokeh pass kept
blending onto the previous frames until the target held thousands and inf,
which showed as noise and banded garbage over every 3D scene.

Program info now carries the constant a program stores when it is only index
arithmetic, one v_mov of a constant and one buffer store; a one-buffer 32-bit
formatted fill over every record with that value becomes a clear.

* [Vk] On macOS, retire a GPU tick only once its submission's fence signals

MoltenVK records Metal command buffers with unretained resource references
and signals a Vulkan timeline semaphore from a Metal event scheduled at the
end of the command buffer. That event can fire before Metal has finished
executing the command buffer, so a host thread that treats the timeline
value as authoritative can free resources the GPU is still reading. Metal
API validation reports this as "destroyed while still required by a command
buffer", and the resulting use-after-free showed up as intermittent GPU
tick stalls.

Every submission that signals the timeline now also signals a VkFence, which
MoltenVK signals from the Metal command buffer's completion handler. The
timeline value a host thread is allowed to act on is clamped to just below
the oldest tick whose fence has not signaled yet, and a timeline wait is
followed by a blocking wait on the last fence covering that tick. Fences are
pooled, tracked before the submit so no reader can observe a signaled tick
without its fence, and reset only once no thread is blocked on them. Fences
are polled at all only when the timeline already claims the tick is done, so
the common path costs one queue peek. The behaviour is macOS-only and can be
turned off with SHARPEMU_FENCE_RETIREMENT=0.

* [Vk] Refuse push descriptors on macOS for every device through one policy

The guard that refuses push descriptors on MoltenVK keyed on the
VK_KHR_portability_subset device extension, but that extension is not
enumerated for every device: the headless device the draw replay and the
device tests create took the raw driver limit, so replays on macOS read
guest storage buffers past their first bytes as zero (MoltenVK reports a
zero OpArrayLength for buffers bound through push descriptors).

The limit now comes from one policy both the presenter and the headless
device use, and macOS, whose only driver is MoltenVK, pushes none
regardless of which extensions are listed.

* [SpirvTranslator] Order emulated wave64 LDS phases in every block

A guest wave64 spans two host subgroups. The guest orders one lane's LDS
write before another lane's read by executing in lockstep, so the translator
puts a workgroup barrier between the halves wherever the wave switches
between writing and reading LDS. It only did so for programs of a single
block, which left every program with branches -- an NGG geometry stage
compute program has seventeen exec-skip branches around its ES to GS LDS
exchange -- reading the other half's LDS words with no ordering at all, so
the result depended on timing.

Every guest branch condition is wave-uniform in this emulation (EXEC and VCC
tests go through the wave mask and SCC is scalar), so every block is entered
by the whole wave and may hold a barrier, exactly as the wave64 ballot
exchanges already do. A block can be reached from either phase, so its first
LDS access always starts with a barrier.

* [Vk] Keep the rendering scope open across barriers and guest cache flushes

Tile-based GPUs pay for every rendering scope: ending one stores the
attachments out of tile memory and beginning the next one loads them back.
The presenter ended the scope for three things that do not actually need it.

An image barrier that repeats an attachment access in the same layout only
matters to work that runs after the scope, because accesses to an attachment
inside one scope are already ordered by rasterization order. Such barriers
are now queued and recorded as the scope ends instead of ending it.

A guest cache flush (a global memory barrier) inside a scope whose draws only
wrote attachments is deferred the same way, and every scope now opens with
that global barrier so anything recorded before the scope stays ordered
before its draws. A draw whose vertex or pixel stage stores to buffers,
storage images or device addresses ends a scope with a deferred flush first,
so a store can never move ahead of it. Finally, the DMA fill and copy entry
points no longer end the scope up front: the buffer cache completes most
transfers in guest memory, and the paths that do record GPU work end the
scope themselves.

SHARPEMU_DEFER_GLOBAL_BARRIERS=0 restores ending the scope at every flush.

* [SpirvTranslator] Take wave32 EXEC/VCC lane state from the low register

In wave32 a lane mask is its low register alone: EXEC_HI and VCC_HI are
ordinary SGPRs. Writing one of them therefore must not recompute the wave
lane state, and the lane state has to be tested against the low dword rather
than against a 64-bit mask composed from the low and high registers.

The lane-bit test that guards this covered the wave64 constant width only, so
it now accepts a mask of either width.

* [AudioOut2] Pace one grain per Advance+Push cycle and report the queue level

sceAudioOut2ContextAdvance and sceAudioOut2ContextPush each submitted the
context's pending PCM and, whenever nothing reached a host device, each slept
a whole grain in the software pacing fallback. A title that calls Advance then
Push once per grain therefore spent two grain periods per grain, so its audio
thread ran at half real time and held up every thread waiting on it.

Advance now claims the next grain on the context's clock and returns without
blocking (or, when its own submit already blocked in the backend, marks the
grain served), and Push waits for the grain Advance claimed; a Push with no
preceding Advance claims one itself. Neither call skips pending PCM. Because
the output holds QueueDepth grains, a grain may be queued as soon as the grain
QueueDepth-1 ahead of it starts playing, so a context can run that far ahead
of real time before a push blocks.

sceAudioOut2ContextGetQueueLevel reported an empty queue with the full depth
available on every call. Titles size their rendering by those two values --
Wwise renders exactly puiAvailableQueues grains per update and pushes them
non-blocking -- so a queue that never filled made it render a full queue every
update and then block inside Push for a grain per push while holding its audio
lock, which starved the game thread. The level now comes from the context's
grain clock, or, once a grain has reached a host device, from that device's
queued milliseconds beyond a short cushion.

* [Vk] Keep one depth attachment layout for draws that do not sample it

The depth attachment layout followed each draw's depth/stencil write mask, so
a draw sequence that toggles depth writes — opaque geometry, then decals and
translucency — changed the layout every few draws, and every layout change
ended the rendering scope.

The read-only attachment layouts are only required when the draw also samples
the attachment. Every other draw now uses the writable layout for the
aspects the format has, and the write mask alone selects the access, so the
layout stays constant and the scope survives. The presenter answers whether a
texture bound for the draw being prepared views the depth attachment's
subresources, defaulting to yes for hosts that do not track it.

* [Audio] Sleep for the SDL queue's drain time instead of polling every ms

Submit's backpressure wait is what paces every audio grain on the SDL
output, and it polled the queued byte count with Thread.Sleep(1), costing
the audio thread several wakeups per grain.

It now sleeps for the time the device needs to drain back under the queue
cap, still bounded by the existing deadline and the maximum wait.

* [CLI] Shut down cooperatively on SIGTERM

SIGTERM (launchd, process managers, kill) used the runtime default and
exited with GPU work in flight. It now takes the same host-interrupt path
as Ctrl+C: the presenter closes and tears Vulkan down before exit.

* [SpirvTranslator] Fold constant integer and boolean instructions

The translator materializes a good deal of translation-time knowledge as
SPIR-V instructions: a specialized descriptor's buffer format, swizzles,
strides, and the conditions that guard host-guaranteed ranges all end up as
arithmetic, comparisons and selections over operands the builder itself just
emitted as constants. That reaches the driver as runtime work, and on Metal
every one of those instructions costs pipeline-creation time.

The module builder now remembers the value of each 32-bit integer and boolean
constant it emits and folds pure instructions over them while it builds:
integer arithmetic, bit operations, shifts, bitfield extraction, the integer
and logical comparisons, the logical connectives, and a selection on a known
condition. Folding happens at emission, so a folded result feeds further
folding without a separate pass. Anything whose operands are not all known
constants is emitted exactly as before.

The buffer format decoder uses this directly: a specialized descriptor makes
the unified format a constant, so it decodes on the host instead of emitting
a module-level lookup table and an indexed read.
The test that covered that path asserted the table's presence and now asserts
its absence.

* [SpirvTranslator] Skip host-guaranteed bounds checks and unused LDS

Two sources of instructions the driver has to compile but can never need.

A read of a planned slot in the host-flattened resource table is always
inside the table the host binds, because the table holds every planned read
and written range. Those loads nevertheless carried a runtime array-length
compare and two selects each; a large pixel shader made about 376 of them.
A slot below the planned reserved word count now loads directly, and only a
slot computed at run time keeps the check.

ds_swizzle and ds_bpermute exchange data between lanes and GDS instructions
address the global data share, so none of them touches LDS. A graphics stage
that uses only those was still given the 8 KiB zero-initialized private LDS
array, which Metal pays for in compile time and in private memory per
invocation. The array is now declared only for instructions that really
address LDS.

* [Cpu] Answer pthread_self and pthread_getspecific in native stubs

The managed import gateway costs a guest-to-host stack switch, a full guest
register pack, a GCHandle dereference and the whole dispatch bookkeeping
before the HLE export even runs. For the two hottest trivial imports that is
three orders of magnitude more work than the answer itself: one UE5 title's
load measured 12.9M scePthreadGetspecific calls (38 s of wall time) and 4.3M
scePthreadSelf calls, at roughly 2.9 us each.

The few values those two imports need are now published into a per-host-thread
native block whose address lives in a native TLS slot, rebound whenever a
thread enters or is restored as a guest thread, and the two imports are
patched to emitted x86-64 stubs that read the block directly. pthread-specific
values live in native per-thread tables so a stub and the managed export read
exactly the same storage and cannot drift apart. The managed path stays the
source of truth for every case a stub declines -- no block published, no guest
thread bound, no value table, a key outside the table -- which it reaches by
jumping to the import's normal trampoline with every register intact,
including the incoming RAX variadic vector count.

The value-table slot follows whichever handle the current thread reports, the
bound guest thread or the host thread's own synthetic handle, so
pthread_getspecific is answered on unbound host threads as well; the primary
execution thread never enters through the guest-thread path and is a major
caller in UE5 titles. The self-handle slot stays guest-only, because
pthread_self on an unbound thread registers that thread's CPU context with the
guest scheduler and must keep reaching the managed export. Each stub also
bumps a per-thread hit counter, reported next to the existing HLE cost
histogram, so a call that misses the stub is visible rather than invisible.

The stubs are gated to macOS x64, where the emitted TLS read matches the
platform's pthread key array, and switched off whenever import or pthread
tracing needs every call to pass through the gateway.

* [CPU] Run libc memcpy/memmove as a native guest-side stub

Guest memcpy went through the managed gateway on every call: two write
tracking notifications, the memory reader lock and two region lookups, about
0.8 us per call under Rosetta even for a copy of a few bytes. Dreaming Sarah
makes roughly 45k of those calls a second.

Guest memory is identity-mapped, and every fault a copy can take -- write
tracking, lazy commit -- is resolved from the fault address alone, so the copy
can run as a forward rep movsb in a fast-path stub. A destination that sits
inside the source, where a forward copy would read bytes it has already
written, and the write-watch diagnostic both keep the managed export.

* [SpirvTranslator] Fill the FRONT_FACE and ANCILLARY pixel inputs

A pixel shader that enables FRONT_FACE or ANCILLARY reads those VGPRs, but the
translator only reserved their compact slots and left them reading zero.

Unreal Engine bakes its colour grading LUT one volume slice per instance and
has the pixel shader read the slice back out of ANCILLARY[28:16], the render
target array index. With that register zero every slice was baked from the
blue = 0 slice, so the tonemapped image lost its blue channel.

ANCILLARY is now the Layer built-in placed at bit 16, and FRONT_FACE the
FrontFacing built-in mapped to 1.0f for a front face and 0 for a back face,
which satisfies both the float greater-than and the integer not-equal tests
compilers emit for it.

* [SpirvTranslator] Fill the SAMPLE_COVERAGE and POS_FIXED_PT pixel inputs

The two remaining reserved pixel system inputs were also left reading zero.
SAMPLE_COVERAGE now reads the first element of the SampleMask built-in, and
POS_FIXED_PT packs the integer pixel position taken from FragCoord, x in bits
[15:0] and y in bits [31:16], so no enabled pixel system input is left unset.

* [CPU] Run the POSIX signal handler on the host stack for guest faults

Guest faults are delivered on the guest stack, and the managed handler ran
there. The runtime only knows the thread's own stack; Windows swaps the TEB
stack bounds while guest code runs, but POSIX has no equivalent. A garbage
collection during a guest fault then misread the thread's frames and
reported garbage object references, and the process failed with "attempted
to call a UnmanagedCallersOnly method from managed code". A small native
trampoline now moves to the host stack below the frames that entered guest
code before it calls the managed handler.

* [VideoOut] Give every swapchain image its own sRGB-encode intermediate

A float guest flip is blitted through an sRGB image before it is copied into
the UNORM swapchain image, and one such intermediate served every frame. Each
frame discards its contents by transitioning it Undefined -> TransferDst
before blitting, so with two frames in flight the next frame's blit raced the
previous frame's copy-out and the presented image came out fully zeroed. The
guest's own display buffers held the correct picture the whole time, so the
window simply went black for long stretches.

Each swapchain image now owns its own intermediate, created and destroyed with
the swapchain, so a frame can only ever discard the intermediate belonging to
the image it is about to present.

On Superliminal the same run went from 60 of 84 presented-swapchain readbacks
black to 10 of 187, all of them from before the menu appears, and the menu no
longer turns black after a couple of minutes.

* [VideoOut] Present a flip only after the tick that copied it

CaptureFlip recorded the display-surface copy into the guest batch, flushed
it, and then read the shared _submitTimeline field for the presentation's
RequiredTick. The presenter thread writes that same field from its own
submission, so the flip could be tagged with an older tick that was already
complete. The render loop then blitted the freshly created (never written)
flip snapshot, which presents as fully zeroed RGBA - a black frame with an
alpha of 0. Take the tick that this flush returned instead.

* [VideoOut] Pool the per-flip display-surface snapshot images

CaptureFlip created a 1920x1080 RGBA16F VkImage with its own VkDeviceMemory
for every flip and destroyed both when the flip retired: around twenty
vkCreateImage plus vkAllocateMemory pairs a second for the same extent, and on
MoltenVK as many Metal texture allocations.

Retired snapshots are now kept in a small per-format, per-extent pool and
handed back instead. A snapshot is fully overwritten by the copy that follows
it and its barrier takes it from Undefined, so neither its previous contents
nor its layout matter. The pool holds at most eight images, is guarded because
the command-stream thread takes snapshots while the render thread retires
them, and is drained at teardown. SHARPEMU_FLIP_SNAPSHOT_POOL=0 turns it off.

* [CPU] Bridge SIGFPE into the guest fault handler so #DE crashes are reported

The POSIX bridge installed handlers for SIGSEGV, SIGBUS, SIGILL, SIGTRAP and
SIGABRT, but not SIGFPE. A guest integer divide by zero therefore took the
runtime default and killed the process with no exception record and no guest
context, so the faulting instruction was invisible.

SIGFPE now routes to the same handler and is reported as an integer divide by
zero. Like SIGILL, it skips the image write tracker, which only ever resolves
data-access faults.

* [Cpu] Resolve GPU-tracked page faults before building the exception context

A CPU access to a page the GPU memory tracker protects faults on every first
touch after an upload or a GPU write, thousands of times a second in a frame.
The POSIX bridge converted each one into a full Win64 CONTEXT (general and
vector registers), then walked the interrupt, image-tracker, lazy-commit and
allocator-hole handlers before the tracker ever saw it.

The tracker needs only the fault address and the access kind, so it now runs
right after the image tracker, straight off the raw signal. An env var
restores the old handler order.

* [CPU] Serialize import stub and lazy TLS site patches

Patching a guest code site unprotects the page it lives on, writes, and
restores the old protection. Two threads patching sites that share a page
therefore race: one restores the page to read-execute while the other is
still writing into it, and the second write faults or is lost. Both happen in
practice -- a runtime module load sets up import stubs while guest threads are
running, and guest threads patch their own lazy TLS access sites as they first
reach them, several of which land on one page.

Every import stub patch and every lazy TLS site patch now runs under a single
gate, so the unprotect/write/restore sequence is never interleaved.

* [SpirvTranslator] Follow guest NaN and saturation rules for float ops

v_min_f32 and v_max_f32 return the other operand when one of them is NaN, and
v_cvt_u32_f32 and v_cvt_i32_f32 saturate an out-of-range value to the target
type's limit and turn NaN into zero. The GLSL FMin and FMax instructions and
SPIR-V's ConvertFToU and ConvertFToS all leave those cases undefined, so a
host driver is free to hand back the NaN or an arbitrary integer, and Metal's
fast math does return the NaN.

The minimum and maximum now select the other operand when either side is NaN,
and the two conversions clamp at the type's limits and return zero for NaN.
NaN is tested on the value's bits rather than with an ordered comparison, so
fast math cannot assume the test away.

Device tests cover this and the wave-wide maximum that Unreal's motion blur
computes with DPP row_shr, v_permlanex16_b32 and v_readlane_b32 across a
64-lane wave.

* [ShaderCompiler] Fix the SOPK immediate width and S_ADDK_I32's SCC

Two things were wrong in the SOPK forms, in both the SPIR-V and the MSL
backend.

S_CMPK_*_U32 compares against SIMM16 zero-extended; only the signed compares
sign-extend it. Both translators sign-extended it for every compare, so
"s_cmpk_le_u32 s4, 0xffff" was true for any value at all. NGG geometry
programs use exactly that test on the packed vertex and primitive count, so
they took their no-primitive path and exported a single null primitive, which
left Unreal's volume passes empty. The register S_CMPK names is also only
read, yet user-data liveness recorded it as a definition, so a compare on a
user-data register left that register unloaded; it now counts as a use, as
does the register of the SOPK accumulations.

S_ADDK_I32 is defined as D.i = D.i + signext(SIMM16) with SCC set on signed
overflow, the same SCC rule as S_ADD_I32, which both backends already
implement. Neither wrote SCC for the SOPK form, so a following
S_CBRANCH_SCC0/1 or S_CSELECT read whatever the previous instruction had left
there. S_MOVK_I32 and S_MULK_I32 correctly leave SCC alone.

* [ShaderCompiler] End the decode at S_CODE_END

S_CODE_END pads the space after a shader's last instruction. When the code
after the final S_ENDPGM ends in a backward branch, the linear decoder walks
straight into that padding and failed with an unknown SOPP opcode 0x1F, which
stopped the session.

The decoder now names 0x1F and ends the program there, unless a forward branch
still targets code beyond it -- in which case the padding really would be
inside the program and the decode still fails.

* [ShaderCompiler] Widen host-evaluable scalar operations for descriptors

A resource descriptor the host materializes is built by replaying the shader's
scalar operations on the host. The validator that decides whether a value can
be replayed listed only part of what the scalar evaluator implements, so a
descriptor computed through any of the others was rejected even though the
host can compute it exactly.

The list now covers every pure scalar function the evaluator supports: the
remaining integer maximum, absolute value and high multiplies, the signed and
unsigned comparisons, 64-bit equality, the bit-counting and bit-scanning
operations, the quad mask, the integer/float conversions, and the float
arithmetic and comparisons. Anything with side effects or a lane-varying
result is still rejected.

* [Gpu] Stop draining the GPU for predication that asked not to wait

PredicationZPassWaitOp is 0 for kWaitForQueryResults and 1 for
kDoNotPredicateIfQueryResultsNotReady, so the wait bit was being read
inverted. Every SET_PREDICATION packet that asked the command processor not to
stall drained the whole host queue instead, and the packets that did ask to
wait read the predication label without waiting for the results at all, so
they could act on a stale value.

The drain now happens only for kWaitForQueryResults, and only on the branch
that actually reads the label. A packet tagged
kDoNotPredicateIfQueryResultsNotReady leaves its work unpredicated, which is
what the hardware does while the results are still outstanding, and clearing
predication reads no memory at all so it never drains.

* [Agc] Queue the suspend point instead of draining the command stream

A suspend point inserts GPU commands that drain the graphics pipe. The call
that inserts it does not wait for those commands, and the hardware allows one
suspend point to be in flight, but the queue implemented it by blocking the
calling thread until every accepted submission had been processed.

The frame boundary is now a queued submission of its own, ordered behind the
graphics work it ends, and processing it flushes what the frame recorded. The
caller returns immediately for the first boundary and only waits when a second
one arrives while the first is still pending. Shutdown still drains, because no
slice will run a queued boundary once the queue stops accepting work, and a
cancelled queue drops pending boundaries along with the rest.

Measured on Octopath Traveler II: the call went from 223 ms to 72 ms, and the
guest render thread spent 38 s instead of 107 s of its 170 s inside it.

* [Cpu] Give guest execution threads a 64 MiB host stack for nested continuations

Every guest call that blocks in an HLE import resumes through a managed
continuation frame, so a guest thread that blocks deep inside its own call
tree nests host frames instead of unwinding them. Demon's Souls' render
thread overflowed the default thread stack within a minute of reaching its
main loop.

Guest execution threads now reserve 64 MiB. The reservation is virtual, so a
generous stack costs nothing until it is touched.

* [Gpu] Report pipeline creations that take longer than 250 ms

A host shader compiler can spend seconds inside vkCreateGraphicsPipelines or
vkCreateComputePipelines for one translated program, and the guest's command
stream cannot advance while it does. There was nothing in the log to say that
had happened, so the stall looked like the game hanging.

Pipeline creation is now timed, and any creation of 250 ms or more is reported
with the stage hashes, the SPIR-V byte count of each module that went into it,
and the running total spent creating pipelines, which is what identifies the
program to look at.

* [Gpu] Compile compute pipelines off the command-stream thread

A host shader compiler can spend tens of seconds on a single large translated
compute program, and the command stream could not advance while it did, because
the pipeline cache holds its lock across the creation call. Every other queue
that wanted any pipeline waited behind it too.

The pipeline host can now report that a compute pipeline is not ready yet. The
Vulkan presenter answers that way the first time it sees a program: it prepares
everything the command stream owns (descriptor set layout, pipeline layout,
shader module) up front and runs only vkCreateComputePipelines on a worker
thread, so the task touches nothing else. The number of compiles in flight is
bounded, since each one blocks its thread inside the host compiler and a frame
can touch many programs at once. Asking again returns the finished pipeline
without starting a second compile.

The dispatch waits for its pipeline rather than being dropped: a guest that
does not replay a one-shot dispatch deadlocks, because the dispatch can feed a
label a later packet waits on. Asking again from the executor keeps that wait
outside the pipeline cache's lock. Hosts that compile cheaply keep the blocking
behaviour through the interface default, and
SHARPEMU_ASYNC_COMPUTE_PIPELINES=0 compiles inline.

* [GpuMemory] Stop allocating on every tracked CPU write and shader identity hash

MarkCpuWrite runs on every guest CPU write into tracked memory — HLE register
patching, memcpy, index buffer setup. Its flush lambda and the region visitor
inside InvalidateRegion were both capturing closures, so every such write
allocated two closure objects and two delegates even when nothing needed
flushing at all.

InvalidateRegion now has a state-passing overload built on a ref-state
VisitRegions, and both call sites use static lambdas. The public
Action-based overload is kept for the callers that are not on a hot path.

ShaderIdentity.Compute is the other one: it allocated a fresh XxHash3 and a
byte[] per code range on every draw of a shader that carries no declared hash.
It now resets a per-thread hasher and reads each range into a pooled buffer.

* [Gpu] Allocate nothing per host DMA fill or copy

A DMA fill the buffer cache completes on the host allocated a 16 KiB array for
every call, even though almost all of them are label-sized, and a host copy
allocated a 64 KiB array per call. WriteHostMemory then scanned every
registered buffer for each write it made.

The fill builds its repeating chunk in a stack buffer sized to the fill, the
copy rents its staging buffer from the shared pool, and WriteHostMemory walks
only the registered buffers the write actually overlaps, which it can do
because the registry is ordered and disjoint.

* [Audio] Fix out-struct sizes and layouts in AudioOut, Ajm and AudioPropagation

sceAudioOutGetPortState wrote 16 bytes and put the volume in a single byte at
+7, which is inside rerouteCounter. SceAudioOutPortState is 0x20 bytes with
volume as an int16 at +4; the export now writes the whole struct with
volume = -1, which is what the library reports for anything but the pad
speaker. Its guest-stack bail is gone for the same reason it is going in
libSceAudioOut2: the call names one out pointer and its host address range is
not a signal.

ClearAjmBatchError zeroed 24 bytes, the naive sum of the field widths.
SceAjmBatchError is 0x20 bytes because its two pointers force 8-byte
alignment, so pJobOriginRa lands at +0x18 and kept stale guest bytes across
every batch start and wait.

sceAudioPropagationSystemQueryMemory wrote a {size, alignment} pair at +0x00
and +0x08, which is not what SceAudioPropagationSystemMemory holds there: that
is the struct descriptor the caller has already initialized. The two size
fields live at +0x18 (CPU) and +0x28 (GPU), and the descriptor is now left
alone.

* [SpirvTranslator] Emit forward, nested control flow as structured selections

Every program with more than one basic block ran as a loop around a switch on
the guest PC. That shape keeps every guest register live across iterations and
stops the host compiler from optimizing across blocks, so on Metal the register
files spill.

A program whose branches only skip forward over properly nested ranges -- an
s_cbranch_* skip, an if/else with an s_branch over the else range, a skip to
the end of the program -- is exactly a nest of SPIR-V selections, and is now
emitted as one. The structuring is attempted first without emitting: if any
branch goes backwards, leaves a range it entered, or targets an instruction
that is not a block boundary, nothing is emitted and the program keeps the PC
dispatcher, so no program loses a shape the dispatcher handled. Setting
SHARPEMU_STRUCTURED_CF=0 forces the dispatcher for every program.

Measured on two replayed programs, with identical output: an instanced vertex
shader 8.1 -> 4.8 ms and a per-pixel compute program 10.7 -> 6.6 ms.

* [Agc] Batch the interpolant mapping's guest reads and register writes

sceAgcCreateInterpolantMapping and its version 2 run once per draw. Each one
read every semantic word with its own guest read — the output semantic table
was re-read from the start for every pixel input — and then wrote the 32
SPI_PS_INPUT_CNTL (register, value) pairs as 64 separate four-byte guest
writes, each paying the full guest write path.

Both semantic tables are now read once, the register block is built on the
stack (the identity pairs first, then the computed values over them), and the
whole block goes out in a single guest write. The output table is rented from
the pool when it is larger than a kilobyte. The bit arithmetic is unchanged,
and a new test pins version 1's output to the values the per-word
implementation produced.

Measured on Dreaming Sarah in-game: 8.6 us to 1.7 us per call, which is 5.0 s
down to 1.0 s of the main thread over about two minutes.

* [AudioOut2] Take every out pointer and struct size from the ABI

Out-parameter handling in libSceAudioOut2 was inferred at runtime: a helper
picked whichever of two argument registers looked like a writable pointer, and
another decided from the host address range whether a pointer was a guest
stack slot. Neither is a signal. The ABI names exactly one out pointer per
argument slot, and guest stacks sit at 0x7FFF_xxxx_xxxx on Windows but
0x6FFF_xxxx_xxxx on macOS, so the heuristic silently changed behaviour per
host. Every export now reads its out pointer from the register the prototype
gives it: ContextQueryMemory from rsi, PortCreate from rdx, PortGetState from
rsi, GetSpeakerInfo and GetSystemState from rdi.

The written sizes are now the real sizeof() of each struct.
SceAudioOut2PortState is 0x40 bytes, not 0x20. SceAudioOut2SpeakerInfo is
0x50, not 0x20, and its contents were invented; it now reports a TV speaker
type with front-left and front-right and the two stereo speaker angles.

sceAudioOut2SpeakerArrayCreate follows its real signature (pHandle,
pVbapParams, pAmbiParams): the handle goes to rdi, the speaker count and the
caller's buffer and size come out of the param block, and the handle is that
buffer when the title supplied one. The previous reading wrote the handle over
the VBAP parameters' speaker-position pointer and left the caller's handle
uninitialized. sceAudioOut2GetSpeakerArrayCoefficients writes
uiNumCoefficients floats to rsi and the ambisonics form writes them to rdx;
both used to zero a fixed 0x400-byte slab, and the ambisonics form could pick
its own count register as the destination address.

Errors are returned in the libSceAudioOut2 error space (0x80268xxx) rather
than as generic codes a title never compares against, and
sceAudioOut2UserGetSupportedAttributes is added.

sceAudioOut2ContextQueryMemory and sceAudioOut2ContextGetQueueLevel are left
exactly as they are, so that the two changes already in flight for them do not
collide with this one; the two address-range predicates survive for those two
callers alone.

* [Kernel] Memoize guest path resolution against the mount configuration

Resolving a guest path to a host path is pure text work plus a reparse-point
check per path component, but a resource streamer calls
sceKernelAprResolveFilepathsToIdsAndFileSizes with the same paths hundreds of
thousands of times over a load, so the work dominates.

Successful resolutions are now memoized. The only inputs that can change an
already-computed answer are the mount table and the host mount roots, so each
entry records the root configuration it was computed under and is ignored if
that has changed, and registering or removing a guest mount clears the cache
outright. A denial is not memoized: it is a containment decision about the
host filesystem's current shape, so it stays live. The cache is bounded, and
its size is tracked in a plain counter because ConcurrentDictionary.Count
takes every bucket lock, which on a path a dozen guest threads resolve at
once costs more than the resolution it guards.

* [Gpu] Route packed pixel color exports to the slots CB_SHADER_MASK enables

Shader compilers drop the MRTs a pixel program does not write, and the
hardware then delivers the Nth color export to the Nth target that
CB_SHADER_MASK enables — the export number and the target slot are not the
same thing. Unreal's base pass is the clear case: it exports MRT0 and MRT1 but
means targets 0 and 4 (SPI_SHADER_COL_FORMAT=0x54, CB_SHADER_MASK=0x000F000F).

Mapping each export to the target of the same number therefore wrote the
fourth G-buffer's data into the first, which showed up as a scene rendered in
world normals. Exports are now paired with the enabled slots in order, the
compiled pixel program keys its outputs by the export that feeds the slot
rather than by the slot, and a bound slot that no export reaches gets a zero
color write mask so it keeps its contents. When the two registers do not pair
up — different counts, or no formats at all — each export keeps going to the
slot of the same number, as before.

* [GPU] Clamp a volume render-target view to the volume depth

Unreal binds a whole volume as a render target with the last slice set to
its depth, one past the end, and the resolver stopped the session on it.
The color block writes only the slices the volume has, so the view is now
clamped to them. A view that starts past the last slice is still fatal.

* [Kernel] Remember APR paths absent from the read-only game image

Looking up a resolved path's size stats the host filesystem, and a path that
is not there costs two stats (a file probe and a directory probe) every single
time it is asked for. A resource streamer asks for far more paths than the
image contains, so misses are the common case and they are repeated.

/app0 is the read-only game image: a path that is not in it now will not
appear later. Absent paths under that root are therefore remembered, which
turns the repeated pair of host stats on what is often a slow external volume
into a dictionary probe. Paths outside /app0 can be created at run time and
are not remembered.

* [Kernel] Verify mount containment per component, not by listing directories

Containment verification stats each component of a resolved path once to reject
reparse points. It was changed to verify a whole parent directory in one
listing instead, on the theory that one listing is cheaper than N stats.

It is not, for a game image: .NET fills the attributes of every entry it
enumerates, so listing a directory stats all of it. A title whose asset
directories hold thousands of entries paid for every file it never opens --
directories of up to 7,390 entries, about 9 s of a load spent in those stats.

Each component is verified with its own stat again, and the per-component
memo that made the listing look attractive stays, so a component is still
verified only once.

* [Ngs2] Implement sceNgs2ParseWaveformData/File/User

The three waveform-parse entry points returned NOT_FOUND, and Void Terrarium
calls ParseWaveformData on its audio thread for every sound it loads.

They now parse the container and publish the description SceNgs2WaveformInfo
lays out (0xE8 bytes, with the block table at 0x48). A RIFF/WAVE fmt chunk
resolves to PCM by bit depth, to IEEE float, through the SubFormat GUID for
WAVE_FORMAT_EXTENSIBLE, or to ATRAC9, whose configuration is decoded so that
the audio unit size, samples per unit, units per frame and delay samples
describe the real frame and superframe. A smpl chunk supplies the loop points
and a fact chunk the decoded sample count. The "VAGp" container maps onto the
VAG waveform type at 28 samples per 16-byte HE-VAG unit.

ParseWaveformFile resolves the guest path and reads the header at the given
offset. ParseWaveformUser would have to drive a guest read callback, so it
reports INVALID_WAVEFORM_DATA rather than fabricating a description.

* [NpWebApi2] Add sceNpWebApi2CheckTimeout

Poppy Playtime calls it every frame, about 6k times a session, and each
call went through the unresolved-import path. No web API request is ever
in flight, so there is nothing to expire and it returns success.

* [Ime] Fill in sceImeKeyboardGetInfo and sceImeKeyboardGetResourceId

sceImeKeyboardGetInfo zeroed 0x88 bytes at its out pointer and returned
success. SceImeKeyboardInfo is 0x24 bytes -- six 4-byte members plus
int8_t reserved[12] -- so the call scribbled 0x64 bytes past the caller's
struct, and a title that reads the device type or the status got a zero for
both, which is not a state the library ever reports.

The export now writes exactly sizeof(SceImeKeyboardInfo) and reports an OSK
device in the DISCONNECTED state, which is what the host can honestly claim
since no physical keyboard is bridged. sceImeKeyboardGetResourceId returned
success without touching the caller's array, leaving the storage that
sceImeKeyboardGetInfo is called with uninitialized; it now publishes the
caller's user id with an empty id array. Both use the real error values.

Also adds a test for the existing scePadResetOrientation, which is a
handle-only call with no out parameter, so a bad handle is its only failure.

* [Gpu] Run an attachment-less draw whose vertex stage stores to memory

A draw with no color target, no depth target and no pixel stage was treated as
having no observable effect and dropped. That is wrong when the vertex or
emulated geometry stage stores to a buffer or a storage image: a GPU-culling or
stream-out pass whose only output is the buffer a later indirect draw reads
looks exactly like that, and dropping it leaves the indirect draw reading
stale data.

Such a draw now runs for its stores alone. The check only resolves the shader
programs when there is an export address to resolve, so a genuinely empty draw
still costs nothing.

* [AudioOut2] Write a single size_t from sceAudioOut2ContextQueryMemory

The export returns the context memory size through one size_t. For heap
output it also wrote a second qword (an alignment) after it, and titles keep
other locals there: Octopath Traveler II's allocator reads the dword at +12 of
that block as a divisor, so it faulted with #DE during boot. Write only the
size, wherever the output lives.

* [CPU] Reuse import trampolines and leave patched stubs alone on module reloads

Every runtime module load sets up the import stubs of all loaded modules
again, and each setup built a fresh trampoline and rewrote the stub's 16 bytes
-- under guest threads that may be executing exactly those bytes.

A trampoline only encodes its import index, so the trampolines are now cached
by index and reused, and a stub that already jumps to the trampoline it would
be given is left untouched, with no unprotect/write/restore cycle at all. A
reload of a module whose stubs are already patched therefore writes no guest
code.

The trampoline ABI test builds its backend with GetUninitializedObject, which
skips field initializers, so it has to supply the new cache; both fields now
go through one helper that names a field it cannot find.

* [Cpu] Read import stack arguments from the thread's own stack without a region query

Every import copies six stack argument slots (twice, with the per-thread
diagnostics). The per-thread readable-range cache is keyed by the host mapping
generation, which every tracker protection change bumps, so on macOS nearly
each slot fell through to a locked host region query: about half of the busy
managed samples at Octopath Traveler II's title were in that query or waiting
for its lock. Addresses inside the calling guest thread's stack, which the
backend maps read-write for the thread's lifetime, are now read directly.

* [HLE] Do not log expected wait timeouts, mutex relocks and closed pad reads

The import gateway logs an error result unless the NID is on a list of calls
whose failure is a normal outcome. Four common ones were missing:
scePthreadCondTimedwait and sceKernelWaitEventFlag time out exactly as the
caller asked, scePthreadMutexLock reports EDEADLK to the owner of an
error-checking mutex (titles use that to build their own recursive locks), and
scePadReadState reports a handle that is not open because titles poll every pad
slot.

Poppy Playtime logs roughly 260k of these lines per session, which buries the
failures that do matter.

* [Kernel] Run one mapping transaction per sceKernelBatchMap

A mapping change has to be handed off to the GPU worker before any lock the
image and buffer reads need, and the handoff waits for the GPU to drain.
sceKernelBatchMap walked its entries calling the same per-mapping entry points
the single-mapping exports use, so every entry in the batch took its own
handoff and its own drain.

The batch now opens one transaction and runs all of its entries inside it. A
thread-local flag marks that a transaction is already open so a nested entry
point runs directly instead of handing off again, and the flag is cleared in a
finally so an entry that throws cannot leave it set.

* [Loader] Rewrite SHA instructions in spans that touch no guest memory

The red-zone patcher computes a shifted core for every span: the run of
faultable guest memory accesses that executes with RSP moved below the
red zone. A span over register-only instructions has no such access, so
the core could not be computed and the span was refused as too short.
SHA rewrite sites are exactly that shape (sha256msg1/msg2/rnds2 on
registers), so no SHA instruction was rewritten any more: on hosts
without the SHA extensions every one trapped and was emulated one at a
time. Poppy Playtime logged sha_rewrites=0 with 144 too-short refusals,
hit hundreds of thousands of illegal-instruction traps and stopped making
progress within a minute.

A span with no guest memory access has nothing that must run outside the
shift, and the span builder has already refused any instruction that
touches RSP, so the whole span is the core.

* [Cpu] Keep fiber switches from writing stack bounds into the macOS TSD

The guest context-transfer stub that fiber switches go through keeps the
Windows TEB stack bounds in sync by storing the target stack top and
bottom to gs:[8] and gs:[16]. Unlike the guest-entry and exception stubs,
it did so on every host. On macOS gs addresses the pthread TSD, where
those slots hold errno's address and another key: a fiber switch wrote
its stack bounds over them, and the next failed libc call on the thread
(a timed-out condition wait) crashed reading errno through the pointer.
Demon's Souls died this way within 10-50 s of boot; a hardware
watchpoint on the thread's errno slot stopped in this stub.

The fiber bounds sync now lives next to the other TEB-bound helpers and,
like them, emits nothing off Windows.

* [Kernel] Take APR file sizes from the mount check's stat instead of listing directories

Resolving an APR path already stats every component to rule out links out of the mount.
The same stat now records the file's size, so size lookup no longer lists the file's whole
directory. Listing stats every entry: Demon's Souls keeps up to 7,390 files per asset
directory on a slow disk, and each first lookup in one paid for all of them.

FileInfo reports a missing component as -1 instead of throwing; it still ends the check.

* [Kernel] Place mappings in untouched address space without waiting for the GPU worker

Every mapping change queued behind the GPU worker so it could not race a pending GPU read.
During loading that worker is busy translating shaders, and Demon's Souls' reservations and
batch maps waited seconds for a queue slot (23.6 s over 132 calls, up to 7.1 s each) while
the change itself took about a millisecond.

A change that only places memory where the GPU was never given anything - a kernel-chosen
address, or a fixed range that is empty or reserved and overlaps no registered span - cannot
race a GPU read and has nothing to unregister, so it now runs on the calling thread. Those
paths also skip the unregister request for free and reserved ranges, which are never
registered; waiting on the worker while holding the mapping lock that GPU reads take would
deadlock, so reaching a registered span there throws instead.

* [HLE] Resolve single-view backing reads and writes without the views lock

Every HLE access to aliased guest memory took one lock shared by all guest threads, and
Demon's Souls' job threads queued on it for 8-byte mutex reads. Readers now binary-search a
copy of the view list; mutations drop the copy under the lock and the next reader rebuilds
it. A reader that races a mutation uses the list from before it, as if it ran first.

* [ShaderCompiler] Find each instruction's block by search and reuse register files

Several passes found a block's instructions by scanning the whole program once per block,
and the value graph did it again on every block visit. Blocks are sorted and contiguous, so
IrControlFlowGraph.BlockOf finds an instruction's block by binary search and each pass
groups the program once.

The value graph also allocated two 256-entry register files per block visit. Large Demon's
Souls compute shaders visit thousands of blocks, and the collections that caused stopped the
renderer for about 2.6 s of its first-frame shader work. Replaced entry and exit states are
now reused; a reused state is reset exactly as the constructor would, at the same point, so
the undefined values it starts with and the instructions they are charged to are unchanged.
The resource graphs and SPIR-V of the game's first 134 programs are identical.

* [Cpu] Deliver guest access faults on macOS as signals, not runtime Mach exceptions

The runtime receives EXC_BAD_ACCESS for its threads through a Mach exception port before
the kernel raises SIGSEGV or SIGBUS. It treats a fault in the page holding RSP, or the page
below, as a stack overflow and aborts - assuming RSP is on a stack it owns. Guest code runs on
guest stacks whose pages fault whenever GPU or image write tracking protects them, so Demon's
Souls died with a bare "Stack overflow." about every other minute of play.

Threads now clear that port the first time they enter guest code. Their access faults reach
the signal handler, which resolves guest faults and chains the rest to the runtime's own
signal handlers, as on Linux. Each tracking fault also skips the Mach round trip, which
roughly doubled Demon's Souls' frame rate (about 2 to 4-5 fps).

* [ShaderCompiler] Solve user-data liveness on bit sets and hash graph nodes by id

The liveness fixpoint that picks a program's user-data registers walked 256 booleans per
block per pass; it now works on four 64-bit words per block with the same equations.

ScalarValue keys many graph dictionaries. It keeps reference equality but hashes its unique
id, which skips the runtime's identity-hash path.

* [SpirvTranslator] Mask a wave32 saveexec result at 64 bits

The low-half mask for s_*_saveexec_b64 on a 32-lane wave used the 32-bit AND helper on the
64-bit exec value, emitting OpBitwiseAnd %uint with a %ulong operand. spirv-val rejects the
module and the driver's behaviour for it is undefined; Octopath has four such programs.

* [SpirvTranslator] Structure loops, early exits and single-block programs

Only forward, nested branches were emitted as structured control flow; every program with a
loop, and every single-block program, went through the loop around a switch on the guest PC,
which keeps all registers live and stops the host compiler from optimizing across blocks.

A block that a later block branches back to - on a wave-uniform condition or with s_branch -
now opens a SPIR-V loop whose body is structured like any range, whose continue evaluates
that branch's condition, and whose iterations share the dispatcher's step guard so a guest
loop that never ends still cannot wedge the GPU queue. A conditional branch from the body to
the block after the latch is a break out of the innermost loop. Any other backward edge, or a
break past an outer loop, keeps the dispatcher as before.

Across eight games, programs left on the dispatcher went from 760 to 104 (Poppy, Silent Hill,
Oregon Trail and Dreaming Sarah to none); every emitted module passes spirv-val and the
frames match. Octopath's 12.5M-invocation instanced draw went from 12.2 to 10.8 ms.

* [Gpu] Age cached images by frame, not by guest submission

The image collector runs after every completed guest submission as well as at each flip, and
every run advanced the age it compares against. A title submits dozens of command buffers per
frame, so "unused for 16 ticks" meant a fraction of a frame: every texture sampled once a frame
was deleted and recreated, and Superliminal uploaded 3,591 textures (2.2 GB) every 5 seconds.
Deleting a GPU-written image the cache cannot read back also dropped its contents.

Only a flip now advances the age. Collection after a submission still runs, so memory pressure is
relieved during long stretches without a flip. Superliminal's per-frame uploads went from ~55 to
none, and its intro scene from 12 to 45 fps.

* [Gpu] Submit on a release-memory label write only when it raises an interrupt

A RELEASE_MEM that writes a 32-bit label submitted the open batch at once. Without an interrupt
nothing inside the slice waits for the label, and every slice that makes progress already ends
with a submit - including one that stops at a WAIT_REG_MEM on that label - so the label is
written when that batch completes either way.

The per-label submits split Superliminal's frames into ~35 extra command buffers; each ended the
render pass, which stores and reloads every attachment on a tile-based GPU. The title menu went
from 15.6 to 21 fps and Octopath from 13-21 to 18-29 fps, with no hang over 150 s runs.

* [VideoOut] Reinterpret the sRGB-encoded frame on a presenter image, not the swapchain

A floating-point display buffer is sRGB-encoded by blitting it into an sRGB image and then
copied byte-for-byte into the UNORM swapchain image. MoltenVK does that copy through a
reinterpreting texture view it caches on the destination; on a presentable image the drawable
behind it changes every frame, and destroying the swapchain then walked those views through a
freed device. Superliminal, whose display buffers are RGBA16F, crashed at every exit (SIGSEGV
in MVKImagePlane::releaseMTLTexture from vkDestroySwapchainKHR) and each crash kept two crash
reporter processes busy for minutes.

The encoded bytes are now copied into a presenter-owned image in the swapchain's format first,
so the swapchain image only ever receives a same-format copy. Frames are unchanged; the exit is
clean.

* [Cpu] Stop guest threads at their next import once the host shuts down

Host shutdown only kept guest threads from starting another slice; a thread already inside
guest code kept calling HLE while the services behind it were torn down. Superliminal's job
threads then got a null command buffer from the GPU library, wrote through it, and the process
died with SIGSEGV on its way out.

After shutdown is requested an import now returns to the host entry stub instead of running,
ending that thread's slice; the scheduler already refuses to enter guest code again.

(cherry picked from commit 9e0e8ec0aa8b0bfaa030e5e97d51dbc0223f93e1)

* [Gpu] Declare every parameter the pixel program reads in the paired vertex program

A vertex program declares outputs for the parameters it exports plus as many locations as the
pixel program has inputs. SPI_PS_INPUT_CNTL can map a pixel input to any parameter number,
though, so a pixel program with two inputs may read parameters 4 and 5. Metal requires every
fragment input to be written by the vertex stage, so the pipeline failed to link ("fragment
inputs user(locn4), user(locn5) ... not written by vertex shader"), the command stream slice
failed and Silent Hill stopped rendering at a scene change.

The required output count now covers the highest location the pixel program reads, resolved
through the same input mapping its translator uses; missing exports are zero-filled as before.
The pipeline creation error also names the vertex and pixel programs.

(cherry picked from commit 80ec9fb53cfae922e458e2dd43d4b1010dbd2701)

* [Kernel] sceKernelAprGetFileSize writes the resolved file size

The export was a success stub that never wrote its out parameter, so callers
sized buffers from uninitialized memory. The signature is (id, uint64_t* size);
it now answers from the APR file registry like sceKernelAprGetFileStat.

* [Cpu] sceKernelWaitSema is an import-loop guard boundary

A thread that blocks on a semaphore between iterations is waiting, like the
condition-variable waits already on the list. A job-wait loop that runs queued
work between timed semaphore waits was otherwise taken for a hang once loading
outlasted the guard window.

* [Fiber] Avoid formatting unused names and disabled traces

* [Shader] Build materialization cache ranges without temporary copies

* [ShaderCompiler] Intern scalar graphs without string keys or hit allocations

* [Media] Vectorize movie YUV conversion without changing pixels

* [Shader] Reuse scratch storage for resource read recording

* [Tests] Initialize presenter state for GPU binding validation

* [Vulkan] Keep temporary descriptor writes off the managed heap

* [GPU] Reuse bounded descriptor preparation scratch arrays

* [ShaderCompiler] Persist versioned scalar analysis across launches

* [GPU] Remove duplicated image layouts from texture bindings

* [ShaderCompiler] Bind cached graph payloads to their input keys

* [Vulkan] Load content-addressed driver cache shards on demand

* [Tests] Keep presenter allocation fixture independent of diagnostics

* [Vulkan] Forget driver cache identities of destroyed shader modules

The remaining change of the updated #1006 head (e6659681) that the integration branch did not carry.

* [Vk] Measure GPU busy time from per-submission timestamps

Per-draw timestamps are written only with SHARPEMU_PROFILE_GPU_DRAWS=1; by
default each submission gets two timestamps and the overlapping intervals
are merged into a [PERF][GPU_BUSY] line with the busy share and the longest
submission.

* [HLE] Reserve a host core for the render thread

On Windows hosts with 8 to 64 logical processors the render thread gets the
last physical core of the fastest efficiency class at the highest priority,
and guest threads are kept off that core so spinning job workers cannot take
the renderer's SMT sibling. SHARPEMU_RENDER_CORE=0 turns it off.

* [Vk] Spin briefly before blocking on a GPU wait

A GPU wait polls the timeline for SHARPEMU_GPU_WAIT_SPIN_US microseconds
(150 by default) before it sleeps, which saves the wake-up latency when the
work completes soon.

* [GpuMemory] Answer CPU-dirty range queries without the tracker lock

MayHaveCpuDirtyPages reads the per-block summary and the region masks without
taking the region lock; a true answer still goes through the locked path.
Regions also bump a CPU-dirty epoch whenever a page becomes CPU-dirty.

* [Gpu] Skip the device-address sweep while no page became CPU-dirty

PrepareBda remembers the CPU-dirty epoch and the mapping it swept last and
skips the full sweep of mapped memory until either changes.

* [GpuMemory] Scan possibly CPU-dirty blocks 64 at a time

ForEachPossiblyCpuDirtyRange combined a region lookup and a summary read for
every 4 MiB block of mapped memory on each device-address sweep. A bitset of
blocks that have a region and the dirty summary words are now scanned a word
at a time, with the same runs as before.

* [Gpu] Skip syncing a written buffer range that is already GPU-owned

SynchronizeBuffer returns early when a written range lies entirely in the
GPU-modified ranges, uses the lock-free CPU-dirty query for reads, and the
render profile splits buffer sync time into written, texel and upload parts.

* [Gpu] Version the GPU-modified buffer ranges

A written range bumps GpuModifiedVersion only when it adds bytes to the
GPU-modified set, so readers can cache a clean verdict for a page until the
GPU writes something new.

* [Gpu] Track the extent of DCC metadata and answer overlap queries

A color target records the size of its DCC metadata, and the image cache can
tell whether a guest range overlaps registered DCC metadata.

* [Diagnostics] Trace the GPU writers of DCC metadata and of a chosen address

SHARPEMU_TRACE_DCC_WRITERS=1 writes the shader program and a call stack for
GPU buffer writes that overlap DCC metadata; SHARPEMU_TRACE_WRITER_ADDRESS
does the same for writes that cover one guest address.

* [Gpu] Fill DCC metadata on the GPU and in guest memory at once

A fill that targets DCC metadata which no GPU write owns is recorded as a GPU
fill and also written to the guest backing directly, so the range never
becomes GPU-dirty and later CPU reads need no readback. Ranges the GPU still
owns or that overlap an image keep the plain buffer fill.

* [Gpu] Turn AGC fill compute shaders into buffer fills

BoundedFillDetector recognizes the AGC range-fill and pattern-fill compute
programs, including thread-dimension dispatches, and a dispatch of one that
targets DCC metadata becomes a DCC fill instead of a compute dispatch.
Refused conversions are reported by the DCC writer trace.

* [HLE] Resolve backing aliases for readers that hold an access window

SharedBackingViews publishes its view snapshot as an alias identity, and a
reader can enter an alias access window once and resolve guest pages to their
backing alias without the views lock until the snapshot changes.

* [Diagnostics] Trace shader resource reads that wait for GPU-written memory

SHARPEMU_TRACE_GPU_READS=1 writes the shader, stage, address and table phase
of a resource read that has to synchronize GPU-written memory, once per shader
and page.

* [ShaderCompiler] Keep recent materialization variants per draw key

A cache key now holds up to four materializations in most-recently-used order,
so alternating descriptor contents reuse their earlier result instead of
re-materializing. The cache report counts stale and unreadable entries and
table refreshes, and ReadingTable tells a reader when the flattened table is
being evaluated.

* [VideoOut] Read resource words through cached clean pages and the backing alias

TryReadGuestWord and TryReadResidentGuestBytes remember the last 64 pages
found free of GPU-dirty bytes, keyed by the GPU-modified version, and read
them through the backing alias inside the alias access window that each
command stream slice now holds. GPU-dirty checks are byte-precise, and a
resident read refuses unreadable ranges before it asks the page tracker.

* [Gpu] Read GPU-written guest memory back asynchronously and ahead of time

VulkanAsyncReadback keeps eight slots: slot zero serves synchronous reads and
the others carry asynchronous downloads. A guest thread that reads GPU-written
memory lets the render thread start the copy and waits for it on its own
thread, then the render thread applies it if the range is unchanged; a
foreign read keeps the source buffer alive until it completes.

Windows the render thread had to read synchronously become hot. When a batch
writes into a hot window, the window is downloaded right after the batch is
submitted, and the next read uses that copy if it is still current. A pending
write to a hot window ends the open batch early. SHARPEMU_ASYNC_GUEST_READBACK=0
keeps the synchronous path; [PERF][ASYNC_READBACK] reports the counts.

* [ShaderCompiler] Prefetch contiguous resource words in one resident read

Resource materialization read every descriptor and flattened-table word
through its own guarded TryReadGuestWord call, about 2.6 million per five
seconds in Demon's Souls. The raw reads of each plan are grouped once; at run
time their addresses are resolved, sorted and read as contiguous runs through
the resident guest reader, and the values seed the evaluator cache. A run the
GPU may still own, or one out of bounds or through a null base, falls back to
the word reads. The cache recorder records the prefetched words, and
SHARPEMU_RESOURCE_PREFETCH=0 turns the prefetch off.

* [Gpu] Reuse image lookups that found the same backing

FindImage remembers, in a 256-slot table, each request that resolved to an
image with the same backing, keyed by the request bytes and a generation
that every index registration or removal advances. A repeated request
touches the image and returns the remembered result without walking the page
owner index. SHARPEMU_IMAGE_LOOKUP_MEMO=0 turns it off; [PERF][IMAGE_LOOKUP]
reports hits and misses.

* [ShaderCompiler] Look up fused programs without the registry lock

Every shader header lookup and decode asked the fused-program registry under
its lock. The registry now publishes an immutable dictionary that readers
take with a volatile read, and a registration copies it under the lock.

* [ShaderCompiler] Decode fused programs whose halves are far apart

The fused decoder joined the continuation at its address distance from the
entry and refused halves more than 4 GiB apart or in the wrong order, which
Poppy Playtime now hits for a vertex shader (invalid-fused-layout). Such a
continuation is placed right after the entry instead, and each of its
instructions keeps its real offset from the program address in AddressOffset;
S_GETPC_B64 in the scalar graph, the SPIR-V and the MSL translators uses that
offset, and the persisted scalar analysis key includes it.

* [Gpu] Collect an image only once it is old enough in frames

Since images age by frame, clamping the age to the current frame made every
image of the first frame collectable during the first 16 frames, and a
submission that ended no frame could delete a texture the frame still used.
Without memory pressure nothing is collected until the full age has passed;
under pressure the clamp still lets collection relieve memory early.

* [Tests] Cover the deferred global barrier of an attachment-only scope

A global barrier still ends a scope whose draws store to memory. In a scope
whose draws only write attachments it waits for the scope to end, and a later
memory-writing draw ends the scope and records it.

* [Agc] Make the number of suspend points in flight configurable

CommandStreamQueue takes the number of frame boundaries that may wait behind
the graphics commands. The default stays one, so the guest CPU can run one
frame ahead, and SHARPEMU_SUSPEND_POINTS_IN_FLIGHT=0 makes a suspend point
wait until its own boundary is processed, for diagnosis. Tests cover both
modes, including a label that the CPU rewrites after the suspend point.

* [Gpu] Throttle the device-address fault and 3D slice range logs

Little Nightmares wrote 195 thousand "Accessed non-GPU cached memory" lines in
one session and Silent Hill 6800 slice range lines. Both now print the first
occurrences and then only at power-of-two counts, with the count.

* [Docs] Document the new environment variables

Adds SHARPEMU_ASYNC_GUEST_READBACK, SHARPEMU_GPU_WAIT_SPIN_US,
SHARPEMU_IMAGE_LOOKUP_MEMO, SHARPEMU_RESOURCE_PREFETCH,
SHARPEMU_SUSPEND_POINTS_IN_FLIGHT, SHARPEMU_RENDER_CORE,
SHARPEMU_TRACE_DCC_WRITERS, SHARPEMU_TRACE_GPU_READS,
SHARPEMU_TRACE_WRITER_ADDRESS and SHARPEMU_PROFILE_GPU_DRAWS, and corrects the
group counts to the rows the tables hold.

* [GpuCommands] Write the 64-bit label of a compute-done release with an interrupt

RELEASE_MEM with event 0x2F and a 64-bit data selection was accepted only
without an interrupt. It is now handled like the other end-of-pipe events:
the label is written and the interrupt is raised after it.

* [GpuCommands] Let a wait see its own queue's preceding label store

A memory wait that directly follows a 4- or 8-byte store of its queue to the
same address, with only waits or inert NOPs and markers between them, compares
against the stored value when guest memory no longer holds it. Dead Cells
writes a label and waits for it while the CPU already rewrites it for the next
frame. The forwarded value lives only within one slice, and any draw, dispatch
or transfer in between drops it.

* [ShaderCompiler] Key fused programs by the underlying guest memory

Each native guest thread wraps the guest memory in its own tracking wrapper,
so a fused program registered while one thread created the shader was not
found by the render context. The registry now unwraps ICpuMemoryWrapper
before it looks up the per-memory table.

* [Agc] Implement the legacy sceAgcFuseShaderHalves export

The older NID (nApJjpKNBl4) shares the fusing path but keeps the front half's
user data pointer, takes the larger value of the resource allocation fields
of both halves, takes the user SGPR count and the ES component flag from the
front half, and copies the checksum register of the matching stage.

* [ShaderCompiler] Decode S_CMOV_B64 as a conditional select

S_CMOV_B64 is decoded as S_CSELECT_B64 with the old destination pair as the
false source, so it reuses the SCC, register-pair and EXEC handling of the
translators and of the scalar value graph.

* [Gpu] Merge the stencil replacement references of a face

Vulkan has one stencil reference per face for the comparison and every
replace operation. Replacements with the test value and with the operation
value are now merged into that reference over the written bits, and refused
only when they conflict on bits the comparison also reads. A replacement
with an operation value of zero over the written bits becomes a zero
operation, which ASTRO's PLAYROOM uses to clear one stencil bit.

* [Json] Add the sce::Json::Value copy constructor and keep shadow values on copies

The copy constructor (fSb2oQTNrgA) shares the assignment path. Assignment
and reads now carry the value a constructor or setter recorded in the object
heap, so a copy keeps it after the source is destroyed.

* [Font] Implement sceFontTextSourceInit

Fills the 0x60-byte text source with the text range, the cursor, the parser
callback and its object, and the text size, and leaves the memory after it
untouched.

* [AudioIn] Answer sceAudioInGetSilentState without an input backend

No AudioIn port can be opened until an input backend exists, so the export
returns an AudioIn error code (0x80260101) instead of being an unresolved
import.

* [PhtreadSpecificSemanticsTests] Fixes for computed shaders

* [ShaderCompiler] Return the entry header address of a registered fused program

An overload of TryGetFusedProgramParts also gives the entry header, so a
caller can register the same fused program on another memory.

* [Vulkan] Keep saving a pipeline cache that outgrows its limit

A driver cache over 256 MiB was refused on every save, so it was never
written again and every launch compiled the same pipelines. Such a cache
is now written as an empty file once, and the next launch starts a fresh
one. A save is skipped when the driver reports the size that was loaded
or last saved, and a failed or deferred save waits for the next interval
instead of running again on every new pipeline.

* [Vulkan] Write only the cache shards that gained pipelines

A shard remembers the driver size it was loaded or saved with and is not
written again while that size holds. Shard saves are logged as one
summary line, and a shard load only when it is slow.

* [Vulkan] Remove the single-file cache once the shard mode takes over

The shard mode never reads the single cache file of the default path, so
it is deleted instead of staying on disk.

* [Gpu] Record compiled compute programs in a shader prewarm list

When the pipeline host gives a list, each compute permutation the game
compiles is appended at once to shader-prewarm.bin: the guest code the
decoder read (once per program), the fused parts, the compute input, the
system registers, the resource specialization and the push data start.
Records carry a checksum, so a cut tail is dropped at the next open.
TryCompilePrewarm rebuilds the compile request from a record through the
same layout and request code as the runtime, so it produces the same
SPIR-V.

* [Vulkan] Prewarm the recorded compute pipelines after a translator or driver change

A first run after a translator change compiled every compute pipeline
one at a time while the render thread waited (Demon's Souls: 282
pipelines, 144 s). When the translator assemblies or the driver differ
from shader-prewarm.stamp, background threads at below-normal priority
translate the listed programs again and create their pipelines, so the
driver has them before the game asks. With the same build and driver the
launch does no prewarm work. The log reports the prewarm result and how
many runtime compute modules it produced.

* [Vulkan] Keep the pipeline cache in memory on Windows

The GPU driver keeps its own shader cache on disk, and the shader prewarm
list rebuilds it after an update, so Windows no longer writes the driver
cache file by default. SHARPEMU_VK_PIPELINE_CACHE=file keeps one; Linux
keeps the file and macOS keeps its shards.

* [Docs] Document the pipeline cache modes and the shader prewarm list

Adds SHARPEMU_SHADER_PREWARM, SHARPEMU_VK_PIPELINE_CACHE_SHARDS and
SHARPEMU_VK_PIPELINE_CACHE_LEGACY_SHARDS, and describes the new cache
file default.

---------

Co-authored-by: kuba <xnetcat.dev@gmail.com>
2026-10-03 04:49:43 +03:00
Mathias e01198a147
Fix/gen5 shader resource handling (GTA 5) (#1015)
* fix(gpu): upload complete dirty pages for cached image sources

* perf(shader): hoist single-block loop entry guards

* fix(shader): support scalar quad masks in resource analysis

* fix(gpu): use native Vulkan fill for three-vertex rectangles

* test(stdio): wait directly for concurrency workers
2026-10-03 04:00:32 +03:00
Mathias 6cac2b5f47
fix(agc): patch indirect-buffer continuation links (#1012) 2026-10-03 00:51:09 +03:00
Mathias 6cebf7ec56
Fix/vulkan wave64 ballot masks (#1011)
* fix(shader): preserve wave64 ballot masks on Vulkan

* test(shader): cover subgroup lane bits in wave mask predicates
2026-10-02 15:10:39 +03:00
ParantezTech e7a4f0a0ce [Gpu] Expose HDR output support and handle PQ buffer attribute changes 2026-10-02 03:37:17 +03:00
ParantezTech f199acd42f [SharedBackingViewsTests] using await Task.WhenAll instead Task.WaitAll 2026-10-02 02:57:25 +03:00
Berk 5a3755fbdc
[GUI] revision of default settings (#1009)
* [GUI] revision of default settings

* [test] fix performance profile settings tests to use the new default values
2026-10-02 02:51:50 +03:00
Thegamerx808 8e1c6255b8
libSceFont: scale layout metrics with font size and accept layout pointer in rdx (#1008)
sceFontGetHorizontalLayout returned fixed 16px-era values regardless of
the scale set with sceFontSetScalePixel. Games that size their render
surfaces from the reported baseline (Astro Bot) ended up with surfaces too
short for the requested glyph size, so DrawGlyph cropped the bottom half of
every character. The layout values now derive from the font's current
pixel height, matching the ascent convention already used by glyph
metrics and the rasterizer.

Some callers pass the layout output pointer in rdx instead of rsi, which
the stub read exclusively, causing an INVALID_ARGUMENT return and Astro
Bot's own assert in FontSystem.cpp followed by the string being skipped
entirely. Fall back to rdx before failing.
2026-10-02 02:07:06 +03:00
ParantezTech e007d43181 [readme] update readme with new image 2026-10-01 21:44:07 +03:00
Berk 36acf4a40e
Des dcc fixes (#1000)
* [SpirvTranslator] Take high products from extended multiplies

Co-authored-by: TarkusR <90155059+TarkusR@users.noreply.github.com>

* [SpirvTranslator] Keep shader flags in uint variables

Co-authored-by: TarkusR <90155059+TarkusR@users.noreply.github.com>

* [SpirvTranslator] Synchronize shared memory phases in multi block shaders

Co-authored-by: TarkusR <90155059+TarkusR@users.noreply.github.com>

* [GPU] Merge device address ranges before buffers are bound

Co-authored-by: TarkusR <90155059+TarkusR@users.noreply.github.com>

* [GPU] Track per-slice guest DCC clear metadata

* [GPU] Materialize guest DCC clears in color and sampled images

* [GPU] Preserve color targets without pixel shader exports

* [ShaderCompiler] Track wave-indexed image descriptor waterfalls

* [ShaderCompiler] Analyze wave64 half masks and shared-memory hazards

* [ShaderCompiler] Pass guest LDS size to SPIR-V compilation

* [SpirvTranslator] Synchronize wave64 half masks through LDS exchange

---------

Co-authored-by: TarkusR <90155059+TarkusR@users.noreply.github.com>
2026-10-01 21:15:55 +03:00
ParantezTech 658e839933 [readme] hi from astro-bot 2026-10-01 15:46:36 +03:00
ParantezTech 5d640293c2 [readme] added new screenshot 2026-10-01 14:23:10 +03:00
T a424a67c1c
[GPU] Refresh the stencil plane through the depth image (#989) 2026-09-30 20:14:49 +03:00
ParantezTech b480391a7b [SpirvTranslator] perf: Clear vertex shader interpolation parameters before translating to SPIR-V
Co-authored-by: Astellou <mathieu.richardeau@gmail.com>
2026-09-30 19:01:44 +03:00
Astell c076513bd6
Astrobot / Demon's soul performance improvement (#955)
* [Gpu] Astro Bot performance: 14 -> ~60 fps at the title scene

- Defer RELEASE_MEM command-buffer flushes instead of submitting per packet
- Resolve indexed indirect draws and dispatches on the GPU
- Async buffer readbacks on a dedicated transfer/compute queue
- Pool image backings, flip snapshots and tiler resources
- One-frame command-stream run-ahead
- Lock-free backed-range and image page-owner checks on CPU writes
- Scalar value cache with generation-stamped reset; memoized invariant phis
- Shader compiler: structured forward-only CFGs with function-scope
  registers, EXEC-full guard elision, bounded V_MOVREL offsets
- Trivial-leaf import dispatch and strchr/strrchr fast paths
- SHARPEMU_GUEST_REFRESH_RATE option

* [Tests] Fix full-suite flaky tests

- Red-zone patcher: when every fixed trampoline candidate is taken, look
  for any free host range within relative-jump reach
  (PhysicalVirtualMemory.EnumerateFreeHostRanges); the test places its
  image in a probed free hole
- Kernel memory tests: probe a free PRT-area address instead of the fixed
  0x1026C00000; the reservation-extent test only rejects picks inside
  the reservation
- Release checks tolerate another thread reusing the freed range
- Allocation tests measure on a dedicated thread and keep the least
  allocating of several rounds (AllocationMeasurement.SteadyState)

* [Gpu] Astro Bot: structured loops, buffer slabs, pad motion

- Shader: emit natural loops as structured SPIR-V loops (OpLoopMerge)
  instead of the block dispatcher, and merge SCC-uniform if/else joins
  as selects so descriptors picked on a branch stay evaluable per draw.
- Shader: decode V_FFBH_I32 and V_MIN3_F16; read the DS GDS bit from
  bit 17 (GFX10) and route GDS append/consume through shared atomics.
- Gpu: sub-allocate small device-local buffers from shared memory slabs.
- Pad: report motion data by default (Astro Bot never imports
  scePadSetMotionSensorState), convert acceleration from m/s^2 to G,
  and add scePadResetOrientation / scePadSetAngularVelocityDeadbandState.

* [CPU] Stop pinning guest threads to host cores by default

Guest affinity packed Demon's Souls' 13 spinning BPE job workers onto 10 host lanes and put its renderer next to them at equal priority, so the renderer and lock holders waited out whole scheduler quanta. Intro 10.6 -> 44.7 fps, menus 11.6 -> 47.5 fps. SHARPEMU_GUEST_AFFINITY=1 restores pinning.

* [Media] Convert host movie frames to YUV on the decoder thread

The render thread converted every decoded Bink frame from BGRA back to YUV 4:2:0 (6.7 ms per frame). The decoder thread now produces the planes and the presenter uploads them as-is. PS Studios logo 33 -> ~50 fps, attract movie 44 -> 60 fps.

* [Agc] Accept a zero destination in sceAgcDcbWriteData

Demon's Souls emits WRITE_DATA with address 0 into a template and patches it after copying. Returning null made the title patch a relocated null pointer, which wrote a stack-derived value into its label and was then parsed as an unknown NOP marker (GPU FATAL).

* [Loader] Patch short red-zone faulting accesses next to branches

A faulting access shorter than a jump could not be relocated when followed by a branch or a branch target, so a handled fault let Windows overwrite the red zone. Spans may now end with a direct branch (run after the stack pointer is restored) or start up to three instructions earlier. Fixes a Demon's Souls crash after the new-game intro movie.

* [GPU] Astro Bot rendering fixes: compute subgroups, DCC clears, PS inputs, texture MIN_LOD

- Compute: pin non-emulated compute pipelines to a 32-lane subgroup
  (VK_EXT_subgroup_size_control) so wave64 groups other than 64
  invocations keep lanes 32..63 active on AMD (striped froxel volume).
- Shader translator: 64-bit AND for the wave32 S_*_SAVEEXEC_B64 mask.
- PS inputs: slots that read one VS parameter share one host input;
  a smooth/flat slot next to a V_INTERP_MOV slot is rebuilt from the
  per-vertex values (black save cards, NaN normals, black props).
- Render targets: drop unwritten color targets of depth passes from both
  the attachments and the pixel outputs, keeping locations aligned.
- DCC: materialize pending zero fast clears before shader access so a
  later attachment bind does not wipe compute writes.
- Textures: honour the T# MIN_LOD with VK_EXT_image_view_min_lod so
  streamed textures never sample unloaded mips (blown-out stadium sky).
- Device: enable VK_KHR_maintenance5 for point lists without PointSize.

* [Audio][GPU] ATRAC9 independent mono streams, BC storage fallback, 32-bit bit counts

- LibAtrac9: decode config header 0x30 streams (PS5 ambisonics), where every
  channel is an independent mono stream interleaved frame by frame.
- Images: when the driver refuses storage usage on a block-compressed image,
  compute writes go through an uncompressed replacement of the same memory.
- SPIR-V: count 64-bit masks with two 32-bit OpBitCount, which Vulkan requires
  without maintenance9.
- Agc: drop the indirect-draw emit debug log; report the draw modifier in the
  unsupported indirect draw error.

* [GPU] Partial texture-pool uploads and cheaper per-draw preparation

- A CPU write into a large layered texture (Demon's Souls' 256-layer BC3
  pools) re-uploaded the whole image, ~750 ms of GPU detiling in one frame.
  Each (mip, layer) piece's guest bytes are hashed at upload; a refresh
  uploads only the pieces that changed.
- Device-address preparation touched and checked every registered buffer for
  each dispatch. Recency touches now run once per retirement tick, and uploads
  only visit buffers in blocks the tracker does not know to be clean; hot
  pages stay dirty, so they are still re-uploaded every time.
- Resource materialization cache: when the only changed words are ones the
  flattened table alone reads (per-frame inline constants), only the table is
  evaluated again.
- A full batch no longer splits an open render pass before 512 draws.
- Lock-free lookups for shader headers, device format properties and the idle
  host movie bridge; the SPIR-V dump toggle is read once per program cache.

* Demon soul - fix texture

* Delete runahead tests

* Screcrow fix for nvidia GPU
2026-09-30 18:14:21 +03:00
Berk d0dd3fe102
Gran Turismo 7 Fixes, AvPlayer, Razor CPU stubs, Net stubs (#927)
* [AvPlayer] improved video playback sync and stats

* [AvPlayer] enabled threaded video decoding

* [Fiber] fixed current fiber address query

* [Font] added bitmap glyph rendering

* [GPU] added unsigned scaled texture sampling

* [Network] added socket receive and resolver support

* [NpManager] added offline signup status

* [NpSessionSignaling] added signed-out request stubs

* [SigninDialog] added dialog stubs

* [TextToSpeech] added initialization stubs

* [SystemService] added music player disable stub

* [VideoOut] added VRR stubs

* [RazorCpu] added marker stubs

* [Fiber] updated current fiber address test

* [Pad] Added scePadGetFeatureReport stub

* [Pad] For now, extra controller definitions should remain as stubs

* [Runtime] Module loader correct order: libc > libSceNpCppWebApi > libScePfs > logiWheel

* [SystemService] Added sceSystemServiceReenableMusicPlayer stub

* [VideoOut] Add sceVideoOutVrrUnpegFromFixedRate stub

* [Cpu] Reuse exited guest thread stack and TLS regions

* [Kernel] Isolate temp0 storage per game process
2026-09-30 01:37:56 +03:00
ParantezTech 50198a694b [Kernel] Return packed directory entries for Quake II 2026-09-30 00:56:20 +03:00
ParantezTech 4d65ff6d51 [Test] Prevented other tests from running the same alignment test in parallel 2026-09-29 19:32:08 +03:00
Berk a9e1c25968
[Ampr] Fix PakDirectoryTracker to handle multiple directories with the same name (#925) 2026-09-28 04:43:05 +03:00
ParantezTech b4c065a0b0 [GPU] performance: negative interval filter 2026-09-28 04:37:46 +03:00
okidooh 4799a1f82f
test(shader): cover SAshrI64 translation (#914) 2026-09-28 02:59:51 +03:00
Foued Attar e17fb6fed1
Fix for DS,Little Nightmares, Little Nightmares III and Astro Bot shader (#913)
* shader(decode): fill MIMG float-atomic and SOP1 opcode gaps

Gen5ShaderTranslator's opcode name tables were missing several real
RDNA2 opcodes that Ghost of Yotei's shaders use: MIMG 0x1D-0x1F
(ImageAtomicFcmpswap/Fmin/Fmax) and SOP1 0x15/0x1B/0x1C/0x1E/0x34/0x3B
(SFlbitI32B32, SBitset0/1 B32/B64, SAbsI32, SBitreplicateB64B32).
Without names these decoded as unknown instructions and aborted
translation before the pipeline ever reached GPU submission.

* shader(resources): accept float-numeric-class atomic image descriptors

ResourceMaterializer rejected any atomic image descriptor whose guest
format wasn't exactly Format32Uint, but real atomic-float images
(ImageAtomicFmin/Fmax) arrive with a float-numeric-class format. Relax
the check to also accept formats whose SampledNumericClass is Float,
and default the null-descriptor's NumericClass to the image's own
class for atomics instead of always Float.

Also surface the actual materialization failure reason in
ShaderProgramCache's error message instead of a generic string, so
each subsequent blocking bug could be identified from the log without
extra instrumentation.

* shader(bindings): add a dedicated atomic-float image binding range

BindingLayout only had a single Atomic-Uint binding range (32-36), so
any atomic image with a float numeric class had nowhere to bind and
ForImage() returned null for it. Add AtomicFloatBinding (37-40),
bump ImageBindingCount 36->41, and split Describe()'s atomic range
into its Uint and Float sub-ranges to match.

Also add an Atomic flag to ShaderImageShape (TargetRegisterWords.cs)
so downstream view-format resolution can distinguish atomic images
from ordinary sampled/storage ones.

* spirv: emit ImageAtomicFmin/Fmax and DsSwizzleB32, fill SOP1 ALU gaps

Vulkan has no native float image-atomic-min/max instruction, so emit
them the way KytyPS5 does: OpImageTexelPointer (typed uint) ->
OpAtomicLoad -> compare-and-swap loop (OpPhi/OpFOrdLessThan/OpSelect
on the bitcast float value) -> OpAtomicCompareExchange, returning the
pre-exchange value from EmitAtomicWordUpdate (now non-void, valid SSA
at the loop's merge block).

Add DsSwizzleB32 (bit-mode/quad-mode lane shuffle via
GroupNonUniformShuffle) to the LDS-opcode switch and to
UsesSubgroupShuffle(), and add the SFlbitI32B32/SAbsI32/SBitset0B32/
SBitset1B32 SOP1 cases so the newly-decoded opcodes from
Gen5ShaderTranslator actually translate to SPIR-V instead of hitting
the generic "unsupported instruction" fallback.

* spirv: declare atomic image OpTypeImage with a Uint sampled type

DeclareImageClass previously derived the SPIR-V OpTypeImage's sampled
type purely from the binding's logical NumericClass, so an
atomic-float image (logical class Float, backed by our new
compare-and-swap emission on a uint texel pointer) still declared its
OpTypeImage as float-sampled. That violates
VUID-StandaloneSpirv-Image-04965: the R32ui image format and a float
sampled type disagree on numeric class. Force the sampled type (and
format, already correct as R32ui) to Uint whenever the image is
atomic, regardless of its logical numeric class.

* gpu: back atomic-float images with a real Uint VkImageView

The SPIR-V side now declares atomic images as Uint (OpTypeImage), but
the actual VkImageView bound at dispatch time was still created with
the descriptor's own float-numeric-class format, tripping
VUID-vkCmdDispatch-format-07753 (the shader's declared sampled type
must match the bound view's format numeric class).

Fix both resolution paths:
- VulkanVideoPresenter.Descriptors.cs: NumericClassOf() now forces
  Uint for any atomic image (this covers the null-descriptor
  fallback path), and ShapeOf() forwards the Atomic flag.
- ImageRequestBuilders.Texture.cs: the real, non-null descriptor path
  resolves its view format independently from the descriptor's raw
  GuestPixelFormat and was untouched by the above. Extend the
  existing Sint-storage override (which already forces such images to
  Format.R32Uint) to also cover shape.Atomic.

Confirmed via a fresh Vulkan-validation-layer run against Ghost of
Yotei that VUID-vkCmdDispatch-format-07753 no longer appears.

* fix(shader): reconcile atomic SPIR-V emitters with upstream

* spirv: fix ImageGetResinfo querying a non-existent sampled-image combo

ImageGetResinfo never goes through UsesSampler() (it only matches
ImageSample*/ImageGather* opcodes), so TryResolveLayoutImage always
resolves imageObject as the raw OpTypeImage value for this
instruction, never a sampled-image combo. The size-query code still
called OpImage on it whenever resource.IsStorage was false, expecting
to extract a combo that was never built, which spirv-val rejects:
"Expected Sample Image to be of type OpTypeSampleImage". Just use
imageObject directly in both branches.

This surfaced only after the earlier atomic-image fixes let Ghost of
Yotei's shader compilation get this far; it is an unrelated,
pre-existing bug in the base PR.

* gpu: remap compute workgroup axes past the Z-dimension device limit

Ghost of Yotei dispatches a compute shader with NUM_THREAD (1,1,256).
Vulkan only guarantees maxComputeWorkGroupSize >= (1024, 1024, 64):
the Z axis has a much tighter guaranteed limit than X/Y, and this ran
into it for real: "LocalSize Z (256) exceeds device limit
maxComputeWorkGroupSize[2] (64)" at vkCreateComputePipelines, even
though the NVIDIA RTX 5070 here allows up to 1024 total invocations.

Fix by remapping logical GNM axes onto physical SPIR-V/dispatch axes
at shader-compile time: the largest NUM_THREAD axis always lands on
physical X (most headroom), the smallest on physical Z (tightest
limit). Gen5SpirvTranslator.ComputeWorkgroupAxisOrder computes this
permutation purely from the three thread-group sizes, so:

- The translator uses it to declare the physical LocalSize execution
  mode and to read gl_LocalInvocationId/gl_WorkGroupId's components
  back into the correct logical VGPR/system-register slots, so guest
  shader code (which only ever sees logical TID/WorkGroupId values)
  is unaffected by the remap.
- RenderExecutor.Compute.cs recomputes the identical permutation from
  the same thread-group sizes (input.ThreadsX/Y/Z) to reorder
  vkCmdDispatch's group counts the same way, with no new metadata
  plumbing between the shader compiler and the dispatch path.

* shader(resources): drop redundant ImageHandle ScalarBufferWord guard; add opt-in resource-tracker diagnostics

GetHandleSource had a blanket rejection of any ImageHandle whose dword
was a ScalarBufferWord, predating ValidateSource/RuntimeValueValidator
being able to generically resolve such dwords at bind time (the same
mechanism MaterializationSources already uses for buffer descriptors).
Drop the redundant, narrower guard and let ValidateSource be the
single source of truth, so legitimately resolvable image descriptors
loaded from a scalar buffer (not just the two hardcoded heap/direct
shapes TryMakeIndirectImage/TryMakeDirectImage recognize) aren't
rejected outright.

This did not resolve Ghost of Yotei's current blocker: its compute
shader at hash=0xCECFBCC210CB2372 pc=0x59C resolves an image
descriptor's byte offset through a loop-carried Phi (a hash-table/
linear-probe style bindless material lookup) that is not loop-
invariant, so it genuinely cannot be pre-evaluated as a single
per-dispatch runtime value the way MakeRuntimeBufferSource/
RuntimeValueEvaluator expect. That needs real GPU-side dynamic
descriptor indexing support, which doesn't exist yet in this
resource-tracking pass.

Also add SHARPEMU_RESOURCE_TRACKER_DIAG=1, gating verbose stderr
tracing in TryMakeIndirectImage's rejection paths and
RuntimeValueValidator's node-validation failures. This is what
localized the loop-carried Phi as the actual root cause; keeping it
opt-in and off by default costs nothing at runtime.

* shader(resources): degrade control-dependent bindless image/sampler descriptors to null instead of failing compilation

Ghost of Yotei's material lookup resolves an image descriptor's
offset through a loop-carried phi (a hash-table/linear-probe bindless
scheme) that RuntimeValueValidator correctly can't treat as a single
compile-time source - this resource tracker has no GPU-side dynamic
descriptor indexing to fall back on. Track *why* validation failed
(RuntimeValueValidator.ControlDependent, set when the failure traces
to a non-invariant phi) and, for image/sampler handles specifically,
degrade to a null descriptor instead of hard-failing shader
recompilation. Buffer handles and any other failure reason still fail
as before.

This ports KytyPS5's fix for the identical case
(feat/shader-control-dependent-descriptor, "shader: fall back to a
null image when its descriptor is control-dependent") rather than
attempting full dynamic descriptor indexing support, which doesn't
exist in either codebase.

Also add SHARPEMU_RESOURCE_TRACKER_DIAG tracing in
RuntimeValueEvaluator's evaluation failure paths (per-source-dword,
flattened table reads, and raw memory reads), used to localize the
next blocker down this same path.

* gpu: keep image shader types compatible with Vulkan views

* shader: decode and emit VOP1 0x39 (VFfbhU32, find-first-bit-high)

Another decode gap in the same family as the earlier MIMG/SOP1 fixes:
VOP1 0x39 was missing from the opcode name table, aborting
translation of Ghost of Yotei's next compute shader before it reached
GPU submission. Ported the fix straight from our own tree's
Gen5ShaderTranslator.cs/Gen5SpirvTranslator.Alu.cs, which already
decodes and emits it: reverse the bits then use the GLSL FindILsb
extended instruction, since RDNA reports the leading-zero count with
the architecturally required 0xFFFFFFFF sentinel for a zero source.

* shader(resources): treat a null-based SRT raw read as zero instead of faulting

A bindless pointer the guest leaves unbound for a dispatch resolves
its address-handle dwords to zero; EvaluateRawRead's raw-address
branch (as opposed to the buffer-descriptor branch) then dereferenced
that near-null address directly, and the guest memory reader
correctly refused it as unmapped, failing the whole materialization
with a generic "reason=Other". Ghost of Yotei's next compute shader
hit exactly this: a flattened SRT table read through a null-resolved
48-bit pointer plus a small immediate offset landed at address 0x14.

Treat any raw-address read below a small guest null-page threshold
(0x10000) as reading zero, so the value (and whatever descriptor it
feeds) collapses to null instead of faulting materialization. Ported
directly from KytyPS5's identical fix for the identical symptom
("shader: treat a null-based SRT constant read as zero").

* shader: decode/emit VOPC 64-bit compares and the 64-bit LDS atomics

Ghost of Yotei's cs 0x80003AF600 emits V_CMPX_NE_U64 (VOPC 0xF5) and DS_ADD_U64/DS_OR_B64 (0x40/0x4A), which the decoder refused. The VOPC 0xE0-0xE7 / 0xF0-0xF7 forms are the same V_CMP/V_CMPX U64 operations the VOP3 table already names and the emitter already lowers, so mirror them into the two-operand VOPC table.

The 64-bit LDS atomics sit just ahead of DS_WRITE_B64. LDS is modelled as an array of dwords, so each is lowered to the two 32-bit atomics that make it up. Neither opcode returns the old value, which makes the split exact: only the final memory state is observable. OR is bitwise-independent, so two 32-bit ORs are the 64-bit OR; ADD folds exactly one carry per low-dword wrap into the high dword, so the high word converges on the true wrap count regardless of lane interleaving. The RTN variants cannot be split without losing the returned pair's atomicity, so they stay undecoded and keep failing loudly.

* shader: decode and emit VOP3-encoded 64-bit VOPC compares (0xE0-E7, 0xF0-F7)

Ghost of Yotei's material-lookup shader issues V_CMP_*_U64/V_CMPX_*_U64
through the VOP3 encoding (opcode < 0x100, the same numbering VOPC
uses), which DecodeVop3's own opcode table never listed - it only
handled VOP3-native opcodes >= 0x101. Ported the fix straight from our
own tree, which already special-cases this exact sub-range (see the
"VOP3-encoded 64-bit VOPC" comment there): decode 0xE0-E7/0xF0-F7 to
the VCmp*U64/VCmpx*U64 names, and emit them as a 64-bit integer
compare (or a constant true/false for the F/T pseudo-compares),
reusing the existing generic VCmpx exec-mask handling.

* shader: implement GFX10 double-precision conversions and arithmetic

Decode VOP1 0x04/0x0F/0x16/0x2F/0x30/0x34 and their VOP3-encoded forms (V_CVT_F64_I32, V_CVT_F64_U32, V_CVT_F32_F64, V_RCP_F64, V_RSQ_F64, V_SQRT_F64) and emit them as real SPIR-V doubles. A 64-bit result is split across the destination register pair: the low word goes through the common destination store and the high word is stored alongside it, both under the EXEC guard. V_MUL_F64 (VOP3 0x165) and V_FMA_F64 (VOP3 0x14C) are added as well.

Source absolute/negate modifiers and the VOP3 output modifier and clamp are honoured. FP64 inline constants and literals are rejected explicitly rather than read as the wrong bits, following the gfx10 expansion rules. The shaderFloat64 device feature is enabled only when the physical device offers it, and the Float64 capability is declared only for modules that use a double.

Ghost of Yotei compute shader 0x8000393600 (hash 0xB90E2024732C6111) now translates and compiles instead of stopping at decode.

* shader: decode and emit VOP2 V_PK_FMAC_F16

V_PK_FMAC_F16 (VOP2 0x3C) reads the destination register as the addend for both packed f16 lanes and writes D = S0 * S1 + D back as a packed pair. Reuse the existing single-rounding fused-f16 path per lane and merge the two halves, so the result matches the hardware's f16 fused behaviour.

Ghost of Yotei compute shader 0x8000393600 reaches this opcode after the decoder is past the f64 gap.

* shader: decode and emit VOP3 V_MAD_I32_I24

V_MAD_I32_I24 (VOP3 0x142) differs from the already-handled V_MAD_U32_U24 only in that both multiplicands are signed 24-bit values. Sign-extend each operand from bit 23, multiply with 32-bit wrap and add the third source.

Ghost of Yotei compute shader 0x8000393600 reaches this opcode after the decoder is past the f64 gap.

* shader(resources): address runtime-fetched buffer descriptors via the device-address page table

A V# whose four dwords are all read from a runtime scalar-memory address (a descriptor-array entry indexed by a loop counter, as in Ghost of Yotei's cs 0x80003F2A00 at pc=0x1B4) cannot be bound ahead of time, so resource tracking used to fail the whole shader. Its dword reads are not control-dependent in any other way: they are real guest memory loads emitted at runtime through the device-address page table.

Detect that case in ResourceTracker and mark the access RuntimeBufferDescriptor instead of building a dense buffer resource. The SPIR-V backend then builds the guest address from the descriptor's runtime base (SGPR pair), the MUBUF offset/soffset/vector offset and, when indexed, the descriptor's stride, and stores/loads through the existing physical-storage-buffer path. num_records/stride bound the access so a null or empty descriptor binds nothing, matching the static path's range check. Formatted, typed and atomic accesses keep failing loudly because their descriptor format cannot be reconstructed from the raw words.

This completes the former d8959888aafd2552 dispatch.

* shader(resources): recognize runtime V# descriptors built from SRT reads and loop phis

The first runtime-descriptor detection only accepted four direct raw ScalarAddressWord dwords. Ghost of Yotei's cs 0x8000289300 at pc=0x78C builds its V# from a loop-carried phi that merges two SBufferLoadDwordx4 reads of the SRT buffer at a dynamic offset, so the access was still rejected even though the descriptor is a real runtime value.

Make the detection generic: a BufferHandle is a runtime descriptor when each dword is a plan-time-known value (constant, user data, shader base, flattened table word) or a guest-memory read, recursing through phis, selects and operations, and at least one leaf is a raw read. A cycle through a phi is accepted the same way the read planner treats cyclic phis. Anything else keeps hard-failing.

The raw BufferLoadUshort at pc=0x78C now lowers through the device-address page table. The formatted BufferLoadFormatX at pc=0x18F4 correctly escalates to BoundedCandidateTable, which is still unimplemented and is now the next required feature.

* shader(resources): plan bounded runtime V# candidate tables

* shader(resources): materialize bounded runtime V# candidate tables

* shader(resources): address a runtime scalar buffer V# through the device page table

* shader(resources): model the guest V# separately from its Vulkan lowering; real 64-bit LDS atomics

Replace MemoryAccessInfo.RuntimeBufferDescriptor with a GuestBufferDescriptor that carries the V#'s provenance (Static or Runtime) and, for static descriptors, the dense-buffer index. The backend now chooses an explicit BufferLoweringStrategy from the descriptor and the access shape via GuestBufferDescriptor.ChooseStrategy, instead of hard-coding a single path: NativeBinding for compile-time descriptors, PhysicalStorageBuffer for a runtime descriptor used by a raw dword/subword access, and BoundedCandidateTable for a runtime descriptor whose format/type cannot be reconstructed from the raw words. The last one is not implemented and fails loudly with a precise reason, which is now a single, discoverable place rather than a boolean scattered through the translator.

DS_ADD_U64/DS_OR_B64 are now emitted as true 64-bit workgroup atomics when the device exposes shaderSharedInt64Atomics (queried through VkPhysicalDeviceShaderAtomicInt64Features, declared with the Int64Atomics capability, addressed through a 64-bit LDS view). The previous two-32-bit split is kept only as a documented fallback for devices without the feature; it is not atomic as a pair. Device setup reports the capability once.

* shader/image: accept 11_11_10 UNORM sampling and 8-bit sRGB render targets

The unified image format 30 is 11_11_10_UNORM, a packed 11/11/10 normalized float format the rendering side already knows as GuestPixelFormat.Bits11_11_10UNorm (mapped to VK_FORMAT_B10G11R11_UFLOAT_PACK32). It was missing from the shader-side sampled-format table, so cs 0x8000265D00 failed specialization with 'sampled image descriptor 7 uses unsupported format 30'.

Bits8Srgb and Bits8_8Srgb also had RenderTargetBytesPerElement = 0 while their element sizes are 1 and 2 bytes, which made TryGetTextureSize reject a RenderTarget-tiled 8-bit sRGB surface (tile mode 27) that the guest creates. Their render-target footprint is the same as the matching UNORM formats, and the host view already substitutes R8/R8G8 UNORM, so give them the real byte counts.

* shader: allow inline constants and literals as VOP3P packed-f16 operands

The VOP3P packed-f16 path only accepted register operands and refused constants, so cs 0x80003AF600 stopped at V_PK_FMA_F16 with src[128]. An inline constant or literal is a single f32 value rather than a packed register pair, so there is no half to select: both lanes take the exactly-converted f16 of that constant, with the lane's negate modifier still applied. Keeps the register path unchanged.

* shader: support Yotei f16 shifts bitsets and safe LDS atomics

* shader(vulkan): dispatch bounded runtime V# candidate tables

* shader: support additional LDS operations

* shader: support RDNA LDS store encoding

* shader: handle LDS operands and RDNA buffer cache op

* shader: extend strict GFX9 buffer and ALU decoding

* [VideoOut] added output mode events and profiling fixes

* [Gpu] fixed image, render, and dispatch handling

* shader: track SDWA and runtime buffer values

* [Shader] expanded Gen5 resource and interpolation support

* gpu: reconcile PR893 metadata and indirect dispatch

* gpu(commands): consume unknown NOP marker ids instead of failing the submission

Demon's Souls emits markers 0x6EC and 0x80C, which the interpreter treated as
fatal. The packets carry no work for the ids without a known side effect
(flips, user-data marker context), so they are consumed and each id is
reported once (command_stream.marker_ignored). voidborn, which gets much
further on this title, likewise ignores NOP marker payloads it has no
handler for.

* kernel: implement sceKernelGetOperationMode (PS5 base console, no submode)

The import was unresolved, so callers polling it (Demon's Souls does it at very
high frequency) got an unresolved-import result instead of the mode. Behaviour
matches KytyPS5 KernelGetOperationMode: *mode = 2, *submode = 0.

* loader: protect red-zone functions with enclosing patch spans

The red-zone patcher only built a trampoline span forward from the faulting
instruction, so it gave up whenever the next instruction was a branch target,
touched RSP, or changed control flow. Those refusals never reached FailedSites,
and the summary line reported sites=11472/11472 failed=0 while 777 faultable
instructions inside red-zone functions stayed unprotected.

Demon's Souls died on one of them. A GPU write-tracking fault at 0x800AD91F8
dispatched on the guest stack with RSP unshifted, which let Windows overwrite
the 128 bytes below RSP; the function reloaded its pointer from [rsp-0x10],
got 0, and faulted writing through it. The fault census confirms the same RSP
in the faulting frame as in the crash report.

Add TryBuildEnclosingPatchSpan: when the forward search refuses, take the
span's bytes from before the faulting instruction so the span ends at that
instruction and the one after it is never rewritten, which keeps every existing
branch into it valid. Two invariants make this safe and both are exercised by
the new tests:

  - the RSP shift brackets only the faultable core, so a relocated
    RSP-relative access still reads the slot it meant to;
  - a span may not start before the end of the previous site, because a
    backward span can otherwise reach instructions an earlier site already
    replaced with its own jump.

Patch() also refuses overlapping sites outright rather than corrupting guest
code, and the scan now reports unrelocatable sites by category.

Unprotected sites drop from 777 to 270. The title runs past the main menu into
its opening cinematic and stops on an unrelated shader resource error.

The fiber tests move into a shared collection: they mutate the same static
FiberExports state as FiberExportsTests, and xUnit runs separate classes in
parallel, which made them fail intermittently.

* cpu: count guest faults and make access-violation reports readable

Guest code is commonly mapped PAGE_EXECUTE, which no host read can satisfy, so
IsReadableHostRange refused it and the whole call-site section of the access
violation report was skipped: every crash in such a title printed "Could not
read code at RIP" and nothing else. Read those windows through the guest memory
view instead, and print the faulting region so a future refusal explains
itself.

Add a census of the recoverable faults taken on guest threads, by guest RIP and
by the handler that resolved them. Windows has no alternate exception-dispatch
stack, so each of those faults overwrites the 128 bytes below RSP; knowing which
guest instructions fault is what turns a red-zone corruption from a hypothesis
into a measurement. Counters are allocated once per RIP and are inert unless
SHARPEMU_FAULT_CENSUS is set, since the handler is hot.

Also fix the guest context transfer frame: it published the stack bounds in the
wrong order, storing the low address in NT_TIB.StackBase and the high one in
StackLimit on every fiber switch.

Note: these two files also carried uncommitted work from earlier in this
worktree (guest stack sizing, the 22-qword transfer frame, import and exception
paths); that work is included here rather than separated, because the hunks
interleave.

* gpu: stop handing image ownership to a buffer that was only bound

Binding a formatted writable buffer over an image's memory invalidated every
image covering that range. The shader only declares that it may write there, so
this fired on every bind of every draw, and when the range belonged to a render
target the image was refreshed from guest memory the GPU never wrote - its
tiled backing read as linear, over the frame that had just been rendered.

A Demon's Souls capture showed 412 buffer-dirty refreshes and 207 GB of image
traffic. Suppressing the two bind-time call sites removed the banding entirely
and took the frame time from 7471 ms to 4272 ms, with GPU occupancy going from
29% to 45%; buffer-dirty refreshes dropped to zero.

Writes that actually happened still invalidate, from GuestBufferCache's fill and
DMA-copy paths, which is what the image ownership tests cover. The declared-write
case needs a reconciliation after the submission, once the GPU-modified ranges
are known; that does not exist yet, so
SHARPEMU_SPECULATIVE_IMAGE_INVALIDATION=1 restores the old behaviour meanwhile.

Note: these two files also carried uncommitted work from earlier in this
worktree.

* shader: name the instruction behind an undefined descriptor dword

A descriptor dword that resolves to an undefined value fails the resource plan
with nothing to act on. Undefined nodes are interned per type, so one shared
node stands for every instruction the builder could not model, and the builder
has about twenty places that produce one: the message names a category where it
should name an opcode.

Record the instruction the builder is translating, and under
SHARPEMU_RESOURCE_TRACKER_DIAG intern undefined nodes per instruction as well.
Revisiting a block reaches the same instruction, so values stay as stable across
visits as before, and the rejection can walk the failing dword back to the
undefined leaves it rests on and name them. Without the diagnostic the interning
and the message are unchanged.

A first attempt recorded every undefined created while an instruction was in
flight, which listed 1410 instructions for one shader because many are created
legitimately, for SCC among others. Only the leaves the failing value actually
depends on are reported.

Test counts are unchanged at 614 passed and 95 pre-existing failures.

* shader: carry over the Gen5 translation work from the port

Pre-existing work in this worktree, recorded here rather than authored in this
session: VOP3B carry/borrow paths for VSubCoCiU32 and VSubrevCoCiU32, the high
opcode bit for MIMG and the ray-tracing names it selects, DS/GDS flags, the
wave32 EXEC mask, and the scalar value graph and runtime evaluator changes that
go with them, across the Vulkan and Metal back ends.

* gpu: carry over the AGC and VideoOut work from the port

Pre-existing work in this worktree, recorded here rather than authored in this
session: tracked image caching in place of unused snapshots, depth/stencil
handling, snapshot reuse for feedback loops, read-only depth, the Vulkan
feedback target resolver, the GuestDepth and draw recording paths, GPU barriers
and image cache tracking, the storage resolver, BDA and GPU memory tracking in
VideoOut, and the submission and indirect dispatch corrections.

* hle: carry over the library export work from the port

Pre-existing work in this worktree, recorded here rather than authored in this
session: an HTTP connect timeout, an offline MAC, NP signalling context, the
asynchronous NP stubs and entitlement key, NP WebAPI context deletion, a CFW
stub, and the added aliases for sceImeKeyboardGetInfo, unlink, sched_yield,
scePadResetOrientation, scePadIsRemoteController and the solo scheduling
attributes, along with the Ampr file registry and kernel compatibility exports.

* cpu: carry over the guest execution and memory work from the port

Pre-existing work in this worktree, recorded here rather than authored in this
session: the guest stack size the pthread attribute asks for and its cap, the
PthreadYield fallback, the multi-thread stall watchdog, import and handoff
instrumentation, the host view and guest space owner changes, and the physical
virtual memory and runtime adjustments that go with them.

* base: verified pre-rebase gameplay baseline

* fix: materialize indirect shader image resources

* gpu,shader: Yotei bring-up changes (GPT session, unreviewed)

Work from a separate GPT session aimed at Ghost of Yotei, committed as-is so
it can be reviewed block by block. It clearly improves Demon's Souls rendering
(the scene becomes visible), but review found problems to fix before a PR:

- S_BITREPLICATE_B64_B32 copies the dword into both halves; the ISA doubles
  each bit (bit i -> bits 2i, 2i+1). Wrong in the translator and the graph.
- FindMatchingMipLevel no longer matches 2D array views of 3D volumes; the
  test expectation was flipped from 0 to -1 instead of keeping the case.
- VectorCompareResourceTests lost five passing tests, replaced by
  compile-only smoke tests.
- 11_11_10 UNorm is mapped to a packed-float Vulkan format.
- Unknown BufferLoadFormat descriptors now read zeros / null images silently.
- Undefined scalar values are interned per instruction for every title.

Also adds 16-bit integer VOPC compares, V_RSQ_F16, IMAGE_GATHER4_C_LZ,
IMAGE_SAMPLE_A decode, Yotei base entitlements, richer image-creation
failure messages and flip-source diagnostics.

* diagnostics(renderdoc): capture automatically after N guest flips

SHARPEMU_RENDERDOC_CAPTURE_AFTER_FLIPS=N requests one capture once N guest
flip boundaries have been seen, so an unattended run can capture without the
F12 key. The count is kept here because the flip image version is per display
buffer, not a global frame index.

* fix(import-guard): recognize polling progress boundaries (#895)

* port shader GDS byte reads and float atomics

* port kernel debug exception exports

* Revert "port kernel debug exception exports"

This reverts commit 71d605e82c82a4a921862bfc865a104305cf746d.

* Revert "port shader GDS byte reads and float atomics"

This reverts commit 8f4e7664d7fc81a28ba5c47c86cbc03dba61d47b.

* [usbd] implement event timeout

* [usbd] add initialization stubs

* [share] add feature and overlay exports

* [kernel] implement pthread cond signalto

* [font] add renderer and kerning exports

* [agc] implement ACB rewind exports

* [share] add running status export

* [stubs] add game service exports

* [kernel] implement high resolution timer events

* [gpu] support polygon primitive rendering

* chore: bump version to 0.0.4

* [kernel] implement debug exception exports

* [vulkan] adopt synchronization2 submission and barriers

* docs: update upstream README

* Revert "[vulkan] adopt synchronization2 submission and barriers"

This reverts commit 7e44f90d624c05ccac3ba8d14f94bfa63c225b1d.

* Reapply "[vulkan] adopt synchronization2 submission and barriers"

This reverts commit 66b456dd2a4562b081970404034ab3cc3135f66a.

* Revert "[kernel] implement high resolution timer events"

This reverts commit faf105d9a0f93120f9954ff30890701683d79a67.

* Reapply "[kernel] implement high resolution timer events"

This reverts commit 9858506307cfdc43e875180f21727bea936ac888.

* Revert "[kernel] implement pthread cond signalto"

This reverts commit 83ad3b0ac313b01c7d1493e685423a5a419b8766.

* Reapply "[kernel] implement pthread cond signalto"

This reverts commit 4bc31dabf7885687dc3777aefede6b4122f936a4.

* [ampr] fall back to executable-local index cache

* [ampr] probe cache directory writability

* [media] keep host movies progressing when Vulkan bindings lag

* [media] release stalled host movies independently of rendering

* [vulkan] reuse pipeline caches across emulator builds

* [media] propagate stalled movie EOF to the guest

* [ampr] return guest path ids from resolve exports

* Revert "[vulkan] reuse pipeline caches across emulator builds"

This reverts commit f0f8e21382b402b510645acb66cf122ad765cd4a.

* [vulkan] reuse pipeline caches across emulator builds

* Revert "[vulkan] reuse pipeline caches across emulator builds"

This reverts commit fd667b6320b74be1e5d71b37a3c29fc11af713bb.

* fix(media): honor full Bink movie duration

* fix(vulkan): schedule wave64 barriers uniformly

* fix(vulkan): emit wave64 loop merge before branch

* fix(vulkan): predicate wave64 image stores

* Revert "fix(vulkan): predicate wave64 image stores"

This reverts commit 5842298743822d1b128e8b4dcb3f9d0a8fd03c35.

* Revert "fix(vulkan): emit wave64 loop merge before branch"

This reverts commit d2b98e0a8439e41c8faf04335320f202740fe7f9.

* Revert "fix(vulkan): schedule wave64 barriers uniformly"

This reverts commit 976d5a5957080de6568417c9d12235570b1503ef.

* baseline: preserve good Demon's Souls rendering

* Revert "[vulkan] adopt synchronization2 submission and barriers"

This reverts commit 7e44f90d624c05ccac3ba8d14f94bfa63c225b1d.

* fix(ampr): keep APR resolve ids unique on path-hash collisions

The APR resolve exports now return the 31-bit FNV hash of the guest path
(upstream 5c347d2c). Demon's Souls ships 13 same-hash file pairs under
/app0/ alone, and it resolves 32 colliding paths before the main menu.
Colliding files shared one id and read each other's bytes, and the
first level load after the menu never finished.

Hand out the hash only while it names one host file, keep it in an
authoritative table that later alias publishes cannot poison, and fall
back to a collision-safe Register() handle otherwise. Log both the
fallback and reads of unknown ids, which previously failed silently.

* fix(media): size the Bink watchdog to the movie, restore Gen4 export

c77746bd reverted the duration-based Bink watchdog to a fixed 90 s, and
MediaFramePlayback also capped every movie (AvPlayer too) at 120 s.
Demon's Souls ships a 171 s intro, 117-138 s attract movies and 756 s
credits, which both bounds cut short. Arm the watchdog for the movie
length plus 60 s (minimum 90 s, no upper bound) and drop the fixed
playback cap, as in the pre-rebase baseline.

Also keep cfwBSQyr5Ys exported for Gen4 as the baseline did.

* chore: trim added comments, keep upstream's cfwBSQyr5Ys target

Restore upstream's APR ABI comment verbatim, keep each added comment to
one line, and leave sceKernelDebugWriteCppExceptionInfo Gen5-only as
upstream declares it.

* fix(vulkan): query image levels only when the result is read

ImageGetResinfo emitted OpImageQueryLevels for every sampled image even
when the dmask never reads component 3. On a 3D image, the unused query
crashes NVIDIA's pipeline compiler inside vkCreateComputePipelines:
Demon's Souls compute shader 0xC553F37E46481A6B (dmask 3) takes the
process down right after the first frame.

* fix(shader): reconcile branch resource planning with upstream contracts

- Keep upstream's 42-binding image ABI. A float min/max image atomic
  binds as the uint atomic image its compare-exchange loop already uses.
- A null-page read turns into zero only after a null base pointer fails
  to read, not for every address below 0x10000.
- An empty V# reads as zero; overrunning a bound buffer stays a failure.
- A wave-indexed image table reads its mask through the clean reader,
  like every other slot its descriptor depends on.
- A buffer load through a lane-varying address stays undefined, and a
  constant exec_lo write keeps s_cbranch_execz decidable.
- An image descriptor from a scalar buffer must be one contiguous
  record, and a vector access through a draw-evaluable V# keeps its
  explicit binding instead of the runtime-descriptor path.

* fix(shader): drop the null-page read rule, encode GDS at bit 17 in tests

KytyPS5 does not turn a null SRT pointer read into zero: an unmapped
read fails materialization, which FailedResourceReadsRemainFatal pins.
Remove the rule.

GFX10 DS encodes GDS at bit 17 with OP at 25:18; bit 16 is GFX9's
position (LLVM DS_Real_gfx10). The decoder already reads bit 17, so the
DataShare tests set GDS there, and the LDS wave-counter tests clear it.

* fix(vulkan): keep bind-time image invalidation coherent with GPU contents

Binding a formatted writable buffer over an image marks the image
buffer-modified, so its next use refreshes it from the buffer. The
buffer was only synchronized from the image for read-only views, so
over a render target a writable view refreshed the image from stale
guest bytes. That is the Demon's Souls banding 48cd723a worked around
by skipping the invalidation altogether.

Synchronize writable formatted views from the image as well, and at bind
time invalidate every covered image except one whose only current copy
is still on the GPU and could not be copied into the buffer. Drop the
SHARPEMU_SPECULATIVE_IMAGE_INVALIDATION switch.

* test(shader): expect the header immediate in the indirect selector offset

The materializer reads the selector word at selector * stride +
SelectorOffset, so the offset must include the material read's
immediate. With the header immediate 4 and the +4 in the address
arithmetic it is 8; the test expected 4 since it was written.

* chore: remove session diagnostics

Drop the ad-hoc instrumentation added while bringing Demon's Souls and
Ghost of Yotei up:
- SHARPEMU_RESOURCE_TRACKER_DIAG traces in the resource tracker, dense
  image tables, runtime evaluator and validator
- unconditional materialize_snapshot_probe warnings and the
  SHARPEMU_TRACE_INDIRECT_IMAGES wave-table trace
- the guest fault census (SHARPEMU_FAULT_CENSUS / SHARPEMU_FAULT_WATCH)
- red-zone patcher address trace, unprotected-site file and short-jump
  estimate (SHARPEMU_REDZONE_TRACE / SHARPEMU_REDZONE_SITES_FILE)
- RenderDoc capture after N flips and the flip-source refresh traces

The red-zone coverage counters and the readable access-violation report
stay.

* fix(kernel): sparse virtual reservations and HLE compatibility fixes

- sceKernelReserveVirtualRange: keep very large non-fixed reservations
  in the guest mapping table without one contiguous host placeholder.
- Event flags: read names and write handles through the kernel
  compatibility helpers so read-only image pages work.
- sceAjmInitialize: only validate the 32-bit reserved argument.
- Pthread: only free opaque objects the compatibility layer allocated.
- Route libc memset to the HLE implementation (int 45h path in LLE).

* fix(gpu): tiling, color targets, VideoOut pipelines and primitive stage masks

- Tile geometry and tiler shader fixes for detiling.
- Color target request fixes for 3D slice ranges.
- VideoOut descriptor, draw recording and pipeline fixes.
- Accept the compact primitive-shader stage masks (0x2000, 0x2030)
  and report the rejected state when draws are skipped.

* fix(shader): Little Nightmares III decoding and translation

- Decode S_SCRATCH_STORE_DWORDX2 (SMRD op 0x16) as a scalar scratch
  store instead of a load.
- Raise the decoder instruction limit to the maximum shader size.
- Stop linear decoding at S_SETPC_B64 and treat the tail as
  unreachable; find fused GS pairs across the full 1 MiB object and
  resolve continuation image descriptors from its entry SGPRs.
- Translate S_SETPC_B64 in linearised fused programs as a marker.
- Implement S_MUL_HI_I32 and V_DOT2C_F32_F16.

* fix(shader): Astro Bot debugger stubs and wave32 primitive pipelines

- S_CBRANCH_CDBG* only fire under an attached GPU debugger; do not let
  them extend the decoded program past S_ENDPGM into debugger stubs
  that load descriptors from devkit-only addresses.
- Stop decoding after an unconditional backward S_BRANCH with no
  pending forward target instead of reading the "sl00" metadata
  trailer as instructions.
- Ignore the GS_W32_EN/VS_W32_EN wave-size bits when matching
  primitive-shader stage masks; graphics stages always compile as
  wave32, so these draws were skipped for no reason.

* fix(kernel): keep sparse reservations out of the macOS graphics window

macOS reserves 0x10_0000_0000..0x70_0000_0000 for graphics memory, so a
sparse reservation starting at 0x40_0000_0000 could not be mapped there
(LargeVirtualReservationFallsBackToSparseGuestRange failed on osx-x64).
Start the sparse aperture at 0x70_0000_0000 on macOS.

* fix(shader): declare guest 1D textures as 1D images

Since #903 the image request builder binds guest 1D textures through
1D Vulkan views, but the SPIR-V translator still declared them as 2D.
Sampling a 1D view through a 2D image type is invalid, and on NVIDIA
Astro Bot's final composite pass wrote black to the flip buffer.
Declare Dim1D/Dim1DArray as SPIR-V 1D images with Sampled1D/Image1D,
matching upstream.

* revert(gpu): fail on written device-address ranges that cannot be planned

The Little Nightmares III work skipped unplannable written ranges on the
host and allowed those stores unconditionally in the shader. Stores whose
pages were not already in the BDA page table were then dropped silently.
Restore upstream's fatal and remove UnplannableWrittenMemoryIndices, so
each such shader is reported and fixed on its own.

* fix(shader): route FLAT accesses through the LDS and scratch apertures

GFX10 sends a FLAT access to LDS or scratch when bits 63:48 of its
address match the shared or private aperture (SH_MEM_BASES), and to
global memory otherwise. src_shared_base/src_private_base decoded to 0,
so an LDS pointer became a device address the host could not plan
(Little Nightmares traversal stack, shader 0x9669394374AAE5BC).

- Give the apertures distinct high dwords no guest address can reach,
  consistent for 32-bit (high dword) and 64-bit (address) reads.
- Keep aperture identity in the scalar value graph (MemoryAperture).
- The device-address planner classifies a FLAT access whose high dword
  derives from an aperture and gives it no device range; plain device
  pointers keep the range and the fatal.
- The SPIR-V backend routes each lane by bits 63:48 to LDS, scratch or
  the page-table global path.

* fix(shader): use the PS5 apertures and prove clamped FLAT addresses local

Little Nightmares builds its BVH traversal-stack addresses without
src_shared_base: v_med3_u32(0x80000000, 0x70000000, sp) clamps the high
dword, and the pop path reads the 0x7xxxxxxx entries with ds_read and
the 0x8xxxxxxx ones with scratch_load. These are the PS5 shared and
private apertures, so:

- SharedApertureHigh = 0x70000000, PrivateApertureHigh = 0x80000000;
  the backend routes a FLAT lane by the top nibble of its high dword.
- Model v_med3_u32/v_med3_i32 in the scalar value graph.
- The planner bounds the high dword (Phi/Select/UMin/UMax, cycles
  ignored since each yields one of its inputs) and classifies it local
  when the bounds stay inside the apertures.
- Record the EXEC mask of each global/flat access: a select on that
  same mask is a lane-masked register write whose inactive arm never
  reaches a lane that accesses memory.

Little Nightmares shaders 0x9669..., 0xE9F1... and 0x392B... now plan
without the removed unplanned-write skip.

* feat(shader): emulate the GFX10 BVH node test for image_bvh_intersect_ray

Follows AMD GPURT's RT IP 1.1 fallback: triangle nodes 0/1 with barycentric
swizzle, FP16/FP32 box slab test with grow, NaN rule and sorting network.
Nodes are read through the device-address page table.

* fix(gpu): move a depth surface sampled as color into a color image

A texture whose format reads neither the depth nor the stencil plane
reinterprets the memory; Little Nightmares samples a D32S8 surface as BGRA8.

* fix(shader): make s_barrier order buffer and image memory within the workgroup

Guest code publishes stores to its workgroup with s_waitcnt vmcnt(0) +
s_barrier; the host barrier only ordered shared memory.

* fix(gpu): match sampler border color and filtering to the sampled view

Border colors were always integer, which Vulkan leaves undefined on float
views (an opaque-white border can read back as black). The numeric class
now comes from the bound view formats; integer views also drop filtering.

* fix(shader): decode the VOP1 and VOP3 half-precision transcendentals

Silent Hill's pixel shaders use v_log_f16; add rcp, sqrt, log, exp,
floor, ceil, trunc, rndne, fract, sin and cos for f16 in both encodings.

* fix(shader): decode v_min3_f16, v_max3_f16 and v_med3_f16

Silent Hill's pixel shaders use v_min3_f16; the draw was skipped.

* fix(agc): give a fused shader the larger user SGPR count of its halves

sceAgcFuseShaderHalves kept the back half's SPI_SHADER_PGM_RSRC2_GS, so a
front half reading its vertex tables from user SGPRs 26-29 saw only 12
(Silent Hill: front 30, back 12) and the draw faulted on null tables.
A vertex program without input semantics no longer needs the tables, and
the null-table and PRT-mapping messages name the registers involved.

* fix(shader): read buffers past the binding budget through their device descriptors

A Silent Hill compute shader binds more than 32 distinct buffers. Past the
budget an untyped access reads its V# from its SGPRs at run time, as the
hardware does, instead of failing the whole shader.

* fix(gpu): treat a compute constant fill of DCC metadata as a fast clear

Unreal fast-clears DCC render targets with a compute shader that stores one
dword from a constant buffer into every metadata record (0x40404040 clears
to 0,0,0,1). The fill only reached plain memory, so Silent Hill's
translucency layer stayed 0 and its composite multiplied the scene by 0.
The exact instruction sequence is recognised and routed to the existing
DCC clear tracking.

* fix(gpu): invalidate every image under a bound writable formatted buffer

The bound-write path skipped images whose only current copy was on the GPU.
Such an image kept stale contents after the guest rewrote it through the
buffer: Dead Cells lost its background and Demon's Souls showed wrong
surfaces. Bisected to ed3de27b; upstream invalidates unconditionally, and
52fbe275 already synchronizes writable views from the image, which fixed the
banding the exception was meant to hide.

---------

Co-authored-by: ParantezTech <12572227+par274@users.noreply.github.com>
Co-authored-by: Mathias <06mathias6@gmail.com>
2026-09-27 20:43:07 +03:00
kuba ab0e77e5d6
[CPU] Emulate and rewrite SHA extension instructions on hosts without SHA (#909)
* [CPU] Emulate the SHA extensions when the host raises #UD

The PS5 CPU supports SHA1RNDS4/SHA1NEXTE/SHA1MSG1/SHA1MSG2 and
SHA256RNDS2/SHA256MSG1/SHA256MSG2, and titles use them without a CPUID
check. Rosetta 2 does not translate them, so Poppy Playtime (UE4) aborted
with SIGILL on sha1msg1 on Apple Silicon. Decode the faulting instruction
and compute it from the saved XMM registers, like the SSE4a fallback.

* [Loader] Rewrite SHA extension instructions at load time on hosts without SHA

A #UD trap per SHA instruction is far too slow for titles that hash large
files: Poppy Playtime took 300k traps and the stall watchdog stopped it.
The red-zone patcher now replaces each SHA instruction with general-register
code in its trampoline, keeping all other registers and the flags. The trap
handler stays as the fallback for sites that cannot be patched.
2026-09-26 14:20:08 +03:00
kuba 9073974ba8
[SpirvTranslator] Use a flat input for v_interp_mov P0 on MoltenVK (#910)
MoltenVK advertises VK_KHR_fragment_shader_barycentric, but SPIRV-Cross
cannot translate PerVertexKHR inputs to MSL, so every pixel shader with
v_interp_mov_f32 failed pipeline creation on macOS (Poppy Playtime).
Reading only P0 is the provoking vertex value, which a flat input gives.
Attributes that read P10 or P20 still use per-vertex inputs.
2026-09-26 14:19:57 +03:00
kuba 155add2c10
[CPU] Cache readable stack ranges per thread for import arguments on POSIX (#911)
Every import reads its stack arguments through a region query, which on
POSIX takes the global region lock and scans the view regions. With many
guest threads this was the most contended lock in the process (about 36k
contentions per second in Poppy Playtime) and HLE calls averaged ~59 us.
Keep the last readable range per thread for the import path and reuse it
until any POSIX mapping or protection changes. The signal handlers keep the
uncached query, since they must not touch thread-static storage.
2026-09-26 14:19:48 +03:00
kuba ac8ffc3f3a
[Pad] Reject pad handle 0 after the title opens a pad (#912)
Unreal Engine polls scePadReadState for all four user slots and passes
handle 0 for slots it never opened. Accepting handle 0 as the primary pad
reported three phantom controllers that repeated the primary pad's buttons,
and Poppy Playtime ignored all menu input. Handle 0 stays valid until the
title opens a pad, for Monster Truck Championship's early polling.
2026-09-26 14:19:39 +03:00
kuba 1759e18b77
[Memory] Pre-reserve the guest address space on POSIX hosts (#905)
* [Memory] Reserve the guest address space again after an image reset

SelfLoader clears virtual memory before loading the eboot, which released the
startup pre-reservation of 0x10_0000_0000..0xFC_0000_0000. Every later large
reservation then had to probe the host address space candidate by candidate.

* [Memory] Pre-reserve the guest address space on POSIX hosts

POSIX had no ReserveFreeAddressRanges and cannot query foreign host mappings,
so TryHoldRangeAtOrAbove stepped through the address space one alignment unit
at a time. On macOS a 512 GiB reservation (all UE titles) took ~196k failed
mmap/munmap pairs before reaching free space, which the stall watchdog reported
as a hang in sceKernelReserveVirtualRange.

Find the free ranges by bisection, and use the first pre-reserved candidate
once a lower candidate fails.
2026-09-26 03:06:25 +03:00
Berk f98ff990ec
chore: bump version to 0.0.4-release.2 (#908) 2026-09-26 01:14:40 +03:00
Mathias 8feea60d31
fix(gen5): handle runtime and shader buffer paths (#904)
* Implement AMPR wait-on-address commands

* Accept Gen5 AJM initialization options

* Preserve opaque context register table values

* Support shader-loaded buffer descriptors

* Support V_CVT_U16_F16 shader instruction
2026-09-26 00:37:09 +03:00
Berk 7dbdd8b2cc
[GUI/CLI] Add support for console settings and language selection (#907) 2026-09-26 00:17:25 +03:00
Astell d4ff32a1d2
Amd fix opcode nid filecache wave32 (#903)
* AMD RDNA2 FIX, WAVE32 FIX, GatherResourceFileInfo imporove with cache, sop 0x0F

* multiple vulkan fixes

* Astrobot video black square fix

* Fix tests: supported depth/stencil formats on AMD, non-null unmapped pointer, robust allocation check
2026-09-24 15:00:42 +03:00
Astell 22e73fbea1
[SpirvTranslator] Declare vgprPackedHalf only when a shader uses it (#901)
Every translated module declared the 4 KiB private vgprPackedHalf array,
even when no packed-half instruction reads it. AMD's Windows compiler
keeps the unused array as a named .bss global; linking two stages then
fails and the driver copies the NOBITS section as file data, reading
past the end of the ELF. The result is a 0xC0000005 access violation
inside amdvlk64.dll during vkCreateGraphicsPipelines /
vkCreateComputePipelines.

The array is now created on first use by PackedHalfRegisters().
2026-09-24 02:00:23 +03:00
Berk f70e333c08
[GUI/CLI] Add option to disable Vulkan implicit layers (#900) 2026-09-23 16:08:19 +03:00
ParantezTech d9433ff185 [Vk] Implement VK_EXT_shader_viewport_index_layer extension support 2026-09-23 14:47:08 +03:00
ParantezTech a036bc1a48 [CPU] Host RBX is restored from the saved host frame below 2026-09-23 14:46:17 +03:00
Berk 6d6a5a1a0d
[Spirvtranslator] Added many instruction set for SPIR-V translator (#894) 2026-09-23 14:05:19 +03:00
Berk 6fe8555f8f
Vk version update (#897)
* [Gpu] Vk version update

* [Gpu] Add Vk synchronization2 helper

* [Gpu] Migrate Vk queue submission to synchronization2

* [Gpu] Migrate Vk timestamps to synchronization2

* [Gpu] Migrate Vk buffer barriers to synchronization2

* [Gpu] Migrate Vk image barriers to synchronization2

* [Gpu] Migrate Vk GDS barrier to synchronization2

* [Gpu] Migrate Vk cached image barriers to synchronization2

* [Gpu] Migrate Vk command stream barriers to synchronization2

* [Gpu] Migrate Vk present barriers to synchronization2

* [Gpu] Migrate Vk rendering barriers to synchronization2

* [Gpu] Update Vk image tests for synchronization2

* [Gpu] Update Vk compute tests for synchronization2
2026-09-22 17:45:51 +03:00
Berk db382cf32f
chore: bump version to 0.0.4 (#896) 2026-09-22 04:33:19 +03:00
ParantezTech 0b2ee449a7 [readme] update 2026-09-22 04:29:46 +03:00
ParantezTech 54ab51e117 [SpirvTranslator] Fix SPIR-V viewport/layer capability handling 2026-09-22 04:20:21 +03:00
ParantezTech 5c347d2cb2 [Ampr] Separate APR guest file IDs from local handles 2026-09-22 04:17:44 +03:00
ParantezTech f1be35aa35 [GameService] more service stubs for the game service 2026-09-22 04:17:08 +03:00
ParantezTech 7d299c6b87 [Share] Added sceShareGetRunningStatus 2026-09-22 04:16:44 +03:00
ParantezTech a86f67393b [GPU] added polygon rendering support for VK 2026-09-22 04:15:50 +03:00
ParantezTech 082b5fa246 [AGC] sceAgcAcbRewind, sceAgcRewindPatchSetRewindState implements 2026-09-22 04:13:11 +03:00
ParantezTech b4584f8040 [Font] sceFontRebindRenderer, sceFontGetCharGlyphMetrics, sceFontGetKerning 2026-09-22 04:12:19 +03:00
ParantezTech 2a27cfe8be [Pthread] implement scePthreadCondSignalto 2026-09-22 03:07:29 +03:00
ParantezTech acbf28c784 [Share] added more share implementation 2026-09-22 03:06:54 +03:00
ParantezTech 0409f3aab1 [Usbd] more stubs 2026-09-22 03:06:22 +03:00
ParantezTech 3e760035b1 [Kernel] implement sceKernelAddHRTimerEvent & sceKernelDeleteHRTimerEvent for scheduler 2026-09-22 02:27:08 +03:00
ParantezTech acb0d4afb5 [usbd] implement sceUsbdHandleEventsTimeout, just return signal not connect and timeout 2026-09-22 02:26:15 +03:00
ParantezTech f4e6c7355c [Kernel] added sceKernelDebugWriteCppExceptionInfo implements for cpp exception info 2026-09-22 01:54:27 +03:00
Mathias ea943c1281
fix(import-guard): recognize polling progress boundaries (#895) 2026-09-21 19:56:05 +03:00
Berk cff4a167a6
Alpha rebuild part2 (#893)
* [Libc] routed strcasecmp through HLE

* [Ampr] implemented command buffer streaming contract

* [Agc] completed command buffer operations

* [Kernel] added wide string formatting coverage

* [VideoOut] added output mode events and profiling fixes

* [Shader] expanded Gen5 resource and interpolation support

* [Gpu] fixed image, render, and dispatch handling

* [Memory] added guest address space pre-reservation

* [AMPR] deferred read file execution to command submission

* [SpirvTranslator] Add DsMinF32 and DsMaxF32 instructions

* [spirvtranslator] Added V_CMPX_NE_U64 instruction

* [spirvtranslator] added DsReadI8 instruction

* [test] fixed
2026-09-21 00:29:16 +03:00
ParantezTech 9db40fcec8 [readme] new screenshots 2026-09-20 05:00:39 +03:00
voidborn_astra 37694dfbb7
Alpha Rebuild Progress (#887)
* refactor(videoout): isolate host buffer code

Move pooled host-visible Vulkan buffer management into a dedicated presenter partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(videoout): isolate draw state code

Move guest draw-state conversion into a dedicated presenter partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(videoout): isolate texture format support code

Move Vulkan image-format capability and render-target mapping into the texture-format presenter partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(videoout): isolate presentation image code

Move presentation-target selection and offscreen presentation-image creation into a dedicated presenter partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(videoout): isolate HDR presentation code

Move HDR presentation resources, pipelines, and command recording into a dedicated presenter partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(videoout): isolate draw execution code

Move offscreen draw, clear, guest-image write, and render-pass execution into a dedicated presenter partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(videoout): isolate guest submission code

Move guest GPU batching, submission, retirement, and visibility waits into a dedicated presenter partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(videoout): isolate render loop code

Move presenter work waiting, queue draining, frame acquisition, and work dispatch into a dedicated partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(videoout): isolate draw recording code

Move translated draw recording, image transitions, draw tracing, and resource retirement into a dedicated presenter partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(videoout): isolate guest work queue code

Move guest GPU work submission, scheduling, backpressure, and completion into a dedicated partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(videoout): place storage image contracts code with its owner

Move SPIR-V storage image contract parsing and validation into the compute storage-image partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(videoout): place ordered guest flips code with its owner

Move ordered guest flip capture and completion into the presentation-frame partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(videoout): place frame lifetime code with its owner

Move presentation frame waits and flip-version retirement into the presentation-frame partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(videoout): place texture cache resolution code with its owner

Move cached texture resolution and CPU refresh into the texture-cache partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(videoout): place barycentric pipeline code with its owner

Move the fullscreen barycentric shaders and pipeline creation into the pipeline partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(videoout): place swapchain draw resources code with its owner

Move presentation render-pass, image-view, and framebuffer setup into the swapchain partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(videoout): place feedback snapshot creation code with its owner

Move color feedback snapshot creation beside its pool lifecycle and telemetry.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(videoout): place texture format conversion code with its owner

Move real-format conversion and its transfer scratch images into the texture-format partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(videoout): place guest image diagnostics code with its owner

Move guest image tracing and readback diagnostics beside the guest image registry.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(videoout): place guest submission execution code with its owner

Move ordered actions, cache operations, pooled-data returns, and guest-work descriptions beside guest submission lifetime.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(agc): isolate initialization exports code

Move AGC initialization and versioned register-default materialization into a focused partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(agc): isolate driver resource exports code

Move AGC driver resource-registration exports and their private machinery into a focused partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(agc): isolate event exports code

Move AGC event signaling exports and their private machinery into a focused partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(agc): isolate shader state exports code

Move AGC shader-pipeline state exports and their private machinery into a focused partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(agc): isolate packet patching exports code

Move AGC command-packet patching exports and their private machinery into a focused partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(agc): isolate control flow exports code

Move AGC command-buffer control-flow exports into a focused partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(agc): isolate register packet exports code

Move AGC register-programming packet exports and their private machinery into a focused partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(agc): isolate draw packet exports code

Move AGC draw-command packet exports and their private machinery into a focused partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(agc): isolate DMA packet exports code

Move AGC DMA packet exports into a focused partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(agc): isolate compute fast paths code

Move CPU semantic replacements for recognized compute kernels into a focused partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(agc): isolate compute dispatch code

Move translated compute dispatch handling into a focused partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(agc): isolate draw translation code

Move translated guest draw construction into a focused partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(agc): isolate draw state code

Move AGC render-state decoding into a focused partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(agc): isolate submitted geometry code

Move submitted index and vertex retention into a focused partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(agc): isolate texture transport code

Move guest texture transport into a focused partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(agc): isolate PM4 decoding code

Move submitted PM4 stream decoding into a focused partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(agc): isolate GPU wait lifecycle code

Move submitted GPU wait suspension and resumption into a focused partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(agc): isolate orphan preamble recovery code

Move orphan-preamble recovery into a focused partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(agc): isolate submission runtime code

Move submitted command execution into a focused partial.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(agc): isolate draw diagnostics code

Move translated-draw diagnostics into a focused partial.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(agc): isolate command packet code

Move general command-buffer packet builders into a focused partial.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(agc): place multi-DCB export in submissions

Place the multi-DCB submission handler beside the queue parser and submission lifecycle.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(agc): place driver configuration exports with its owner

Place tessellation driver configuration handlers beside the other driver resources.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(agc): place software present path in events

Place software presentation beside the AGC flip and event handlers.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(agc): place color-control decode in draw state

Place the CB color-mode and hardware-resolve helpers with the other draw-state code.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(agc): place translated draw buffers in draw translation

Place the translated draw buffer builders with the draw translation pipeline.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(agc): place wait packet helpers in command packets

Place WAIT_REG_MEM encoders and command-packet trace counters with their only consumers.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(agc): place draw translation helpers with its owner

Place pixel-input translation helpers and their trace state with the draw translation pipeline.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(agc): place frame packet trace setting in pm4

Place the frame-packet trace setting with its PM4 consumers.
The new location makes ownership clear.
Execution behavior does not change.

* refactor(agc): place guest memory transfer helpers in submissions

Place guest memory copy and fill helpers with their submitted-command consumers.
This change only improves code organization.
Keep runtime behavior unchanged.

* refactor(agc): place packet identity helper in packet patching

Place packet identity decoding with its packet-patching consumers.
This move changes code ownership only.
Runtime behavior stays the same.

* refactor(agc): place duplicate target trace state in draw state

Place the duplicate-target trace counter with its draw-state consumer.
The new location makes ownership clear.
Execution behavior does not change.

* style(renderer): remove extra spacing from split files

Remove excess blank lines left by the AGC and Vulkan partial extractions.
This cleanup changes formatting only.
Runtime behavior stays the same.

* refactor(agc): keep rebased state in the split renderer

Keep color-metadata state with draw translation after the file split. Restore the complete PM4 helper set. Retain frame publication and metadata tracking that arrived during the rebase.

* fix(gpu): keep acquire memory cache ranges

Keep acquire memory operations separate when their ranges or cache semantics differ.
Merge only matching operations that overlap or touch.
Submit the exact operations as one backend work item to limit queue growth without widening invalidation ranges.
Add focused tests for the changed behavior.

* fix(vulkan): scope guest cache barriers to tracked resources

Use exact buffer and depth-image ranges for ranged guest cache operations. Use a global barrier when the range or image layout is unknown, when no resource matches, or when the operation covers all memory. Record cached texture spans and test each fallback.

* fix(cpu): handle guest image write faults in native code

Keep tracked-page write faults inside the Windows VEH path.
Restore page access, queue dirty pages, and defer managed tracker work until safe execution.
This prevents CLR fail-fast crashes and avoids full tracked-page scans.
Add focused tests for the changed behavior.

* fix(agc): track constant fills as managed writes

Call the managed-writer tracker after the constant-fill fast path writes guest memory. Do not protect a range that the managed memory layer already reports. This prevents an immediate write fault on the same pages.

* fix(cpu): make exception memory reads safe

Probe diagnostic addresses before reading them.
Use ReadProcessMemory for unstable data and keep direct reads only for executable bytes that are active during dispatch.
This prevents the crash reporter from causing a second access violation while it reports a guest fault.
Add focused tests for the changed behavior.

* fix(loader): protect the guest red zone on Windows

Patch faultable memory instructions in System V red-zone functions to run through nearby trampolines.
The trampoline moves RSP while Windows handles a write fault, so the handler cannot overwrite live guest values below the stack pointer.
Add focused tests for the changed behavior.

* fix(audio): correct AJM job argument and size handling

Read the gapless result pointer from the fifth ABI argument and keep reset as the fourth argument.
Use the split-job base size before adding buffer descriptors.
This keeps batch cursors and result writes aligned with AJM.
Add focused tests for the changed behavior.

* fix(vulkan): use all attachments for framebuffer identity

Clamp the framebuffer extent to every color and depth attachment.
Include the color format and view in the depth-framebuffer cache key.
This prevents invalid reuse when one guest image changes attachment views or formats.
Add focused tests for the changed behavior.

* fix(videoout): align captures with complete guest frames

Start a capture at a guest-frame boundary and keep it active across presenter ticks.
End the capture after the next guest flip completes.
Discard interrupted or timed-out captures so later requests can continue.

* fix(shader): keep forward branches after program end markers

Allow a forward scalar branch to target reachable code after S_ENDPGM.
Preserve instruction boundaries and reaching definitions across the program-end marker.
Add a regression test for this control-flow form.

* fix(shader): apply fragment export validity

Apply the EXP.VM flag when a fragment export is conditionally valid.
Suppress invalid color and depth exports in both shader backends.
Add translation and output-mask tests.

* fix(vulkan): declare graphics subgroup operations

Enable subgroup capabilities only for graphics modules that use subgroup instructions.
Declare the required SPIR-V capabilities and execution modes.
Add interface validation tests for vertex and fragment stages.

* fix(vulkan): use flat fragment subgroup inputs

Decorate integer fragment subgroup built-ins with Flat so generated SPIR-V satisfies Vulkan interface validation.
Add focused tests for the changed behavior.

* fix(storage): return usable storage capacity

Add the temporary-data capacity export and saved-data search alias, then report total and free blocks using the platform ABI.
Add focused tests for the changed behavior.

* fix(videoout): send capture requests to guest-frame control

Send the capture hotkey request to the guest-frame capture state machine.
Do not start a host-present capture directly from the window event.
This keeps one request aligned with one complete guest frame.

* fix(videoout): apply metadata-backed image clear patterns

Track metadata fills and constant-buffer fills with their full 16-byte pattern and physical image size.
Decode clear values by target format, including repeated half-float texels.
Apply pending clears when the guest image becomes available.
Add tests for tiled allocation sizes, metadata state, and clear patterns.

* chore(videoout): trace selected image synchronization paths

Add address-filtered traces for compute destinations, guest-image overlaps, and sampled-image binds.
Keep the traces off unless the related environment option is set.
Use the output to compare image synchronization without broad logging.

* fix(vulkan): require a compatible wave size for graphics subgroups

Enable graphics subgroup lowering only when the device reports a compatible native wave size.
Pass the selected policy into shader translation and shader cache keys.
Add policy and interface tests.

* fix(agc): preserve composite depth target extents

Decode attachment width and height from composite depth binding packets and carry them separately from independent context-register state.

Detach irreconcilably mismatched depth attachments instead of shrinking color passes, with focused coverage for packet parsing and fallback behavior.

* fix(cpu): preserve full-width guest callback results

Return the complete 64-bit value from direct and worker-backed guest calls instead of truncating it to 32 bits.

Add fourth-argument support for guest callbacks and cover both ABI behaviors in the native return smoke test.

* fix(shader): key translated programs by checksum

Include programmed shader checksums in decode and compiled-pipeline cache identities so replaced code at a reused guest address cannot resolve to stale translations.

Propagate checksums through compute, graphics, and submitted-geometry translation and cover address reuse with a regression test.

* fix(agc): skip rectangle draws without parameter exports

Track enabled shader parameter exports and reject only non-indexed rectangle draws that have no vertex inputs or parameter exports but still request interpolated pixel inputs.

Treat the rejection as intentional and cover the guarded and preserved draw shapes with focused tests.

* diagnostics(agc): trace video draw chains

Track decoded video planes through recent render-target dependencies and report texture payload summaries, generations, blend state, and viewport data for targeted analysis.

Keep the trace flag, rectangle-skip visibility, and flip-bounded diagnostic state together in this commit.

* fix(agc): snapshot rotating video buffers per draw

Recognize registered decoded-video buffer addresses independently of tracing and bypass address-only upload and texture-content cache shortcuts for those ranges.

This preserves the texels associated with queued draws when the decoder later reuses a rotating guest buffer.

* fix(video): queue decoded frames and honor seek state

Start video decoding with playback, buffer decoded frames on a bounded worker queue, and distinguish pending data from end of stream instead of blocking guest polling.

Preserve pause state across jumps, seek audio and video decoders to the requested timestamp, offset reported times, and deliver the completion warning through the event callback ABI.

* fix(video): load replacement-backed sources through callbacks

Read replacement-backed sources through the guest open, size, offset-read, and close callbacks, materializing a temporary host file for decoding.

Fall back to the ordinary resolved path when the optional replacement interface declines a source, and clean up owned temporary files when sources or players are released.

* fix(video): report decoded stream metadata

Preserve display aspect ratio, color range, primaries, transfer characteristics, frame pitch, and crop information when reporting decoded video streams and frames.

Use the stream's fallback frame rate when its average rate is unavailable, and cover the extended ABI field layout with focused tests.

* fix(video): report extended audio stream format

Populate channel count and sample rate in extended stream details so clients configure decoded PCM output correctly. Add ABI coverage for the audio union layout and duration.

* fix(shader): preserve full LDS single-address offsets

Combine both encoded offset bytes for single-address data-share operations while retaining independent scaled offsets for paired forms. Apply the correction to both shader backends and add decoder and generated-module regression coverage.

* fix(shader): preserve depth comparison filter semantics

Decode the sampler comparison function instead of assuming one operation, and evaluate linear LOD-zero depth filtering per texel before interpolation. Add focused generated-module coverage for comparison functions and the four-tap filtering path.

* fix(agc): create native interpolant mappings

Implement dbOlWdppb4o as sceAgcCreateInterpolantMapping2 and emit packed SPI_PS_INPUT_CNTL register pairs from matched shader semantics. Fill unused entries with identity mappings and cover identity, matched, default, flat, custom, and f16 modes.

* fix(agc): construct primitive state registers

Build context and user-config primitive state independently, merge optional hull-stage state, and select the correct output primitive source. Cover hull handling and derived versus shader-owned output primitives.

* fix(agc): emit native indirect register packets

Emit and parse native indirect context, shader, and user-config register packets. Patch native address and count fields without clobbering control bits, retain legacy packet compatibility, and apply flagged depth-size entries to the correct state.

* fix(agc,video): support guest depth-stencil state

Decode guest stencil attachment, clear, mask, reference, compare, and operation state. Create compatible Vulkan depth-stencil resources and preserve their aspects through render passes, pipeline caching, feedback copies, and barriers.

* chore(diagnostics): add focused guest graphics tracing

Add canonical draw-state summaries with optional descriptor detail filters. Improve guest instruction sampling with thread selection and per-window accounting, and trace register-default handoff provenance.

* fix(video): publish cache identity for depth aliases

Reuse the exact sampled-texture content identity when a depth-backed image resolves successfully. Publish its sampler and write generation so later submissions avoid redundant guest-memory snapshots that the presenter would discard.

* chore(diagnostics): profile guest thread execution

* chore(diagnostics): profile graphics command processing

* chore(diagnostics): profile texture preparation

* chore(diagnostics): profile shader evaluation

* chore(diagnostics): profile address synchronization

* chore(diagnostics): unify performance profiling switches

* fix(video): disable face culling for rectangle primitives

Keep expanded rectangle draws visible regardless of triangle winding. Preserve culling and all other raster settings for other primitive types.

Add regression coverage for each culling combination and unchanged non-rectangle raster state.

* fix(agc): keep depth clears separate from color targets

Remove the color-clear request triggered by the depth-clear control bit. Keep the existing depth, stencil, and color-metadata clear paths unchanged.

* fix(shader): honor pixel input counts and mapped locations

Read only the programmed pixel input controls and use identity mappings beyond that range. Share duplicate-location resolution between both shader backends.

Test input-count bounds, zero-input state, identity fallback, duplicate mappings, and location limits.

* chore(diagnostics): trace interpolant packet and draw mappings

Add opt-in packet fingerprints, register pairs, and consumed draw mappings through SHARPEMU_TRACE_AGC_INTERPOLANT_FLOW.

Limit packet output and unique draw records to 1024 entries. Stop packet scans after the trace limit and keep diagnostic state bounded.

* feat(memory): add GPU memory tracking foundations

Track mapped ranges and page access state.
Keep unresolved faults on the existing error path.
Report memory counters once when shutdown starts.

* feat(memory): map direct memory through shared backing

Create portable host views over a persistent guest backing object.

Route direct and flexible mappings, protection, queries, unmaps, and aliases through one owner.

Preserve private-memory behavior and cover lifecycle, overlap, and failure paths.

* feat(gpu): schedule submissions with timeline completion

Route graphics and compute work through one queue and scheduler. Replace per-submit fences with timeline ticks and preserve batch accounting on every submission path.

Add synchronous worker relay, ordered completion callbacks, and shutdown tests. Keep optional video frame polling nonblocking to prevent a relay deadlock.

* fix(gui): drain pending logs before closing the file

Save all queued output at shutdown without the display batch limit.

Keep console output when file logging is disabled. Add tests for complete and batched drains.

* fix(cpu): bypass managed handlers for debug output

* fix(vulkan): correct image barriers and release texture resources

Include attachment reads and select the source stage for presentation uploads.

Release cached textures at shutdown and retain ownership of sampled image views.

* fix(kernel): service guest exceptions during mutex waits

Deliver pending exceptions outside the mutex lock and resume the wait.

Test delivery without granting ownership and isolate the shared scheduler state.

* feat(gpu): replace buffer snapshots with a tracked buffer cache

Keep guest buffers in device memory and upload changed ranges on use.

Recover CPU access through GPU downloads and preserve guest page permissions.

Manage buffer lifetime through submission completion and remove the old writeback path.

Add buffer, tracking, fault recovery, and descriptor synchronization tests.

* fix(vulkan): use cached buffers for GPU-written geometry

Read current vertex and index data from the buffer cache instead of stale CPU snapshots.

Preserve buffer offsets and complete allocation merges before resolving draw handles.

Add tests for index routing, vertex bindings, and overlapping geometry allocations.

* feat(diagnostics): trace GPU submissions and guest memory reads

Keep a bounded submission history and report memory mappings when buffer reads fail.

Trace scalar loads for the selected shader and reset operation details for each recording.

Add tests for submission history and memory-range reports.

* feat(gpu): replace image snapshots with a tracked image cache

* fix(shaders): bound scalar load memory ranges

* fix(shaders): preserve image bindings across branch paths

* fix(videoout): use the active presentation target

* feat(diagnostics): report image cache and presenter costs

* perf(agc): skip unused context updates during geometry capture

* perf(gpu): skip image uploads before full color clears

* perf(gpu): wake the presenter when submissions complete

* perf(agc): reuse retained vertex data before capture

* feat(diagnostics): report image upload preparation costs

* feat(diagnostics): report vertex snapshot and prepass costs

* feat(gpu): replace command processing and label handling

* test(gpu): use asynchronous waits in the image lock test

* fix(memory): finish GPU work before taking mapping locks

* perf(memory): avoid temporary segments for single-mapping reads

* perf(shader): cache scalar analysis query results

* perf(shader): cache scalar load bounds and batch component reads

* feat(diagnostics): report draw and scalar evaluation costs

* fix(videoout): widen the performance overlay and align it right

* test(videoout): isolate flip state and limit port cleanup

* refactor: remove unused fields and unreachable branches

* fix(kernel): use a private lock for event waiter completion

* feat(gpu): replace draw and compute translation

* fix(memory): select the first available guest address

* fix(gpu): invalidate tracked memory across partial ranges

* perf(gpu): stream repeatedly written buffer pages

* fix(shader): preserve image array coordinates

* fix(shader): order shared memory access across wave lanes

* perf(gpu): cache decoded shader instruction metadata

* fix(gpu): preserve command failures when error logging fails

* feat(profiling): add detailed render and submission timings

* feat(profiling): add optional presentation frame history

* fix(gpu): use storage images for stencil writes

* fix(gpu): support compressed image sampling on macOS

* fix(gpu): check graphics subgroup stage support

* fix(cpu): preserve pending waits during signal delivery

* fix(memory): avoid reserved graphics addresses on macOS

* fix(cpu): preserve vector registers during macOS signal recovery

* fix(loader): protect guest memory accesses on macOS

* fix(avplayer): preserve the playback clock during video catch-up

* fix(kernel): write the complete local time conversion result

* feat(http): parse URI components into guest memory

* feat(profiling): separate GPU wait and submission cleanup time

* feat(profiling): add GPU command completion intervals

* fix(profiling): use the configured shader dump directory

* feat(diagnostics): add Windows crash dump capture

* fix(gui): save console placement and hide it on Options

* fix(renderdoc): use F12 for capture and show the shortcut

* feat(gui): add crash dump controls and enable app0 writes by default

* feat(gui): add overlay modes, corner controls, and GPU usage

* fix(cpu): remove unsafe SSE4a instruction rewrites

* fix(cpu): preserve call width and registers in TLS load patches

* fix(loader): copy TLS initialization bytes after relocation

* fix(memory): extend retained reservations through free ranges

* fix(memory): retry faults after backing view restoration

* perf(memory): use binary search for mapped ranges

* perf(memory): track direct allocations and free ranges

* perf(gpu): reuse completed drains when no work is pending

* fix(gpu): identify image upload failures

* feat(diagnostics): profile guest memory operations

* feat(gui): add performance profiling options

* fix(cpu): allow concurrent native fault callbacks

* fix(cpu): respect instruction boundaries in TLS patches

* fix(cli): preserve the assembly path during relaunch

* fix(cpu): recognize time reads in import loop checks

* fix(diagnostics): capture native thread state safely

* fix(agc): validate shader headers and direct register exports

* fix(gpu): apply bounded embedded vertex offsets

* test(shader): verify unsigned difference instructions

* fix(shader): separate global memory source and destination registers

* fix(debugger): restrict frontend requests and validate tokens

* feat(gui): add the community link

* fix(shader): preserve buffer descriptors across branches

Keep incoming register values for alternate resource paths. Resolve each vertex fetch once and preserve shared bindings. Add branch regression tests and a gated invalid-address trace.

* fix(diagnostics): handle Windows debugger breaks during crash capture

Identify debugger breaks from the system module and thread entry. Resume only verified first-chance breaks and preserve application exception handling. Add regression tests for repeated breaks and crash dumps.

* fix(memory): recover late writes after page protection is removed

Track write-access restoration for each watched page. Retry a late write only when the mapping and host permissions still allow it. Reject repeated faults and stale mapping evidence. Add page-watch and native fault regression tests.

* feat(gpu): replace shader and pipeline caches

Resolve shader resources with a cached value graph. Share binding layouts between Vulkan and Metal. Keep descriptors until each GPU submission completes. Add shader access to device addresses and global data share memory. Correct typed buffer formats. Remove the replaced code paths.

* fix(shader): add signed 24-bit multiplication

Decode signed 24-bit multiplication in both instruction formats. Sign-extend the low 24 bits of each input. Store the low 32 bits of the product. Preserve the destination when its lane is inactive. Add Vulkan and Metal translation support and regression tests.

* fix(shader): add signed 16-bit packing

Decode signed 16-bit packing in the extended instruction format. Clamp each signed input to the 16-bit range and pack both results into one register. Add Vulkan and Metal translation support. Preserve inactive destinations and add regression tests.

* fix(shader): add 64-bit shared-memory reads

Decode single and paired 64-bit reads. Load local or global shared memory with the required offsets. Preserve the source address when destination registers overlap it. Keep inactive destination registers unchanged. Add Vulkan and Metal translation support and regression tests.

* fix(shader): add paired 64-bit shared-memory writes

Decode both paired-write forms. Write independent source-register pairs to local or global shared memory. Apply eight-byte or 512-byte offset scales. Use only the first source pair when offsets are equal. Preserve memory for inactive lanes and add regression tests.

* fix(shader): add thread-indexed local-memory writes

Decode the thread-indexed write instruction. Form each address from the low 16 bits of M0, the byte offset, and four times the lane index. Preserve memory for inactive lanes. Enable the required Vulkan lane input and add regression tests for both shader backends.

* fix(shader): handle traps without an installed handler

Decode the shader trap instruction and retain its eight-bit trap ID. Treat the instruction as a no-op under the current no-handler model on Vulkan and Metal. Preserve shader state and continue execution. Keep unknown-opcode checks and add regression tests.

* perf(gpu): avoid allocations in small image queries

Store up to 16 image identifiers inline and use overflow storage for larger queries. Replace the capturing owner callback with an indexed loop. Preserve query order, duplicate filtering, and snapshots during image removal. Add allocation and query regression tests.

* perf(avplayer): reuse private video frame buffers

Recycle a delivered frame only after a new frame is available. Keep reusable storage separate for each playback and drain queued frames before reporting completion. Reuse the conversion buffer after its pending bytes are consumed. Add frame-lifetime and storage-reuse tests.

* perf(agc): copy register packet payloads in bulk

Copy separate register ranges through the guest memory interface. Keep forward word copies for overlapping ranges or when bulk copying fails. Leave null-source payloads unchanged for the caller to fill.

* perf(memory): avoid segment lists for single-mapping transfers

Write and copy through the backing alias when each range fits one mapping. Preserve range checks, locking, and overlap handling. Keep the existing path for transfers across mappings.

* perf(memory): allow independent protection updates

Use address-range locks for transient protection updates. Keep mapping changes and disposal exclusive. Preserve lock order, release locks on failure, and reject protection requests after disposal.

* perf(cpu): wake ready threads with queue notifications

Replace ready-thread polling with notifications under the scheduler lock. Notify the dispatcher when work is queued, an executor is released, or shutdown starts. Finish slice accounting before releasing executor ownership.

* fix(videoout): validate output settings and report refresh codes

Use refresh-rate codes in output status. Check configuration arguments and reject unavailable output modes. Preserve validation errors and output buffer boundaries.

* fix(videoout): share vblank counts across waits and events

Use one display clock per port for vblank status, waits, and events. Report counters for the latest vblank boundary. Wake the event worker when subscriptions change or shutdown starts.

* fix(videoout): apply per-port flip mode timing

Use each port refresh rate to pace flips. Apply window margins and keep ASAP flips unrestricted. Let multiple-flip requests share the next vblank boundary after readiness without applying the flip rate. Cancel CPU waits when the port closes.

* test(agc): cover register copies across backing views

Verify register payload bytes, the returned packet address, and the command-buffer cursor when the source and destination span separate backing views.

* feat(diagnostics): report slow window event polls

Record poll totals and the four longest calls per report interval. Require frame tracing and an active render scope. Preserve event handling and omit event types when no event is returned.

* feat(diagnostics): profile register packet writes

Measure import dispatch, packet setup, and payload copies. Count copy paths and emitter results. Require performance profiling and frame tracing, and report cumulative inclusive times.

* feat(diagnostics): profile shader resource resolution

Measure resource resolution phases, managed allocations, and source activity. Require performance profiling and frame tracing. Report cumulative inclusive times with invariant decimal formatting.

* feat(diagnostics): save shader planning inputs

Save decoded instructions and resource graphs before descriptor validation. Record planning failures under the existing shader dump switch and address filter. Report file errors without replacing the shader rejection.

* feat(diagnostics): save shader variant inputs and modules

Save cache comparisons before translation and pair each variant with its compiled module. Capture indirect image failures under the existing shader dump controls. Create failure callbacks only when the dump gate matches.

* perf(memory): avoid copies in dirty-page range checks

Test intersecting page-mask words directly instead of creating a masked copy. Preserve half-open range bounds and existing region validation.

* feat(diagnostics): profile buffer uploads

Report buffer upload ranges, byte counts, and slow synchronization calls under frame tracing. Associate device-address uploads with shader program hashes. Read hot-page byte counts under the region lock. Keep counters bounded and report decimals in a fixed format.

* feat(diagnostics): trace guest thread handoffs

Record bounded thread transitions, mutex handoffs, and semaphore signals under frame tracing. Preserve thread identities and wake results. Reset traces at session start and write them at shutdown. Keep trace output failures from interrupting native cleanup.

* feat(diagnostics): trace command submission flow

Record bounded submission, queue, and presenter wait events under frame tracing. Correlate records by queue and submission identifiers. Reset the trace at session start and close it at shutdown. Keep trace output failures from interrupting cleanup.

* feat(diagnostics): profile memory faults and protection

Record fault, protection, and lock timings under frame tracing. Separate tracker and image-cache activity. Prepare thread-local state before guest execution. Report cumulative measurements without changing memory protection or lock ownership.

* feat(gui): expose strict shader mode and enable it by default

Add the strict compute switch to global and per-game debug options. Stop on shader rejections unless skip mode is explicitly selected. Preserve disabled overrides and apply the saved choice at launch. Document the default and skip behavior.

* fix(shader): implement unsigned vector xor-add

Decode V_XAD_U32 and apply XOR followed by wrapping addition in Vulkan, Metal, and resource evaluation. Add tests for literal sources, overlapping destinations, and inactive execution lanes.

* fix(gpu): replace incompatible image backing types

Replace single-row image backings when a view requires a different dimensional type. Preserve cached subresources, current contents, and deferred release. Copy between 1D and 2D images through a GPU buffer. Add cache and binding regression tests.

* fix(shader): add thread-indexed local-memory reads

Decode the thread-indexed read instruction. Form each address from the low 16 bits of M0, the byte offset, and four times the lane index. Preserve inactive destination registers. Add Vulkan and Metal translation support and regression tests.

* test(stdio): synchronize concurrent file operations

Run blocking file operations on dedicated threads. Check that close and seek block before releasing the read. Join workers before cleanup and identify failed synchronization checkpoints.

* fix(cpu): read Linux diagnostic memory safely

Use process_vm_readv to read host memory outside the allocation tracker. Reject incomplete reads and test access across a protected page.

* fix(cpu): defer native callback allocation

Create the import callback thunk when it is first needed. Reject native execution outside an x64 process and declare that requirement in backend tests.

* fix(memory): use address-space protection granularity

Keep the native page-size requirement and let test address spaces declare their granularity. Use one host-memory backend for tracker allocation and queries. Keep the test fatal handler active through cleanup.

* test(cpu): isolate POSIX signal recovery state

Prevent signal recovery tests from overlapping other test collections. Restore the previous backend after each test.

* test(metal): resolve fixture buffer descriptors

Materialize buffer descriptors before compiling compute fixtures. Check the resolved formats and update the matching shader snapshots without changing expected device results.

* test(memory): require supported native page protection

Declare the 4 KiB host page requirement for image tracking and backing-view fault tests. Skip these tests on unsupported hosts without changing production checks.

* fix(memory): isolate write-tracker warm-up pages

Use a dedicated host mapping for protection warm-up. Release the mapping after removing its tracker entry. Check native page permissions in the tracker tests.

* fix(memory): track POSIX backing-view query state

Share view mapping and protection records across host memory queries. Preserve committed state for inaccessible pages and round partial-page changes to host pages. Update protection records without allocating during faults.

* test(memory): use valid portable guest ranges

Probe free addresses within the guest range instead of relying on fixed or host-selected addresses. Respect guest and host alignment. Allocate output storage independently of fixed guest image addresses.

* fix(memory): preserve execute permissions during writes

Request writable protection without execute permission for non-executable private memory. Add a regression check that rejects unnecessary executable protection. Restore the original protection after the write.

* fix(cpu): resolve Linux TLS through libpthread

Load Linux thread-local storage functions from libpthread.so.0. Resolve the native TLS lookup from the same library to support glibc versions before the libc merge. Keep macOS imports unchanged.

* fix(kernel): connect sockets without thread-pool waits

Use synchronous TCP connection handling for the blocking guest call. Remove the fixed task wait that could reject connections under thread-pool load. Add tests for occupied workers, refused connections, and descriptor lifetime.

* fix(gpu): prepare device memory and guard inactive loads

Keep active buffers resident and upload read-only device-address ranges before use. Preserve pending faults when the output buffer is full. Prevent inactive lanes from loading global memory.

* feat(gpu): trace device-address memory faults

Select the first fault page when memory tracing is set to auto. Record the shader, instruction, and address for a fault. Trace buffer registration, preparation, and collection for the selected page.

* feat(gpu): trace buffer readback callers

Record buffer readback callers, ranges, byte counts, and elapsed time. Bound the collected ranges and report calls beyond the limit. Enable these details only when both performance profile switches are set. Add tests for caller separation, report gates, and counter limits.

* perf(kernel): skip occupied ranges during address search

Check kernel reservations before asking the backing store to reserve an address. Keep aligned gaps and reusable reservation hints. Add tests for occupied ranges, alignment, and address overflow.

* fix(gpu): correct shader resource selection and data sharing

Support data-share swizzles on Vulkan and Metal. Bound indirect resource selectors from wave-mask inputs. Resolve sampled image variants with their resource types and include selector state in program identity. Add compiler and device regression tests.

* refactor(gpu): centralize guest buffer ownership and lifetime

Track buffer identity, page ownership, recency, and retirement in one registry. Separate upload preparation, download planning, merge bounds, and collection policy. Preserve GPU synchronization and add registry and device regression tests.

* fix(shader): support unsigned 16-bit packing

Clamp each unsigned input to 16 bits. Pack the first input into the low half and the second input into the high half on Vulkan, Metal, and the resource evaluator.

* fix(memory): reject overlapping fixed allocations

Reject committed pages when an exact allocation shares a host reservation. Keep adjacent allocations valid and preserve existing memory regions.

* fix(kernel): implement AIO waits and correct array arguments

Return recorded completion states for single-request waits. Use the correct argument order for array waits and polls. Validate request IDs and guest memory accesses.

* fix(shader): implement scalar signed absolute value

Decode S_ABS_I32 and emit it on Vulkan and Metal. Preserve the minimum signed value and update the scalar condition flag. Match these results in resource evaluation.

* fix(shader): implement three-input vector XOR

Decode V_XOR3_B32 and combine all three inputs on Vulkan and Metal. Apply the same operation during resource evaluation.

* fix(shader): implement scalar bit clear

Decode S_BITSET0_B32 and clear the selected destination bit on Vulkan and Metal. Preserve the condition flag and retain the destination input for scalar bit updates.

* fix(gpu): keep depth export format from enabling pixel shaders

Use shader control flags to detect depth and coverage effects. Do not activate a pixel shader for a depth-only draw because an export format remains set.

* feat(runtime): trace failed imported data writes

Report whether a failed relocation target is readable and list its tracked memory regions. Keep the details under the existing data-rebind logging switch.

* feat(kernel): trace guest-tracked mutex self-locks

Include adaptive mutex self-lock failures in the existing fast-path trace. Keep the lock behavior and return codes unchanged.

* feat(savedata): trace failed mount requests

Report the directory and mount mode when a save mount is missing or busy. Use the existing save-data logging switch.

* feat(gpu): trace pixel shader draw inputs

Include the pixel shader address, hash, and user data in the existing AGC trace.

* feat(gpu): trace pixel register writes

Log pixel shader register writes when AGC tracing is enabled. Include the packet or table address and the shader address.

* feat(gpu): report sources of invalid shader resources

Include shader and descriptor details when a buffer starts in unmapped memory or a sampler has an invalid anisotropy ratio. Keep the existing validation checks.

* fix(kernel): correct AMPR event filter identifiers

Use the required filter identifiers for AMPR and AMPR system events. Add a regression test for both values.

* fix(gui): add missing Azerbaijani option text

Add labels and descriptions for crash dumps, performance profiling, strict shader checks, and the performance display.
2026-09-20 04:09:27 +03:00
Berk 5c0adf81ca
[CI] Fixes to warnings in workflows and scripts (#892)
* [CI] Fixes to warnings in workflows and scripts

* [CI] rename build job to win-x64

* [CI] sorry for version

* [AGC] Disable warning SHEM004 for AgcExports.cs
2026-09-20 02:44:53 +03:00
ParantezTech ca64b4a7e8 [languages] fixed language keys for Azerbaycanca and correct order for keys 2026-09-20 01:26:55 +03:00
Jamal Kamaladdinoglu 9d99fefd13
[GUI] Azerbaijani language (#890) 2026-09-20 00:11:51 +03:00
Berk c69e88e0a8
Gui improvements part3 (#891)
* [docs] Add documentation for undocumented GUI environment variables

* [GUI] Added Custom Environment Variables dialog and settings

* reuse
2026-09-19 23:26:30 +03:00
Berk 179fcbbfe5
[Kernel] Fix printf %S to be treated as %ls, including for the wide-output family (#889) 2026-09-19 15:00:24 +03:00
Berk b6f71b312b
[appcontent] Saving temp to user directory instead of appdata (#885) 2026-09-17 18:31:36 +03:00
ParantezTech dfb7efa5df Merge branch 'main' of https://github.com/sharpemu/sharpemu 2026-09-11 16:47:44 +03:00
ParantezTech 3c91c768f3 Added official Discord server readme and GUI. 2026-09-11 16:43:38 +03:00
Mathias f84246cf90
Fix/agc rendering and module loading (#881)
* test(cpu): verify VEH thunk preserves nonvolatile registers

* fix(memory): commit complete native guest mappings

* fix(cpu): treat time polling as import-loop progress

* fix(cli): preserve DLL path in mitigation relaunch

* refactor(cpu): remove obsolete inflate recovery hack

* fix(agc): accept shaders without embedded program registers

* fix(cpu): treat user event polling as import-loop progress

* fix(shader): lower unsigned sum of absolute differences

* fix(agc): emit direct shader register packets

* fix(agc): report native wait packet sizes

* fix(agc): propagate embedded vertex fetch offsets

* fix(vulkan): keep vertex attributes relative to upload

* fix(agc): avoid double applying embedded vertex offsets

* docs(agc): clarify embedded vertex offset handling

* fix(gpu): separate vertex IDs from stream offsets

* fix(shader): decode global load destinations

* fix(runtime): index application-root PRX modules
2026-09-11 14:17:37 +03:00
Mathias 0a461f8d69
fix: improve Direct Execution guest runtime and AGC compatibility (#880)
* test(cpu): verify VEH thunk preserves nonvolatile registers

* fix(memory): commit complete native guest mappings

* fix(cpu): treat time polling as import-loop progress

* fix(cli): preserve DLL path in mitigation relaunch

* refactor(cpu): remove obsolete inflate recovery hack

* fix(agc): accept shaders without embedded program registers
2026-09-11 13:37:31 +03:00
Berk ca90d17541
[aerolib-catalog] Add support for multiple Aerolib catalogs (#867) 2026-09-08 18:25:48 +03:00
Berk 6d4e5b4f65
chore: bump version to 0.0.3-release.4 (#866) 2026-09-08 16:04:47 +03:00
Berk d93ecaafa3
[CPU] Fixes a Windows VEH synchronization regression (#865) 2026-09-08 15:56:54 +03:00
Berk 33f590b381
chore: bump version to 0.0.3-release.3-patch.1 (#864) 2026-09-07 14:08:50 +03:00
Mathias b8f24219ae
fix VEH trampoline REX prefix and TLS patch boundaries (#859)
Fixes the REX.B prefix on the VEH entry spinlock's lock cmpxchg, which was
compare-exchanging on [rcx] instead of [r9] and therefore never guarding
anything.

Matches TLS and stack-canary patterns at instruction boundaries instead of
byte by byte. Without it GTA V dies at ~5s on a write through a register the
patcher had left unloaded; with it the title reaches its pause menu.

Co-authored-by: Foued Attar <attar.foued@gmail.com>
2026-09-04 21:07:58 +02:00
Berk 3831f3c407
Fix debugger frontend (#858)
* [security] harden debugger frontend API

* [docs] document debugger frontend security boundaries
2026-09-03 05:24:41 +03:00
frangametv b226dca3df
feat(hle): prefer loaded guest exports for selected registrations (#844)
Co-authored-by: Acelogic <miguelc4600@gmail.com>
2026-08-25 22:32:57 +02:00
Foued Attar 51e5480049
fix(cpu): preserve TLS instruction boundaries after rel8 branches (#846) 2026-08-24 22:52:30 +02:00
frangametv 600fcde637
fix(memory): expand the HLE guest-allocation arena (#843)
Co-authored-by: Foued Attar <foued.attar@lyceeastier.com>
2026-08-24 19:23:43 +03:00
frangametv 807aad18b3
tools(shader): inspect raw Gen5 shader dumps (#842)
Co-authored-by: Acelogic <miguelc4600@gmail.com>
2026-08-24 19:23:18 +03:00
frangametv f4f36b558f
fix(agc): refine vertex layouts without rebasing captured inputs (#841) 2026-08-24 14:49:36 +02:00
frangametv 2b8ef7d8fa
shader: add compact f16 arithmetic and compare lowering (#840)
Co-authored-by: Foued Attar <attar.foued@gmail.com>
2026-08-24 13:59:51 +02:00
angleyanalbedo f8a826ec1b
fix(agc,video): CMASK/DCC metadata state machine , remove heavy heavy motion trails in DeadCell (#836)
* fix(agc): add support for CMASK fast clear in rendering process

* fix(agc): prevent stale cross-frame label writes from bypassing WAIT_REG_MEM

Add frame-ID tracking to GpuWaitRegistry so that WAIT_REG_MEM in frame N+1
is not satisfied by a label written in frame N. Previously, a label that
persisted in guest memory from the previous frame could satisfy a new
WAIT_REG_MEM immediately, causing the waiting DCB to bypass its fence and
execute out of order.

Changes:
- GpuWaitRegistry: add _labelFrameIds, _currentFrameId, AdvanceFrame(),
  IsLabelFresh(); RecordProduced now stamps the frame ID on each write
- AgcExports: call AdvanceFrame() at RFlip (frame boundary);
  HandleSubmittedWaitRegMem checks IsLabelFresh before bypassing

This is one piece of the Dead Cells character visibility fix (issue #833).
The cross-frame label reuse could cause composite passes to execute before
character-layer passes, resulting in invisible characters.

* fix(video): simulate CMASK 'all clear' at frame boundary to prevent trails

On real PS5, CMASK is reset to 'all clear' at each frame boundary,
so render targets are effectively cleared. SharpEmu did not implement
this behavior, causing GBuffer targets to LOAD stale data from the
previous frame, resulting in visible trails/ghosting.

Reset Initialized=false for all offscreen guest images at the present
boundary (when _currentFrameSlot changes). This ensures every render
target starts each frame with LoadOp.Clear, matching the hardware's
CMASK behavior.

This is the trail fix for Dead Cells (issue #833), complementing the
cross-frame label staleness fix in GpuWaitRegistry.

* fix(video): only reset render targets (not textures) for CMASK simulation

Previous commit 89b4610 reset Initialized for ALL guest images, including
textures and storage images, causing a completely black screen. Only images
with a RenderPass (actual color render targets) should be reset, as CMASK
'all clear' only applies to color render targets, not sampled textures.

* Revert "fix(video): simulate CMASK 'all clear' at frame boundary to prevent trails"

This reverts commit 89b4610a015619848e4000372822dca1c08051ff.

* fix(agc): implement CMASK state machine for render target clearing

Implement CMASK (Color Mask) hardware behavior based on shadPS4's approach:

1. Track CMASK addresses from CB_COLORn_CMASK registers
2. Detect compute shaders that write to CMASK addresses (IsComputeMetaClear
   heuristic: no bitwise XOR in shader = clear shader)
3. Mark CMASK as 'all clear' when compute shader writes to it
4. EliminateFastClear mode now checks CMASK state before clearing

This addresses the trail/ghosting issue in Dead Cells (issue #833) where
642x362 GBuffer targets were never cleared after first use, causing stale
data from previous frames to persist.

Reference: shadPS4's IsComputeMetaClear + EliminateFastClear implementation.

* fix(agc): implement CMASK state machine for render target clearing

Based on shadPS4's PM4 implementation, add CMASK (Color Mask) hardware
behavior tracking:

1. TrackCmaskAddresses: Read CB_COLORn_CMASK registers to get CMASK addresses
2. CheckCmaskWrite: When DMA fill targets CMASK address with value 0,
   mark CMASK as 'all clear' (shadPS4's FillBuffer logic)
3. EliminateFastClear: Check CMASK state before clearing - only clear
   if CMASK is 'all clear', then mark as 'dirty'
4. DMA fill: Call TrackCmaskAddresses before processing to ensure
   CMASK addresses are registered when DMA fills happen

This addresses the trail/ghosting issue in Dead Cells (issue #833) where
642x362 GBuffer targets were never cleared after first use.

Reference: shadPS4's IsComputeMetaClear + EliminateFastClear + FillBuffer.

* refactor(agc): remove diagnostic CMASK traces from hot path

Remove 4 diagnostic TraceAgcShader calls that were added during CMASK
investigation:
- agc.cb_regs=[...] - allocated List<string> + string.Join on every draw
- agc.cmask_track - per-slot interpolated string on every draw
- agc.cmask_write - per-DMA-fill interpolated string
- agc.eliminate_fast_clear - per-draw interpolated string

These were debugging probes and are no longer needed.

* fix(agc): sync constant-fill zero writes to Vulkan render targets

Dead Cells GBuffer trails: the constant-fill compute kernel
(TrySubmitConstantFillKernel) wrote zeros to guest memory but never
invalided the host Vulkan GuestImageResource that backs the render
target, so the GBuffer pass kept LoadOp.Load stale previous-frame pixels.

After the guest write, request a guest color clear尷 ... clear for the
destination address (RequestAgentColorClear projection (clear)) so the next render pass
uses LoadOp.Clear. The pending clearandray mechanism already exists; the
fill kernel was simply bypassing it.

* Remove AGC lifecycle debug probes

Remove transient render-target lifecycle and indirect draw debug instrumentation from AgcExports. The change strips the noisy console probing while keeping the active render-target tracking logic intact for draw sequencing and validation.

* fix(video): clear frame-stale MRT groups at guest flip boundary

On hardware a colour surface whose fast-clear metadata is in reset
state reads back as the CB clear value instead of stale memory, so
games can leave per-frame MRT groups uncleaned and rely on that
implicit initialization. With no metadata layer, such a target keeps
whatever touched it last; when the group shares addresses with the
compositor's output, the entire finished previous frame bleeds
through every region the new frame does not repaint (Dead Cells
dungeon trails / ghosted characters).

Arm a reset at the guest's own flip command - the authoritative
frame boundary inside the submission stream - and let the first
multi-attachment colour group of the fresh frame consume it,
starting from LoadOp.Clear. One arm per flip yields exactly one
reset per guest frame regardless of CPU/GPU pipelining; later
groups keep load semantics so intra-frame pass chaining is
untouched. CPU-backed images are never touched.

Mirrors shadPS4's meta-state-driven attachment.is_clear at
render-pass begin (vk_rasterizer.cpp BeginRendering).

* fix(agc): correct CbColor0Cmask register offset and add EXT support

CbColor0Cmask was 0x320 (CMASK_SLICE, tile_max:14) instead of 0x31F
(CMASK_BASE_ADDRESS). TrackCmaskAddresses read the slice count instead
of the base address, so CMASK registration always produced garbage or
zero — the entire meta-state chain starved for every game.

Fix: 0x320 → 0x31F. Add CbColor0CmaskBaseExt (0x398) and decode the
full 48-bit address: ((ext & 0xFF) << 40) | ((low & 0x1FFFFFFF) << 8).

Phase 0 probe confirmed Dead Cells programs neither CMASK nor DCC
registers (all zeros) — it relies on unified memory semantics where
unwritten surfaces read as zero. The register offset fix is still
needed for games that do use CMASK metadata.

* feat(agc,video): CMASK/DCC meta-state machine with CLEAR WORD support

Replace the flat _cmaskClearedState dictionary with a proper meta-state
ledger that separates registration, clearing, and dirtying:

- MetaSurfaceInfo keyed by colour-buffer address (not meta address)
- Reverse map _cmaskToColorBuffer for fill/compute write detection
- TrackCmaskAddresses reads both CMASK (0x31F) and DCC (0x325) with
  EXT high-bit decoding; prefers CMASK, falls back to DCC
- CLEAR_WORD captured at registration time, passed through to
  BeginTranslatedRenderPass as VkClearValue
- EFC checks specific surface (not 'any cleared → clear slot0'),
  dirties only that surface (not entire table)
- CheckCmaskWrite uses reverse map for O(1) lookup
- Presenter bind loop queries IsMetaClearedForSurface → LoadOp.Clear
- _metaStateOverridesFlipArm flag gates flip-arm for gradual retirement

Phase 0 probe confirmed Dead Cells programs neither CMASK nor DCC
(all registers zero) — flip-arm remains the correct fix for that game.
The meta-state machine serves games that do use CMASK/DCC metadata.

* fix(agc,video): implement surface clearing at guest flip boundary

* refactor(video): remove flip-arm heuristic, meta-state machine fully replaces it

The flip-arm (_frameColorResetArmed) was a heuristic that cleared the
first multi-attachment colour group at guest flip boundary.  The
CMASK/DCC meta-state machine now handles all clearing: at flip time
MarkAllSurfacesCleared() marks every registered surface as cleared;
at bind time IsMetaClearedForSurface() triggers LoadOp.Clear and
consumes the state.  This replaces the flip-arm with a per-surface
state machine that correctly handles both explicit clears (DMA fill,
compute, EFC) and implicit frame-boundary resets.

Also fixed a bug where TrackCmaskAddresses overwrote IsCleared to
false on every call, defeating the frame-boundary reset.  Now
preserves existing IsCleared state when re-registering.

* Thread-safe meta-surface state & meta-clear decode

Add synchronization for metadata state: introduce _metaSurfaceGate and guard accesses to _metaSurfaces and _cmaskToColorBuffer in AgcExports to avoid concurrent-dictionary corruption and ensure small critical sections. Preserve cleared state only when metadata binding matches during re-registration. Make Gen5 texture format constants internal. Update logic to set/consume IsCleared under lock and check CMASK nearby windows safely.

Decode meta clear values in VulkanVideoPresenter: skip CPU-backed targets for meta clears, add UnpackMetaClearValue and HalfToFloat to convert CLEAR_WORD0/1 into proper ClearColorValue for R8G8B8A8_UNORM and R16G16B16A16_FLOAT formats (with an 8_8_8_8 fallback). This ensures correct clear colours and thread-safe metadata handling.
2026-08-24 13:56:44 +03:00
Foued Attar 4a7a45d1b3
Fix TLS-load patcher corrupting short jumps immediately before FS:[0] reads (#838)
The linear scanner consumed leading 0x66 bytes without checking that the
candidate starts on an instruction boundary. A short jump whose disp8 is
0x66 (EB 66) directly followed by a 66-prefixed FS:[0] load made the
patcher treat the displacement as a prefix and write its call opcode over
it, rewriting 'jmp forward past the TLS access' into 'jmp backward' -- an
infinite loop. GTA V's AGC resource destructors hit exactly this shape and
leaked the entire heap inside a container drain before any frame was
presented.

Reject candidates whose preceding byte is 0xEB: a bare EB can never be the
last byte of a valid instruction, so such a position is provably
mid-instruction. The outer byte scan then retries at the next offset,
which is the true boundary, and the patch lands correctly.
2026-08-23 14:52:44 +02:00
angleyanalbedo 3a744c991e
fix(agc): record write_data produced labels so WAIT_REG_MEM can resume (#834)
ApplySubmittedWriteData wrote label values to guest memory but never called
GpuWaitRegistry.RecordProduced, unlike ApplySubmittedReleaseMem. A suspended
WAIT_REG_MEM on a write_data label (e.g. Dead Cells frame fence 0x10243CFD8)
then could never be latched or deadlock-broken: guest memory is reset to 0 for
frame reuse before the next re-check, and _lastProduced had no value to replay.
Record each written dword and, for increment count2, the combined 64-bit value
so 32/64-bit waits latch like ReleaseMem dataSel=2.
2026-08-21 20:18:30 +03:00
urmoit 35a28f0143
[GUI] Estonian language (#835)
* [GUI] Estonian language

Implements Estonian language support for the SharpEmu's GUI.

* [GUI] Update and refine Estonian translations

Correct grammatical errors, refine technical UI terminology (e.g., view layout descriptions), and improve overall phrasing for better consistency across the launcher UI.
2026-08-21 20:18:07 +03:00
Marcin Mitura e79a1cc70a
[GUI] Polish language (#832) 2026-08-20 19:34:52 +02:00
Mathias a2241d0e83
Fix/agc zero dim and storage (#828)
* fix(videoout): promote guest images to storage usage

* fix(agc): treat zero-dimension indirect compute dispatches as valid no-ops
2026-08-18 21:20:54 +02:00
Foued Attar fe6521f617
Fix unaligned BufferLoad/GlobalLoad dword access
BufferLoadDword/x2/x3/x4, BufferStoreDword/x2/x3/x4, and their GLOBAL
counterparts were routed through LoadUnalignedBufferWord /
StoreBufferBytes, which reconstruct every dword one byte at a time
(4 bounds-checked buffer accesses per dword, each with its own
OpArrayLength + OpSelect + OpAccessChain + OpLoad/OpStore, plus
shift/mask/or reassembly on top).

The GCN ISA guarantees these opcodes are always dword-aligned - only
the byte/short/D16 variants legitimately need unaligned access, and
those already have their own dedicated path
(LoadSubdwordBufferValue / StoreBufferBytes with an explicit byte
count). The generic dword-count loop reached by every other
BufferLoad*/BufferStore*/GlobalLoad*/GlobalStore* opcode was paying
the same per-byte cost for no reason.

Route the dword-granularity path straight through the existing
LoadBufferWord / StoreBufferWord helpers (one bounds check and one
load/store per dword) instead. Measured on a compute shader with 6
BufferLoadDwordx4 instructions in its hottest basic block, this drops
GPU dispatch time for that shader from ~430-448ms to ~86-92ms (~5x)
with no change in output correctness - it is a pure translation
inefficiency fix, independent of any specific title.
2026-08-18 12:20:24 +02:00
Mathias 034ddcc092
fix(vmem): use ConcurrentDictionary for _pageProtections to prevent race corruption (#823) 2026-08-18 12:13:32 +02:00
Berk d9b599a1fd
chore: bump version to 0.0.3-release.3 (#826) 2026-08-18 00:19:31 +03:00
Astell ad115ddcbc
VMovrelsB32 opcode fix (#825) 2026-08-18 00:00:28 +03:00
Foued Attar 7521295ee1
[Codec/Native] Real H.264 decode for sceVideodec2, fix TLS loader missing the main module (#824)
* [Codec/Native] Real H.264 decode for sceVideodec2, fix TLS loader missing the main module

sceVideodec2 was a capability-only stub: the game's video pipeline
worked end-to-end but never produced a picture, so intro/cinematic
videos stayed black even though playback "completed" without errors
(confirmed on Ghost of Yotei's intro cinematic).

- Videodec2Decoder: owns an FFmpeg H.264 session per decoder handle,
  running decode and presentation pacing on their own threads (never
  the guest thread) so a whole clip isn't decoded faster than it can
  be displayed. Converts to BGRA and submits straight to
  VulkanVideoPresenter, bypassing guest memory the same way the
  existing Bink2 path does.
- Videodec2Exports: wires the real decoder into
  sceVideodec2CreateDecoder/Decode/Flush/Reset/DeleteDecoder, falling
  back to the original no-picture stub whenever FFmpeg is unavailable
  or a given decoder failed to open.
- VulkanVideoPresenter: decoded frames were being dropped under a
  single "latest wins" slot the render loop didn't always poll in
  time before the next frame overwrote it. Queues pending video
  presentations the same way guest-image flips already are.
- DirectExecutionBackend: the TLS load patcher's one-shot scan missed
  the main game module when the entry point resolves to a separate
  bootstrap allocation, and never re-scanned lazily-committed pages
  patched in afterward -- both left FS:[0] TLS loads unpatched,
  causing an early mutex-spin boot stall (reproduced on Demon's
  Souls: stuck at import #256). Now scans both the entry point's own
  allocation and the standard PS5/PS4 image base, and re-scans each
  newly committed executable range as it's touched.

* [GUI] Add a toggle for SHARPEMU_FORCE_SUBMIT_ORPHAN_PREAMBLES

This flag already existed as an AGC workaround (forces queued GPU
command-buffer preambles through when their target queue never picks
them up, unblocking titles stuck on a WAIT_REG_MEM that never
signals) but was only reachable by setting the environment variable
by hand. Expose it as a checkbox next to the other env toggles, in
both the global Options panel and the per-game settings panel, so it
can be turned on for a specific title without touching a shell.

* [GUI] Add remaining language translations for the new env toggle

The previous commit only added the new key to en.json/fr.json,
relying on Localization's runtime fallback to English -- but
LocalizationTests.EmbeddedLanguages_ContainEveryEnglishOptionsKey
requires every Options.* key to exist in every embedded language
file, which broke CI on all three build jobs. Fills in the
remaining 13 languages.
2026-08-18 00:00:01 +03:00
Astell 1660111189
A vplayer fix (#821)
* Astrobot-video-fix

* Astrobot-video-fix with updated files

* Astrobot-video-fix with tests files
2026-08-17 00:57:42 +03:00
Atson Melo 7caf430aa9
test(cpu): cover Gen5 native return smoke path (#818) 2026-08-11 04:52:49 +03:00
Astell 1e96eca316
Astrobot - Canonicalize fix and ffmpeg library on build (#817) 2026-08-11 00:36:12 +03:00
Foued Attar 498d402577
[HLE] Fix AGC OOB, kevent coalescing, and VideoOut flip/buffer-registration bugs (#808)
sceAgcAddPrimStateRegisters (NID unconfirmed, resolved from the decrypted
eboot's call site) reads 32 register pairs from a buffer that
sceAgcCreatePrimState only partially fills, treating the unfilled part as
guest-stack garbage -- an out-of-bounds probe index sourced from that
garbage was the AV. Zero the unfilled part instead.

GPU interrupt kevents were being coalesced when several arrived close
together, but the AGC driver's interrupt thread expects exactly one
completion per delivered kevent -- coalescing silently dropped completions
and wedged its dependency counters. Deliver one kevent per trigger instead,
with a cap so an undrained queue can't grow unbounded.

sceVideoOutGetFlipStatus left an extended region of its output struct
un-zeroed; some titles poll a flag past the classic struct layout and spin
forever on garbage that never clears. Zero the whole region -- flips
already complete synchronously in this emulator, so it should read as
not-pending anyway.

sceVideoOutRegisterBuffers2 rejected any nonzero category/option, which
some titles use, making them unable to ever register display buffers or
flip. Treat unknown categories as the standard layout instead of failing
the registration.

Tested on Ghost of Yotei (PPSA26344): combined with the separate
ajm-acm-audio change, gets past its audio-init stall and renders/presents a
real GPU frame; neither change alone reaches that point.

Tested on Cult of the Lamb: calls sceAgcAddPrimStateRegisters 39 times, 0
crashes (previously an unresolved import on this exact NID).

Regression-checked on Demon's Souls (both with and without the separate
native-tls-fix change, to reach further into boot), Astro Bot, Outer Wilds,
Ghost of Tsushima, GTA, Minecraft, Quake: no change in behavior on any of
them.
2026-08-09 18:52:23 +03:00
Foued Attar 4b8d45520e
[HLE] Fix AJM/ACM no-op stubs and accept Gen5 AudioOut2 mastering/batch calls (#807)
AjmModuleUnregister/AjmFinalize were pure no-ops (always returned success
without touching state); they now validate the context and actually remove
the codec registration / context entry, returning a real error when the
context is unknown. AjmModuleUnregister traces whether the codec was
actually registered, to help spot a title unregistering something it never
registered.

MaxCodecType was hardcoded to 25 based on known Sony codec ids, incorrectly
rejecting valid Gen5 codec types (e.g. 24). Registration is pure bookkeeping
(HashSet.Add); the only real constraint is that codecType must not overflow
the 32-bit instanceId it gets packed into, i.e. codecType < 2^18. Named the
instanceId bit-packing constants (InstanceIdSlotBits/InstanceIdSlotMask) so
the four call sites that used to hardcode 14/0x3FFF independently can't
drift out of sync, and MaxCodecType's formula is self-evident.

Accept sceAcmBatchInitialize/InitializeLite/Start/StartMultiple/Process as
successful no-ops -- the emulator runs no ACM DSP jobs, but Scream's workers
trap on int 0x41/0x42 asserts whenever a submission call reports failure.

Accept sceAudioOut2MasteringInit/Set3DLatency as no-ops -- the host mixer
has no mastering/object pipeline to tune, but returning failure makes
titles tear down their whole ACM context and abort audio arena bring-up.

Tested on Ghost of Yotei (PPSA26344): sceAudioOut2MasteringInit/Set3DLatency
unresolved-import warnings go from 2 to 0, unblocking 5 audio-related guest
threads that never spawned before (MovieDecoder, snd_stream_parsing_thread,
snd_stream_reader_thread, Psn, NCA::PumpThread), watchdog stall errors from
1 to 0. This alone gets the title past its Scream audio-init stall into
further boot, but it still hits an unrelated infinite retry loop in
sceVideoOutGetFlipStatus shortly after -- fixed by the separate
videoout-agc-hle-misc change; combined, the title renders and presents a
real GPU frame.

Regression-checked on Demon's Souls, Astro Bot, Outer Wilds, Cult of the
Lamb, Ghost of Tsushima, GTA, Minecraft, Quake: 0 calls to any export
touched by this change on any of them, byte-for-byte identical to
upstream/main.
2026-08-09 18:52:15 +03:00
Foued Attar 62c3852556
[AGC] Fix arena/fence tracking stalls and recover lost GPU progress (#770)
* [AGC] Fix arena/fence tracking stalls and recover lost GPU progress

Fix several AGC synchronization issues that could leave GPU work
unsubmitted or fences permanently unsatisfied:

- Recover fence writes missed during arena transitions by tracking
  closed arena tails and resweeping unresolved fence locations.
- Fix chunk submission accounting so only actually parsed ranges are
  considered submitted, avoiding missed orphan recovery.
- Extend arena sweeps to follow chained command ranges without
  duplicate submissions.
- Preserve GPU state tracking across native worker memory wrappers by
  using canonical guest memory identity.
- Fix builder-ring orphan submissions and stale ring-tail waits.
- Improve frame cycling by handling arena reuse, cursor regression,
  and transiently unavailable builder headers.
- Record conditional DCB execution (IT_COND_EXEC) instead of
  silently dropping the packet.

These changes improve AGC progress tracking and prevent GPU fence
starvation/deadlocks on titles relying on builder arenas and indirect
command chains.

* chore: trigger CI
2026-08-07 14:37:09 +03:00
Fa1dz 418eb7ecea
fix(audioout2): wire skipped-submit trace counter (#761) 2026-08-04 03:22:39 +03:00
Foued Attar c086e32f3d
Fix GuestDataPool lease leak on non-GPU compute dispatch paths (#759)
ObserveComputeDispatch only returned evaluation's pooled arrays when
evaluationHandledByCpu was set. Dispatches rejected before submission
(empty resource tables, oversized workgroup, compile failure) or a
compute submit that got dropped instead of enqueued (workSequence == 0)
never handed those buffers to a consumer that would return them,
leaking one lease per occurrence and growing GuestDataPool.Shared
without bound over a long session.

Adds GuestDataPool.DiagnosticStats() (outstanding lease count, idle
cached bytes) surfaced in the periodic [LOADER][PERF] line, to catch
this class of regression going forward.

Verified on Ghost of Yotei and Demon's Souls: pool_leases grew
unbounded before the fix (525 in 5 min on Demon's Souls, 1114 in 180s
on Yotei) and stays flat/bounded after (0-6 and 2-18 respectively),
with no behavioral regression observed.
2026-08-03 21:18:23 +03:00
shpeenut22 9e10d7c44a
Functions exports in kernel and NpTrophy2 (#749)
* sceNpTrophy2GetTrophyInfoArray export

* sceNpTrophy2GetTrophyInfoArray comment changed

* sceKernelIsTrinityMode & sceKernelGetOpenPsId exports

* deleted console log in KernelIsTrinityMode

* sceKernelGetOpenPsId: fix ORBIS_GEN2_ERROR_INVALID_ARGUMENT casts with uint.
2026-08-03 12:54:07 +03:00
ParantezTech 207441ca95 [asset] upload transparent logo image 2026-08-03 10:43:43 +03:00
ParantezTech 6b8f11a468 [asset] Add logo.psd file for future edits and modifications 2026-08-03 10:37:44 +03:00
Berk da0de5cf92
chore: bump version to 0.0.3-release.2 (#756) 2026-08-03 10:15:53 +03:00
Berk 26bda041fa
[videoout] guard degenerate guest buffer ranges (#755) 2026-08-03 10:09:07 +03:00
Berk 8eb2c1e9cb
Renderdoc (#753)
* [videoout] added renderdoc in-app capture

* [gui] added renderdoc toggle and debug group

* [gui] added renderdoc strings to all languages
2026-08-03 10:01:41 +03:00
1008 changed files with 209196 additions and 52563 deletions

BIN
.github/images/astro-bot.jpg vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 219 KiB

BIN
.github/images/astros-playroom.jpg vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 356 KiB

BIN
.github/images/cult-of-the-lamb.jpg vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 356 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 345 KiB

After

Width:  |  Height:  |  Size: 398 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 229 KiB

After

Width:  |  Height:  |  Size: 485 KiB

BIN
.github/images/gow-sos.jpg vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 538 KiB

BIN
.github/images/hades.jpg vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 693 KiB

BIN
.github/images/pac-man-world-re-pac.jpg vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 393 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 392 KiB

View File

@ -12,7 +12,7 @@ on:
jobs: jobs:
dispatch: dispatch:
runs-on: ubuntu-latest runs-on: ubuntu-26.04
steps: steps:
- name: Trigger sharpemu-site rebuild - name: Trigger sharpemu-site rebuild
env: env:

View File

@ -26,7 +26,7 @@ permissions:
jobs: jobs:
comment: comment:
name: Post artifact links name: Post artifact links
runs-on: ubuntu-latest runs-on: ubuntu-26.04
# Only for successful PR builds — artifacts exist only when the build passed. # Only for successful PR builds — artifacts exist only when the build passed.
if: >- if: >-
github.event.workflow_run.event == 'pull_request' && github.event.workflow_run.event == 'pull_request' &&

View File

@ -34,7 +34,7 @@ concurrency:
jobs: jobs:
init: init:
name: Init name: Init
runs-on: ubuntu-latest runs-on: ubuntu-26.04
outputs: outputs:
release-name: ${{ steps.vars.outputs.release-name }} release-name: ${{ steps.vars.outputs.release-name }}
release-tag: ${{ steps.vars.outputs.release-tag }} release-tag: ${{ steps.vars.outputs.release-tag }}
@ -71,7 +71,7 @@ jobs:
reuse: reuse:
name: REUSE Compliance name: REUSE Compliance
needs: init needs: init
runs-on: ubuntu-latest runs-on: ubuntu-26.04
steps: steps:
- name: Checkout repository - name: Checkout repository
uses: actions/checkout@v6 uses: actions/checkout@v6
@ -80,7 +80,7 @@ jobs:
uses: fsfe/reuse-action@v6 uses: fsfe/reuse-action@v6
build: build:
name: Build Archive name: Build win-x64
needs: needs:
- init - init
- reuse - reuse
@ -138,7 +138,7 @@ jobs:
fail-fast: false fail-fast: false
matrix: matrix:
include: include:
- os: ubuntu-latest - os: ubuntu-26.04
rid: linux-x64 rid: linux-x64
- os: macos-latest - os: macos-latest
rid: osx-x64 rid: osx-x64
@ -227,7 +227,7 @@ jobs:
# Versioned releases are immutable and tag-driven. Branch and manual runs # Versioned releases are immutable and tag-driven. Branch and manual runs
# still produce Actions artifacts without modifying a published release. # still produce Actions artifacts without modifying a published release.
if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v') if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
runs-on: ubuntu-latest runs-on: ubuntu-26.04
permissions: permissions:
contents: write contents: write
steps: steps:

4
.gitignore vendored
View File

@ -42,4 +42,6 @@ ehthumbs.db
.vs/ .vs/
.idea/ .idea/
.vscode/ .vscode/
clean_test/
.debug/

View File

@ -9,7 +9,7 @@ SPDX-License-Identifier: GPL-2.0-or-later
<ImplicitUsings>enable</ImplicitUsings> <ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable> <Nullable>enable</Nullable>
<GenerateDocumentationFile>true</GenerateDocumentationFile> <GenerateDocumentationFile>true</GenerateDocumentationFile>
<SharpEmuVersion>0.0.3-hotfix-2</SharpEmuVersion> <SharpEmuVersion>0.0.5-nexus</SharpEmuVersion>
<Version>$(SharpEmuVersion)</Version> <Version>$(SharpEmuVersion)</Version>
<RepoRoot>$([MSBuild]::NormalizeDirectory('$(MSBuildThisFileDirectory)'))</RepoRoot> <RepoRoot>$([MSBuild]::NormalizeDirectory('$(MSBuildThisFileDirectory)'))</RepoRoot>

View File

@ -22,6 +22,10 @@ SPDX-License-Identifier: GPL-2.0-or-later
<PackageVersion Include="Silk.NET.Vulkan" Version="2.23.0" /> <PackageVersion Include="Silk.NET.Vulkan" Version="2.23.0" />
<PackageVersion Include="Silk.NET.Vulkan.Extensions.EXT" Version="2.23.0" /> <PackageVersion Include="Silk.NET.Vulkan.Extensions.EXT" Version="2.23.0" />
<PackageVersion Include="Silk.NET.Vulkan.Extensions.KHR" Version="2.23.0" /> <PackageVersion Include="Silk.NET.Vulkan.Extensions.KHR" Version="2.23.0" />
<!-- Reuse the font rasterizer already shipped with Avalonia.Skia. -->
<PackageVersion Include="SkiaSharp" Version="3.119.4" />
<PackageVersion Include="SkiaSharp.NativeAssets.Linux" Version="3.119.4" />
<PackageVersion Include="System.IO.Hashing" Version="10.0.0" />
<!-- Transitive of Avalonia.Desktop; pinned. Avalonia 12 requires 0.94.1+. --> <!-- Transitive of Avalonia.Desktop; pinned. Avalonia 12 requires 0.94.1+. -->
<PackageVersion Include="Tmds.DBus.Protocol" Version="0.94.1" /> <PackageVersion Include="Tmds.DBus.Protocol" Version="0.94.1" />
<PackageVersion Include="xunit" Version="2.9.3" /> <PackageVersion Include="xunit" Version="2.9.3" />

View File

@ -15,6 +15,18 @@ SPDX-License-Identifier: GPL-2.0-or-later
--- ---
<p align="center">
<a href="https://discord.gg/zdTuUU9Uwn">
<img src="https://img.shields.io/badge/Discord-Join%20our%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join our Discord">
</a>
</p>
<p align="center">
<strong>Join our official Discord server for development updates, compatibility discussions, support, and community chat.</strong>
</p>
---
<p align="center"> <p align="center">
<a href="#support"> <a href="#support">
<img src="https://img.shields.io/badge/Support-GitHub%20Sponsors%20%26%20Crypto-EA4AAA?style=for-the-badge&logo=githubsponsors&logoColor=white" alt="Support SharpEmu"> <img src="https://img.shields.io/badge/Support-GitHub%20Sponsors%20%26%20Crypto-EA4AAA?style=for-the-badge&logo=githubsponsors&logoColor=white" alt="Support SharpEmu">
@ -23,6 +35,9 @@ SPDX-License-Identifier: GPL-2.0-or-later
--- ---
> [!IMPORTANT]
> **Official channels:** Only **sharpemu.app** and the links listed in this GitHub repository are affiliated with SharpEmu. Any other websites, accounts, or donation pages are unofficial and unauthorized.
> [!NOTE] > [!NOTE]
> SharpEmu supports Windows x64, Linux x64, and macOS x64. Apple Silicon Macs > SharpEmu supports Windows x64, Linux x64, and macOS x64. Apple Silicon Macs
> can run the macOS x64 build through Rosetta 2, and Windows on ARM devices > can run the macOS x64 build through Rosetta 2, and Windows on ARM devices
@ -43,32 +58,21 @@ Our goal is **not** to emulate PS4 games, as there is already an excellent emula
## Games Tested ## Games Tested
| Demons Souls Remake | Dreaming Sarah | | Demon's Souls Remake | ASTRO BOT |
| :-----------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | | :-----------------------------------------------------------: | :--------------------------------------------------------------------------------------------: |
| ![Bloodborne screenshot](./.github/images/demons-souls.jpg) | ![Dreaming Sarah](./.github/images/dreaming-sarah.jpg) | | ![DeS screenshot](./.github/images/demons-souls.jpg) | ![Astro Bot](./.github/images/astro-bot.jpg) |
| Void Terrarium | Dead Cells | | ASTRO's PLAYROOM | Dead Cells |
| :------------------------------------------------------------------------: | :------------------------------------------------------------------: | | :------------------------------------------------------------------------: | :------------------------------------------------------------------: |
| ![Void Terrarium](./.github/images/void-terrarium.jpg) | ![Dead Cells](./.github/images/dead-cells.jpg) | | ![Astro's Playroom](./.github/images/astros-playroom.jpg) | ![Dead Cells](./.github/images/dead-cells.jpg) |
| God of War: Sons of Sparta | Tomb Raider V Remastered |
| :------------------------------------------------------------------------: | :------------------------------------------------------------------: |
| ![GoW SOS](./.github/images/gow-sos.jpg) | ![Tomb Raider V](./.github/images/tomb-raider-v-remastered.jpg) |
## Status ## Status
The emulator can currently load the `eboot.bin` of real games, execute native CPU instructions, and partially handle kernel-related functionality. However, several critical components are still missing. The emulator can currently load the `eboot.bin` of real games, execute native CPU instructions, and partially handle gpu-related functionality. Included 3D games.
Current capabilities include:
* Loading `eboot.bin` and `.elf` files
* Executing native CPU instructions
* Reading basic game metadata (title, version, etc.)
* Loading system modules (`prx` / `sys_module`)
* Partial support for some kernel functions
* `Fiber` and `AMPR` exports
* PlayGo scenarios
* Initial loading game files
* Shader/resource submits and AGC initial
* Video outputs in some games
Some games have reached like `sceVideoOut` and AGC stages.
SharpEmu supports Windows, Linux, and macOS hosts. Video output uses Vulkan on SharpEmu supports Windows, Linux, and macOS hosts. Video output uses Vulkan on
Windows and Linux, and MoltenVK on macOS. Platform support is still experimental, Windows and Linux, and MoltenVK on macOS. Platform support is still experimental,
@ -79,11 +83,12 @@ so compatibility and performance vary by game, operating system, and GPU driver.
Download the release archive for your operating system, extract it, and launch Download the release archive for your operating system, extract it, and launch
SharpEmu with the path to a legally obtained game's `eboot.bin`. SharpEmu with the path to a legally obtained game's `eboot.bin`.
Or command line;
Windows PowerShell: Windows PowerShell:
```powershell ```powershell
.\SharpEmu.exe "C:\path\to\game\eboot.bin" 2>&1 | .\SharpEmu.exe "C:\path\to\game\eboot.bin" --log-to-file
Tee-Object -FilePath "SharpEmu.log"
``` ```
Linux and macOS: Linux and macOS:
@ -91,10 +96,13 @@ Linux and macOS:
```bash ```bash
chmod +x ./SharpEmu chmod +x ./SharpEmu
./SharpEmu "/path/to/game/eboot.bin" 2>&1 | ./SharpEmu "/path/to/game/eboot.bin" --log-to-file
tee SharpEmu.log
``` ```
SharpEmu supports environment variables that can be configured from the GUI. Undocumented variables are listed here: [docs/sharpemu-gui-undocumented-env-vars.md](docs/sharpemu-gui-undocumented-env-vars.md)
You can set them per game or globally in the GUI, or pass them directly through the CLI.
A Vulkan-capable GPU and current graphics driver are required. The macOS A Vulkan-capable GPU and current graphics driver are required. The macOS
release includes the MoltenVK Vulkan implementation. release includes the MoltenVK Vulkan implementation.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.1 MiB

After

Width:  |  Height:  |  Size: 656 KiB

BIN
assets/images/logo.psd Normal file

Binary file not shown.

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.3 MiB

View File

@ -12,6 +12,9 @@ python scripts/aerolib_catalog.py lookup Zxa0VhQVTsk
# Export name to NID # Export name to NID
python scripts/aerolib_catalog.py lookup sceKernelWaitSema python scripts/aerolib_catalog.py lookup sceKernelWaitSema
# A comma can be used for multiple query strings.
python scripts/aerolib_catalog.py lookup Zxa0VhQVTsk,SaKib2Ug0yI,sceVideoOutOpen,amuBfI-AQc4
# Search export names # Search export names
python scripts/aerolib_catalog.py search VideoOut --limit 20 python scripts/aerolib_catalog.py search VideoOut --limit 20

View File

@ -9,12 +9,12 @@ Demon's Souls plays Bink 2 (.bk2) files through a Bink implementation linked
directly into eboot.bin. It does not use libSceVideodec, therefore an HLE video directly into eboot.bin. It does not use libSceVideodec, therefore an HLE video
decoder cannot observe or replace those frames. decoder cannot observe or replace those frames.
SharpEmu observes successful guest .bk2 opens and, when a Bink decoder is By default, SharpEmu leaves Bink decoding to the implementation linked into
available, presents its decoded BGRA frames at the normal guest-flip boundary. the game (`SHARPEMU_BINK_MODE=guest`).
This preserves the game's own timing and lets the host Vulkan presenter display
the movie without trying to execute the PS5-specific Bink GPU decode path.
The default path decodes by calling FFmpeg's own C API directly from managed Set `SHARPEMU_BINK_MODE=native` to use the optional host bridge. It observes
guest .bk2 opens and presents decoded frames at the guest-flip boundary. The
host path decodes by calling FFmpeg's C API directly from managed
code (`src/SharpEmu.Libs/Bink/FfmpegNativeBinkFrameSource.cs`, via the code (`src/SharpEmu.Libs/Bink/FfmpegNativeBinkFrameSource.cs`, via the
[FFmpeg.AutoGen](https://github.com/Ruslan-B/FFmpeg.AutoGen) P/Invoke [FFmpeg.AutoGen](https://github.com/Ruslan-B/FFmpeg.AutoGen) P/Invoke
bindings) against a custom FFmpeg build bindings) against a custom FFmpeg build
@ -24,47 +24,38 @@ libraries come from. No proprietary RAD SDK is needed to build or run
SharpEmu, and there is no C/C++ code of SharpEmu's own involved in decoding SharpEmu, and there is no C/C++ code of SharpEmu's own involved in decoding
-- SharpEmu.CLI.csproj only downloads a prebuilt release archive. -- SharpEmu.CLI.csproj only downloads a prebuilt release archive.
Set `SHARPEMU_BINK_MODE=guest` to leave decoding to the Bink implementation Set `SHARPEMU_BINK_MODE=skip` only when explicitly testing a title whose
statically linked into the game instead. Set `skip` only when explicitly cinematics are optional.
testing a title whose cinematics are optional.
Set SHARPEMU_BINK_MODE=dummy to retain the open and show a built-in, Set SHARPEMU_BINK_MODE=dummy to retain the open and show a built-in,
non-decoded placeholder frame. This requires no SDK, but is a visual diagnostic non-decoded placeholder frame. This requires no SDK, but is a visual diagnostic
only; it does not decode the movie or alter its game logic. only; it does not decode the movie or alter its game logic.
SHARPEMU_BINK_MODE=native is equivalent to the default and mainly useful for `SHARPEMU_BINK_MODE=ffmpeg` is an alias for `native`.
being explicit about it.
The experimental `SHARPEMU_BINK_MODE=ffmpeg` override is unrelated to the
default path above: instead of calling into FFmpeg in-process, it spawns a
standalone `ffmpeg` executable and reads raw frames from its stdout
(`src/SharpEmu.Libs/Bink/FfmpegBinkFrameSource.cs`). SharpEmu searches
`SHARPEMU_FFMPEG_PATH`, the executable directory, its `ffmpeg` subdirectory,
and then `PATH` (plus a couple of common Homebrew paths on macOS). That
`ffmpeg` build must contain a Bink 2 decoder itself; a stock FFmpeg build that
only recognizes the Bink container is not sufficient. Most users want the
default `native` mode instead, which always has Bink 2 support since it's
built against `ffmpeg-core` specifically.
## Supplying the FFmpeg libraries ## Supplying the FFmpeg libraries
`dotnet publish` fetches a prebuilt release of `github.com/sharpemu/ffmpeg-core` Both `dotnet build` and `dotnet publish` fetch a prebuilt release of
(the tag is pinned in `SharpEmu.CLI.csproj`'s `FfmpegRuntimeTag`, matched to `github.com/sharpemu/ffmpeg-core` (the tag is pinned in
the `FFmpeg.AutoGen` package version in `Directory.Packages.props` -- both `SharpEmu.CLI.csproj`'s `FfmpegRuntimeTag`, matched to the `FFmpeg.AutoGen`
need to agree on the same FFmpeg ABI) and copies its dynamically linked package version in `Directory.Packages.props` -- both need to agree on the
libraries into a `plugins` folder next to the published executable. No C same FFmpeg ABI) and copy its dynamically linked libraries into a `plugins`
toolchain is required to build SharpEmu; publishing just downloads a zip. folder next to the resulting executable (`artifacts/bin/...` for build,
`plugins` is a loose, unpacked folder rather than something embedded in the `artifacts/publish/...` for publish). No C toolchain is required to build
single-file bundle, so the OS loader can resolve the libraries' own SharpEmu; both just download a zip once (cached under
inter-dependencies (`avcodec` depends on `avutil`, etc.) itself. `$(BaseIntermediateOutputPath)ffmpeg-runtime/`, so later builds/publishes
reuse it instead of re-fetching). `plugins` is a loose, unpacked folder
rather than something embedded in the single-file bundle, so the OS loader
can resolve the libraries' own inter-dependencies (`avcodec` depends on
`avutil`, etc.) itself.
A plain `dotnet publish` with no `-r` still works: it defaults to the host A plain `dotnet build`/`dotnet publish` with no `-r` still works: it defaults
machine's own RID (see `Directory.Build.props`), so it fetches the matching to the host machine's own RID (see `Directory.Build.props`), so it fetches
`ffmpeg-core` archive and populates `plugins` without any extra flags. the matching `ffmpeg-core` archive and populates `plugins` without any extra
Passing an explicit `-r <rid>` (e.g. to cross-publish `linux-x64` from flags. Passing an explicit `-r <rid>` (e.g. to cross-publish `linux-x64` from
Windows) still overrides that default normally. Windows) still overrides that default normally.
To use a different set of FFmpeg libraries, drop them into the published To use a different set of FFmpeg libraries, drop them into the build or
`plugins` folder yourself (matching FFmpeg's own file-naming and versioning published `plugins` folder yourself (matching FFmpeg's own file-naming and versioning
conventions, e.g. `avformat-61.dll` / `libavformat.so.61` / matching conventions, e.g. `avformat-61.dll` / `libavformat.so.61` / matching
`.dylib`) -- `FfmpegNativeBinkFrameSource` points `ffmpeg.RootPath` at that `.dylib`) -- `FfmpegNativeBinkFrameSource` points `ffmpeg.RootPath` at that
folder and does not otherwise care where the files came from. folder and does not otherwise care where the files came from.

View File

@ -0,0 +1,80 @@
<!--
Copyright (C) 2026 SharpEmu Emulator Project
SPDX-License-Identifier: GPL-2.0-or-later
-->
# Shader rejection diagnostics
`SHARPEMU_STRICT_COMPUTE` controls the rejections listed below for compute dispatches
and graphics draws. The existing variable name is retained; there is no separate
`SHARPEMU_STRICT_DRAW` switch. Restart the game after a change. The pipeline cache and
draw executor read the value when created.
- Unset or `1`: stop on the rejection so that the failure can be diagnosed (default).
- `0`: skip the affected dispatch or draw. Only this value enables skipping.
The GUI provides this switch under **Environment > Debug**, globally and per game.
It is on by default. Turning it off saves an explicit `0`; an inherited process
environment value does not override the GUI choice. Other values retain strict mode.
## Complete skip list
With the switch set to `0`, these are the only handled rejection categories:
| Rejection | Detection point | Operation skipped |
| --- | --- | --- |
| Resource-plan extraction throws `ResourcePlanException`, including an unsupported resource expression or a value graph that does not converge | `ShaderProgramCache.CreateEntry` | The dispatch or draw that needs the rejected shader |
| Shader compilation returns failure or no compiled program, including an unsupported opcode reported by the compiler | `ShaderProgramCache.CompilePermutation` | The dispatch or draw that needs the rejected shader |
| Indirect image candidates have incompatible image classes (`IncompatibleImageCandidates`) | `ResourceMaterializer.Materialize`, handled by `ShaderProgramCache` | The dispatch or draw that needs those resources |
| Indirect image expansion exceeds the dense image resource limit (`ImageCapacityExceeded`) | `ResourceMaterializer.Materialize`, handled by `ShaderProgramCache` | The dispatch or draw that needs those resources |
| A graphics texture's cached image type cannot support the requested view type, such as a 2D view of a 1D image | Vulkan `ValidateDrawImageTypes`, handled by `RenderExecutor.RecordDraw` | The whole indexed or automatic draw |
The last category applies to vertex and pixel resource preparation, not compute
image binding. It checks available, non-stale cache entries and excludes host movie
textures. A mismatch detected later in binding remains fatal.
The draw image-type check runs before resource binding and draw recording. Skip mode
does not create an invalid view or issue the rejected draw. The preparation scope is
released, and the caller resets the image bindings before the next operation.
## Failures that remain fatal
- Shader decoding failures and invalid shader source reads.
- Unreadable resource memory, invalid indirect table state, and materialization failures
other than the two named categories above.
- Invalid binding layouts or invalid resource snapshot state.
- Other image checks, including format, usage, aspect, component mapping, and range
checks reached during binding or view creation. The image cache checks are unchanged.
- Image-type mismatches in compute binding or outside the graphics preparation check.
- Host allocation failures, device loss, synchronization failures, and unexpected exceptions.
This is not a general exception bypass. Setting the switch to `1` also makes every
category in the skip list fatal. Supported operations use the same path in both modes.
## Warnings and test limits
Program rejections log `COMPUTE_SKIPPED` or `DRAW_SKIPPED` once per stage, shader hash,
and code size in each pipeline cache. Draw image-type rejections log `DRAW_SKIPPED`
once per shader hash, image type, and view type in each draw executor. Warning counts
are not skipped-operation counts. No rejected permutation is recorded as compiled;
a later request can retry it.
A skipped operation does not produce its outputs. Missing images, incorrect results,
later errors, and stalls are possible. FPS can rise because less work is executed.
Skip-mode smoke tests can check progress and expose other defects, but must record
the skip warnings. They do not close the skipped defects or establish a final visual
or performance baseline. This switch does not restore the old renderer.
## PowerShell
Enable strict testing in PowerShell:
```powershell
$env:SHARPEMU_STRICT_COMPUTE = '1'
```
Explicitly enable skip mode:
```powershell
$env:SHARPEMU_STRICT_COMPUTE = '0'
```

View File

@ -0,0 +1,54 @@
<!--
Copyright (C) 2026 SharpEmu Emulator Project
SPDX-License-Identifier: GPL-2.0-or-later
-->
# Performance display
Open **Options → Rendering**, globally or for one game.
- **Performance display:** start with statistics on or off.
- **Display mode:** Full shows all counters and the frame graph. Minimal shows
guest FPS, process CPU usage, process GPU usage, and elapsed session time.
Title bar shows the same minimal values in the window title.
- **Screen corner:** choose any of the four corners. This setting applies only
to the on-screen panel.
F1 toggles the display for the current run. F2 cycles clockwise through the
screen corners. Neither key changes saved settings. The next run uses the saved
options again. Command+F1 retains its separate Metal HUD shortcut.
`SHARPEMU_OVERLAY=0` starts the display hidden, even when the saved option is on.
F1 can still show it. RenderDoc's F12 hint remains in the title when available.
The operating system does not show a title bar in borderless/fullscreen modes.
The launcher passes these options to the game process, including when a separate
emulator path is configured:
```text
--overlay=on|off
--overlay-mode=full|minimal|titlebar
--overlay-corner=topleft|topright|bottomright|bottomleft
```
## Usage values
The panel dimensions are separate constants in `PerfOverlay.cs`:
`PanelWidth` / `PanelHeight` for Full, and
`MinimalPanelWidth` / `MinimalPanelHeight` for Minimal. Both heights are fixed;
the renderer clips the panel only when the window is too small.
CPU usage is the emulator process's CPU time divided by wall time and the
number of logical processors. GPU usage is the busiest GPU engine used by the
emulator process, not GPU memory usage or total usage by all applications.
Windows supplies the GPU Engine performance counters. Collection runs off the
render thread and uses the existing statistics refresh interval. Rate counters
need two samples. Missing counters, unavailable samples, and other platforms
show **N/A**, not zero. No GPU waits or presentation delays are added.
The full panel keeps cache memory counters and puts CPU/GPU usage on a separate
line above elapsed time and the Vulkan allocation counters.
The counter interpretation follows [Microsoft's GPU utilization description](https://devblogs.microsoft.com/directx/gpus-in-the-task-manager/).
Wildcard samples use [PdhGetFormattedCounterArray](https://learn.microsoft.com/en-us/windows/win32/api/pdh/nf-pdh-pdhgetformattedcounterarrayw).

View File

@ -0,0 +1,433 @@
<!--
Copyright (C) 2026 SharpEmu Emulator Project
SPDX-License-Identifier: GPL-2.0-or-later
-->
# SharpEmu: environment variables that are not on the GUI options pages
## Scope
This list contains each `SHARPEMU_*` environment variable in the repository that the GUI does not show.
The GUI shows 14 variables on its **Options** and **Game options** pages. This list does not contain them:
`SHARPEMU_BTHID_UNAVAILABLE`, `SHARPEMU_CRASH_CAPTURE`, `SHARPEMU_DEFAULT_PROFILE`,
`SHARPEMU_DISABLE_IMPORT_LOOP_GUARD`, `SHARPEMU_DUMP_SPIRV`, `SHARPEMU_LOG_DIRECT_MEMORY`, `SHARPEMU_LOG_IO`,
`SHARPEMU_LOG_NP`, `SHARPEMU_PROFILE_PERFORMANCE`, `SHARPEMU_PROFILE_PERFORMANCE_FRAME_TRACE`,
`SHARPEMU_RENDERDOC`, `SHARPEMU_VK_DISABLE_IMPLICITS`, `SHARPEMU_STRICT_COMPUTE`, `SHARPEMU_VK_VALIDATION`, `SHARPEMU_WRITABLE_APP0`.
The list contains 269 variables. The source was examined on 2026-09-19, branch `dev`.
The descriptions come from the code that reads each variable. The emulator was not started for this list.
## How to use a variable
1. Set the variable in the shell before you start the emulator or the GUI.
2. You can also enter additional env vars using the button next to the "Play" button from GUI.
3. The GUI also accepts a variable in the `EnvironmentToggles` list of its settings file. Write `NAME` or `NAME=value`. An entry without a value gets the value `1`.
4. The emulator reads most variables one time, when it starts. Start the game again after a change.
5. If the **Value** column shows `1`, only the value `1` turns the function on, unless the row gives other values.
## Number of variables in each group
| Group | Variables |
| --- | --- |
| Behavior switches | 19 |
| GPU and Vulkan | 59 |
| Metal | 10 |
| Audio and video | 6 |
| Input | 5 |
| Memory and CPU | 19 |
| Loader | 11 |
| Debugger | 1 |
| Log channels | 72 |
| Traces | 25 |
| Data dumps | 12 |
| Performance measurement | 17 |
| Internal | 1 |
| Tests and tools | 12 |
## Behavior switches
These variables change how the emulator operates.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_AGC_VERSION13_DEFAULTS` | text (`legacy`, `generic` or `0`) | Selects the register defaults for AGC version 13 requests. The default uses the version 11 compact tables. The values `legacy`, `generic` and `0` use the older generic layout. | `AgcExports.Init.cs` |
| `SHARPEMU_DISABLE_LLE_LIBC` | `1` | Stops the use of the guest libc module for libc exports. The emulator then uses its HLE handlers for these exports. | `DirectExecutionBackend.cs` |
| `SHARPEMU_HLE_FAST_MEMCPY` | `0` | Set to `0` to stop the native fast-path stub for the guest libc `memcpy` and `memmove`, so those imports use the managed HLE gateway again. | `DirectExecutionBackend.FastPath.cs` |
| `SHARPEMU_HLE_FAST_PATH` | `0` | Set to `0` to stop the native fast-path stubs for `pthread_self` and `pthread_getspecific`, so those imports use the managed HLE gateway again. The stubs are on by default on macOS x64 and are off on any run that traces imports or pthreads. | `DirectExecutionBackend.FastPath.cs` |
| `SHARPEMU_HOLD_FIRST_FLIP_MS` | number | Stops the thread that submits the flip for this number of milliseconds on one guest flip. The range is 0 to 60000 and the default is 0 (off). `SHARPEMU_HOLD_FLIP_NUMBER` selects the flip. | `VideoOutExports.cs` |
| `SHARPEMU_HOLD_FLIP_NUMBER` | number | Selects the guest flip that `SHARPEMU_HOLD_FIRST_FLIP_MS` holds. The minimum is 1 and the default is 1 (the first flip). | `VideoOutExports.cs` |
| `SHARPEMU_IGNORE_GUEST_EXCEPTIONS` | `1` | `sceKernelRaiseException` returns OK and does not call the installed guest exception handler. Default is off. | `KernelExceptionCompatExports.cs` |
| `SHARPEMU_IMPORT_LOOP_GUARD_SECONDS` | number | When `SHARPEMU_DISABLE_IMPORT_LOOP_GUARD=0` enables the guard, sets how long an import call pattern can repeat before a guest exit. The default is 5 seconds; 0 turns the guard off. | `DirectExecutionBackend.Imports.cs`, `DirectExecutionBackend.cs` |
| `SHARPEMU_NET_REDIRECT` | IP address | Sends guest `connect` and `sendto` traffic to this host IP address. When unset, the emulator permits outbound guest traffic only to loopback addresses. If the value is not a valid IP address, the emulator keeps the original destination and permits the traffic. | `KernelSocketCompatExports.cs` |
| `SHARPEMU_NO_FLIP_PACING` | `1` | Stops flip pacing. The emulator completes each flip immediately and does not wait for the display refresh time. The default is off. | `VideoOutExports.cs`, `VideoOutExports.FlipRequests.cs` |
| `SHARPEMU_OVERLAY` | `0` | Hides the performance overlay at start, even when the video options have the overlay on. All other values use the video options. | `PerfOverlay.cs`, `PerformanceOverlayState.cs` |
| `SHARPEMU_POSIX_GPU_FAULT_FAST_PATH` | `0` | Set to `0` to stop the POSIX fault bridge from offering GPU-tracked page faults to the GPU memory tracker before it builds the Win64 exception context. The fault then takes the full handler order again. | `DirectExecutionBackend.PosixSignals.cs` |
| `SHARPEMU_RETAIN_SUBMITTED_INDEX_DATA` | `0` | The default is on. The emulator keeps a copy of submitted index data until the translated draws run. Set to `0` to stop this copy. Use `0` only for a comparison test. | `AgcExports.SubmittedGeometry.cs` |
| `SHARPEMU_RETAIN_SUBMITTED_VERTEX_DATA` | `0` | The default is on. The emulator keeps a copy of submitted vertex data until the translated draws run. Set to `0` to stop this copy. Use `0` only for a comparison test. | `AgcExports.SubmittedGeometry.cs` |
| `SHARPEMU_SAVEDATA_DIR` | path | Set the root directory for save data. The default is `user/savedata` next to the executable. When this variable is set, the emulator does not move save data from the old layout. | `SaveDataStorage.cs`, `SaveDataExports.cs` |
| `SHARPEMU_STALL_WATCHDOG_SECONDS` | number (seconds) | Sets the time without import progress before the stall watchdog operates. The default is 20. The watchdog writes a snapshot and stops the process with exit code 4. It does not operate when a guest thread is ready or a known wait is in progress. `0` stops the watchdog. | `DirectExecutionBackend.cs` |
| `SHARPEMU_STRICT_RWLOCK_WRITER_PREFERENCE` | `1` | Set to `1` to make a guest thread take a free pthread rwlock as the exclusive writer. By default, the thread gets a compatibility writer record and the lock has no writer thread. | `KernelPthreadExtendedCompatExports.cs` |
| `SHARPEMU_TEMP0_DIR` | path | Set the host directory for the guest `temp0` mount. The default is `user/temp/<app name>/temp0` next to the executable. When unset, the kernel code sets this variable to the default path. | `AppContentExports.cs`, `KernelMemoryCompatExports.cs` |
| `SHARPEMU_TRACE_TITLE_SHADER_STATE` | `1` | The SPIR-V translator changes the pixel shader at address 0x0000000500781200 for diagnosis. The first float output then shows the execution state, the wave mask state, and the export state as colors. Default is off. | `Gen5SpirvTranslator.cs` |
## GPU and Vulkan
These variables change the GPU path or the Vulkan presenter.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_ASYNC_GUEST_READBACK` | `0` | `0` makes a guest thread that reads GPU-written buffer memory wait until the render thread has copied the data back. The default starts the copy on the render thread and lets the guest thread wait for it on a separate readback slot, so the render thread continues. | `GuestBufferCache.cs` |
| `SHARPEMU_CAPTURE_PIXEL_EXEC_PCS` | list (`pc:register` pairs) | At each given instruction PC, the pixel shader writes the execution flag to the given VGPR register. The value is 1.0 when the flag is set and 0.0 when it is not. `SHARPEMU_CAPTURE_PIXEL_VGPR_ADDRESS` must match the shader address. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_CAPTURE_PIXEL_IMAGE_ADDRESS` | hex address | Selects the pixel shader for the image capture by its program address. The default is no capture. Use it with `SHARPEMU_CAPTURE_PIXEL_IMAGE_PC`. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_CAPTURE_PIXEL_IMAGE_PC` | number (instruction PC) | Sets the image instruction whose result the SPIR-V translator copies to four VGPR registers. `SHARPEMU_CAPTURE_PIXEL_IMAGE_ADDRESS` must match the shader address. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_CAPTURE_PIXEL_IMAGE_VGPR_BASE` | number (0 to 252) | Sets the first VGPR register that receives the captured image components. The default is 248. Values above 252 use the default. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_CAPTURE_PIXEL_VGPR_ADDRESS` | hex address | Selects the pixel shader for the VGPR capture, execution capture and path marker functions by its program address. The default is no capture. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_CAPTURE_PIXEL_VGPR_DEST_BASE` | number (0 to 252) | Sets the first destination VGPR register for `SHARPEMU_CAPTURE_PIXEL_VGPR_SOURCES`. The default is 248. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_CAPTURE_PIXEL_VGPR_IGNORE_EXEC` | `1` | Makes the VGPR capture copies occur without the execution flag guard. The default applies the guard. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_CAPTURE_PIXEL_VGPR_PC` | number (instruction PC) | Sets the instruction PC at which the translator copies the source VGPR registers. `SHARPEMU_CAPTURE_PIXEL_VGPR_ADDRESS` must match the shader address. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_CAPTURE_PIXEL_VGPR_POINTS` | list (`pc:source:destination` triples) | At each given instruction PC, the pixel shader copies the source VGPR register to the destination register. Register numbers must be less than 256. `SHARPEMU_CAPTURE_PIXEL_VGPR_ADDRESS` must match the shader address. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_CAPTURE_PIXEL_VGPR_SOURCES` | list (one to four register numbers) | Gives the source VGPR registers that the translator copies at `SHARPEMU_CAPTURE_PIXEL_VGPR_PC`. The copies go to the registers that start at the destination base. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_DETILE` | `1` or `0` | Controls the detile step for tiled surfaces. The default detiles only the trusted swizzle modes. `1` also detiles the approximate modes and `0` uploads all surfaces as raw data. | `GnmTiling.cs` |
| `SHARPEMU_DISABLE_FILL_CLEAR` | `1` | Stops the adaptation that treats a transparent premultiplied fill draw as a target overwrite. The default keeps the adaptation on. | `ShaderPipelineCache.Adaptations.cs` |
| `SHARPEMU_ENABLE_CHUNKED_DRAWS` | `1` | The Vulkan presenter reads the value into a field. No code uses the field, so the variable has no effect. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_FORCE_ATTRIBUTE_FRAGMENT` | number (attribute location) | The Vulkan presenter reads the number into a field. No code uses the field, so the variable has no effect. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_FORCE_DEFAULT_RASTER_STATE` | `1` | The Vulkan presenter reads the value into a field. No code uses the field, so the variable has no effect. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_FORCE_FULLSCREEN_PIPELINE` | `1` | The Vulkan presenter reads the value into a field. No code uses the field, so the variable has no effect. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_FORCE_FULLSCREEN_VERTEX` | `1` | The Vulkan presenter reads the value into a field. No code uses the field, so the variable has no effect. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_FORCE_PACKED_EXPORT_ONE` | `1` | The SPIR-V translator replaces each packed half-float export component with the constant 1.0. This applies to all shaders. Default is off. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_FORCE_PACKED_EXPORT_STORE_ONE` | `1` | The SPIR-V translator writes (1.0, 1.0) to the packed half-float pair before the export reads it. This applies only to the pixel shader at guest address 0x0000000500781200. Default is off. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_FORCE_PACKED_STORE_EXEC_VALUES` | `1` | Each packed half-float store writes 1.0 when the EXEC mask is active and 0.5 when it is not. This shows the EXEC state as a color. This applies only to the pixel shader at guest address 0x0000000500781200. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_FORCE_PIXEL_EXPORT_ADDRESS` | hex address | Sets the shader address filter for the pixel export debug overrides. The value is a hex address, and the `0x` prefix is optional. When unset, the overrides apply to all pixel shaders. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_FORCE_PIXEL_EXPORT_PACK_VGPR_BASE` | number | Float pixel outputs read four vector registers that start at this base plus four times the export target. The translator packs the values to half-float and unpacks them again. The address filters select the shaders. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_FORCE_PIXEL_EXPORT_VGPR_ADDRESS` | hex address | Sets the shader address filter for the two VGPR base overrides. The `0x` prefix is optional. When unset, the filter from `SHARPEMU_FORCE_PIXEL_EXPORT_ADDRESS` applies. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_FORCE_PIXEL_EXPORT_VGPR_BASE` | number | Float pixel outputs read four vector registers that start at this base plus four times the export target. These values replace the decoded export sources. The address filters select the shaders. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_FORCE_PIXEL_MAGENTA` | `1` | Each selected pixel shader export writes opaque magenta. The control flow, EXEC mask, geometry and raster state stay the same. Use `SHARPEMU_FORCE_PIXEL_EXPORT_ADDRESS` to select one shader. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_FORCE_SOLID_FRAGMENT` | `1` | The Vulkan presenter reads the value into a field. No code uses the field, so the variable has no effect at this time. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_FORCE_TITLE_COMPARE_4D4` | `1` | The compare instruction at shader PC 0x4D4 always gives the result true. This applies only to the shader at guest address 0x0000000500781200. Default is off. | `Gen5SpirvTranslator.Alu.cs` |
| `SHARPEMU_FORCE_TITLE_COMPARE_540` | `1` | The compare instruction at shader PC 0x540 always gives the result true. This applies only to the shader at guest address 0x0000000500781200. Default is off. | `Gen5SpirvTranslator.Alu.cs` |
| `SHARPEMU_FORCE_TITLE_DEFAULT_RASTER_STATE` | `1` | The Vulkan presenter reads the value into a field. No code uses the field, so the variable has no effect at this time. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_FORCE_TITLE_EARLY_COLOR` | `1` | The pixel shader at guest address 0x0000000500781200 writes a constant to its first output and returns at once. A float output gets opaque magenta. An integer output gets zero. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_FORCE_TITLE_EXPORT_EXEC` | `1` | The translator sets the EXEC mask to true and writes 1 to 64-bit register 126 before each pixel export store. This applies only to the pixel shader at guest address 0x0000000500781200. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_FORCE_TITLE_FULLSCREEN_VERTEX` | `1` | The Vulkan presenter reads the value into a field. No code uses the field, so the variable has no effect at this time. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_FORCE_TITLE_SINGLE_MRT` | `1` | The translator declares only the first pixel output for the pixel shader at guest address 0x0000000500781200. It does not declare the other render target outputs. Default is off. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_FORCE_TITLE_SOLID_FRAGMENT` | `1` | The Vulkan presenter reads the value into a field. No code uses the field, so the variable has no effect at this time. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_FORCE_TITLE_VERTEX_OUTPUTS_ONE` | `1` | Vertex export targets 32 to 35 write the vector (1, 1, 1, 1). This applies only to the vertex shader at guest address 0x0000000500780000. Default is off. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_GPU_BACKEND` | `vulkan` or `metal` | Selects the guest GPU backend. The default is Vulkan. The value `metal` works only on macOS, and other hosts show a warning and use Vulkan. | `GuestGpu.cs` |
| `SHARPEMU_GPU_WAIT_SPIN_US` | number (microseconds) | Sets how long a wait for GPU work polls before it blocks. A short poll saves the wake-up delay when the GPU finishes soon. `0` blocks at once. The default is 150. | `GpuWaitSpin.cs` |
| `SHARPEMU_GRAPHICS_SUBGROUPS` | `0` or `1` | Set `1` to use native Vulkan subgroup operations in graphics shaders. Set `0` to use the fallback path. When unset, the presenter uses them only if the subgroup size is 32 and the vertex and fragment stages support subgroups. | `VulkanVideoPresenter.cs`, `VulkanVideoPresenter.Device.Setup.cs` |
| `SHARPEMU_IMAGE_LOOKUP_MEMO` | `0` | `0` turns off the image lookup memo. The default keeps the result of each image lookup that found an image with the same backing, and gives it again for the same request until an image is registered or removed. | `GuestImageCache.Lookup.cs` |
| `SHARPEMU_MARK_PIXEL_PCS` | list of `pc:register` pairs | Makes the SPIR-V pixel shader write the float value 1.0 to a shader register when execution reaches the given instruction PC. Use decimal numbers, a register below 256, and a comma between pairs. It has an effect only for the shader address in `SHARPEMU_CAPTURE_PIXEL_VGPR_ADDRESS`. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_MAX_GUEST_WORK_PER_RENDER` | number | Sets the maximum number of guest command stream slices that the Vulkan presenter runs in one render pass. The default is 1024, or 256 on macOS. The value must be more than 0. | `VulkanVideoPresenter.cs`, `VulkanVideoPresenter.CommandStream.cs` |
| `SHARPEMU_RENDERDOC_CAPTURE_TIMEOUT_SECONDS` | number (seconds) | Set the maximum time for a RenderDoc frame capture. The emulator discards a capture that does not end in this time. The range is 1 to 120. The default is 15. | `RenderDocCapture.cs` |
| `SHARPEMU_RENDERDOC_DLL` | path | Set the path of the RenderDoc library file. The emulator tries this path first. When unset or when the load fails, it searches the default library name and the known install paths. | `RenderDocCapture.cs` |
| `SHARPEMU_RENDERDOC_WAIT` | number (seconds) or `enter` | Set to make the emulator wait before it starts Vulkan, so that you can attach RenderDoc. `enter` waits until you press Enter. A number waits that many seconds, from 1 to 300. Other text waits 15 seconds. | `VulkanVideoPresenter.Device.Setup.cs` |
| `SHARPEMU_RENDER_WORK_BUDGET_MS` | number (milliseconds) | Set the maximum time that one render call uses for queued guest work in the Vulkan presenter. Work that remains stays in the queue for the next frame. `0` removes the limit. The default is 12 on macOS and 0 on other hosts. | `VulkanVideoPresenter.cs`, `VulkanVideoPresenter.RenderLoop.cs` |
| `SHARPEMU_RESOURCE_PREFETCH` | `0` | `0` makes the shader resource materialization read each guest word one at a time. The default reads adjacent words of descriptors and the flattened resource table in one read of resident guest memory. A range that the GPU may still own is read word by word as before. | `ShaderProgramCache.cs`, `RawReadPrefetch.cs` |
| `SHARPEMU_SHADER_MAX_STEPS` | number | Set the maximum number of dispatcher loop steps in each translated shader invocation. The limit makes sure that an incorrect loop stops. `0` removes the limit. The default is 100000. | `Gen5SpirvTranslator.cs`, `Gen5MslTranslator.cs` |
| `SHARPEMU_SHADER_PREWARM` | `0` | `0` turns off the shader prewarm list. By default, each compute program that a game compiles is added at once to `shader-prewarm.bin` in `user/pipeline_cache/<title id>/`, so a stopped game keeps the list. At the next launch after a change of the shader translator or of the GPU driver, background threads translate the listed programs again and create their pipelines, so that the driver compiles them before the game asks for them. The `shader-prewarm.stamp` file names the build and driver that last did this; with the same build and driver, the launch does no prewarm work. The log shows `Shader prewarm done` and `Shader prewarm hits`. On Windows it replaces the cache file by default; on Linux it works beside the cache file. It has no effect with the per-shader cache files of `SHARPEMU_VK_PIPELINE_CACHE_SHARDS`. | `VulkanVideoPresenter.ShaderPrewarm.cs`, `ShaderPrewarmList.cs`, `ShaderProgramCache.cs` |
| `SHARPEMU_SKIP_ALL_COMPUTE` | `1` | Set to `1` to make the Metal presenter skip all compute dispatches. The Vulkan presenter reads the value but does not use it. The default is off. | `MetalVideoPresenter.Compute.cs`, `VulkanVideoPresenter.cs` |
| `SHARPEMU_SKIP_TALL_COMPUTE_Z` | number | Effect not clear from the code. The Vulkan presenter reads the number into a field for a minimum Z group count. No code uses that field. The default is 0. | `VulkanVideoPresenter.cs` |
| `SHARPEMU_SRT_NATIVE` | `0` | `0` turns off the compiled shader resource (SRT) evaluator. By default, the resource plan of each shader is compiled once to .NET code (`DynamicMethod`) on a low-priority background thread named `SRT compiler`; until it is ready, the plan is evaluated by the interpreter, so the first use of a new shader does not wait for the compilation. With `0`, every plan always uses the interpreter. The compiled path is also off when the runtime does not support dynamic code, for example in a Native AOT build. | `CompiledResourceEvaluator.cs`, `ShaderResourcePlan.cs`, `RuntimeValueEvaluator.cs` |
| `SHARPEMU_SUSPEND_POINTS_IN_FLIGHT` | `0` | `0` makes `sceAgcSuspendPoint` wait until the frame boundary it queued is processed. The default lets one boundary wait behind the graphics commands, so the guest CPU can run one frame ahead. A wait that follows its own queue's store to the same label still sees that value when the title rewrites the label for the next frame (Dead Cells). | `CommandStreamQueue.cs`, `GpuCommandInterpreter.cs` |
| `SHARPEMU_VK_DEBUG_LABELS` | `1` | Turns on Vulkan object names and command labels for capture tools. `SHARPEMU_VK_VALIDATION=1` also turns them on. Default is off because the labels add overhead to each draw. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_VK_DEVICE` | text (part of a device name) | Selects the Vulkan device whose name contains this text. The comparison ignores case. When unset, the presenter gives a score to each device and prefers a discrete GPU. | `VulkanVideoPresenter.Device.Setup.cs`, `VulkanVideoPresenter.cs` |
| `SHARPEMU_VK_PIPELINE_CACHE_PATH` | path | Sets the path of the Vulkan pipeline cache file. The path can contain environment variables. Default is `user/pipeline_cache/<title id>/` below the application directory. The shader prewarm list goes to the same directory. With the per-shader cache, the files go to a `.shards` directory next to this path. | `VulkanVideoPresenter.Device.Setup.cs`, `VulkanPipelineCacheStorage.cs` |
| `SHARPEMU_VK_PIPELINE_CACHE` | `0`, `1` or `file` | Selects the Vulkan pipeline cache file, which keeps the driver's compiled pipelines. `1` or `file` saves and loads one cache file. `0` keeps the cache in memory only on every system. The default is memory only on Windows: the GPU driver keeps its own shader cache on disk, and the shader prewarm list (`SHARPEMU_SHADER_PREWARM`) rebuilds it after an update. Linux keeps a cache file by default, and macOS keeps per-shader files. | `VulkanVideoPresenter.Device.Setup.cs` |
| `SHARPEMU_VK_PIPELINE_CACHE_SHARDS` | `1` or `0` | `1` keeps one Vulkan pipeline cache file for each compute shader and for each vertex and pixel shader pair, in `vulkan-pipeline-cache.bin.shards`, also on Windows. `0` keeps the whole cache in one file. The default is `1` on macOS and `0` on other systems: NVIDIA adds about 2 MB of driver data to every cache file, so a file for each shader uses much more disk. A shard file loads when its pipeline is first created, and a save writes only the files that got new pipelines. The shard mode removes the old single file when `SHARPEMU_VK_PIPELINE_CACHE_PATH` is not set. A cache file that grows over 256 MiB is emptied, so the next launch starts it again. | `VulkanVideoPresenter.Device.Setup.cs`, `VulkanVideoPresenter.PipelineCacheShards.cs` |
| `SHARPEMU_VK_PIPELINE_CACHE_LEGACY_SHARDS` | `1` | `1` names the per-shader cache files by the guest shader hash. The default names them by a hash of the translated SPIR-V, so a translator change does not load records that no longer match. | `VulkanVideoPresenter.PipelineCacheShards.cs` |
## Metal
These variables apply to the Metal backend.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_GPU_DETILE` | `0` | The Metal backend decodes supported tiled texture data on the GPU by default. Set `0` to decode all tiled textures on the CPU. | `MetalTextureSnapshots.cs`, `GuestGpuTypes.cs` |
| `SHARPEMU_LOG_GPU_DETILE` | `1` | Writes each texture tile mode and each GPU detile decision one time to stderr. It applies to the Metal texture path only. The emulator reads the value one time at start. | `MetalTextureSnapshots.cs` |
| `SHARPEMU_METAL_CAP_DRAWABLE` | `1` | Limits the long edge of the Metal drawable to 1920 pixels and keeps the aspect ratio. The default is off, so the drawable uses the full window pixel size. | `MetalVideoPresenter.cs` |
| `SHARPEMU_METAL_DBG` | `solid` or `uv` | Replaces the Metal present fragment shader with a test shader. `solid` shows a green frame. `uv` shows the value of vertex attribute 0. All other values use the normal present shader. | `MetalVideoPresenter.cs` |
| `SHARPEMU_METAL_FULL_DRAWABLE` | `1` | Cancels `SHARPEMU_METAL_CAP_DRAWABLE=1`, so the Metal drawable uses the full window pixel size. It has no effect when the cap is off. | `MetalVideoPresenter.cs` |
| `SHARPEMU_NO_TEXTURE_SKIP` | `1` | Stops the reuse of cached texture snapshots in the Metal backend, so each texture is copied again. Use it to make sure that a snapshot is not stale. The default is off. | `MetalTextureSnapshots.cs` |
| `SHARPEMU_REUSE_GUEST_TEXTURE_SNAPSHOTS` | `0` | The default is on. The Metal backend uses a guest texture snapshot again when the snapshot key is the same. Set to `0` to make a new snapshot each time. | `MetalTextureSnapshots.cs` |
| `SHARPEMU_TEXTURE_DUMP_DIR` | path | Set a directory to make the Metal backend write raw texture source bytes to `.bin` files. The file name contains the address, size, pitch, format and tile mode. The limit is 200 files. | `MetalTextureSnapshots.cs` |
| `SHARPEMU_TEXTURE_LINEAR_DUMP_DIR` | path | Set a directory to make the Metal backend write the linear texture bytes to `.linear.bin` files. The file name contains the address, size, pitch, format and tile mode. The limit is 200 files. | `MetalTextureSnapshots.cs` |
| `SHARPEMU_TRACE_STORAGE_IMAGE_INIT_ADDRESS` | hex address | The Metal backend writes an `agc.storage_initial_data` trace line when it makes the texture at this guest address. The line shows the upload state and the read result of the initial data. | `MetalTextureSnapshots.cs` |
## Audio and video
These variables apply to audio output and video playback.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_ALSA_DEVICE` | text (ALSA device name) | Sets the ALSA playback device on Linux. The default is `default`. | `PosixAlsaAudioStream.cs` |
| `SHARPEMU_AUDIO_LATENCY_MS` | number (milliseconds) | Sets the target depth of the SDL audio queue, which is the playback latency. The default is 60. Values of zero or less use the default. | `SdlHostAudio.cs` |
| `SHARPEMU_BINK_MODE` | text (`native`, `ffmpeg`, `dummy`, `skip`, `guest`) | Selects how the emulator handles Bink movies. `native` or `ffmpeg` decodes on the host and is the default. `dummy` shows a placeholder frame, `skip` skips the movie, and `guest` lets the guest decode. | `HostMovieBridge.cs` |
| `SHARPEMU_LOG_MOVIE_SYNC` | `1` | Records the difference between the movie clock and the guest audio position during movie playback. The emulator reads the value one time at start. | `MediaFramePlayback.cs` |
| `SHARPEMU_MOVIE_CLOCK` | `wall` | Sets the time base for host-decoded movie playback. By default, playback follows the guest audio clock and uses the wall clock when no guest audio flows. `wall` makes playback always use the wall clock. | `MediaFramePlayback.cs` |
| `SHARPEMU_TRACE_AVPLAYER_IMAGES` | `1` | Set to `1` to write `[AVPLAYER][TRACE]` lines for video buffer addresses and the first 16 video frame payloads. It also marks the video buffer ranges for image traces in other components. The default is off. | `AvPlayerExports.cs` |
## Input
These variables apply to the controller and input libraries.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_AUTO_CROSS` | list (seconds, for example `40,52,64`) | Presses the Cross button for 0.4 seconds at each time in the list. The times are seconds from process start. The default is no automatic press. | `PadExports.cs` |
| `SHARPEMU_BTHID_CB_FAIL` | text (`nf` or `ni`) | Makes `sceBluetoothHidRegisterCallback` return an error. `nf` returns NOT_FOUND and `ni` returns NOT_IMPLEMENTED. The default returns the usual result. | `BluetoothHidExports.cs` |
| `SHARPEMU_BTHID_EVENT_CODE` | number (decimal or `0x` hex) | Sets the event code of the synthetic Bluetooth HID callback event. The default is 0. It has an effect only with `SHARPEMU_BTHID_FIRE_CALLBACK=1`. | `BluetoothHidExports.cs` |
| `SHARPEMU_BTHID_EVENT_SIZE` | number (bytes, decimal or `0x` hex) | Sets the size of the zeroed event structure for the synthetic Bluetooth HID callback. The default is 256. It has an effect only with `SHARPEMU_BTHID_FIRE_CALLBACK=1`. | `BluetoothHidExports.cs` |
| `SHARPEMU_BTHID_FIRE_CALLBACK` | `1` | Calls the registered Bluetooth HID guest callback one time with a zeroed event structure. The call occurs at the first `sceBluetoothHidRegisterDevice`. The default is off. | `BluetoothHidExports.cs` |
## Memory and CPU
These variables apply to guest memory and guest code execution.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_DISABLE_GUEST_ALLOCATOR_HOLE_RECOVERY` | `1` | Stops the Windows fault recovery for a guest allocator that reads an empty pool node. The default recovers the fault and continues at the allocator fallback code. | `DirectExecutionBackend.Exceptions.cs` |
| `SHARPEMU_DISABLE_MITIGATION_RELAUNCH` | `1` | Stops the Windows relaunch of the emulator as a child process with Control Flow Guard and CET shadow stacks off. The default starts the child process. | `Program.cs`, `SelfLoader.cs` |
| `SHARPEMU_DISABLE_NATIVE_GUEST_WORKERS` | `1` | Stops the use of native worker threads for guest thread execution on Windows. The default uses the native workers. | `DirectExecutionBackend.NativeWorker.cs` |
| `SHARPEMU_DISABLE_POSIX_SIGNALS` | `1` | Does not install the POSIX signal handlers on Linux and macOS. The emulator then cannot recover guest faults. | `DirectExecutionBackend.PosixSignals.cs` |
| `SHARPEMU_DISABLE_RAW_HANDLER` | `1` | Does not install the raw vectored exception handler on Windows. On POSIX hosts it stops the raw sentinel recovery. The default keeps the two functions on. | `DirectExecutionBackend.Exceptions.cs`, `DirectExecutionBackend.PosixSignals.cs` |
| `SHARPEMU_IGNORE_INT41` | `0` or `false` | The fault handler skips guest `int 0x41` instructions and continues at the next instruction by default. Set `0` or `false` to stop this recovery. The emulator shows a warning for the first 16 traps and then for each 65536th trap. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Exceptions.cs` |
| `SHARPEMU_IGNORE_STACK_CHK` | `1` | Recovers from a guest stack-protector failure call (NID `Ou3iL1abvng`) when a UD2 instruction follows the call. The emulator sets the return address to the function epilogue 20 bytes before. It does this only when the code bytes match the known pattern. | `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LAZY_RESERVE_PRIME_MB` | number | Sets the number of megabytes that the emulator commits at the start of each reserve-only memory region. The default is 64 and the maximum is 4096. The value 0 turns the initial commit off. | `PhysicalVirtualMemory.cs` |
| `SHARPEMU_NATIVE_WORKER_MAX_CONCURRENT` | number | Sets the maximum number of native guest worker runs that execute at the same time. The default is 2. The emulator limits the value to the range 1 to 64. | `DirectExecutionBackend.NativeWorker.cs`, `DirectExecutionBackend.cs` |
| `SHARPEMU_GUEST_AFFINITY` | `1` | Applies the guest thread affinity to the host threads. The default leaves host threads unpinned, because pinning let spinning guest workers starve the render thread. | `DirectExecutionBackend.cs` |
| `SHARPEMU_RENDER_CORE` | `0` | `0` turns off the render core reservation. On Windows hosts with 8 to 64 logical processors, the default gives the render thread the last physical core of the fastest efficiency class with a high priority, and keeps guest threads off that core. | `HostLaneReservation.cs`, `VulkanVideoPresenter.Present.cs`, `DirectExecutionBackend.cs` |
| `SHARPEMU_RESERVED_HOST_LANES` | number | Set the number of host logical processors that guest thread affinity does not use. The emulator keeps these processors for its own threads. The default is three eighths of the processor count, with a minimum of 2. It has an effect only with `SHARPEMU_GUEST_AFFINITY=1`. | `DirectExecutionBackend.cs` |
| `SHARPEMU_TSC_FREQ_HZ` | number (Hz, minimum 1000000) | Sets the TSC frequency that the kernel library reports to the guest. When unset, the emulator uses the calibrated RDTSC frequency, then the CPUID frequency, then the host stopwatch frequency. | `KernelRuntimeCompatExports.cs` |
| `SHARPEMU_WATCH_BULK_DEST_HI` | hex number | Limits the `SHARPEMU_WATCH_BULK_TORN` scan to writes whose upper 32 address bits equal this value. When unset, the scan uses the direct-memory address band. | `GuestWriteWatch.cs` |
| `SHARPEMU_WATCH_BULK_TORN` | `1` | Examines each aligned 8-byte value in managed bulk writes to guest memory. It reports torn values and shifted pointer values with a stack trace. It writes a maximum of 64 reports for each kind. | `GuestWriteWatch.cs` |
| `SHARPEMU_WATCH_POOL_HEADER` | `1` | Monitors the header slot at offset 0x40 of each pool mapping with size 0x10000 and protection 0xF2. It reports each managed write to a monitored slot with a stack trace. It monitors a maximum of 64 slots. | `GuestWriteWatch.cs` |
| `SHARPEMU_WATCH_VALUE1` | `1` | Reports managed writes of 1 to 8 bytes that have the value 1 and go to the direct-memory address band. Each report has a stack trace. It writes a maximum of 128 reports. | `GuestWriteWatch.cs` |
| `SHARPEMU_WATCH_VALUE_PATTERN` | `1` | Reports each managed 8-byte write whose low half is 1 and whose high half is between 1 and 0xFFFF. Each report has a stack trace. | `GuestWriteWatch.cs` |
| `SHARPEMU_WATCH_WRITE` | hex address | Monitors the 8 bytes at this guest address. It reports each managed write that touches these bytes with the address, the length, the first value, and a stack trace. Default is off. | `GuestWriteWatch.cs` |
## Loader
These variables apply to the program loader and the module system.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_AMPR_INDEX_CACHE` | path (directory) | Sets the directory for the AMPR file index cache. The default is `SharpEmu/ampr-index` in the local application data folder. | `AmprFileRegistry.cs` |
| `SHARPEMU_AMPR_REINDEX` | `1` | Ignores the AMPR index cache on disk and scans the application file tree again. Use it after manual changes to the application files. | `AmprFileRegistry.cs` |
| `SHARPEMU_APP0_DIR` | path (directory) | Sets the host directory for the guest `/app0` mount. The default is the directory of the loaded executable. The directory name also identifies the per-application data folders. | `SharpEmuRuntime.cs`, `KernelMemoryCompatExports.cs`, `AppContentExports.cs` |
| `SHARPEMU_DEVLOG_APP_DIR` | path (directory) | Sets the host directory for the guest devlog application path. The default is `user/game_logs/<title id>/devlog/app` below the emulator directory. | `KernelMemoryCompatExports.cs` |
| `SHARPEMU_DISABLE_RED_ZONE_PATCH` | `1` | Stops the load-time patch that protects the guest stack red zone on Windows and macOS. The default applies the patch. The vector store split for Rosetta stays on when it is necessary. | `GuestRedZonePatcher.cs` |
| `SHARPEMU_DOWNLOAD0_DIR` | path (directory) | Sets the host directory for the guest `/download0` mount. The default is a `download0` folder in the per-application writable directory. The emulator sets the variable to the default when it is not set. | `KernelMemoryCompatExports.cs` |
| `SHARPEMU_GUEST_ARGS` | text | Adds arguments to the guest process entry frame after the image name. White space divides the arguments. The emulator uses only the first two. | `CpuDispatcher.cs` |
| `SHARPEMU_HOSTAPP_DIR` | path | Sets the host directory for the guest `/hostapp` mount. The default is `user/game_logs/<title id>/hostapp` below the emulator directory. The emulator makes the directory if it is absent. | `KernelMemoryCompatExports.cs`, `KernelGameLogPathTests.cs` |
| `SHARPEMU_LLE_LIBC_ALL` | `1` | Sends all libc imports to the guest libc module and not to the HLE handlers. `SHARPEMU_DISABLE_LLE_LIBC=1` and `SHARPEMU_LLE_LIBC_SAFE_ONLY=off` have priority. Default is off. | `DirectExecutionBackend.cs` |
| `SHARPEMU_LLE_LIBC_SAFE_ONLY` | `1`, `0`, `off`, `false` or `none` | Controls which libc imports use the guest libc module. Unset or `1` uses guest code only for exports on the safe list. `0` uses guest code for all libc exports, and `off`, `false` or `none` uses HLE for all of them. | `DirectExecutionBackend.cs` |
| `SHARPEMU_PRELOAD_ALL_SCE_MODULES` | `1` | Set to `1` to preload all system modules. When unset, the runtime does not preload the modules in its internal skip list. | `SharpEmuRuntime.cs` |
## Debugger
These variables apply to the debug server.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_SENTINEL_PROBE` | `1` | Set to `1` to call the native entry stub with the unresolved sentinel address 0xFFFE before the guest entry. The emulator writes a log line before and after the call. The default is off. | `DirectExecutionBackend.cs`, `Gen5NativeReturnSmokeTests.cs` |
## Log channels
Each variable adds one group of messages to the log. The default is off.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_LOG_ACM` | `1` | Writes `acm.` trace lines from the Acm library handlers to stderr. Default is off. | `AcmExports.cs` |
| `SHARPEMU_LOG_AGC_SHADER` | `1` | Writes only the AGC shader trace lines and the Vulkan shader trace lines. `SHARPEMU_LOG_AGC=1` also turns this on. Default is off. | `AgcExports.cs`, `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_LOG_AGC` | `1` | Starts the full AGC trace: command submissions, shader creation, draws and dispatches. It also turns on the AGC shader trace and the Vulkan shader trace. Default is off. | `AgcExports.cs`, `RenderExecutor.Trace.cs`, `AgcExports.ShaderState.cs` |
| `SHARPEMU_LOG_AJM` | `1` | Writes `ajm.` trace lines to stderr: context initialization, codec registration, split buffer descriptors and ATRAC9 decode state. Default is off. | `AjmExports.cs`, `Atrac9DecodeState.cs` |
| `SHARPEMU_LOG_ALLOC_IMPORTS` | `1` | Writes more trace lines for `sceKernelGetGPI` (the returned mask) and for the PRT aperture set call (the raw register values). Default is off. | `KernelRuntimeCompatExports.cs` |
| `SHARPEMU_LOG_ALL_IMPORTS` | `1` | Writes a debug line for each import stub during setup. The lines show if the import uses a direct bridge, a trampoline, HLE or a runtime symbol. Default is off. | `DirectExecutionBackend.cs` |
| `SHARPEMU_LOG_AMPR_READS` | `1` | Writes only the AMPR file read trace lines and the pak directory tracker lines. `SHARPEMU_LOG_AMPR=1` also turns this on. Default is off. | `AmprExports.cs`, `PakDirectoryTracker.cs` |
| `SHARPEMU_LOG_AMPR` | `1` | Writes trace lines for AMPR command buffers, APR submissions and waits, and the pak directory tracker. It also turns on the AMPR read trace. Default is off. | `AmprExports.cs`, `KernelAprCompatExports.cs`, `PakDirectoryTracker.cs` |
| `SHARPEMU_LOG_APP_CONTENT` | `1` | Writes an `app_content` trace line to stderr for each AppContent call. The default is off. | `AppContentExports.cs` |
| `SHARPEMU_LOG_AUDIO_OUT2` | `1` | Writes an `audio_out2` trace line to stderr for each AudioOut2 operation. The default is off. | `AudioOut2Exports.cs` |
| `SHARPEMU_LOG_AUDIO_OUT` | `1` | Records `sceAudioOutOutput` calls and the peak amplitude of the submitted samples. It writes the first 8 calls and then every 200th call. The emulator reads the value one time at start. | `AudioOutExports.cs` |
| `SHARPEMU_LOG_BOOTSTRAP` | `1` | Writes a trace line for each call through the bootstrap bridge import. The line shows the handle, the symbol name and the output address. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_CONTEXT` | `1` | Writes `guest_context` trace lines to stderr. Each import dispatch shows the NID, the return address, the managed thread, the guest thread and the fiber. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_DATA_REBIND` | `1` | Writes one `[RUNTIME]` line for each imported data relocation. The line shows if the relocation is rebound, unresolved or write-failed. | `SharpEmuRuntime.cs` |
| `SHARPEMU_LOG_DISCMAP` | `1` | Writes a trace line for each DiscMap call. The line shows the export name, the path, the offset and the size. | `DiscMapExports.cs` |
| `SHARPEMU_LOG_DISCORD` | `1` | Writes `[DISCORD]` messages from the rich presence client of the GUI to stderr. The default is off. | `DiscordRichPresence.cs` |
| `SHARPEMU_LOG_DLSYM` | `1` | Writes a trace line for each successful `sceKernelDlsym` call. The line shows the module handle, the symbol name and the resolved address. | `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_EQUEUE` | `1` | Writes trace lines for kernel event queue operations. The emulator reads the value one time at start. | `KernelEventQueueCompatExports.cs` |
| `SHARPEMU_LOG_EVENT_FLAG` | `1` | Writes trace lines for kernel event flag operations. The emulator reads the value one time at start. | `KernelEventFlagCompatExports.cs` |
| `SHARPEMU_LOG_EXPECTED_IMPORT_RESULTS` | `1` | Shows import error results that the emulator knows as usual, for example file-not-found probes, timeouts and busy trylocks. It shows the first 8 results for each NID and result, and then every 10000th. The default hides these results. | `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_FIBER` | `1` | Writes `fiber` trace lines for the Fiber library calls. It also writes a line for each fiber context transfer in the CPU backend. | `FiberExports.cs`, `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_FILE` | path | Writes all log entries to this file with timestamps and appends to an existing file. The file receives every log level. `SHARPEMU_LOG_LEVEL` then limits only the console output. | `SharpEmuLog.cs` |
| `SHARPEMU_LOG_FMOD` | `1` | Writes a trace line for the FMOD `system_set_output` compatibility call. The line shows the system address, the output type and the call count. | `FmodCompatExports.cs` |
| `SHARPEMU_LOG_GUARDS` | `1` | Writes a trace line for each C++ static guard operation. The line shows the guard address, the guard word, the state flags and the owner thread. | `CxxAbiExports.cs` |
| `SHARPEMU_LOG_GUEST_EXCEPTIONS` | `1` | Writes `guest_exception` trace lines when the emulator raises and delivers a guest exception. The lines show the target thread and the exception type. | `DirectExecutionBackend.cs`, `KernelExceptionCompatExports.cs` |
| `SHARPEMU_LOG_GUEST_THREADS` | `1` | Writes guest thread scheduler messages to stderr. The messages show thread state changes, yields, wakes, exits, nested callbacks and affinity failures. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs`, `KernelRuntimeCompatExports.cs` |
| `SHARPEMU_LOG_GUEST_THREAD_SNAPSHOTS` | `1` | Writes one snapshot line for each guest thread every second. The line shows the state, the import count, the last NID, the last return address and the block reason. The ready-dispatch thread then wakes every second. | `DirectExecutionBackend.cs` |
| `SHARPEMU_LOG_HTTP2` | `1` | Writes an `http2` trace line for each Http2 library call. The line shows the operation, the id and four arguments. | `Http2Exports.cs` |
| `SHARPEMU_LOG_HTTP` | `1` | Writes an `http` trace line for each Http library call. The line shows the operation, the id and four arguments. | `HttpExports.cs` |
| `SHARPEMU_LOG_IO_FILTER` | text | Limits the `SHARPEMU_LOG_IO` output to paths that contain this text. The comparison ignores case. When unset, the emulator shows all paths. | `KernelMemoryCompatExports.cs` |
| `SHARPEMU_LOG_JSON` | `1` | Writes a `json` trace line for each Json library call. Text values show a maximum of 128 characters. | `JsonExports.cs` |
| `SHARPEMU_LOG_LAZY_COMMIT` | `1` | Writes a trace line for every lazy memory commit fault. The default shows only the first 16 faults and then every 256th fault. | `DirectExecutionBackend.Exceptions.cs` |
| `SHARPEMU_LOG_LEVEL` | text | Sets the minimum log level. The values are `Trace`, `Debug`, `Info`, `Warning` or `Warn`, `Error`, `Critical` or `Fatal`, and `None`. The default is `Info`, and the comparison ignores case. | `SharpEmuLog.cs` |
| `SHARPEMU_LOG_LIBC_ALLOC` | `1` | Writes a trace line for each guest libc allocation call. The line shows the size, the alignment, the result address and the return address of the caller. | `KernelMemoryCompatExports.cs` |
| `SHARPEMU_LOG_NET` | `1` | Writes `net` trace lines for Net library calls and debug lines for kernel socket operations. It also writes each payload that the guest sends on a connected socket to stdout as text. | `NetExports.cs`, `KernelSocketCompatExports.cs` |
| `SHARPEMU_LOG_NGS2` | `1` | Writes trace lines for Ngs2 audio library calls. The default is off. | `Ngs2Exports.cs` |
| `SHARPEMU_LOG_NO_COLOR` | `1` | Stops the use of colors in the console log. The values `1`, `true`, `yes` and `on` are accepted. The console log has no colors when the output is redirected. | `SharpEmuLog.cs` |
| `SHARPEMU_LOG_NP_WEB_API2` | `1` | Writes an `npwebapi2` trace line for each NpWebApi2 call. The line shows the operation, the id, the first argument and the initialized state. | `NpWebApi2Exports.cs` |
| `SHARPEMU_LOG_OPEN` | `1` | Writes trace lines for guest file open operations to stderr. The default is off. | `KernelMemoryCompatExports.cs` |
| `SHARPEMU_LOG_PLAYGO` | `1` | Writes `playgo` trace lines for PlayGo calls. For single-entry locus queries it shows the first 32 calls and then every 1000th call. | `PlayGoExports.cs` |
| `SHARPEMU_LOG_POINTER_WINDOW_SIZE` | hex number | Sets the byte size of each memory window that `SHARPEMU_LOG_POINTER_WINDOWS` shows after a guest fault. The value is hexadecimal, with or without `0x`. The default is 0x80. | `DirectExecutionBackend.Exceptions.cs` |
| `SHARPEMU_LOG_POSIX_SIGNALS` | `1` | Writes a trace line for every POSIX signal that the fault handler receives. When unset, the log shows only the first 16 signals and then every 1024th signal. | `DirectExecutionBackend.PosixSignals.cs` |
| `SHARPEMU_LOG_PROC_PARAM_PTRS` | `1` | Shows the pointer fields in the process parameter block. This dump is part of the `SHARPEMU_LOG_PROC_PARAM` trace, so set that variable also. | `KernelRuntimeCompatExports.cs` |
| `SHARPEMU_LOG_PROC_PARAM` | `1` | Shows the address and the contents of the process parameter block of the guest program. The default is off. | `KernelRuntimeCompatExports.cs` |
| `SHARPEMU_LOG_PS5_USER_SLOTS` | `1` | Adds four 0x60-byte memory dumps to the IL2CPP exception diagnostic. The dumps start at the fixed guest address 0x801A73110 and have a step of 0x51C8 bytes. | `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_PSML` | `1` | Writes `psml.` trace lines for the PSML library calls to stderr. The default is off. | `PsmlExports.cs` |
| `SHARPEMU_LOG_PTHREADS` | `1` | Writes trace lines for the pthread calls of the guest. It also starts the condition variable trace of `SHARPEMU_LOG_PTHREAD_CONDS`. The default is off. | `KernelPthreadCompatExports.cs`, `KernelExports.cs` |
| `SHARPEMU_LOG_PTHREAD_CONDS` | `1` | Writes a `pthread_cond_` trace line for each condition variable operation. The line shows the waiter count, the signal epoch, and the result. | `KernelPthreadCompatExports.cs` |
| `SHARPEMU_LOG_PTHREAD_FASTPATH` | `1` | Writes trace lines for the mutex fast path. It shows the first 16 fast-path unlocks with the mutex object words. It shows one busy result for each mutex address. | `KernelPthreadCompatExports.cs` |
| `SHARPEMU_LOG_PTHREAD_MUTEX_FILTER` | list of hex addresses | Limits the mutex trace to the given mutex addresses. Use a comma, a semicolon, or a space between the hexadecimal addresses. The listed mutexes are in the trace even if `SHARPEMU_LOG_PTHREADS` is not set. | `KernelPthreadCompatExports.cs` |
| `SHARPEMU_LOG_REFSCAN_ADDRS` | list of hex addresses | After a guest fault, scans executable guest memory from 0x800000000 to 0x810000000 for instructions that refer to the given addresses. It shows a maximum of 24 hits for each address. Use a comma between the hexadecimal addresses. | `DirectExecutionBackend.Exceptions.cs` |
| `SHARPEMU_LOG_REGISTER_WINDOWS` | `1` | After a guest fault, shows a 0x80-byte memory window at each general register value that is 0x10000 or more. The default is off. | `DirectExecutionBackend.Exceptions.cs` |
| `SHARPEMU_LOG_SAVEDATA` | `1` | Writes `savedata.` and `save_data_dialog.` trace lines for the save data calls to stderr. The default is off. | `SaveDataExports.cs`, `SaveDataDialogExports.cs` |
| `SHARPEMU_LOG_SEMA` | `1` | Writes trace lines for the kernel semaphore operations. The emulator reads the value one time at start. The default is off. | `KernelSemaphoreCompatExports.cs` |
| `SHARPEMU_LOG_SHARE` | `1` | Writes `share.` trace lines for the Share library calls to stderr. The default is off. | `ShareExports.cs` |
| `SHARPEMU_LOG_SSL` | `1` | Writes an `ssl.` trace line for each SSL library call. The line shows the operation, the identifier, and the first argument. | `SslExports.cs` |
| `SHARPEMU_LOG_STACK_CHK` | `1` | Writes diagnostic lines when the guest calls the stack check failure import. The lines show the return address, the guard registers, and the stack slots from rbp-0x10 to rbp-0x80. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_STDIO` | `1` | Writes trace lines for the libc stdio calls of the guest. The emulator reads the value one time at start. The default is off. | `LibcStdioExports.cs` |
| `SHARPEMU_LOG_STRLEN_BURSTS` | `1` | Writes a warning when the guest calls `strlen` 24 times in sequence. The warning shows the return address and the last five different imports before the burst. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_STRLEN` | `1` | Keeps `strlen` calls in the import trace. When unset, the import trace does not show `strlen` calls. It also starts the burst detection of `SHARPEMU_LOG_STRLEN_BURSTS`. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_THREAD_MODE` | `1` | Writes `[THREADMODE]` lines when a native guest worker thread is created, starts a guest run, and stops a guest run. Each line shows the host thread identifiers. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.NativeWorker.cs` |
| `SHARPEMU_LOG_USER_SERVICE` | `1` | Writes trace lines for the user service library calls. Each line includes the guest return address of the call. | `UserServiceExports.cs` |
| `SHARPEMU_LOG_USLEEP` | `1` | Writes trace lines for `usleep` calls: the first 32 calls and then every 10000th call. It also stops the native inline `usleep` stub and the leaf import path, so each call goes through the traced handler. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs`, `KernelRuntimeCompatExports.cs` |
| `SHARPEMU_LOG_VIDEOOUT_FPS` | `1` | Writes periodic frame rate lines with flip, present, draw, pipeline, and buffer pool counts. `SHARPEMU_PROFILE_PERFORMANCE=1` starts the same output. | `VideoOutExports.cs` |
| `SHARPEMU_LOG_VIDEOOUT` | `1` | Writes `videoout.` trace lines for the video output calls, such as flip events and frame dumps. The default is off. | `VideoOutExports.cs` |
| `SHARPEMU_LOG_VK_RESOURCES` | `1` | Writes a `vk.global_buffer` trace line one time for each new guest buffer that the Vulkan presenter binds. The line shows the base address and the size. | `VulkanVideoPresenter.Draws.Recording.cs`, `VulkanVideoPresenter.GuestBuffers.cs` |
| `SHARPEMU_LOG_VMEM` | `1` | Writes debug lines for guest virtual memory operations and `[HOSTMEM]` lines for host memory operations. The default is off. | `PhysicalVirtualMemory.cs`, `HostMemory.cs`, `PosixHostMemory.cs` |
| `SHARPEMU_LOG_WIDE_PRINTF_ARGS` | `1` | Writes trace lines for the arguments of printf format calls, such as string arguments. Use `SHARPEMU_LOG_WIDE_PRINTF_FILTER` to limit the output. | `KernelMemoryCompatExports.cs` |
| `SHARPEMU_LOG_WIDE_PRINTF_FILTER` | text | Limits the `SHARPEMU_LOG_WIDE_PRINTF_ARGS` trace to format strings that contain this text. The comparison is case-sensitive. When unset, the trace includes all format strings. | `KernelMemoryCompatExports.cs` |
| `SHARPEMU_LOG_WIDE_PRINTF` | `1` | Writes a trace line for each wide-character printf call. The line shows the first 160 characters of the format and of the result. | `KernelMemoryCompatExports.cs` |
| `SHARPEMU_LOG_WIDE` | `1` | Shows the first 32 bytes at the string address for each `wcslen` call. The default is off. | `KernelMemoryCompatExports.cs` |
| `SHARPEMU_PERIODIC_SNAPSHOT_SECONDS` | number (seconds) | Set a number of seconds to write the stall watchdog snapshot at that interval. The default is 0, which writes no periodic snapshot. The stall watchdog must be on. | `DirectExecutionBackend.cs` |
## Traces
Each variable records a detailed sequence of events. Traces can be large.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_LOG_IMPORT_FILTER` | text | Writes a trace line for each import that contains this text. The emulator compares the text with the library name, the export name and the NID, and ignores case. When unset, the filter selects no imports. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_IMPORT_FRAMES` | `1` | Adds the guest frame chain to each traced import. It applies only to imports that `SHARPEMU_LOG_ALL_IMPORTS` or `SHARPEMU_LOG_IMPORT_FILTER` selects. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_IMPORT_PERIODIC` | `1` | Starts the periodic import trace. It shows the early import bands and every 100000th import dispatch. The default is off because the stderr output decreases the speed. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_IMPORT_RECENT` | `1` | Writes the recent import history after each traced import. It applies only to imports that `SHARPEMU_LOG_ALL_IMPORTS` or `SHARPEMU_LOG_IMPORT_FILTER` selects. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_PROBE_IMPORT_RET_ADDRESS` | hex address | Set a guest return address. When an import call returns to this address, the emulator writes an `import-return-address-probe` line with the thread, NID, stack and frame values. The limit is 2048 lines. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_PROBE_IMPORT_RET` | text (NID or `*`) | Set an import NID, or `*` for all imports. For the first 8 applicable import calls, the emulator writes the bytes and the disassembly before the return address. The default is off. | `DirectExecutionBackend.cs`, `DirectExecutionBackend.Imports.cs`, `DirectExecutionBackend.Diagnostics.cs` |
| `SHARPEMU_RTC_PROBE_RANGE` | hex address range (`start-end`) | Set a range of guest addresses. When a caller of `sceRtcGetCurrentTick` returns into this range, the emulator writes 0x100 bytes of code near that return address. It does this one time only. | `RtcExports.cs` |
| `SHARPEMU_TRACE_AGC_EQ_ACCESSORS` | `1` | Set to `1` to write an `agc.eq_accessor` line for calls to the AGC event accessor functions. Each line shows the accessor, the event address, the result and the event bytes. After 64 lines, the emulator writes only at power-of-two counts. | `AgcExports.Events.cs` |
| `SHARPEMU_TRACE_DCC_WRITERS` | `1` | Writes a `[GPU][DCC_WRITER]` line with the shader program and a call stack for each GPU buffer write that overlaps DCC metadata. It also writes `[GPU][BOUNDED_FILL_REFUSED]` lines when a fill shader is not changed into a buffer fill. Each kind writes a maximum of 64 lines. | `DccWriterTrace.cs` |
| `SHARPEMU_TRACE_FOCUSED_CONTINUATION` | `1` | Set to `1` to write `focused_continuation` lines for guest thread continuations. The emulator writes a line only when the stack pointer is in the range 0x6FFFAC000000 to 0x6FFFAC200000. | `DirectExecutionBackend.cs` |
| `SHARPEMU_TRACE_FRAME_PACKETS` | `1` | Writes a `[FRAMEPKT]` line at a flip with the draw count and the dispatch count of the frame. It shows the first 8 flips, each 60th flip, and each flip that has no draws. Default is off. | `AgcExports.CommandStream.cs` |
| `SHARPEMU_TRACE_GPU_MEMORY_ADDRESS` | hex address or `auto` | Writes `[GPU][MEMORY_TRACE]` lines for GPU memory events that touch the page of the given address. The value `auto` selects the page of the first device-address fault. Default is off. | `GuestGpuMemoryHook.cs` |
| `SHARPEMU_TRACE_GPU_READS` | `1` | Writes a `[GPU][SYNC_READ]` line with the shader hash, the stage and the address when a shader resource read must wait for GPU-written memory. It writes one line for each shader and page, and a maximum of 64 lines. | `GpuReadTrace.cs`, `VulkanVideoPresenter.Pipelines.cs` |
| `SHARPEMU_TRACE_GUEST_IMAGES` | `1`, `present` or `every:N[@M]` | `1` and `present` write Vulkan present trace lines (`vk.present_taken`, `vk.present_dropped`, `vk.present_sample`) and up to 64 Metal `agc.texture_fallback` lines. The code reads the `every:N[@M]` form, but no code uses the result. Default is off. | `VulkanVideoPresenter.Draws.Recording.cs`, `VulkanVideoPresenter.Present.cs`, `MetalTextureSnapshots.cs` |
| `SHARPEMU_TRACE_GUEST_IMAGE_ADDRS` | list of hex addresses or `*` | The guest image write tracker writes `[WT][LIFETIME]` lines for each tracked range that contains a listed address. `*` selects all ranges. The Vulkan presenter also reads the list, but no code uses that filter. | `GuestImageWriteTracker.cs`, `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_TRACE_GUEST_IMAGE_FORMAT` | text (Vulkan format name) | Effect not clear from the code. The Vulkan presenter keeps the name for an image filter that compares the image format, but no code calls the filter. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_TRACE_GUEST_IMAGE_HEIGHT` | number | Effect not clear from the code. The Vulkan presenter keeps the number for an image filter that compares the image height, but no code calls the filter. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_TRACE_GUEST_IMAGE_WIDTH` | number | Effect not clear from the code. The Vulkan presenter keeps the number for an image filter that compares the image width, but no code calls the filter. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_TRACE_GUEST_MEMORY_LIFETIME` | list of source names or `*` | The guest image write tracker writes `[WT][LIFETIME]` lines for each tracked range that has a listed source name. Use a comma or a semicolon between names. `*` selects all sources. | `GuestImageWriteTracker.cs` |
| `SHARPEMU_TRACE_GUEST_WRITES` | list of hex addresses or `*` | Effect not clear from the code. The Vulkan presenter reads the list in an address filter for guest image writes, but no code calls the filter. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_TRACE_PACKED_EXPORT` | `1` | The SPIR-V translator writes `[AGC][PACKED-EXPORT]` and `[AGC][TITLE-IR]` lines for packed export analysis. It does this only for the shader program at address 0x0000000500781200. Default is off. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_TRACE_PRESENTED_GUEST_IMAGE_ADDRS` | list of hex addresses or `*` | Writes a `vk.present_sample` trace line when the presenter shows a guest image at a listed address. It records the first presentation of each address unless `SHARPEMU_TRACE_PRESENTED_GUEST_IMAGE_OCCURRENCE` is set. | `VulkanVideoPresenter.Draws.Recording.cs`, `VulkanVideoPresenter.RenderLoop.cs` |
| `SHARPEMU_TRACE_PRESENTED_GUEST_IMAGE_OCCURRENCE` | number | Selects which presentation of an address in `SHARPEMU_TRACE_PRESENTED_GUEST_IMAGE_ADDRS` the presenter records. Default is 0, which selects the first presentation. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_TRACE_TITLE_INTERFACE` | `1` | The SPIR-V translator writes `[AGC][TITLE-INTERFACE]` lines with the export and interpolation instructions of a shader. It does this only for the programs at addresses 0x0000000500780000 and 0x0000000500781200. | `Gen5SpirvTranslator.cs` |
| `SHARPEMU_TRACE_WRITER_ADDRESS` | hex address | Writes a `[GPU][TARGET_WRITER]` line with the shader program and a call stack for each GPU buffer write that covers this guest address. It writes a maximum of 64 lines. Default is off. | `DccWriterTrace.cs` |
## Data dumps
Each variable writes data to files.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_DUMP_FAULT_STACK_WINDOW` | `1` | Writes the full stack window from RSP-0x300 to RSP+0x100 to the error output when a guest fault report occurs. The default writes only the short stack list. | `DirectExecutionBackend.Exceptions.cs` |
| `SHARPEMU_DUMP_FIXED_SOLID_FRAGMENT` | path | The Vulkan presenter reads the value into a field. No code uses the field, so the variable has no effect. | `VulkanVideoPresenter.Draws.Recording.cs` |
| `SHARPEMU_DUMP_SPIRV_ADDRESS` | hex address | Limits the shader dump of `SHARPEMU_DUMP_SPIRV=1` to the shader at this guest address. The default writes all shaders. | `ShaderProgramCache.cs` |
| `SHARPEMU_DUMP_VIDEOOUT` | `1` | Writes submitted VideoOut frame buffers as BMP files with a text metadata file. It writes a maximum of 8 frames and skips a frame that did not change. | `VideoOutExports.cs`, `VideoOutExports.FlipRequests.cs` |
| `SHARPEMU_GUEST_IMAGE_DUMP_CONTINUOUS` | `1` | Writes a swapchain dump for each presented frame, not only for the first one. It needs `SHARPEMU_GUEST_IMAGE_DUMP_DIR` and an active presented-image trace. Each dump waits for the GPU, so the frame rate decreases. | `VulkanVideoPresenter.Present.Frames.cs` |
| `SHARPEMU_GUEST_IMAGE_DUMP_DIR` | path | Sets the directory for raw swapchain dumps. The presenter writes `present-NNNN-WxH-format.bgra` files there when `SHARPEMU_TRACE_GUEST_IMAGES` is `1` or `present`. The presenter makes the directory if it is absent. | `VulkanVideoPresenter.Present.Frames.cs` |
| `SHARPEMU_LOG_DISASM_ADDRS` | list of hex addresses | Adds more addresses to the fault disassembly dump. Use a comma between the addresses. The emulator uses this list only when `SHARPEMU_LOG_DISASM` is `1`, and it shows 48 instructions for each address. | `DirectExecutionBackend.Exceptions.cs` |
| `SHARPEMU_LOG_DISASM` | `1` | Writes guest disassembly to stderr when a guest fault, an abort or an illegal instruction occurs. It shows the code before the fault address, before the stack return address and before three frame return addresses. | `DirectExecutionBackend.Exceptions.cs` |
| `SHARPEMU_LOG_IL2CPP_EXCEPTION` | `1` | Writes a diagnostic dump when the guest calls the unresolved import with NID `cfwBSQyr5Ys`. The dump shows the registers, the code pointers on the stack and the frame pointer chain. The emulator writes a maximum of 4 dumps. | `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_LOG_POINTER_WINDOWS` | list of hex addresses | Writes a memory window for each address when a guest access fault occurs. Use a comma between the addresses. The window size is 0x80 bytes unless `SHARPEMU_LOG_POINTER_WINDOW_SIZE` sets a different size. | `DirectExecutionBackend.Exceptions.cs` |
| `SHARPEMU_SHADER_SPIRV_DUMP_DIR` | path | Set a directory for shader dumps. When set, the Vulkan presenter writes each SPIR-V module to a numbered `.spv` file. The `SHARPEMU_DUMP_SPIRV=1` dumps also use this directory. Their default is `shader-dumps` next to the executable. | `VulkanVideoPresenter.Pipelines.cs`, `ShaderProgramCache.cs`, `VulkanVideoPresenter.Device.Setup.cs` |
| `SHARPEMU_SWAPCHAIN_DUMP_EVERY` | number (frames) | Set a number N to trace the presented swapchain image at each Nth present. This operates only when `SHARPEMU_TRACE_GUEST_IMAGES` is `1` or `present`. The default is 0, which traces only the first presented image. | `VulkanVideoPresenter.Present.Frames.cs`, `VulkanVideoPresenter.Draws.Recording.cs` |
## Performance measurement
Each variable records timings or counts.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_LOG_AUDIO_QUEUE` | `1` | Writes one `[PERF][AUDIO]` line per second for each SDL audio stream. The line shows the queue depth in milliseconds, the submit rate, the fill percentage and the drops. The emulator reads the value one time at start. | `SdlHostAudio.cs` |
| `SHARPEMU_PERF_HLE_NODICT` | `1` | Use with `SHARPEMU_PERF_HLE=1`. Set to `1` to stop the call count dictionary and the top call count report. The dispatch time report stays on. | `DirectExecutionBackend.Diagnostics.cs` |
| `SHARPEMU_PERF_HLE` | `1` | Set to `1` to measure the time of each HLE import dispatch. After each 500000 calls, the emulator writes `[PERF][HLE]` lines with the call counts and the cost of the top exports. The default is off. | `DirectExecutionBackend.Diagnostics.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_PERF_MEM` | `1` | Set to `1` to count the POSIX fault signals that the signal handler receives. The emulator writes a `[PERF][MEM] posix_faults` line after each 100000 signals. This has an effect only on POSIX hosts. | `DirectExecutionBackend.PosixSignals.cs` |
| `SHARPEMU_PROFILE_DCB_PARSE` | `1` | Set to `1` to measure the time to parse draw command buffers. The emulator writes `[PERF][DCB_PARSE]` lines. `SHARPEMU_PROFILE_PERFORMANCE=1` also starts this profile. | `DcbParseProfile.cs` |
| `SHARPEMU_PROFILE_DCB_SUBMISSION` | `1` | Set to `1` to measure command buffer submission and geometry snapshot work. The emulator writes `[PERF][DCB_SUBMIT]`, `[PERF][VERTEX_SNAPSHOT]` and `[PERF][SNAPSHOT_PREPASS]` lines. `SHARPEMU_PROFILE_PERFORMANCE=1` also starts this profile. | `DcbSubmissionProfile.cs` |
| `SHARPEMU_PROFILE_GPU_DRAWS` | `1` | Use with the render profile. Writes a GPU timestamp after each draw and dispatch, so that the `[PERF][GPU_INTERVAL]` lines give the GPU time of each pipeline. The default writes only two timestamps for each submission for the `[PERF][GPU_BUSY]` lines, because one timestamp for each draw can change the GPU time. | `VulkanCommandProfile.cs` |
| `SHARPEMU_PROFILE_GUEST_IMAGE_TRACKER` | `1` | Set to `1` to record counters for the guest image write tracker. The emulator writes `[PERF][GUEST_IMAGE_TRACKER]` and `[PERF][GUEST_IMAGE_TRACKER_RANGE]` lines. `SHARPEMU_PROFILE_PERFORMANCE=1` also starts this profile. | `GuestImageWriteTracker.cs` |
| `SHARPEMU_PROFILE_GUEST_RIP_INTERVAL_MS` | number (milliseconds) | Set the time between samples of the guest code profiler. The value must be more than 0. The default is 2. | `DirectExecutionBackend.GuestSampler.cs` |
| `SHARPEMU_PROFILE_GUEST_RIP_REPORT_S` | number (seconds) | Set the time between reports of the guest code profiler. The value must be more than 0. The default is 15. | `DirectExecutionBackend.GuestSampler.cs` |
| `SHARPEMU_PROFILE_GUEST_RIP_THREAD` | text | Set a text filter for the guest code profiler. The profiler samples only guest threads whose name contains this text. The comparison ignores case. When unset, the profiler samples all guest threads. | `DirectExecutionBackend.GuestSampler.cs` |
| `SHARPEMU_PROFILE_GUEST_RIP` | `1` | Set to `1` to start a sample profiler for guest code. The profiler records the instruction address of each guest thread and writes `[PERF][GUEST]` reports. The default is off. | `DirectExecutionBackend.GuestSampler.cs`, `DirectExecutionBackend.Imports.cs` |
| `SHARPEMU_PROFILE_GUEST_SCHEDULER` | `1` | Set to `1` to record guest thread scheduler statistics. The emulator writes `[PERF][GUEST_SCHED]` lines. With `SHARPEMU_PROFILE_PERFORMANCE_FRAME_TRACE=1`, it also records guest thread flow events. `SHARPEMU_PROFILE_PERFORMANCE=1` also starts this profile. | `DirectExecutionBackend.GuestSchedulerProfile.cs`, `GuestThreadFlowProfile.cs` |
| `SHARPEMU_PROFILE_RENDER_REPORT_S` | number (seconds) | Set the time between render profile reports. The value can be a decimal number and must be more than 0. The default is 5. | `RenderPhaseProfile.cs` |
| `SHARPEMU_PROFILE_RENDER` | `1` | Set to `1` to measure the time of each render thread phase. The emulator writes `[PERF][RENDER]`, `[PERF][RENDER_MS]` and related lines. With `SHARPEMU_PROFILE_PERFORMANCE_FRAME_TRACE=1`, it also records GPU memory access counters. `SHARPEMU_PROFILE_PERFORMANCE=1` also starts this profile. | `RenderPhaseProfile.cs`, `GpuMemoryAccessProfile.cs` |
| `SHARPEMU_PROFILE_SYNC_ON_ADDRESS` | `1` | Set to `1` to start the detailed sync-on-address profile. The emulator also records the guest call stack for each wait and wake call. It writes `[PERF][SYNC_ADDR]` and `[PERF][SYNC_THREAD]` lines. `SHARPEMU_PROFILE_PERFORMANCE=1` starts the profile without the call stack. | `KernelSyncOnAddressProfile.cs`, `KernelSyncOnAddressCompatExports.cs` |
| `SHARPEMU_PROFILE_TEXTURE_PREPARATION` | `1` | Set to `1` to measure texture preparation work. The emulator writes `[PERF][TEXTURE_PREP]` lines. `SHARPEMU_PROFILE_PERFORMANCE=1` also starts this profile. | `TexturePreparationProfile.cs` |
## Internal
The emulator sets these variables for its own processes. Do not set them manually.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_MITIGATED_CHILD` | `1` | The Windows launcher sets this variable to 1 when it starts the child process with CFG and CET mitigations off. The child accepts the `--sharpemu-mitigated-child` argument only when the value is 1. Do not set it manually. | `Program.cs`, `EmulatorProcess.cs` |
## Tests and tools
Only the tests, the scripts or the build tools read these variables.
| Variable | Value | Function | Code that reads it |
| --- | --- | --- | --- |
| `SHARPEMU_BACKING_VIEW_FAULT_WORKER` | `1` | The backing view fault test sets this for its child process. The value `1` tells the child to do the fault sequence. Do not set it manually. | `BackingViewFaultTests.cs`, `GuestFaultWorker.cs` |
| `SHARPEMU_BUFFER_FAULT_WORKER` | `1` | The guest buffer fault test sets this for its child process. The value `1` tells the child to do the fault sequence. Do not set it manually. | `GuestBufferFaultTests.cs`, `GuestFaultWorker.cs` |
| `SHARPEMU_FAULT_WORKER_REPORT` | path | The fault test parent sets this to a temporary file path for its child process. The child writes its result (`completed` or `skipped`) to this file. When unset, the child writes the result to the error stream. | `GuestFaultWorker.cs` |
| `SHARPEMU_IMAGE_FAULT_WORKER` | `1` | The guest image fault test sets this for its child process. The value `1` tells the child to do the fault sequence. Do not set it manually. | `GuestImageFaultTests.cs`, `GuestFaultWorker.cs` |
| `SHARPEMU_NATIVE_RETURN_SMOKE_WORKER` | `1` | The native return smoke test sets this for its child process. The value `1` tells the child to run the synthetic guest entry. Do not set it manually. | `Gen5NativeReturnSmokeTests.cs` |
| `SHARPEMU_SOCKET_CONNECTION_TEST_WORKER` | `1` | The kernel socket connection test sets this for its child process. The value `1` tells the child to do the connect sequence. Do not set it manually. | `KernelSocketConnectionTests.cs` |
| `SHARPEMU_TEST_REFERENCE_SPIRV_DIR` | path | Sets the directory that contains the reference compiled shader files for the GPU image tests. The tests make sure that each file has the recorded SHA-256 hash. When unset, these tests skip the reference comparison. | `ImageTestHarness.cs` |
| `SHARPEMU_TEST_REQUIRE_DEVICE` | `1` | Makes a GPU test fail when a Vulkan or Metal device or a device feature is missing. Default is to skip the test. | `ImageTestHarness.cs`, `MetalRuntimeTests.cs` |
| `SHARPEMU_TEST_REQUIRE_REFERENCE_SPIRV` | `1` | Makes a test fail when a reference shader file, its directory, or a necessary device is missing. Default is to skip the test. | `ImageTestHarness.cs`, `GuestFaultWorker.cs` |
| `SHARPEMU_TEST_VK_VALIDATION` | `1` | Loads the Vulkan validation layer in the headless test device and prints the validation messages. Default is off. | `HeadlessVulkan.cs` |
| `SHARPEMU_THREAD_CONTEXT_TEST_WORKER` | `1` | The Windows thread context capture test sets this for its child process. The value `1` tells the child to do the capture sequence. Do not set it manually. | `WindowsThreadContextCaptureTests.cs`, `GuestFaultWorker.cs` |
| `SHARPEMU_UPDATE_GOLDENS` | `1` | Makes the Metal golden tests write the generated shader text to the golden files in the source tree. Default is to compare the generated text with the golden files. | `MslGoldenTests.cs` |
## Variables that the code reads but does not use
The code reads these variables into a field or a filter. No other code uses that field or filter.
Thus they have no effect, or only a part of their function operates. The rows above give the details.
- `SHARPEMU_DUMP_FIXED_SOLID_FRAGMENT`
- `SHARPEMU_ENABLE_CHUNKED_DRAWS`
- `SHARPEMU_FORCE_ATTRIBUTE_FRAGMENT`
- `SHARPEMU_FORCE_DEFAULT_RASTER_STATE`
- `SHARPEMU_FORCE_FULLSCREEN_PIPELINE`
- `SHARPEMU_FORCE_FULLSCREEN_VERTEX`
- `SHARPEMU_FORCE_SOLID_FRAGMENT`
- `SHARPEMU_FORCE_TITLE_DEFAULT_RASTER_STATE`
- `SHARPEMU_FORCE_TITLE_FULLSCREEN_VERTEX`
- `SHARPEMU_FORCE_TITLE_SOLID_FRAGMENT`
- `SHARPEMU_SKIP_TALL_COMPUTE_Z`
- `SHARPEMU_TRACE_GUEST_IMAGE_FORMAT`
- `SHARPEMU_TRACE_GUEST_IMAGE_HEIGHT`
- `SHARPEMU_TRACE_GUEST_IMAGE_WIDTH`
- `SHARPEMU_TRACE_GUEST_WRITES`

View File

@ -0,0 +1,48 @@
<!--
Copyright (C) 2026 SharpEmu Emulator Project
SPDX-License-Identifier: GPL-2.0-or-later
-->
# Windows crash capture
In the launcher, open **Options > Logging** and enable **Crash dumps** before
you start a game. The same toggle is available in each game's Logging settings.
It sets `SHARPEMU_CRASH_CAPTURE` and is off by default.
For a diagnostic run on Windows x64, you can also set it from PowerShell:
```powershell
$env:SHARPEMU_CRASH_CAPTURE = '1'
.\SharpEmu.exe
```
Start a new launcher from that PowerShell window. The game process starts a
hidden helper before runtime initialization. No SDK or debugger install is
required. Look for `[CRASH][INFO] Crash capture ready` in the game log.
The helper writes a full dump beside the run log. Without a log path, it uses
`user/logs` beside the executable. Names include the game process ID:
- `<run>.crash-<pid>.dmp`: the memory dump.
- `<run>.crash-<pid>.dmp.capture.log`: capture status and errors.
Full dumps can use many GB of disk space and contain private process data.
Keep them local until you choose to share them. There is no automatic upload.
The helper uses Windows debugger events. It passes first-chance exceptions to
the application and captures only second-chance, unhandled exceptions. Normal
handled page faults do not create dumps. A normal exit or a forced process
termination does not create a dump either. The original crash is not suppressed.
This option changes debugger presence and can change timing. Do not use it for
FPS comparisons. Do not attach WinDbg, ProcDump, or another native debugger at
the same time. Capture failures are recorded when possible; no capture method
can cover every process termination. A failed write can leave an incomplete dump.
This is separate from the `DOTNET_Dbg*` settings. It does not change them.
To disable a GUI selection, turn off **Crash dumps** before the next game launch.
If you set the option in PowerShell, close the launcher and run:
```powershell
Remove-Item Env:SHARPEMU_CRASH_CAPTURE -ErrorAction SilentlyContinue
```

View File

@ -41,21 +41,36 @@ def write_pair(nid: str, export_name: str) -> None:
def lookup(args: argparse.Namespace) -> int: def lookup(args: argparse.Namespace) -> int:
value = args.value.strip() values = [value.strip() for value in args.value.split(",") if value.strip()]
if NID_PATTERN.fullmatch(value): names = read_names(args.names)
for export_name in read_names(args.names): name_set = set(names)
if compute_nid(export_name) == value:
write_pair(value, export_name)
return 0
print(f"NID not found in catalog: {value}", file=sys.stderr) result = 0
return 1
names = set(read_names(args.names)) for value in values:
write_pair(compute_nid(value), value) if NID_PATTERN.fullmatch(value):
if value not in names: found = False
print("Warning: export name is not present in the catalog.", file=sys.stderr)
return 0 for export_name in names:
if compute_nid(export_name) == value:
write_pair(value, export_name)
found = True
break
if not found:
print(f"NID not found in catalog: {value}", file=sys.stderr)
result = 1
continue
write_pair(compute_nid(value), value)
if value not in name_set:
print(
f"Warning: export name is not present in the catalog: {value}",
file=sys.stderr,
)
return result
def search(args: argparse.Namespace) -> int: def search(args: argparse.Namespace) -> int:
@ -132,7 +147,9 @@ def create_parser() -> argparse.ArgumentParser:
lookup_parser = subparsers.add_parser( lookup_parser = subparsers.add_parser(
"lookup", help="resolve a NID or calculate the NID for an export name" "lookup", help="resolve a NID or calculate the NID for an export name"
) )
lookup_parser.add_argument("value", help="11-character NID or exact export name") lookup_parser.add_argument(
"value", help="11-character NID or exact export name; comma-separated values are supported"
)
lookup_parser.set_defaults(handler=lookup) lookup_parser.set_defaults(handler=lookup)
search_parser = subparsers.add_parser( search_parser = subparsers.add_parser(

View File

@ -133845,6 +133845,7 @@ sceKernelWriteRemapIntoPrtCommand
sceKernelWriteRemapWithGpuMaskIdCommand sceKernelWriteRemapWithGpuMaskIdCommand
sceKernelWriteSdkEventLog sceKernelWriteSdkEventLog
sceKernelWriteSdkEventLogV sceKernelWriteSdkEventLogV
sceKernelWriteThrottlingStatus
sceKernelWriteUnmapCommand sceKernelWriteUnmapCommand
sceKernelWriteUnmapToPrtCommand sceKernelWriteUnmapToPrtCommand
sceKernelWriteWaitOnAddressCommand sceKernelWriteWaitOnAddressCommand
@ -154456,3 +154457,6 @@ sceNpEAAccessInitialize
sceNpEAAccessTerminate sceNpEAAccessTerminate
sceNpHasEAAccessSubscription sceNpHasEAAccessSubscription
sceNpHasEAAccessSubscriptionAbortRequest sceNpHasEAAccessSubscriptionAbortRequest
sceAgcAddPrimStateRegisters
sceVoiceQoSSetMode
sceVoiceQoSTerminate

View File

@ -32,7 +32,6 @@ internal static partial class Program
private const ulong PROCESS_CREATION_MITIGATION_POLICY_CONTROL_FLOW_GUARD_ALWAYS_OFF = 0x00000002UL << 40; private const ulong PROCESS_CREATION_MITIGATION_POLICY_CONTROL_FLOW_GUARD_ALWAYS_OFF = 0x00000002UL << 40;
private const ulong PROCESS_CREATION_MITIGATION_POLICY2_CET_USER_SHADOW_STACKS_ALWAYS_OFF = 0x00000002UL << 28; private const ulong PROCESS_CREATION_MITIGATION_POLICY2_CET_USER_SHADOW_STACKS_ALWAYS_OFF = 0x00000002UL << 28;
private const ulong PROCESS_CREATION_MITIGATION_POLICY2_USER_CET_SET_CONTEXT_IP_VALIDATION_ALWAYS_OFF = 0x00000002UL << 32; private const ulong PROCESS_CREATION_MITIGATION_POLICY2_USER_CET_SET_CONTEXT_IP_VALIDATION_ALWAYS_OFF = 0x00000002UL << 32;
private const ulong PROCESS_CREATION_MITIGATION_POLICY2_XTENDED_CONTROL_FLOW_GUARD_ALWAYS_OFF = 0x00000002UL << 40;
private const int ATTACH_PARENT_PROCESS = -1; private const int ATTACH_PARENT_PROCESS = -1;
private const int STD_INPUT_HANDLE = -10; private const int STD_INPUT_HANDLE = -10;
private const int STD_OUTPUT_HANDLE = -11; private const int STD_OUTPUT_HANDLE = -11;
@ -48,6 +47,12 @@ internal static partial class Program
{ {
ConfigureManagedPluginResolution(); ConfigureManagedPluginResolution();
if (args.Length > 0 && args[0] == SharpEmu.Core.Diagnostics.WindowsCrashCapture.HelperArgument)
return SharpEmu.Core.Diagnostics.WindowsCrashCapture.RunHelper(args);
RenderDocCapture.ApplyVulkanLoaderEnvironment();
SharpEmu.Libs.VideoOut.RenderDocCapture.Initialize();
try try
{ {
return Run(args); return Run(args);
@ -302,6 +307,8 @@ internal static partial class Program
Console.Error.WriteLine("[DEBUG] Creating runtime..."); Console.Error.WriteLine("[DEBUG] Creating runtime...");
SharpEmu.Core.Diagnostics.WindowsCrashCapture.StartIfEnabled(logFilePath);
try try
{ {
using var runtime = SharpEmuRuntime.CreateDefault(runtimeOptions); using var runtime = SharpEmuRuntime.CreateDefault(runtimeOptions);
@ -316,6 +323,16 @@ internal static partial class Program
VideoOutExports.NotifyHostInterrupt(); VideoOutExports.NotifyHostInterrupt();
}; };
Console.CancelKeyPress += cancelHandler; Console.CancelKeyPress += cancelHandler;
// SIGTERM (launchd, process managers, `kill`) takes the same cooperative shutdown: the
// runtime's default exits with GPU work in flight, which leaves the host driver to reclaim
// resources the device still owns.
using var terminateRegistration = OperatingSystem.IsWindows()
? null
: PosixSignalRegistration.Create(PosixSignal.SIGTERM, context =>
{
context.Cancel = true;
VideoOutExports.NotifyHostInterrupt();
});
Console.Error.WriteLine($"[DEBUG] Running: {ebootPath}"); Console.Error.WriteLine($"[DEBUG] Running: {ebootPath}");
result = runtime.Run(ebootPath); result = runtime.Run(ebootPath);
@ -518,9 +535,15 @@ internal static partial class Program
return false; return false;
} }
string[] childArgs = [MitigatedChildFlag, .. args]; var commandLineArguments = Environment.GetCommandLineArgs();
var entryAssemblyPath = commandLineArguments.Length > 0 ? commandLineArguments[0] : null;
string[] childArguments =
Path.GetFileNameWithoutExtension(processPath).Equals("dotnet", StringComparison.OrdinalIgnoreCase) &&
!string.IsNullOrWhiteSpace(entryAssemblyPath)
? [entryAssemblyPath, MitigatedChildFlag, .. args]
: [MitigatedChildFlag, .. args];
var commandLine = BuildCommandLine(processPath, childArgs); var commandLine = BuildCommandLine(processPath, childArguments);
var startupInfoEx = new STARTUPINFOEX(); var startupInfoEx = new STARTUPINFOEX();
startupInfoEx.StartupInfo.cb = Marshal.SizeOf<STARTUPINFOEX>(); startupInfoEx.StartupInfo.cb = Marshal.SizeOf<STARTUPINFOEX>();
ConfigureInheritedStdHandles(ref startupInfoEx.StartupInfo); ConfigureInheritedStdHandles(ref startupInfoEx.StartupInfo);
@ -987,7 +1010,7 @@ internal static partial class Program
private static void PrintUsage() private static void PrintUsage()
{ {
Log.Info("Usage: SharpEmu.CLI [--strict] [--trace-imports[=N]] [--cpu-engine=<native>] [--log-level=<level>] [--log-file[=<path>]] [--window-mode=<windowed|borderless|exclusive>] [--resolution=<WIDTHxHEIGHT>] [--display=<N>] [--refresh-rate=<HZ>] [--scaling=<fit|cover|stretch|integer>] [--vsync=<on|off>] [--hdr=<auto|on|off>] [--debug-server[=host:port]] <path-to-eboot.bin>"); Log.Info("Usage: SharpEmu.CLI [--strict] [--trace-imports[=N]] [--cpu-engine=<native>] [--console=<ps5>] [--console-language=<language>] [--log-level=<level>] [--log-file[=<path>]] [--window-mode=<windowed|borderless|exclusive>] [--resolution=<WIDTHxHEIGHT>] [--display=<N>] [--refresh-rate=<HZ>] [--scaling=<fit|cover|stretch|integer>] [--vsync=<on|off>] [--hdr=<auto|on|off>] [--overlay=<on|off>] [--overlay-mode=<full|minimal|titlebar>] [--overlay-corner=<topleft|topright|bottomright|bottomleft>] [--debug-server[=host:port]] <path-to-eboot.bin>");
Log.Info(@"Example: SharpEmu.CLI --cpu-engine=native --trace-imports=64 --log-level=debug --log-file ""E:\Games\...\eboot.bin"""); Log.Info(@"Example: SharpEmu.CLI --cpu-engine=native --trace-imports=64 --log-level=debug --log-file ""E:\Games\...\eboot.bin""");
Log.Info("Debug server: --debug-server starts a live debug listener (default 127.0.0.1:5714); connect with SharpEmu.DebugClient."); Log.Info("Debug server: --debug-server starts a live debug listener (default 127.0.0.1:5714); connect with SharpEmu.DebugClient.");
} }
@ -1049,6 +1072,7 @@ internal static partial class Program
var strictDynlibResolution = false; var strictDynlibResolution = false;
var importTraceLimit = 0; var importTraceLimit = 0;
var cpuEngine = CpuExecutionEngine.NativeOnly; var cpuEngine = CpuExecutionEngine.NativeOnly;
var systemLanguage = 1;
HostWindowMode? windowModeOverride = null; HostWindowMode? windowModeOverride = null;
HostScalingMode? scalingModeOverride = null; HostScalingMode? scalingModeOverride = null;
int? windowWidthOverride = null; int? windowWidthOverride = null;
@ -1057,6 +1081,9 @@ internal static partial class Program
int? refreshRateOverride = null; int? refreshRateOverride = null;
bool? vsyncOverride = null; bool? vsyncOverride = null;
HostHdrMode? hdrModeOverride = null; HostHdrMode? hdrModeOverride = null;
bool? overlayEnabledOverride = null;
PerformanceOverlayMode? overlayModeOverride = null;
PerformanceOverlayCorner? overlayCornerOverride = null;
videoOptions = HostVideoOptions.Default; videoOptions = HostVideoOptions.Default;
logFilePath = null; logFilePath = null;
logLevel = SharpEmuLog.MinimumLevel; logLevel = SharpEmuLog.MinimumLevel;
@ -1064,6 +1091,26 @@ internal static partial class Program
for (var i = 0; i < args.Length; i++) for (var i = 0; i < args.Length; i++)
{ {
var argument = args[i]; var argument = args[i];
if (TrySplitOption(argument, "--console", out var consoleText))
{
if (!string.Equals(consoleText, "ps5", StringComparison.OrdinalIgnoreCase))
{
ebootPath = string.Empty;
runtimeOptions = default;
return false;
}
continue;
}
if (TrySplitOption(argument, "--console-language", out var consoleLanguageText))
{
if (!TryParseSystemLanguage(consoleLanguageText, out systemLanguage))
{
ebootPath = string.Empty;
runtimeOptions = default;
return false;
}
continue;
}
if (TrySplitOption(argument, "--window-mode", out var windowModeText)) if (TrySplitOption(argument, "--window-mode", out var windowModeText))
{ {
if (!TryParseWindowMode(windowModeText, out var windowMode)) if (!TryParseWindowMode(windowModeText, out var windowMode))
@ -1131,6 +1178,41 @@ internal static partial class Program
vsyncOverride = vsync; vsyncOverride = vsync;
continue; continue;
} }
if (TrySplitOption(argument, "--overlay", out var overlayText))
{
if (!TryParseSwitch(overlayText, out var overlayEnabled))
{
ebootPath = string.Empty;
runtimeOptions = default;
return false;
}
overlayEnabledOverride = overlayEnabled;
continue;
}
if (TrySplitOption(argument, "--overlay-mode", out var overlayModeText))
{
if (!Enum.TryParse<PerformanceOverlayMode>(overlayModeText, true, out var overlayMode) ||
!Enum.IsDefined(overlayMode))
{
ebootPath = string.Empty;
runtimeOptions = default;
return false;
}
overlayModeOverride = overlayMode;
continue;
}
if (TrySplitOption(argument, "--overlay-corner", out var overlayCornerText))
{
if (!Enum.TryParse<PerformanceOverlayCorner>(overlayCornerText, true, out var overlayCorner) ||
!Enum.IsDefined(overlayCorner))
{
ebootPath = string.Empty;
runtimeOptions = default;
return false;
}
overlayCornerOverride = overlayCorner;
continue;
}
if (TrySplitOption(argument, "--hdr", out var hdrText)) if (TrySplitOption(argument, "--hdr", out var hdrText))
{ {
if (!TryParseHdrMode(hdrText, out var hdrMode)) if (!TryParseHdrMode(hdrText, out var hdrMode))
@ -1300,6 +1382,7 @@ internal static partial class Program
runtimeOptions = new SharpEmuRuntimeOptions runtimeOptions = new SharpEmuRuntimeOptions
{ {
CpuEngine = cpuEngine, CpuEngine = cpuEngine,
SystemLanguage = systemLanguage,
StrictDynlibResolution = strictDynlibResolution, StrictDynlibResolution = strictDynlibResolution,
ImportTraceLimit = importTraceLimit, ImportTraceLimit = importTraceLimit,
}; };
@ -1314,6 +1397,9 @@ internal static partial class Program
RefreshRate = refreshRateOverride ?? configuredVideoOptions.RefreshRate, RefreshRate = refreshRateOverride ?? configuredVideoOptions.RefreshRate,
VSync = vsyncOverride ?? configuredVideoOptions.VSync, VSync = vsyncOverride ?? configuredVideoOptions.VSync,
HdrMode = hdrModeOverride ?? configuredVideoOptions.HdrMode, HdrMode = hdrModeOverride ?? configuredVideoOptions.HdrMode,
OverlayEnabled = overlayEnabledOverride ?? configuredVideoOptions.OverlayEnabled,
OverlayMode = overlayModeOverride ?? configuredVideoOptions.OverlayMode,
OverlayCorner = overlayCornerOverride ?? configuredVideoOptions.OverlayCorner,
}).Normalize(); }).Normalize();
return true; return true;
} }
@ -1351,6 +1437,11 @@ internal static partial class Program
RefreshRate = effective.RefreshRate, RefreshRate = effective.RefreshRate,
VSync = effective.VSync, VSync = effective.VSync,
HdrMode = hdrMode, HdrMode = hdrMode,
OverlayEnabled = effective.OverlayEnabled,
OverlayCorner = Enum.TryParse<PerformanceOverlayCorner>(effective.OverlayCorner, true, out var corner)
? corner : defaults.OverlayCorner,
OverlayMode = Enum.TryParse<PerformanceOverlayMode>(effective.OverlayMode, true, out var mode)
? mode : defaults.OverlayMode,
}.Normalize(); }.Normalize();
} }
catch (Exception exception) catch (Exception exception)
@ -1386,6 +1477,46 @@ internal static partial class Program
return Enum.IsDefined(mode); return Enum.IsDefined(mode);
} }
private static bool TryParseSystemLanguage(string value, out int language)
{
language = value.ToLowerInvariant() switch
{
"japanese" => 0,
"englishus" => 1,
"french" => 2,
"spanishspain" => 3,
"german" => 4,
"italian" => 5,
"dutch" => 6,
"portugueseportugal" => 7,
"russian" => 8,
"korean" => 9,
"chinesetraditional" => 10,
"chinesesimplified" => 11,
"finnish" => 12,
"swedish" => 13,
"danish" => 14,
"norwegian" => 15,
"polish" => 16,
"portuguesebrazil" => 17,
"englishuk" => 18,
"turkish" => 19,
"spanishlatinamerica" => 20,
"arabic" => 21,
"frenchcanada" => 22,
"czech" => 23,
"hungarian" => 24,
"greek" => 25,
"romanian" => 26,
"thai" => 27,
"vietnamese" => 28,
"indonesian" => 29,
"ukrainian" => 30,
_ => -1,
};
return language >= 0;
}
private static bool TryParseScalingMode(string value, out HostScalingMode mode) private static bool TryParseScalingMode(string value, out HostScalingMode mode)
{ {
mode = value.ToLowerInvariant() switch mode = value.ToLowerInvariant() switch

View File

@ -130,7 +130,7 @@ SPDX-License-Identifier: GPL-2.0-or-later
</PropertyGroup> </PropertyGroup>
<Target Name="FetchFfmpegRuntime" <Target Name="FetchFfmpegRuntime"
BeforeTargets="Publish" BeforeTargets="Publish;Build"
Condition="'$(RuntimeIdentifier)' != '' And '$(FfmpegRuntimePackage)' != ''"> Condition="'$(RuntimeIdentifier)' != '' And '$(FfmpegRuntimePackage)' != ''">
<DownloadFile <DownloadFile
SourceUrl="https://github.com/sharpemu/ffmpeg-core/releases/download/$(FfmpegRuntimeTag)/$(FfmpegRuntimePackage)" SourceUrl="https://github.com/sharpemu/ffmpeg-core/releases/download/$(FfmpegRuntimeTag)/$(FfmpegRuntimePackage)"
@ -161,4 +161,23 @@ SPDX-License-Identifier: GPL-2.0-or-later
SkipUnchangedFiles="true" /> SkipUnchangedFiles="true" />
</Target> </Target>
<!-- Mirrors PublishFfmpegRuntime for plain `dotnet build`: devs running
straight out of the build output directory (no publish step) still
need the FFmpeg plugins present, otherwise AvPlayer/Bink video probing
throws NotSupportedException the first time a guest opens a movie. -->
<Target Name="BuildFfmpegRuntime"
AfterTargets="Build"
DependsOnTargets="FetchFfmpegRuntime"
Condition="'$(RuntimeIdentifier)' != '' And '$(FfmpegRuntimePackage)' != ''">
<ItemGroup>
<_FfmpegRuntimeFiles Condition="$(RuntimeIdentifier.StartsWith('win'))"
Include="$(FfmpegRuntimeExtractDir)/bin/*.dll" />
<_FfmpegRuntimeFiles Condition="!$(RuntimeIdentifier.StartsWith('win'))"
Include="$(FfmpegRuntimeExtractDir)/lib/*.so;$(FfmpegRuntimeExtractDir)/lib/*.so.*;$(FfmpegRuntimeExtractDir)/lib/*.dylib" />
</ItemGroup>
<Copy SourceFiles="@(_FfmpegRuntimeFiles)"
DestinationFolder="$(OutDir)$(NativeLibraryFolderName)"
SkipUnchangedFiles="true" />
</Target>
</Project> </Project>

View File

@ -133,6 +133,20 @@ public sealed class CpuDispatcher : ICpuDispatcher, IDisposable
} }
} }
public bool TryInstallAdditionalModule(
IReadOnlyDictionary<ulong, string> importStubs,
IReadOnlyDictionary<string, ulong> runtimeSymbols,
out string? error)
{
if (_nativeCpuBackend is not DirectExecutionBackend backend)
{
error = "the active CPU backend does not support runtime modules";
return false;
}
return backend.TryInstallAdditionalModule(importStubs, runtimeSymbols, out error);
}
private OrbisGen2Result DispatchEntryCore( private OrbisGen2Result DispatchEntryCore(
ulong entryPoint, ulong entryPoint,
Generation generation, Generation generation,

View File

@ -0,0 +1,149 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.Numerics;
namespace SharpEmu.Core.Cpu.Emulation;
/// <summary>
/// Calculates the results of the SHA extension instructions for instruction recovery.
/// Dword 0 of a value is bits 31:0 and dword 3 is bits 127:96, as in the Intel SDM.
/// </summary>
public static class ShaInstructionEmulator
{
public static UInt128 Sha1Rnds4(UInt128 source1, UInt128 source2, int function)
{
var a = Dword(source1, 3);
var b = Dword(source1, 2);
var c = Dword(source1, 1);
var d = Dword(source1, 0);
var e = 0u;
var k = (function & 3) switch
{
0 => 0x5A827999u,
1 => 0x6ED9EBA1u,
2 => 0x8F1BBCDCu,
_ => 0xCA62C1D6u,
};
// The first message dword already carries E (SHA1NEXTE adds it).
for (var round = 0; round < 4; round++)
{
var next = Sha1Function(function, b, c, d) + BitOperations.RotateLeft(a, 5) + Dword(source2, 3 - round) + e + k;
e = d;
d = c;
c = BitOperations.RotateLeft(b, 30);
b = a;
a = next;
}
return FromDwords(d, c, b, a);
}
public static UInt128 Sha1Nexte(UInt128 source1, UInt128 source2)
{
var e = BitOperations.RotateLeft(Dword(source1, 3), 30);
return FromDwords(Dword(source2, 0), Dword(source2, 1), Dword(source2, 2), Dword(source2, 3) + e);
}
public static UInt128 Sha1Msg1(UInt128 source1, UInt128 source2)
{
var w0 = Dword(source1, 3);
var w1 = Dword(source1, 2);
var w2 = Dword(source1, 1);
var w3 = Dword(source1, 0);
var w4 = Dword(source2, 3);
var w5 = Dword(source2, 2);
return FromDwords(w5 ^ w3, w4 ^ w2, w3 ^ w1, w2 ^ w0);
}
public static UInt128 Sha1Msg2(UInt128 source1, UInt128 source2)
{
var w13 = Dword(source2, 2);
var w14 = Dword(source2, 1);
var w15 = Dword(source2, 0);
var w16 = BitOperations.RotateLeft(Dword(source1, 3) ^ w13, 1);
var w17 = BitOperations.RotateLeft(Dword(source1, 2) ^ w14, 1);
var w18 = BitOperations.RotateLeft(Dword(source1, 1) ^ w15, 1);
var w19 = BitOperations.RotateLeft(Dword(source1, 0) ^ w16, 1);
return FromDwords(w19, w18, w17, w16);
}
// SHA256RNDS2 takes its two round-constant-plus-message dwords from XMM0[63:0].
public static UInt128 Sha256Rnds2(UInt128 source1, UInt128 source2, UInt128 xmm0)
{
var a = Dword(source2, 3);
var b = Dword(source2, 2);
var c = Dword(source1, 3);
var d = Dword(source1, 2);
var e = Dword(source2, 1);
var f = Dword(source2, 0);
var g = Dword(source1, 1);
var h = Dword(source1, 0);
for (var round = 0; round < 2; round++)
{
var t1 = Ch(e, f, g) + BigSigma1(e) + Dword(xmm0, round) + h;
var t2 = Maj(a, b, c) + BigSigma0(a);
h = g;
g = f;
f = e;
e = d + t1;
d = c;
c = b;
b = a;
a = t1 + t2;
}
return FromDwords(f, e, b, a);
}
public static UInt128 Sha256Msg1(UInt128 source1, UInt128 source2)
{
var w4 = Dword(source2, 0);
var w3 = Dword(source1, 3);
var w2 = Dword(source1, 2);
var w1 = Dword(source1, 1);
var w0 = Dword(source1, 0);
return FromDwords(w0 + SmallSigma0(w1), w1 + SmallSigma0(w2), w2 + SmallSigma0(w3), w3 + SmallSigma0(w4));
}
public static UInt128 Sha256Msg2(UInt128 source1, UInt128 source2)
{
var w14 = Dword(source2, 2);
var w15 = Dword(source2, 3);
var w16 = Dword(source1, 0) + SmallSigma1(w14);
var w17 = Dword(source1, 1) + SmallSigma1(w15);
var w18 = Dword(source1, 2) + SmallSigma1(w16);
var w19 = Dword(source1, 3) + SmallSigma1(w17);
return FromDwords(w16, w17, w18, w19);
}
public static uint Dword(UInt128 value, int index) => (uint)(value >> (32 * index));
public static UInt128 FromDwords(uint dword0, uint dword1, uint dword2, uint dword3) =>
((UInt128)dword3 << 96) | ((UInt128)dword2 << 64) | ((UInt128)dword1 << 32) | dword0;
private static uint Sha1Function(int function, uint b, uint c, uint d) => (function & 3) switch
{
0 => (b & c) ^ (~b & d),
2 => (b & c) ^ (b & d) ^ (c & d),
_ => b ^ c ^ d,
};
private static uint Ch(uint e, uint f, uint g) => (e & f) ^ (~e & g);
private static uint Maj(uint a, uint b, uint c) => (a & b) ^ (a & c) ^ (b & c);
private static uint BigSigma0(uint x) =>
BitOperations.RotateRight(x, 2) ^ BitOperations.RotateRight(x, 13) ^ BitOperations.RotateRight(x, 22);
private static uint BigSigma1(uint x) =>
BitOperations.RotateRight(x, 6) ^ BitOperations.RotateRight(x, 11) ^ BitOperations.RotateRight(x, 25);
private static uint SmallSigma0(uint x) =>
BitOperations.RotateRight(x, 7) ^ BitOperations.RotateRight(x, 18) ^ (x >> 3);
private static uint SmallSigma1(uint x) =>
BitOperations.RotateRight(x, 17) ^ BitOperations.RotateRight(x, 19) ^ (x >> 10);
}

View File

@ -4,23 +4,7 @@
namespace SharpEmu.Core.Cpu.Emulation; namespace SharpEmu.Core.Cpu.Emulation;
/// <summary> /// <summary>
/// Pure software implementation of the bit-field math behind AMD's SSE4a EXTRQ/INSERTQ /// Calculates the bit-field results for SSE4a instruction recovery.
/// (immediate-form) instructions.
///
/// The direct-execution backend runs guest PS5 code natively on the host CPU. The PS5's Zen 2
/// cores implement AMD-only SSE4a (EXTRQ/INSERTQ), but Intel hosts - and Rosetta 2 on Apple
/// Silicon - do not, so they raise #UD (STATUS_ILLEGAL_INSTRUCTION) instead of executing the
/// opcode. SharpEmu already rewrites one specific compiled EXTRQ+VPBLENDD idiom at load time
/// (see <see cref="Native.Sse4aExtrqBlendPatch"/>), but any other occurrence of EXTRQ/INSERTQ -
/// a different register allocation, a title built with a different compiler version, and so on
/// - still aborts the title. This class ported from Kyty's
/// <c>Loader::X64InstructionEmulator::TryEmulateSse4a</c> provides the general bit-field
/// extract/insert so the illegal-instruction handler can finish *any* immediate-form
/// EXTRQ/INSERTQ in software and resume, instead of relying on a single hard-coded byte pattern.
///
/// The methods operate on plain 64-bit integers rather than the OS CONTEXT record so the bit
/// math can be unit-tested in isolation; the unsafe CONTEXT/XMM plumbing lives in the backend
/// adapter (<see cref="Native.DirectExecutionBackend"/>).
/// </summary> /// </summary>
public static class Sse4aBitFieldEmulator public static class Sse4aBitFieldEmulator
{ {
@ -35,16 +19,13 @@ public static class Sse4aBitFieldEmulator
{ {
var len = length & 0x3F; var len = length & 0x3F;
var idx = index & 0x3F; var idx = index & 0x3F;
if (!IsValidBitField(length, index))
{
return 0;
}
if (len == 0) if (len == 0)
{ {
return value; len = 64;
} }
// Results past bit 63 are undefined; limit the field to the remaining bits.
len = Math.Min(len, 64 - idx);
var mask = len == 64 ? ulong.MaxValue : (1UL << len) - 1; var mask = len == 64 ? ulong.MaxValue : (1UL << len) - 1;
return (value >> idx) & mask; return (value >> idx) & mask;
} }
@ -53,16 +34,12 @@ public static class Sse4aBitFieldEmulator
{ {
var len = length & 0x3F; var len = length & 0x3F;
var idx = index & 0x3F; var idx = index & 0x3F;
if (!IsValidBitField(length, index))
{
return destination;
}
if (len == 0) if (len == 0)
{ {
return source; len = 64;
} }
len = Math.Min(len, 64 - idx);
var fieldMask = len == 64 ? ulong.MaxValue : (1UL << len) - 1; var fieldMask = len == 64 ? ulong.MaxValue : (1UL << len) - 1;
var destinationClearMask = fieldMask << idx; var destinationClearMask = fieldMask << idx;
var sourceField = (source & fieldMask) << idx; var sourceField = (source & fieldMask) << idx;

View File

@ -26,22 +26,21 @@ public sealed unsafe class CpuPatcher : IDisposable
internal unsafe class UnsafeCodeReader : Iced.Intel.CodeReader internal unsafe class UnsafeCodeReader : Iced.Intel.CodeReader
{ {
private byte* _start; private readonly byte* _start;
private byte* _current; private readonly ulong _length;
private int _length; public ulong Position { get; private set; }
public UnsafeCodeReader(byte* start, int length) public UnsafeCodeReader(byte* start, ulong length)
{ {
_start = start; _start = start;
_current = start;
_length = length; _length = length;
} }
public override int ReadByte() public override int ReadByte()
{ {
if (_current >= _start + _length) if (Position >= _length)
return -1; return -1;
return *_current++; return _start[Position++];
} }
} }
} }

View File

@ -7,23 +7,8 @@ using SharpEmu.Core.Cpu.Emulation;
namespace SharpEmu.Core.Cpu.Native; namespace SharpEmu.Core.Cpu.Native;
// General software fallback for the AMD-only instructions PS5 titles occasionally emit that a // Recover supported instructions only after an illegal-instruction fault.
// Zen 2-only host implements but Intel hosts (and Rosetta 2 on Apple Silicon) do not: // Leave native instructions and unrelated register values unchanged.
// - SSE4a EXTRQ/INSERTQ, immediate form
// - MONITORX/MWAITX
//
// This is a direct port of Kyty's Loader::X64InstructionEmulator (TryEmulateSse4a /
// TryEmulateMonitorxMwaitx). SharpEmu already special-cases exactly one compiled EXTRQ+VPBLENDD
// byte sequence at load time (Sse4aExtrqBlendPatch), which only helps the one idiom it was
// reverse-engineered from. This file is a general, fault-time fallback that engages for any
// immediate-form EXTRQ/INSERTQ or MONITORX/MWAITX the narrower patch (or a title using a
// different compiler/register allocation) does not cover, complementing rather than replacing
// it: the load-time patch still avoids paying the fault-and-recover cost on the hot path it was
// built for, while this method is the safety net for everything else.
//
// This is deliberately additive: DirectExecutionBackend.IllegalInstruction.cs (the BMI1/BMI2/ABM
// fallback) is untouched, and this method is only reached from VectoredHandler after that one
// has already declined to handle the fault.
public sealed partial class DirectExecutionBackend public sealed partial class DirectExecutionBackend
{ {
// Byte offset of Xmm0 within the Win64 CONTEXT record: FltSave (the XMM_SAVE_AREA32/FXSAVE // Byte offset of Xmm0 within the Win64 CONTEXT record: FltSave (the XMM_SAVE_AREA32/FXSAVE
@ -46,16 +31,8 @@ public sealed partial class DirectExecutionBackend
return true; return true;
} }
// MONITORX/MWAITX above only ever reads guest code memory and rewrites RIP, both of // EXTRQ and INSERTQ need the current vector register values.
// which the POSIX signal bridge (DirectExecutionBackend.PosixSignals.cs) faithfully // Use recovery only when the signal context contains these values.
// round-trips through the real ucontext, so it works on every supported OS. EXTRQ/
// INSERTQ additionally read and write an XMM register: on Windows contextRecord is the
// live CONTEXT the OS resumes the thread from, so touching the Xmm0.. slots is visible
// to the guest, and on Linux the bridge copies the mcontext's FXSAVE image into the
// Xmm0.. slots and writes them back through sigreturn (_posixXmmContextBridged). On
// Darwin the XMM area is still a zeroed scratch buffer - running this there would
// silently compute a result from stale bytes and then discard whatever it "wrote", so
// the recovery declines until that bridge exists.
return (OperatingSystem.IsWindows() || _posixXmmContextBridged) && return (OperatingSystem.IsWindows() || _posixXmmContextBridged) &&
TryRecoverSse4aExtractInsert(contextRecord, rip); TryRecoverSse4aExtractInsert(contextRecord, rip);
} }
@ -65,7 +42,7 @@ public sealed partial class DirectExecutionBackend
// MONITORX (0F 01 FA) and MWAITX (0F 01 FB) are fixed 3-byte encodings with no // MONITORX (0F 01 FA) and MWAITX (0F 01 FB) are fixed 3-byte encodings with no
// ModRM/SIB/displacement/immediate, so a raw byte compare is sufficient and unambiguous. // ModRM/SIB/displacement/immediate, so a raw byte compare is sufficient and unambiguous.
var opcode = new byte[3]; var opcode = new byte[3];
if (!TryReadHostBytes(rip, opcode) || if (!TryReadExecutableBytes(rip, opcode) ||
opcode[0] != 0x0F || opcode[1] != 0x01 || (opcode[2] != 0xFA && opcode[2] != 0xFB)) opcode[0] != 0x0F || opcode[1] != 0x01 || (opcode[2] != 0xFA && opcode[2] != 0xFB))
{ {
return false; return false;
@ -111,7 +88,10 @@ public sealed partial class DirectExecutionBackend
return false; return false;
} }
if (isExtrq && instruction.OpCount != 3 || isInsertq && instruction.OpCount != 4) var isImmediateExtrq = isExtrq && instruction.OpCount == 3;
var isRegisterExtrq = isExtrq && instruction.OpCount == 2;
var isImmediateInsertq = isInsertq && instruction.OpCount == 4;
if (!isImmediateExtrq && !isRegisterExtrq && !isImmediateInsertq)
{ {
return false; return false;
} }
@ -125,11 +105,26 @@ public sealed partial class DirectExecutionBackend
var destLow = ReadCtxU64(contextRecord, destOffset); var destLow = ReadCtxU64(contextRecord, destOffset);
if (isExtrq) if (isExtrq)
{ {
var length = (int)instruction.GetImmediate(1); int length;
var index = (int)instruction.GetImmediate(2); int index;
if (!Sse4aBitFieldEmulator.IsValidBitField(length, index)) if (isRegisterExtrq)
{ {
return false; if (instruction.GetOpKind(1) != OpKind.Register ||
!TryGetXmmOffset(instruction.GetOpRegister(1), out var controlOffset))
{
return false;
}
// AMD defines the register form's field length in xmm2[5:0] and its start
// index in xmm2[13:8]. Other control bits do not affect the instruction.
var control = ReadCtxU64(contextRecord, controlOffset);
length = (int)(control & 0x3F);
index = (int)((control >> 8) & 0x3F);
}
else
{
length = (int)instruction.GetImmediate(1);
index = (int)instruction.GetImmediate(2);
} }
WriteCtxU64(contextRecord, destOffset, Sse4aBitFieldEmulator.ExtractBitField(destLow, length, index)); WriteCtxU64(contextRecord, destOffset, Sse4aBitFieldEmulator.ExtractBitField(destLow, length, index));
@ -145,11 +140,6 @@ public sealed partial class DirectExecutionBackend
var length = (int)instruction.GetImmediate(2); var length = (int)instruction.GetImmediate(2);
var index = (int)instruction.GetImmediate(3); var index = (int)instruction.GetImmediate(3);
if (!Sse4aBitFieldEmulator.IsValidBitField(length, index))
{
return false;
}
WriteCtxU64(contextRecord, destOffset, Sse4aBitFieldEmulator.InsertBitField( WriteCtxU64(contextRecord, destOffset, Sse4aBitFieldEmulator.InsertBitField(
destLow, ReadCtxU64(contextRecord, srcOffset), length, index)); destLow, ReadCtxU64(contextRecord, srcOffset), length, index));
WriteCtxU64(contextRecord, destOffset + 8, 0); WriteCtxU64(contextRecord, destOffset + 8, 0);

View File

@ -88,6 +88,14 @@ public sealed partial class DirectExecutionBackend
return $"{kvp.Key}: {cores:F2}cores {seconds:F1}s n={callCount} {perCallUs:F2}us/call"; return $"{kvp.Key}: {cores:F2}cores {seconds:F1}s n={callCount} {perCallUs:F2}us/call";
}); });
System.Console.Error.WriteLine($"[PERF][HLE] cost: {string.Join(" | ", top)}"); System.Console.Error.WriteLine($"[PERF][HLE] cost: {string.Join(" | ", top)}");
if (SharpEmu.HLE.GuestFastPath.Enabled)
{
var fastPath = SharpEmu.HLE.GuestFastPath.SnapshotCounters();
System.Console.Error.WriteLine(
$"[PERF][HLE] fast_path: self_hits={fastPath.SelfHits} " +
$"getspecific_hits={fastPath.GetspecificHits} blocks={fastPath.Blocks}");
}
} }
} }
@ -463,6 +471,29 @@ public sealed partial class DirectExecutionBackend
return false; return false;
} }
// The committed readable run of host pages that contains address.
private unsafe static bool TryQueryReadableRange(ulong address, out ulong start, out ulong end)
{
start = 0;
end = 0;
if (address <= 65536 || address >= 140737488355328L ||
VirtualQuery((void*)address, out var info, (nuint)sizeof(MEMORY_BASIC_INFORMATION64)) == 0)
{
return false;
}
var regionEnd = info.BaseAddress + info.RegionSize;
if (regionEnd < info.BaseAddress || address > regionEnd - 8 ||
info.State != 4096 || !IsReadableProtection(info.Protect))
{
return false;
}
start = info.BaseAddress;
end = regionEnd;
return true;
}
private unsafe static bool TryReadStackU64(ulong address, out ulong value) private unsafe static bool TryReadStackU64(ulong address, out ulong value)
{ {
value = 0uL; value = 0uL;

View File

@ -10,6 +10,7 @@ using System.Runtime.InteropServices;
using System.Threading; using System.Threading;
using SharpEmu.Core.Cpu.Disasm; using SharpEmu.Core.Cpu.Disasm;
using SharpEmu.HLE; using SharpEmu.HLE;
using SharpEmu.HLE.GpuMemory;
namespace SharpEmu.Core.Cpu.Native; namespace SharpEmu.Core.Cpu.Native;
@ -40,15 +41,6 @@ public sealed partial class DirectExecutionBackend
} }
_rawExceptionHandler = (nint)AddVectoredExceptionHandler(1u, _rawExceptionHandlerStub); _rawExceptionHandler = (nint)AddVectoredExceptionHandler(1u, _rawExceptionHandlerStub);
Console.Error.WriteLine($"[LOADER][INFO] Raw exception handler installed: 0x{_rawExceptionHandler:X16}"); Console.Error.WriteLine($"[LOADER][INFO] Raw exception handler installed: 0x{_rawExceptionHandler:X16}");
// The raw handler carries the guest-image write-fault bridge, so the
// path must be compiled before the first protected-page store can
// reach it. Guest code has not started yet, so warming here cannot
// race a real fault.
SharpEmu.HLE.GuestImageWriteTracker.WarmUp();
Console.Error.WriteLine(
"[LOADER][INFO] Guest image CPU write tracking: " +
$"{(SharpEmu.HLE.GuestImageWriteTracker.Enabled ? "enabled" : "disabled")}");
} }
else else
{ {
@ -64,7 +56,6 @@ public sealed partial class DirectExecutionBackend
} }
_exceptionHandler = (nint)AddVectoredExceptionHandler(1u, _exceptionHandlerStub); _exceptionHandler = (nint)AddVectoredExceptionHandler(1u, _exceptionHandlerStub);
Console.Error.WriteLine($"[LOADER][INFO] Exception handler installed: 0x{_exceptionHandler:X16}"); Console.Error.WriteLine($"[LOADER][INFO] Exception handler installed: 0x{_exceptionHandler:X16}");
SharpEmu.HLE.GuestImageWriteTracker.WarmUp();
_unhandledFilterDelegate = UnhandledExceptionFilter; _unhandledFilterDelegate = UnhandledExceptionFilter;
_unhandledFilterHandle = GCHandle.Alloc(_unhandledFilterDelegate); _unhandledFilterHandle = GCHandle.Alloc(_unhandledFilterDelegate);
@ -123,22 +114,19 @@ public sealed partial class DirectExecutionBackend
ulong rip = ReadCtxU64(contextRecord, 248); ulong rip = ReadCtxU64(contextRecord, 248);
ulong rsp = ReadCtxU64(contextRecord, 152); ulong rsp = ReadCtxU64(contextRecord, 152);
if (TryRecoverGuestInt41(exceptionCode, contextRecord, rip)) if (MayBeGuestInt41(exceptionRecord) && TryRecoverGuestInt41(exceptionCode, contextRecord, rip))
{ {
return -1; return -1;
} }
if (exceptionCode == 3221225477u && if (!OperatingSystem.IsWindows() &&
exceptionCode == 3221225477u &&
exceptionRecord->NumberParameters >= 2 && exceptionRecord->NumberParameters >= 2 &&
exceptionRecord->ExceptionInformation[0] == 1uL &&
SharpEmu.HLE.GuestImageWriteTracker.TryHandleWriteFault( SharpEmu.HLE.GuestImageWriteTracker.TryHandleWriteFault(
exceptionRecord->ExceptionInformation[1])) exceptionRecord->ExceptionInformation[1]))
{ {
return -1; return -1;
} }
if (TryRecoverAuxiliaryThreadExecuteFault(exceptionRecord, contextRecord, rip))
{
return -1;
}
if (exceptionCode == 3221225477u && TryHandleLazyCommittedPage(exceptionRecord, rip, rsp)) if (exceptionCode == 3221225477u && TryHandleLazyCommittedPage(exceptionRecord, rip, rsp))
{ {
return -1; return -1;
@ -148,6 +136,17 @@ public sealed partial class DirectExecutionBackend
{ {
return -1; return -1;
} }
if (exceptionCode == 3221225477u && TryResolveGpuFault(exceptionRecord))
{
return -1;
}
// Only a fault none of the handlers above resolves aborts a TBB worker: a write
// to a lazily committed or GPU-tracked page is routine, and aborting the worker
// there strands the guest allocator lock it may hold.
if (TryRecoverAuxiliaryThreadExecuteFault(exceptionRecord, contextRecord, rip))
{
return -1;
}
if (exceptionCode == StatusIllegalInstruction && if (exceptionCode == StatusIllegalInstruction &&
TryRecoverIllegalInstruction(contextRecord, rip)) TryRecoverIllegalInstruction(contextRecord, rip))
{ {
@ -158,6 +157,11 @@ public sealed partial class DirectExecutionBackend
{ {
return -1; return -1;
} }
if (exceptionCode == StatusIllegalInstruction &&
TryRecoverShaInstruction(contextRecord, rip))
{
return -1;
}
if (IsBenignHostDebugException(exceptionCode)) if (IsBenignHostDebugException(exceptionCode))
{ {
return -1; return -1;
@ -280,7 +284,7 @@ public sealed partial class DirectExecutionBackend
for (int i = 0; i < 16; i++) for (int i = 0; i < 16; i++)
{ {
ulong stackAddr = rsp + (ulong)(i * 8); ulong stackAddr = rsp + (ulong)(i * 8);
if (!TryReadHostQword(stackAddr, out ulong value)) if (!TryReadDiagnosticHostQword(stackAddr, out ulong value))
{ {
Console.Error.WriteLine("[LOADER][WARNING] Could not read stack qwords."); Console.Error.WriteLine("[LOADER][WARNING] Could not read stack qwords.");
break; break;
@ -297,7 +301,7 @@ public sealed partial class DirectExecutionBackend
var windowStart = rsp >= 0x300 ? rsp - 0x300 : 0; var windowStart = rsp >= 0x300 ? rsp - 0x300 : 0;
for (var stackAddr = windowStart; stackAddr < rsp + 0x100; stackAddr += 8) for (var stackAddr = windowStart; stackAddr < rsp + 0x100; stackAddr += 8)
{ {
if (!TryReadHostQword(stackAddr, out var value)) if (!TryReadDiagnosticHostQword(stackAddr, out var value))
{ {
continue; continue;
} }
@ -317,6 +321,7 @@ public sealed partial class DirectExecutionBackend
DumpPointerWindow("fault-register-rbx", rbx, 0x60); DumpPointerWindow("fault-register-rbx", rbx, 0x60);
DumpPointerWindow("fault-register-rsi", rsi, 0x60); DumpPointerWindow("fault-register-rsi", rsi, 0x60);
DumpPointerWindow("fault-register-rcx", rcx, 0x80);
DumpPointerWindow("fault-register-rdi", rdi, 0x60); DumpPointerWindow("fault-register-rdi", rdi, 0x60);
DumpPointerWindow("fault-register-r13", r13, 0x60); DumpPointerWindow("fault-register-r13", r13, 0x60);
DumpPointerWindow("fault-register-r14", r14, 0x60); DumpPointerWindow("fault-register-r14", r14, 0x60);
@ -327,11 +332,12 @@ public sealed partial class DirectExecutionBackend
ulong frame = rbp; ulong frame = rbp;
for (int i = 0; i < 12; i++) for (int i = 0; i < 12; i++)
{ {
if (frame < 0x10000) if (!IsCanonicalUserAddress(frame) || (frame & 7) != 0)
{ {
break; break;
} }
if (!TryReadHostQword(frame, out ulong next) || !TryReadHostQword(frame + 8, out ulong ret)) if (!TryReadDiagnosticHostQword(frame, out ulong next) ||
!TryReadDiagnosticHostQword(frame + 8, out ulong ret))
{ {
Console.Error.WriteLine("[LOADER][WARNING] Could not walk RBP frame chain."); Console.Error.WriteLine("[LOADER][WARNING] Could not walk RBP frame chain.");
break; break;
@ -359,7 +365,13 @@ public sealed partial class DirectExecutionBackend
Console.Error.WriteLine("[LOADER][ERROR] - Guest code accessed unmapped memory"); Console.Error.WriteLine("[LOADER][ERROR] - Guest code accessed unmapped memory");
Console.Error.WriteLine("[LOADER][ERROR] - Need to implement HLE for this NID"); Console.Error.WriteLine("[LOADER][ERROR] - Need to implement HLE for this NID");
byte[] code = new byte[16]; byte[] code = new byte[16];
if (TryReadHostBytes(rip, code)) DumpHostRegion("RIP", rip);
// Guest code can be mapped execute-only, which makes every
// host-side read of it fail. The guest memory view still
// resolves those pages, so prefer it here: otherwise the
// whole call-site report below is silently skipped on
// exactly the faults that need it.
if (TryReadGuestOrHostBytes(rip, code))
{ {
Console.Error.WriteLine("[LOADER][INFO] Code at RIP: " + BitConverter.ToString(code).Replace("-", " ")); Console.Error.WriteLine("[LOADER][INFO] Code at RIP: " + BitConverter.ToString(code).Replace("-", " "));
if (code[0] == 100) if (code[0] == 100)
@ -377,12 +389,12 @@ public sealed partial class DirectExecutionBackend
Console.Error.WriteLine($"[LOADER][INFO] RSP: 0x{rsp:X16} (mod 16 = {rsp % 16})"); Console.Error.WriteLine($"[LOADER][INFO] RSP: 0x{rsp:X16} (mod 16 = {rsp % 16})");
} }
byte[] before = new byte[16]; byte[] before = new byte[16];
if (rip > 16 && TryReadHostBytes(rip - 16, before)) if (rip > 16 && TryReadGuestOrHostBytes(rip - 16, before))
{ {
Console.Error.WriteLine("[LOADER][INFO] Code before RIP: " + BitConverter.ToString(before).Replace("-", " ")); Console.Error.WriteLine("[LOADER][INFO] Code before RIP: " + BitConverter.ToString(before).Replace("-", " "));
} }
byte[] window = new byte[64]; byte[] window = new byte[64];
if (rip > 32 && TryReadHostBytes(rip - 32, window)) if (rip > 32 && TryReadGuestOrHostBytes(rip - 32, window))
{ {
Console.Error.WriteLine("[LOADER][INFO] Code window [RIP-0x20..]: " + BitConverter.ToString(window).Replace("-", " ")); Console.Error.WriteLine("[LOADER][INFO] Code window [RIP-0x20..]: " + BitConverter.ToString(window).Replace("-", " "));
} }
@ -399,7 +411,7 @@ public sealed partial class DirectExecutionBackend
continue; continue;
} }
byte[] callSiteWindow = new byte[48]; byte[] callSiteWindow = new byte[48];
if (TryReadHostBytes(candidate - 24, callSiteWindow)) if (TryReadGuestOrHostBytes(candidate - 24, callSiteWindow))
{ {
Console.Error.WriteLine( Console.Error.WriteLine(
$"[LOADER][INFO] Stack guest-code candidate [rsp+0x{stackIndex * 8:X2}]=0x{candidate:X16}, bytes [-0x18..]: " + $"[LOADER][INFO] Stack guest-code candidate [rsp+0x{stackIndex * 8:X2}]=0x{candidate:X16}, bytes [-0x18..]: " +
@ -411,6 +423,11 @@ public sealed partial class DirectExecutionBackend
{ {
Console.Error.WriteLine("[LOADER][ERROR] Could not read code at RIP"); Console.Error.WriteLine("[LOADER][ERROR] Could not read code at RIP");
} }
// The faulting instruction is the first thing an access
// violation report has to answer, so decode it through guest
// memory as well: that path still works when the host code
// page refuses a plain read.
DumpGuestInstructionStream("fault", rip, 4);
DumpRecentImportTrace(); DumpRecentImportTrace();
DumpGuestDisasmDiagnostics(rip, rbp, rsp); DumpGuestDisasmDiagnostics(rip, rbp, rsp);
DumpGuestRegisterWindowDiagnostics( DumpGuestRegisterWindowDiagnostics(
@ -602,6 +619,16 @@ public sealed partial class DirectExecutionBackend
return (ulong)(_workerAbortStack + (nint)WorkerAbortStackSize - 0x100) & ~0xFUL; return (ulong)(_workerAbortStack + (nint)WorkerAbortStackSize - 0x100) & ~0xFUL;
} }
// On Windows an INT n the guest may not execute raises a general-protection fault,
// reported as an access violation whose fault address is all ones; a page fault
// carries the data address instead. GPU-tracked and lazily committed pages fault
// thousands of times per frame, so skip the opcode probe (a VirtualQuery and a
// read of the faulting instruction) for them.
private static unsafe bool MayBeGuestInt41(EXCEPTION_RECORD* exceptionRecord) =>
!OperatingSystem.IsWindows() ||
exceptionRecord->NumberParameters < 2 ||
exceptionRecord->ExceptionInformation[1] == ulong.MaxValue;
private unsafe bool TryRecoverGuestInt41(uint exceptionCode, void* contextRecord, ulong rip) private unsafe bool TryRecoverGuestInt41(uint exceptionCode, void* contextRecord, ulong rip)
{ {
if (!_ignoreGuestInt41 || exceptionCode != 3221225477u || rip < 0x10000) if (!_ignoreGuestInt41 || exceptionCode != 3221225477u || rip < 0x10000)
@ -610,7 +637,7 @@ public sealed partial class DirectExecutionBackend
} }
byte[] opcode = new byte[2]; byte[] opcode = new byte[2];
if (!TryReadHostBytes(rip, opcode) || opcode[0] != 0xCD || opcode[1] != 0x41) if (!TryReadExecutableBytes(rip, opcode) || opcode[0] != 0xCD || opcode[1] != 0x41)
{ {
return false; return false;
} }
@ -626,6 +653,25 @@ public sealed partial class DirectExecutionBackend
return true; return true;
} }
// Runs after the lazy-commit branch. That branch commits the page first.
private unsafe static bool TryResolveGpuFault(EXCEPTION_RECORD* exceptionRecord)
{
if (exceptionRecord->NumberParameters < 2)
{
return false;
}
var kind = exceptionRecord->ExceptionInformation[0] switch
{
0 => FaultKind.Read,
1 => FaultKind.Write,
8 => FaultKind.Execute,
_ => FaultKind.Unknown,
};
return kind != FaultKind.Unknown
&& GuestGpuMemoryHook.TryResolveFault(kind, exceptionRecord->ExceptionInformation[1]);
}
private unsafe static bool TryRecoverGuestAllocatorHole( private unsafe static bool TryRecoverGuestAllocatorHole(
EXCEPTION_RECORD* exceptionRecord, EXCEPTION_RECORD* exceptionRecord,
void* contextRecord, void* contextRecord,
@ -763,7 +809,7 @@ public sealed partial class DirectExecutionBackend
// Optimized guest code frequently omits frame pointers. The return // Optimized guest code frequently omits frame pointers. The return
// address at RSP is then more useful than an RBP walk and identifies the // address at RSP is then more useful than an RBP walk and identifies the
// exact call site that supplied the faulting arguments. // exact call site that supplied the faulting arguments.
if (TryReadHostQword(rsp, out var stackReturn) && stackReturn >= 0x60) if (TryReadDiagnosticHostQword(rsp, out var stackReturn) && stackReturn >= 0x60)
{ {
DumpGuestInstructionStream("stack-return-prelude", stackReturn - 0x60, 40); DumpGuestInstructionStream("stack-return-prelude", stackReturn - 0x60, 40);
} }
@ -1192,7 +1238,7 @@ public sealed partial class DirectExecutionBackend
for (int offset = 0; offset < size; offset += 8) for (int offset = 0; offset < size; offset += 8)
{ {
ulong slotAddress = baseAddress + (ulong)offset; ulong slotAddress = baseAddress + (ulong)offset;
if (!TryReadQword(slotAddress, out var value)) if (slotAddress < baseAddress || !TryReadDiagnosticHostQword(slotAddress, out var value))
{ {
Console.Error.WriteLine($"[LOADER][INFO] +0x{offset:X2}: <unreadable>"); Console.Error.WriteLine($"[LOADER][INFO] +0x{offset:X2}: <unreadable>");
break; break;
@ -1235,6 +1281,11 @@ public sealed partial class DirectExecutionBackend
private static bool TryReadHostQword(ulong address, out ulong value) private static bool TryReadHostQword(ulong address, out ulong value)
{ {
value = 0;
if (address < 0x10000)
{
return false;
}
if (!OperatingSystem.IsWindows()) if (!OperatingSystem.IsWindows())
{ {
// A stray read inside the signal handler would raise a nested // A stray read inside the signal handler would raise a nested
@ -1243,7 +1294,6 @@ public sealed partial class DirectExecutionBackend
return TryReadStackU64(address, out value); return TryReadStackU64(address, out value);
} }
value = 0;
try try
{ {
value = (ulong)Marshal.ReadInt64((nint)address); value = (ulong)Marshal.ReadInt64((nint)address);
@ -1255,25 +1305,90 @@ public sealed partial class DirectExecutionBackend
} }
} }
private unsafe static bool TryReadHostBytes(ulong address, byte[] buffer) private unsafe static bool TryReadDiagnosticHostQword(ulong address, out ulong value)
{ {
if (address < 65536) if (OperatingSystem.IsLinux())
{ {
return false; ulong result = 0;
bool success = TryReadLinuxMemory(address, (byte*)&result, sizeof(ulong));
value = success ? result : 0;
return success;
}
if (OperatingSystem.IsMacOS())
{
ulong result = 0;
bool success = TryReadMacOsMemory(address, (byte*)&result, sizeof(ulong));
value = success ? result : 0;
return success;
} }
if (!OperatingSystem.IsWindows()) if (!OperatingSystem.IsWindows())
{ {
// See TryReadHostQword: probe every touched page before reading. return TryReadStackU64(address, out value);
ulong end = address + (ulong)buffer.Length; }
for (ulong page = address & 0xFFFFFFFFFFFFF000uL; page < end; page += 4096)
value = 0;
if (!IsReadableHostRange(address, sizeof(ulong)))
{
return false;
}
ulong readValue = 0;
if (ReadProcessMemory(
(nint)(-1),
(nint)address,
&readValue,
sizeof(ulong),
out var bytesRead) == 0 ||
bytesRead != sizeof(ulong))
{
return false;
}
value = readValue;
return true;
}
private unsafe static bool TryReadHostBytes(ulong address, byte[] buffer)
{
if (OperatingSystem.IsLinux())
{
fixed (byte* destination = buffer)
{ {
if (VirtualQuery((void*)page, out var mbi, (nuint)sizeof(MEMORY_BASIC_INFORMATION64)) == 0 || return TryReadLinuxMemory(address, destination, buffer.Length);
mbi.State != MEM_COMMIT || }
!IsReadableProtection(mbi.Protect)) }
{
return false; if (OperatingSystem.IsMacOS())
} {
fixed (byte* destination = buffer)
{
return TryReadMacOsMemory(address, destination, buffer.Length);
}
}
if (!IsReadableHostRange(address, buffer.Length))
{
return false;
}
if (buffer.Length == 0)
{
return true;
}
if (OperatingSystem.IsWindows())
{
fixed (byte* destination = buffer)
{
return ReadProcessMemory(
(nint)(-1),
(nint)address,
destination,
(nuint)buffer.Length,
out var bytesRead) != 0 &&
bytesRead == (nuint)buffer.Length;
} }
} }
@ -1288,6 +1403,176 @@ public sealed partial class DirectExecutionBackend
} }
} }
private unsafe static bool TryReadLinuxMemory(ulong address, byte* destination, int byteCount)
{
if (byteCount < 0 || !IsCanonicalUserAddress(address) ||
address > 0x0000_8000_0000_0000UL - (ulong)byteCount)
{
return false;
}
if (byteCount == 0) return true;
// Read through the kernel so untracked or inaccessible pages cannot fault the reader.
var local = new DiagnosticMemoryVector { Address = (nint)destination, Length = (nuint)byteCount };
var remote = new DiagnosticMemoryVector { Address = (nint)address, Length = (nuint)byteCount };
return ReadLinuxProcessMemory(Environment.ProcessId, &local, 1, &remote, 1, 0) == byteCount;
}
[StructLayout(LayoutKind.Sequential)]
private struct DiagnosticMemoryVector
{
public nint Address;
public nuint Length;
}
[DllImport("libc", EntryPoint = "process_vm_readv")]
private unsafe static extern nint ReadLinuxProcessMemory(
int processId, DiagnosticMemoryVector* local, nuint localCount,
DiagnosticMemoryVector* remote, nuint remoteCount, nuint flags);
private unsafe static bool TryReadMacOsMemory(ulong address, byte* destination, int byteCount)
{
if (byteCount < 0 || !IsCanonicalUserAddress(address) ||
address > 0x0000_8000_0000_0000UL - (ulong)byteCount)
{
return false;
}
if (byteCount == 0)
{
return true;
}
// The host memory table does not contain all guest code mappings.
// Use Mach to read the memory and report access errors without another fault.
return ReadMachVirtualMemory(GetCurrentMachTask(), address, (ulong)byteCount,
(ulong)destination, out var bytesRead) == 0 && bytesRead == (ulong)byteCount;
}
[DllImport("libSystem.B.dylib", EntryPoint = "mach_task_self")]
private static extern uint GetCurrentMachTask();
[DllImport("libSystem.B.dylib", EntryPoint = "mach_vm_read_overwrite")]
private static extern int ReadMachVirtualMemory(
uint taskHandle, ulong sourceAddress, ulong byteCount, ulong destinationAddress, out ulong bytesRead);
private unsafe static bool TryReadExecutableBytes(ulong address, byte[] buffer)
{
if (!OperatingSystem.IsWindows())
{
return TryReadHostBytes(address, buffer);
}
// Faulting x64 code can have execute-only protection. Data probes still require read access.
if (!IsReadableHostRange(address, buffer.Length, allowExecuteOnly: true))
{
return false;
}
if (buffer.Length == 0)
{
return true;
}
// RIP identifies code that Windows was already executing when the
// exception occurred. These mappings are stable for the duration of
// dispatch, so read them directly. Arbitrary diagnostic and operand
// addresses continue to use ReadProcessMemory above because they can
// become invalid while an exception is being reported.
new ReadOnlySpan<byte>((void*)address, buffer.Length).CopyTo(buffer);
return true;
}
/// <summary>
/// Reads guest bytes for a crash report, preferring the guest memory view
/// over a raw host read. Guest code pages are commonly committed
/// PAGE_EXECUTE, which no host read can satisfy.
/// </summary>
private bool TryReadGuestOrHostBytes(ulong address, byte[] buffer)
{
if (_cpuContext is { } context)
{
try
{
if (context.Memory.TryRead(address, buffer))
{
return true;
}
}
catch
{
// Fall through to the host reader.
}
}
return TryReadHostBytes(address, buffer);
}
private unsafe static void DumpHostRegion(string name, ulong address)
{
if (VirtualQuery((void*)address, out var mbi, (nuint)sizeof(MEMORY_BASIC_INFORMATION64)) == 0)
{
Console.Error.WriteLine($"[LOADER][INFO] {name} region: <VirtualQuery failed> address=0x{address:X16}");
return;
}
Console.Error.WriteLine(
$"[LOADER][INFO] {name} region: base=0x{mbi.BaseAddress:X16} size=0x{mbi.RegionSize:X16} " +
$"state=0x{mbi.State:X08} protect=0x{mbi.Protect:X08} type=0x{mbi.Type:X08}");
}
private unsafe static bool IsReadableHostRange(ulong address, int byteCount, bool allowExecuteOnly = false)
{
if (byteCount < 0 || !IsCanonicalUserAddress(address))
{
return false;
}
var length = (ulong)byteCount;
if (address > 0x0000_8000_0000_0000UL - length)
{
return false;
}
var end = address + length;
var cursor = address;
while (cursor < end)
{
if (VirtualQuery(
(void*)cursor,
out var mbi,
(nuint)sizeof(MEMORY_BASIC_INFORMATION64)) == 0 ||
mbi.State != MEM_COMMIT ||
(!IsReadableProtection(mbi.Protect) &&
!(allowExecuteOnly && mbi.Protect == 0x10)))
{
return false;
}
var regionEnd = mbi.BaseAddress + mbi.RegionSize;
if (regionEnd < mbi.BaseAddress || regionEnd <= cursor)
{
return false;
}
cursor = Math.Min(regionEnd, end);
}
return true;
}
private static bool IsCanonicalUserAddress(ulong address) =>
address >= 0x10000 && address < 0x0000_8000_0000_0000UL;
[DllImport("kernel32.dll", SetLastError = false)]
private unsafe static extern int ReadProcessMemory(
nint process,
nint baseAddress,
void* buffer,
nuint byteCount,
out nuint bytesRead);
private string FormatPointerWithNearestSymbol(ulong value) private string FormatPointerWithNearestSymbol(ulong value)
{ {
string text = $"0x{value:X16}"; string text = $"0x{value:X16}";
@ -1301,9 +1586,10 @@ public sealed partial class DirectExecutionBackend
private void InitializeRuntimeSymbolIndex(IReadOnlyDictionary<string, ulong> runtimeSymbols) private void InitializeRuntimeSymbolIndex(IReadOnlyDictionary<string, ulong> runtimeSymbols)
{ {
_runtimeSymbolsByName.Clear(); var symbolsByName = new Dictionary<string, ulong>(StringComparer.Ordinal);
if (runtimeSymbols.Count == 0) if (runtimeSymbols.Count == 0)
{ {
Volatile.Write(ref _runtimeSymbolsByName, symbolsByName);
_runtimeSymbolsByAddress = Array.Empty<KeyValuePair<string, ulong>>(); _runtimeSymbolsByAddress = Array.Empty<KeyValuePair<string, ulong>>();
return; return;
} }
@ -1314,11 +1600,12 @@ public sealed partial class DirectExecutionBackend
if (runtimeSymbol.Value != 0L && !string.IsNullOrWhiteSpace(runtimeSymbol.Key)) if (runtimeSymbol.Value != 0L && !string.IsNullOrWhiteSpace(runtimeSymbol.Key))
{ {
list.Add(runtimeSymbol); list.Add(runtimeSymbol);
_runtimeSymbolsByName[runtimeSymbol.Key] = runtimeSymbol.Value; symbolsByName[runtimeSymbol.Key] = runtimeSymbol.Value;
} }
} }
list.Sort((a, b) => a.Value.CompareTo(b.Value)); list.Sort((a, b) => a.Value.CompareTo(b.Value));
Volatile.Write(ref _runtimeSymbolsByName, symbolsByName);
_runtimeSymbolsByAddress = list.ToArray(); _runtimeSymbolsByAddress = list.ToArray();
} }
@ -1453,6 +1740,7 @@ public sealed partial class DirectExecutionBackend
} }
TryCommitRange(pageBase + 4096, 4096uL, commitProtect); TryCommitRange(pageBase + 4096, 4096uL, commitProtect);
RescanTlsPatternsIfExecutable(committedBase, committedSize + 4096uL, commitProtect);
if (traceLazyCommit) if (traceLazyCommit)
{ {
Console.Error.WriteLine($"[LOADER][TRACE] lazy-reserve-commit#{traceIndex}: addr=0x{committedBase:X16} size=0x{committedSize:X16} access={accessType} protect=0x{commitProtect:X8}"); Console.Error.WriteLine($"[LOADER][TRACE] lazy-reserve-commit#{traceIndex}: addr=0x{committedBase:X16} size=0x{committedSize:X16} access={accessType} protect=0x{commitProtect:X8}");
@ -1512,6 +1800,7 @@ public sealed partial class DirectExecutionBackend
} }
TryCommitRange(pageBase + 4096, 4096uL, commitProtect); TryCommitRange(pageBase + 4096, 4096uL, commitProtect);
RescanTlsPatternsIfExecutable(committedBase, committedSize + 4096uL, commitProtect);
if (traceLazyCommit) if (traceLazyCommit)
{ {
Console.Error.WriteLine($"[LOADER][TRACE] lazy-commit#{traceIndex}: addr=0x{committedBase:X16} size=0x{committedSize:X16} access={accessType} protect=0x{commitProtect:X8}"); Console.Error.WriteLine($"[LOADER][TRACE] lazy-commit#{traceIndex}: addr=0x{committedBase:X16} size=0x{committedSize:X16} access={accessType} protect=0x{commitProtect:X8}");
@ -1613,6 +1902,25 @@ public sealed partial class DirectExecutionBackend
} }
} }
// Re-scans a just-committed window for FS:[0] TLS loads; skips non-executable commits.
private unsafe void RescanTlsPatternsIfExecutable(ulong committedBase, ulong committedSize, uint commitProtect)
{
const uint executableProtectionMask = PAGE_EXECUTE | PAGE_EXECUTE_READ | PAGE_EXECUTE_READWRITE | PAGE_EXECUTE_WRITECOPY;
if ((commitProtect & executableProtectionMask) == 0 || committedSize == 0)
{
return;
}
var counts = PatchTlsPatternsInRange(committedBase, committedBase + committedSize);
if (counts.Total != 0)
{
Console.Error.WriteLine(
$"[LOADER][INFO] Patched {counts.Loads} TLS loads, {counts.Stores} TLS stores, " +
$"{counts.StackCanaries} stack-canary accesses " +
$"(lazy-commit rescan 0x{committedBase:X16}-0x{committedBase + committedSize:X16})");
}
}
private static bool ShouldTraceLazyCommit(int traceIndex) private static bool ShouldTraceLazyCommit(int traceIndex)
{ {
if (string.Equals(Environment.GetEnvironmentVariable("SHARPEMU_LOG_LAZY_COMMIT"), "1", StringComparison.Ordinal)) if (string.Equals(Environment.GetEnvironmentVariable("SHARPEMU_LOG_LAZY_COMMIT"), "1", StringComparison.Ordinal))

View File

@ -0,0 +1,286 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
using SharpEmu.HLE;
namespace SharpEmu.Core.Cpu.Native;
/// <summary>
/// Native fast-path stubs for the trivial per-thread imports that dominate the
/// HLE call count. Each stub answers from <see cref="GuestFastPath"/>'s
/// per-host-thread block and jumps to the normal import trampoline whenever it
/// cannot, so the managed implementation stays the single source of truth for
/// every case the stub does not handle.
/// </summary>
public sealed unsafe partial class DirectExecutionBackend
{
internal enum GuestFastPathStub
{
None,
PthreadSelf,
PthreadGetspecific,
MemoryCopy,
}
// scePthreadSelf / pthread_self.
private const string PthreadSelfNid = "aI+OeCz8xrQ";
private const string PosixPthreadSelfNid = "EotR8a3ASf4";
// scePthreadGetspecific / pthread_getspecific.
private const string PthreadGetspecificNid = "eoht7mQOCmo";
private const string PosixPthreadGetspecificNid = "0-KXaS70xy4";
// memcpy / memmove.
private const string MemcpyNid = "Q3VBxCXhUHs";
private const string MemmoveNid = "+P6FRGH4LfA";
// Guest memory is identity-mapped and every fault the copy can take (write tracking, lazy
// commit) is resolved from the fault address alone, so the copy may run as guest-side code.
// SHARPEMU_HLE_FAST_MEMCPY=0 keeps it on the managed export.
private static readonly bool GuestMemoryCopyStubEnabled =
!string.Equals(Environment.GetEnvironmentVariable("SHARPEMU_HLE_FAST_MEMCPY"), "0", StringComparison.Ordinal);
private uint _fastPathBlockTlsIndex = uint.MaxValue;
private bool _guestFastPathEnabled;
private int _guestFastPathStubCount;
/// <summary>
/// Decides whether native fast-path stubs may be installed for this run and
/// arms <see cref="GuestFastPath"/> if so. Any diagnostic mode that must
/// observe every import call keeps the fast path off, because a stub answers
/// without ever reaching the managed gateway that does the tracing.
/// </summary>
private void ConfigureGuestFastPath()
{
_guestFastPathEnabled = false;
_guestFastPathStubCount = 0;
// Emission uses the macOS pthread gs-indexed key array. Windows and
// Linux keep the managed gateway until their TLS read is emitted too.
if (!OperatingSystem.IsMacOS() ||
RuntimeInformation.ProcessArchitecture != Architecture.X64)
{
return;
}
if (string.Equals(Environment.GetEnvironmentVariable("SHARPEMU_HLE_FAST_PATH"), "0", StringComparison.Ordinal))
{
Console.Error.WriteLine("[LOADER][INFO] HLE native fast path disabled by SHARPEMU_HLE_FAST_PATH=0.");
return;
}
if (_logAllImports ||
!string.IsNullOrEmpty(_importFilter) ||
string.Equals(Environment.GetEnvironmentVariable("SHARPEMU_LOG_PTHREADS"), "1", StringComparison.Ordinal))
{
Console.Error.WriteLine(
"[LOADER][INFO] HLE native fast path disabled: import/pthread tracing needs every call in the gateway.");
return;
}
if (_fastPathBlockTlsIndex == uint.MaxValue)
{
_fastPathBlockTlsIndex = TlsAlloc();
if (_fastPathBlockTlsIndex == uint.MaxValue)
{
return;
}
}
var tlsIndex = _fastPathBlockTlsIndex;
GuestFastPath.Enable(block => TlsSetValue(tlsIndex, block));
_guestFastPathEnabled = true;
}
private static GuestFastPathStub ClassifyGuestFastPathStub(string nid) => nid switch
{
PthreadSelfNid or PosixPthreadSelfNid => GuestFastPathStub.PthreadSelf,
PthreadGetspecificNid or PosixPthreadGetspecificNid => GuestFastPathStub.PthreadGetspecific,
MemcpyNid or MemmoveNid => GuestFastPathStub.MemoryCopy,
_ => GuestFastPathStub.None,
};
/// <summary>
/// Builds the native stub for <paramref name="nid"/>, falling back to
/// <paramref name="fallbackTrampoline"/> (the import's managed gateway
/// trampoline) for every case the stub declines.
/// </summary>
private unsafe bool TryCreateGuestFastPathStub(string nid, nint fallbackTrampoline, out nint address)
{
address = 0;
if (!_guestFastPathEnabled || fallbackTrampoline == 0)
{
return false;
}
var kind = ClassifyGuestFastPathStub(nid);
if (kind == GuestFastPathStub.None ||
// The write watch inspects every managed guest write, which a native copy never reaches.
(kind == GuestFastPathStub.MemoryCopy && (!GuestMemoryCopyStubEnabled || GuestWriteWatch.Armed)))
{
return false;
}
var code = EmitGuestFastPathStub(kind, _fastPathBlockTlsIndex, fallbackTrampoline);
const uint stubAllocationSize = 128u;
if (code.Count > stubAllocationSize)
{
return false;
}
void* memory = VirtualAlloc(null, stubAllocationSize, 12288u, 64u);
if (memory == null)
{
return false;
}
for (var i = 0; i < code.Count; i++)
{
((byte*)memory)[i] = code[i];
}
uint oldProtect = 0;
if (!VirtualProtect(memory, stubAllocationSize, 32u, &oldProtect))
{
VirtualFree(memory, 0u, 32768u);
return false;
}
FlushInstructionCache(GetCurrentProcess(), memory, (nuint)code.Count);
address = (nint)memory;
_importHandlerTrampolines.Add(address);
_guestFastPathStubCount++;
return true;
}
/// <summary>
/// Emits one fast-path stub. The stubs obey the SysV ABI the guest calls
/// them with: the answer goes in RAX, only RAX and the arithmetic flags are
/// clobbered (both caller-saved across a call), and on the slow path every
/// register - including the incoming RAX that carries the variadic vector
/// count - is restored before jumping to the trampoline.
/// </summary>
internal static List<byte> EmitGuestFastPathStub(
GuestFastPathStub kind,
uint blockTlsIndex,
nint fallbackTrampoline)
{
if (kind == GuestFastPathStub.MemoryCopy)
{
return EmitGuestMemoryCopyStub(fallbackTrampoline);
}
var code = new List<byte>(48);
var slowPathFixups = new List<int>();
void Emit(params byte[] bytes) => code.AddRange(bytes);
// Emits a short conditional branch to the slow path; 0x74 is JE, 0x73 is JAE.
void EmitBranchToSlowPath(byte opcode)
{
Emit(opcode, 0x00); // rel8, patched once the slow-path offset is known
slowPathFixups.Add(code.Count - 1);
}
void EmitJumpToSlowPath() => EmitBranchToSlowPath(0x74);
// push rax: the guest's incoming RAX/AL must survive a slow-path bail.
Emit(0x50);
// mov rax, gs:[blockTlsIndex * 8] - the macOS pthread key array is the
// gs-based thread specific data array, so a key read is a single load.
Emit(0x65, 0x48, 0x8B, 0x04, 0x25);
code.AddRange(BitConverter.GetBytes(checked(blockTlsIndex * 8u)));
// test rax, rax / je slow: no block published on this host thread.
Emit(0x48, 0x85, 0xC0);
EmitJumpToSlowPath();
switch (kind)
{
case GuestFastPathStub.PthreadSelf:
// cmp qword [rax + SelfHandleOffset], 0 / je slow: no guest
// thread bound here, and a host thread's pthread_self has to
// reach the managed export for its scheduler registration.
Emit(0x48, 0x83, 0x78, checked((byte)GuestFastPath.BlockSelfHandleOffset), 0x00);
EmitJumpToSlowPath();
// inc qword [rax + SelfHitsOffset]
Emit(0x48, 0xFF, 0x40, checked((byte)GuestFastPath.BlockSelfHitsOffset));
// mov rax, [rax + SelfHandleOffset]
Emit(0x48, 0x8B, 0x40, checked((byte)GuestFastPath.BlockSelfHandleOffset));
break;
case GuestFastPathStub.PthreadGetspecific:
// cmp qword [rax + TlsValuesOffset], 0 / je slow: this thread
// has no value table published.
Emit(0x48, 0x83, 0x78, checked((byte)GuestFastPath.BlockTlsValuesOffset), 0x00);
EmitJumpToSlowPath();
// cmp rdi, TlsSlotCount / jae slow. An out-of-range or
// sign-extended negative key is answered by the managed path,
// which truncates it to int and consults the key registry.
Emit(0x48, 0x81, 0xFF);
code.AddRange(BitConverter.GetBytes(GuestFastPath.TlsSlotCount));
EmitBranchToSlowPath(0x73);
// inc qword [rax + GetspecificHitsOffset]
Emit(0x48, 0xFF, 0x40, checked((byte)GuestFastPath.BlockGetspecificHitsOffset));
// mov rax, [rax + TlsValuesOffset] / mov rax, [rax + rdi*8]
Emit(0x48, 0x8B, 0x40, checked((byte)GuestFastPath.BlockTlsValuesOffset));
Emit(0x48, 0x8B, 0x04, 0xF8);
break;
default:
throw new ArgumentOutOfRangeException(nameof(kind), kind, "Unknown fast-path stub kind.");
}
// add rsp, 8 (drop the saved RAX - the result replaces it) / ret
Emit(0x48, 0x83, 0xC4, 0x08);
Emit(0xC3);
var slowPathOffset = code.Count;
// pop rax / jmp qword [rip+0] - the absolute target follows the
// instruction, so nothing else is clobbered on the way out.
Emit(0x58);
Emit(0xFF, 0x25, 0x00, 0x00, 0x00, 0x00);
code.AddRange(BitConverter.GetBytes((long)fallbackTrampoline));
foreach (var fixup in slowPathFixups)
{
var delta = slowPathOffset - (fixup + 1);
if (delta is < 0 or > 127)
{
throw new InvalidOperationException("Fast-path stub slow-path branch is out of rel8 range.");
}
code[fixup] = (byte)delta;
}
return code;
}
/// <summary>
/// memcpy/memmove(dst, src, n) as a forward <c>rep movsb</c>, returning dst. The libc
/// export copies with memmove semantics, so a destination that starts inside the source
/// (where a forward copy would read bytes it already overwrote) takes the managed path.
/// Only RAX, RCX, RSI, RDI and the flags change - all caller-saved - and the direction
/// flag is clear on entry per the SysV ABI.
/// </summary>
internal static List<byte> EmitGuestMemoryCopyStub(nint fallbackTrampoline)
{
var code = new List<byte>(40);
// mov rcx, rdi / sub rcx, rsi / cmp rcx, rdx / jb slow: dst - src < n (unsigned) is
// exactly a destination in (src, src + n) or equal to src with a non-empty copy.
code.AddRange([0x48, 0x89, 0xF9, 0x48, 0x29, 0xF1, 0x48, 0x39, 0xD1, 0x72, 0x00]);
var slowPathFixup = code.Count - 1;
// mov rax, rdi / mov rcx, rdx / rep movsb / ret
code.AddRange([0x48, 0x89, 0xF8, 0x48, 0x89, 0xD1, 0xF3, 0xA4, 0xC3]);
code[slowPathFixup] = checked((byte)(code.Count - (slowPathFixup + 1)));
// jmp qword [rip+0] with the absolute trampoline address after it.
code.AddRange([0xFF, 0x25, 0x00, 0x00, 0x00, 0x00]);
code.AddRange(BitConverter.GetBytes((long)fallbackTrampoline));
return code;
}
}

View File

@ -7,6 +7,7 @@ using System.Collections.Generic;
using System.Diagnostics; using System.Diagnostics;
using System.Linq; using System.Linq;
using System.Threading; using System.Threading;
using SharpEmu.HLE;
namespace SharpEmu.Core.Cpu.Native; namespace SharpEmu.Core.Cpu.Native;
@ -40,6 +41,9 @@ public sealed partial class DirectExecutionBackend
? report ? report
: 15; : 15;
private static readonly string? _profileGuestRipThreadFilter =
Environment.GetEnvironmentVariable("SHARPEMU_PROFILE_GUEST_RIP_THREAD");
private const ulong GuestImageBase = 0x0000_0008_0000_0000UL; private const ulong GuestImageBase = 0x0000_0008_0000_0000UL;
private const ulong GuestImageLimit = 0x0000_0009_0000_0000UL; private const ulong GuestImageLimit = 0x0000_0009_0000_0000UL;
@ -48,31 +52,30 @@ public sealed partial class DirectExecutionBackend
private readonly ConcurrentDictionary<string, long> _guestRipThreadSamples = new(); private readonly ConcurrentDictionary<string, long> _guestRipThreadSamples = new();
private readonly ConcurrentDictionary<string, long> _guestWaitSamples = new(); private readonly ConcurrentDictionary<string, long> _guestWaitSamples = new();
private readonly ConcurrentDictionary<string, long> _guestThreadWaitSamples = new(); private readonly ConcurrentDictionary<string, long> _guestThreadWaitSamples = new();
private readonly ConcurrentDictionary<string, long> _guestThreadWaitReasonSamples = new();
private long _guestRipTotalSamples; private long _guestRipTotalSamples;
private long _guestWaitTotalSamples; private long _guestWaitTotalSamples;
private long _guestRipCaptureFailures; private long _guestRipCaptureFailures;
private long _guestRipSamplerErrors; private long _guestRipSamplerErrors;
private int _guestRipSampleCursor;
private readonly record struct GuestRipSampleTarget(
string Name,
CpuContext Context,
int HostThreadId,
string? BlockReason);
/// <summary> /// <summary>
/// Names the HLE call a thread is parked in, using the guest RIP the import /// Names the HLE call a thread is parked in, using the guest RIP the import
/// dispatcher left on its context. /// dispatcher left on its context.
/// </summary> /// </summary>
private string ResolveWaitLabel(GuestThreadState thread) private string ResolveWaitLabel(CpuContext context, string? blockReason)
{ {
var context = thread.Context;
if (context is null)
{
return "<no-context>";
}
var importIndex = context.ActiveImportIndex; var importIndex = context.ActiveImportIndex;
if ((uint)importIndex >= (uint)_importEntries.Length) if ((uint)importIndex >= (uint)_importEntries.Length)
{ {
// Host code with no import in flight: the thread is parked by the // Host code with no import in flight: the thread is parked by the
// emulator's own scheduler. The cooperative block records why, which // emulator's own scheduler. The cooperative block records why, which
// is the part that actually identifies what the frame is waiting on. // is the part that actually identifies what the frame is waiting on.
var blockReason = thread.BlockReason;
return string.IsNullOrEmpty(blockReason) return string.IsNullOrEmpty(blockReason)
? "<idle-or-scheduler>" ? "<idle-or-scheduler>"
: $"blocked:{blockReason}"; : $"blocked:{blockReason}";
@ -116,7 +119,8 @@ public sealed partial class DirectExecutionBackend
sampler.Start(); sampler.Start();
Console.Error.WriteLine( Console.Error.WriteLine(
$"[PERF][GUEST] RIP sampler started: interval={_profileGuestRipIntervalMs}ms " + $"[PERF][GUEST] RIP sampler started: interval={_profileGuestRipIntervalMs}ms " +
$"report={_profileGuestRipReportSeconds}s"); $"report={_profileGuestRipReportSeconds}s " +
$"thread={_profileGuestRipThreadFilter ?? "<all>"}");
} }
private void GuestRipSampleLoop() private void GuestRipSampleLoop()
@ -129,14 +133,20 @@ public sealed partial class DirectExecutionBackend
{ {
try try
{ {
var guestThreads = SnapshotGuestThreads(); var guestThreads = SnapshotGuestRipTargets();
var sampleIndex = guestThreads.Length == 0 if (!string.IsNullOrWhiteSpace(_profileGuestRipThreadFilter))
? 0
: (int)((uint)Interlocked.Increment(ref _guestRipSampleCursor) % (uint)guestThreads.Length);
foreach (var thread in guestThreads.Skip(sampleIndex).Take(1))
{ {
var hostThreadId = Volatile.Read(ref thread.HostThreadId); guestThreads = guestThreads
if (hostThreadId == 0) .Where(thread => thread.Name.Contains(
_profileGuestRipThreadFilter,
StringComparison.OrdinalIgnoreCase))
.ToArray();
}
var sampledHostThreads = new HashSet<int>();
foreach (var thread in guestThreads)
{
var hostThreadId = thread.HostThreadId;
if (hostThreadId == 0 || !sampledHostThreads.Add(hostThreadId))
{ {
continue; continue;
} }
@ -165,12 +175,18 @@ public sealed partial class DirectExecutionBackend
continue; continue;
} }
var threadName = string.IsNullOrEmpty(thread.Name) ? "<unnamed>" : thread.Name;
var waitLabel = ResolveWaitLabel(thread.Context, thread.BlockReason);
_guestWaitSamples.AddOrUpdate( _guestWaitSamples.AddOrUpdate(
ResolveWaitLabel(thread), waitLabel,
1, 1,
static (_, value) => value + 1); static (_, value) => value + 1);
_guestThreadWaitSamples.AddOrUpdate( _guestThreadWaitSamples.AddOrUpdate(
string.IsNullOrEmpty(thread.Name) ? "<unnamed>" : thread.Name, threadName,
1,
static (_, value) => value + 1);
_guestThreadWaitReasonSamples.AddOrUpdate(
$"{threadName}\u001F{waitLabel}",
1, 1,
static (_, value) => value + 1); static (_, value) => value + 1);
Interlocked.Increment(ref _guestWaitTotalSamples); Interlocked.Increment(ref _guestWaitTotalSamples);
@ -201,10 +217,38 @@ public sealed partial class DirectExecutionBackend
} }
} }
private GuestRipSampleTarget[] SnapshotGuestRipTargets()
{
using (LockGate("SnapshotGuestRipTargets"))
{
var targets = new GuestRipSampleTarget[_guestThreads.Count + _externalGuestThreads.Count];
var index = 0;
foreach (var thread in _guestThreads.Values)
{
targets[index++] = new GuestRipSampleTarget(
thread.Name,
thread.Context,
Volatile.Read(ref thread.HostThreadId),
thread.BlockReason);
}
foreach (var pair in _externalGuestThreads)
{
var thread = pair.Value;
targets[index++] = new GuestRipSampleTarget(
thread.Name,
thread.Context,
Volatile.Read(ref thread.HostThreadId),
null);
}
return targets;
}
}
private void ReportGuestRipSamples(long windowSamples, double windowSeconds) private void ReportGuestRipSamples(long windowSamples, double windowSeconds)
{ {
var total = Interlocked.Read(ref _guestRipTotalSamples); if (windowSamples == 0)
if (total == 0)
{ {
return; return;
} }
@ -233,7 +277,7 @@ public sealed partial class DirectExecutionBackend
} }
Console.Error.WriteLine( Console.Error.WriteLine(
$"[PERF][GUEST] samples={total} window={windowSamples} in {windowSeconds:F1}s " + $"[PERF][GUEST] window={windowSamples} in {windowSeconds:F1}s " +
$"capture_failures={Interlocked.Read(ref _guestRipCaptureFailures)}"); $"capture_failures={Interlocked.Read(ref _guestRipCaptureFailures)}");
Console.Error.WriteLine( Console.Error.WriteLine(
@ -243,7 +287,7 @@ public sealed partial class DirectExecutionBackend
byRip.OrderByDescending(pair => pair.Value) byRip.OrderByDescending(pair => pair.Value)
.Take(12) .Take(12)
.Select(pair => .Select(pair =>
$"0x{pair.Key:X}{DescribeGuestAddress(pair.Key)}={pair.Value * 100.0 / total:F1}%"))); $"0x{pair.Key:X}{DescribeGuestAddress(pair.Key)}={pair.Value * 100.0 / windowSamples:F1}%")));
Console.Error.WriteLine( Console.Error.WriteLine(
"[PERF][GUEST] top_page: " + "[PERF][GUEST] top_page: " +
@ -252,7 +296,7 @@ public sealed partial class DirectExecutionBackend
byPage.OrderByDescending(pair => pair.Value) byPage.OrderByDescending(pair => pair.Value)
.Take(8) .Take(8)
.Select(pair => .Select(pair =>
$"0x{pair.Key:X}{DescribeGuestAddress(pair.Key)}={pair.Value * 100.0 / total:F1}%"))); $"0x{pair.Key:X}{DescribeGuestAddress(pair.Key)}={pair.Value * 100.0 / windowSamples:F1}%")));
var byWait = new List<KeyValuePair<string, long>>(_guestWaitSamples.Count + 16); var byWait = new List<KeyValuePair<string, long>>(_guestWaitSamples.Count + 16);
foreach (var pair in _guestWaitSamples) foreach (var pair in _guestWaitSamples)
@ -262,12 +306,26 @@ public sealed partial class DirectExecutionBackend
var waitTotal = Interlocked.Read(ref _guestWaitTotalSamples); var waitTotal = Interlocked.Read(ref _guestWaitTotalSamples);
Console.Error.WriteLine( Console.Error.WriteLine(
$"[PERF][GUEST] waiting={waitTotal * 100.0 / total:F1}% of guest thread-time; top_wait: " + $"[PERF][GUEST] waiting={waitTotal * 100.0 / windowSamples:F1}% of guest thread-time; top_wait: " +
string.Join( string.Join(
" | ", " | ",
byWait.OrderByDescending(pair => pair.Value) byWait.OrderByDescending(pair => pair.Value)
.Take(12) .Take(12)
.Select(pair => $"{pair.Key}={pair.Value * 100.0 / total:F1}%"))); .Select(pair => $"{pair.Key}={pair.Value * 100.0 / windowSamples:F1}%")));
Console.Error.WriteLine(
"[PERF][GUEST] thread_wait: " +
string.Join(
" | ",
_guestThreadWaitReasonSamples.OrderByDescending(pair => pair.Value)
.Take(16)
.Select(pair =>
{
var separator = pair.Key.IndexOf('\u001F');
var threadName = separator >= 0 ? pair.Key[..separator] : pair.Key;
var waitLabel = separator >= 0 ? pair.Key[(separator + 1)..] : "<unknown>";
return $"{threadName}->{waitLabel}={pair.Value * 100.0 / windowSamples:F1}%";
})));
// Per-thread spin/park split. The global wait share mixes the job pool in // Per-thread spin/park split. The global wait share mixes the job pool in
// with a dozen dormant threads, which hides the number that matters: // with a dozen dormant threads, which hides the number that matters:
@ -291,7 +349,14 @@ public sealed partial class DirectExecutionBackend
" | ", " | ",
byThread.OrderByDescending(pair => pair.Value) byThread.OrderByDescending(pair => pair.Value)
.Take(10) .Take(10)
.Select(pair => $"{pair.Key}={pair.Value * 100.0 / total:F1}%"))); .Select(pair => $"{pair.Key}={pair.Value * 100.0 / windowSamples:F1}%")));
_guestRipSamples.Clear();
_guestRipThreadSamples.Clear();
_guestWaitSamples.Clear();
_guestThreadWaitSamples.Clear();
_guestThreadWaitReasonSamples.Clear();
Interlocked.Exchange(ref _guestWaitTotalSamples, 0);
} }
/// <summary> /// <summary>

View File

@ -0,0 +1,309 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.Collections.Concurrent;
using System.Diagnostics;
namespace SharpEmu.Core.Cpu.Native;
public sealed unsafe partial class DirectExecutionBackend
{
private sealed class GuestSchedulerThreadStats
{
public string Name = string.Empty;
public long ReadyTimestamp;
public long BlockTimestamp;
public long ScheduledTimestamp;
public long RunTimestamp;
public long ReadyCount;
public long ClaimCount;
public long ScheduleCount;
public long RunCount;
public long BlockCount;
public long ResumeCount;
public long ReadyTicks;
public long BlockTicks;
public long ScheduleTicks;
public long RunTicks;
public long MaxReadyTicks;
public long MaxBlockTicks;
public long MaxScheduleTicks;
public long MaxRunTicks;
public string? LastBlockReason;
public int Completed;
}
private static readonly bool _profileGuestScheduler =
string.Equals(
Environment.GetEnvironmentVariable("SHARPEMU_PROFILE_GUEST_SCHEDULER"),
"1",
StringComparison.Ordinal) ||
string.Equals(
Environment.GetEnvironmentVariable("SHARPEMU_PROFILE_PERFORMANCE"),
"1",
StringComparison.Ordinal);
private readonly ConcurrentDictionary<ulong, GuestSchedulerThreadStats> _guestSchedulerStats = new();
private readonly GuestThreadFlowProfile _guestThreadFlowProfile = new();
private readonly object _guestTraceOutputGate = new();
private long _guestSchedulerProfileWindowStart = Stopwatch.GetTimestamp();
private long _guestSchedulerProfileNextReport =
Stopwatch.GetTimestamp() + (Stopwatch.Frequency * 5L);
private int _guestSchedulerProfileReporting;
private void StartGuestFlowTraces()
{
lock (_guestTraceOutputGate)
{
_guestThreadFlowProfile.StartSession();
SharpEmu.Libs.Diagnostics.SemaphoreSignalProfile.StartSession();
SharpEmu.Libs.Diagnostics.MutexHandoffProfile.StartSession();
SharpEmu.Libs.VideoOut.SubmissionFlowProfile.StartSession();
}
}
private void WriteGuestFlowTraces(TextWriter? output = null)
{
output ??= Console.Error;
lock (_guestTraceOutputGate)
{
var signals = SharpEmu.Libs.Diagnostics.SemaphoreSignalProfile.Close();
var mutexes = SharpEmu.Libs.Diagnostics.MutexHandoffProfile.Close();
SharpEmu.Libs.VideoOut.SubmissionFlowProfile.WriteTrace(output);
try
{
_guestThreadFlowProfile.WriteTrace(output);
SharpEmu.Libs.Diagnostics.SemaphoreSignalProfile.WriteTrace(output, signals);
SharpEmu.Libs.Diagnostics.MutexHandoffProfile.WriteTrace(output, mutexes);
}
catch (Exception exception) when (exception is IOException or ObjectDisposedException)
{
// A closed trace output must not prevent native session cleanup.
}
}
}
private void RecordGuestThreadFlow(GuestThreadState thread, GuestThreadFlowProfile.EventKind kind, string? reason = null)
{
if (!GuestThreadFlowProfile.Enabled) return;
_guestThreadFlowProfile.Record(new GuestThreadFlowProfile.TraceEvent(
Stopwatch.GetTimestamp(), Environment.CurrentManagedThreadId, thread.ThreadHandle,
thread.Name, kind, reason, thread.BlockWakeKey, Volatile.Read(ref thread.LastImportNid),
Volatile.Read(ref thread.LastImportRdi), Volatile.Read(ref thread.LastImportRsi), thread.BlockDeadlineTimestamp));
}
private GuestSchedulerThreadStats GetGuestSchedulerStats(GuestThreadState thread)
{
var stats = _guestSchedulerStats.GetOrAdd(
thread.ThreadHandle,
static _ => new GuestSchedulerThreadStats());
stats.Name = thread.Name;
return stats;
}
private void ProfileGuestThreadReady(GuestThreadState thread)
{
RecordGuestThreadFlow(thread, GuestThreadFlowProfile.EventKind.Ready);
if (!_profileGuestScheduler)
{
return;
}
var stats = GetGuestSchedulerStats(thread);
var now = Stopwatch.GetTimestamp();
Volatile.Write(ref stats.ReadyTimestamp, now);
Interlocked.Increment(ref stats.ReadyCount);
var blockTimestamp = Interlocked.Exchange(ref stats.BlockTimestamp, 0);
if (blockTimestamp != 0 && now >= blockTimestamp)
{
var ticks = now - blockTimestamp;
Interlocked.Increment(ref stats.ResumeCount);
Interlocked.Add(ref stats.BlockTicks, ticks);
UpdateGuestSchedulerMaximum(ref stats.MaxBlockTicks, ticks);
}
}
private void ProfileGuestThreadClaimed(GuestThreadState thread)
{
RecordGuestThreadFlow(thread, GuestThreadFlowProfile.EventKind.Claimed);
if (!_profileGuestScheduler)
{
return;
}
var now = Stopwatch.GetTimestamp();
var stats = GetGuestSchedulerStats(thread);
var readyTimestamp = Interlocked.Exchange(ref stats.ReadyTimestamp, 0);
Interlocked.Increment(ref stats.ClaimCount);
if (readyTimestamp != 0 && now >= readyTimestamp)
{
var ticks = now - readyTimestamp;
Interlocked.Add(ref stats.ReadyTicks, ticks);
UpdateGuestSchedulerMaximum(ref stats.MaxReadyTicks, ticks);
}
}
private void ProfileGuestThreadScheduled(GuestThreadState thread)
{
RecordGuestThreadFlow(thread, GuestThreadFlowProfile.EventKind.Scheduled);
if (!_profileGuestScheduler)
{
return;
}
var stats = GetGuestSchedulerStats(thread);
Volatile.Write(ref stats.ScheduledTimestamp, Stopwatch.GetTimestamp());
Interlocked.Increment(ref stats.ScheduleCount);
}
private void ProfileGuestThreadRunStarted(GuestThreadState thread)
{
RecordGuestThreadFlow(thread, GuestThreadFlowProfile.EventKind.RunStarted);
if (!_profileGuestScheduler)
{
return;
}
var now = Stopwatch.GetTimestamp();
var stats = GetGuestSchedulerStats(thread);
var scheduledTimestamp = Interlocked.Exchange(ref stats.ScheduledTimestamp, 0);
Volatile.Write(ref stats.RunTimestamp, now);
Interlocked.Increment(ref stats.RunCount);
if (scheduledTimestamp != 0 && now >= scheduledTimestamp)
{
var ticks = now - scheduledTimestamp;
Interlocked.Add(ref stats.ScheduleTicks, ticks);
UpdateGuestSchedulerMaximum(ref stats.MaxScheduleTicks, ticks);
}
}
private void ProfileGuestThreadRunStopped(GuestThreadState thread)
{
if (!_profileGuestScheduler)
{
return;
}
var now = Stopwatch.GetTimestamp();
var stats = GetGuestSchedulerStats(thread);
var runTimestamp = Interlocked.Exchange(ref stats.RunTimestamp, 0);
if (runTimestamp != 0 && now >= runTimestamp)
{
var ticks = now - runTimestamp;
Interlocked.Add(ref stats.RunTicks, ticks);
UpdateGuestSchedulerMaximum(ref stats.MaxRunTicks, ticks);
}
if (thread.State == GuestThreadRunState.Blocked)
{
Interlocked.Increment(ref stats.BlockCount);
Volatile.Write(ref stats.BlockTimestamp, now);
Volatile.Write(ref stats.LastBlockReason, thread.BlockReason);
}
else if (thread.State is GuestThreadRunState.Exited or GuestThreadRunState.Faulted)
{
Volatile.Write(ref stats.Completed, 1);
}
TryReportGuestSchedulerProfile(now);
}
private void TryReportGuestSchedulerProfile(long now)
{
var deadline = Volatile.Read(ref _guestSchedulerProfileNextReport);
if (now < deadline ||
Interlocked.CompareExchange(ref _guestSchedulerProfileReporting, 1, 0) != 0)
{
return;
}
try
{
Volatile.Write(
ref _guestSchedulerProfileNextReport,
now + (Stopwatch.Frequency * 5L));
var windowStart = Interlocked.Exchange(ref _guestSchedulerProfileWindowStart, now);
var seconds = Math.Max(
(now - windowStart) / (double)Stopwatch.Frequency,
double.Epsilon);
var rows = new List<(long Rank, string Text)>();
foreach (var pair in _guestSchedulerStats)
{
var stats = pair.Value;
var readyCount = Interlocked.Exchange(ref stats.ReadyCount, 0);
var claimCount = Interlocked.Exchange(ref stats.ClaimCount, 0);
var scheduleCount = Interlocked.Exchange(ref stats.ScheduleCount, 0);
var runCount = Interlocked.Exchange(ref stats.RunCount, 0);
var blockCount = Interlocked.Exchange(ref stats.BlockCount, 0);
var resumeCount = Interlocked.Exchange(ref stats.ResumeCount, 0);
var readyTicks = Interlocked.Exchange(ref stats.ReadyTicks, 0);
var blockTicks = Interlocked.Exchange(ref stats.BlockTicks, 0);
var scheduleTicks = Interlocked.Exchange(ref stats.ScheduleTicks, 0);
var runTicks = Interlocked.Exchange(ref stats.RunTicks, 0);
var maxReadyTicks = Interlocked.Exchange(ref stats.MaxReadyTicks, 0);
var maxBlockTicks = Interlocked.Exchange(ref stats.MaxBlockTicks, 0);
var maxScheduleTicks = Interlocked.Exchange(ref stats.MaxScheduleTicks, 0);
var maxRunTicks = Interlocked.Exchange(ref stats.MaxRunTicks, 0);
if (readyCount == 0 && claimCount == 0 && scheduleCount == 0 && runCount == 0)
{
continue;
}
rows.Add((Math.Max(blockTicks, Math.Max(readyTicks, runTicks)),
$"name='{stats.Name}' handle=0x{pair.Key:X16} " +
$"ready={readyCount} claimed={claimCount} scheduled={scheduleCount} " +
$"runs={runCount} blocked={blockCount} resumed={resumeCount} " +
$"blocked_ms={GuestSchedulerMilliseconds(blockTicks):F2} " +
$"blocked_avg_ms={(resumeCount == 0 ? 0.0 : GuestSchedulerMilliseconds(blockTicks) / resumeCount):F3} " +
$"blocked_max_ms={GuestSchedulerMilliseconds(maxBlockTicks):F3} " +
$"ready_ms={GuestSchedulerMilliseconds(readyTicks):F2} " +
$"ready_avg_ms={(claimCount == 0 ? 0.0 : GuestSchedulerMilliseconds(readyTicks) / claimCount):F3} " +
$"ready_max_ms={GuestSchedulerMilliseconds(maxReadyTicks):F3} " +
$"dispatch_ms={GuestSchedulerMilliseconds(scheduleTicks):F2} " +
$"dispatch_avg_ms={(runCount == 0 ? 0.0 : GuestSchedulerMilliseconds(scheduleTicks) / runCount):F3} " +
$"dispatch_max_ms={GuestSchedulerMilliseconds(maxScheduleTicks):F3} " +
$"run_ms={GuestSchedulerMilliseconds(runTicks):F2} " +
$"run_avg_ms={(runCount == 0 ? 0.0 : GuestSchedulerMilliseconds(runTicks) / runCount):F3} " +
$"run_max_ms={GuestSchedulerMilliseconds(maxRunTicks):F3} " +
$"last_block={Volatile.Read(ref stats.LastBlockReason) ?? "none"}"));
if (Volatile.Read(ref stats.Completed) != 0)
{
_guestSchedulerStats.TryRemove(pair.Key, out _);
}
}
Console.Error.WriteLine(
$"[PERF][GUEST_SCHED] window={seconds:F1}s active_threads={rows.Count}");
foreach (var row in rows
.OrderByDescending(static item => item.Rank)
.Take(32))
{
Console.Error.WriteLine($"[PERF][GUEST_SCHED] {row.Text}");
}
}
finally
{
Volatile.Write(ref _guestSchedulerProfileReporting, 0);
}
}
private static double GuestSchedulerMilliseconds(long ticks) =>
ticks * 1000.0 / Stopwatch.Frequency;
private static void UpdateGuestSchedulerMaximum(ref long target, long candidate)
{
var current = Volatile.Read(ref target);
while (candidate > current)
{
var observed = Interlocked.CompareExchange(ref target, candidate, current);
if (observed == current)
{
return;
}
current = observed;
}
}
}

View File

@ -201,7 +201,7 @@ public sealed partial class DirectExecutionBackend
foreach (var attempt in DecodeWindowSizes) foreach (var attempt in DecodeWindowSizes)
{ {
var buffer = new byte[attempt]; var buffer = new byte[attempt];
if (!TryReadHostBytes(rip, buffer)) if (!TryReadExecutableBytes(rip, buffer))
{ {
continue; continue;
} }

View File

@ -72,45 +72,9 @@ public sealed partial class DirectExecutionBackend
private unsafe static int RawVectoredHandlerManaged(void* exceptionInfo) private unsafe static int RawVectoredHandlerManaged(void* exceptionInfo)
{ {
if (TryHandleGuestImageWriteFault(exceptionInfo))
{
return -1;
}
return TryRecoverUnresolvedSentinel(exceptionInfo); return TryRecoverUnresolvedSentinel(exceptionInfo);
} }
/// <summary>
/// Windows counterpart of the POSIX SIGSEGV bridge into
/// <see cref="SharpEmu.HLE.GuestImageWriteTracker"/>. Guest code runs natively,
/// so a store into a surface the GPU backend has cached is an ordinary CPU
/// write with nothing to intercept — the page is write-protected instead and
/// the resulting fault is what tells the backend to re-upload. Without this
/// the cache serves the first upload forever, and anything the guest CPU
/// draws (a software-decoded movie frame, a memset fog layer) never reaches
/// the screen.
/// </summary>
private unsafe static bool TryHandleGuestImageWriteFault(void* exceptionInfo)
{
if (!SharpEmu.HLE.GuestImageWriteTracker.Enabled)
{
return false;
}
var exceptionRecord = ((EXCEPTION_POINTERS*)exceptionInfo)->ExceptionRecord;
// STATUS_ACCESS_VIOLATION, and only the write flavour: ExceptionInformation
// is [accessKind, address] with 0=read, 1=write, 8=DEP execute.
if (exceptionRecord->ExceptionCode != 3221225477u ||
exceptionRecord->NumberParameters < 2 ||
exceptionRecord->ExceptionInformation[0] != 1uL)
{
return false;
}
return SharpEmu.HLE.GuestImageWriteTracker.TryHandleWriteFault(
exceptionRecord->ExceptionInformation[1]);
}
private unsafe static int RawUnhandledFilterManaged(void* exceptionInfo) private unsafe static int RawUnhandledFilterManaged(void* exceptionInfo)
{ {
return TryRecoverUnresolvedSentinel(exceptionInfo); return TryRecoverUnresolvedSentinel(exceptionInfo);
@ -200,6 +164,7 @@ public sealed partial class DirectExecutionBackend
return 18446744071562199042uL; return 18446744071562199042uL;
} }
ImportStubEntry importStubEntry = _importEntries[importIndex]; ImportStubEntry importStubEntry = _importEntries[importIndex];
using var registerPacketImport = SharpEmu.Libs.Diagnostics.AgcRegisterPacketProfile.MeasureImport(importStubEntry.Nid);
if (_perfHleHistogram) if (_perfHleHistogram)
{ {
RecordPerfHleCall(importStubEntry.Export?.Name ?? importStubEntry.Nid); RecordPerfHleCall(importStubEntry.Export?.Name ?? importStubEntry.Nid);
@ -220,6 +185,11 @@ public sealed partial class DirectExecutionBackend
return hotMemoryResult; return hotMemoryResult;
} }
if (importStubEntry.IsTrivialLeaf && !_disableTrivialLeafDispatch)
{
return DispatchTrivialLeaf(cpuContext, in importStubEntry, argPackPtr, num);
}
if (importStubEntry.IsLeaf && if (importStubEntry.IsLeaf &&
TryDispatchLeafImport(cpuContext, importStubEntry, argPackPtr, num, out var leafResult)) TryDispatchLeafImport(cpuContext, importStubEntry, argPackPtr, num, out var leafResult))
{ {
@ -245,6 +215,13 @@ public sealed partial class DirectExecutionBackend
cpuContext[CpuRegister.R14] = *(ulong*)(argPackPtr + 80); cpuContext[CpuRegister.R14] = *(ulong*)(argPackPtr + 80);
cpuContext[CpuRegister.R15] = *(ulong*)(argPackPtr + 88); cpuContext[CpuRegister.R15] = *(ulong*)(argPackPtr + 88);
cpuContext[CpuRegister.Rsp] = (ulong)argPackPtr + 96uL; cpuContext[CpuRegister.Rsp] = (ulong)argPackPtr + 96uL;
cpuContext.SetImportStackArguments(
ReadImportStackArgument(argPackPtr, 0),
ReadImportStackArgument(argPackPtr, 1),
ReadImportStackArgument(argPackPtr, 2),
ReadImportStackArgument(argPackPtr, 3),
ReadImportStackArgument(argPackPtr, 4),
ReadImportStackArgument(argPackPtr, 5));
ulong value = cpuContext[CpuRegister.Rdi]; ulong value = cpuContext[CpuRegister.Rdi];
ulong value2 = cpuContext[CpuRegister.Rsi]; ulong value2 = cpuContext[CpuRegister.Rsi];
ulong num3 = cpuContext[CpuRegister.Rdx]; ulong num3 = cpuContext[CpuRegister.Rdx];
@ -266,8 +243,8 @@ public sealed partial class DirectExecutionBackend
if (probeTarget && if (probeTarget &&
Interlocked.Increment(ref _probeImportReturnAddressCount) <= 2048) Interlocked.Increment(ref _probeImportReturnAddressCount) <= 2048)
{ {
var frameValue = TryReadStackU64(value4, out var savedRbp) ? savedRbp : 0; var frameValue = TryReadImportStackU64(value4, out var savedRbp) ? savedRbp : 0;
var frameReturn = TryReadStackU64(value4 + sizeof(ulong), out var savedReturn) var frameReturn = TryReadImportStackU64(value4 + sizeof(ulong), out var savedReturn)
? savedReturn ? savedReturn
: 0; : 0;
Console.Error.WriteLine( Console.Error.WriteLine(
@ -368,6 +345,14 @@ public sealed partial class DirectExecutionBackend
Console.Error.WriteLine( Console.Error.WriteLine(
$"[LOADER][TRACE] bootstrap_call#{num}: op=0x{value:X16} sym_ptr=0x{value2:X16} sym='{symbolText}' out_ptr=0x{num3:X16} ret=0x{num7:X16}"); $"[LOADER][TRACE] bootstrap_call#{num}: op=0x{value:X16} sym_ptr=0x{value2:X16} sym='{symbolText}' out_ptr=0x{num3:X16} ret=0x{num7:X16}");
} }
// Once the host is shutting down, a guest thread still running reaches no more HLE: the
// services behind the imports are being torn down, and a title that sees them fail (a null
// command buffer from the GPU library, say) crashes the process on its way out.
if (_forcedGuestExit && !ActiveForcedGuestExit && TryEndGuestSliceForShutdown(argPackPtr))
{
cpuContext[CpuRegister.Rax] = 1uL;
return 1uL;
}
if (!isGuestWorker && if (!isGuestWorker &&
!ActiveForcedGuestExit && !ActiveForcedGuestExit &&
ShouldForceGuestExitOnImportLoop(in importStubEntry, num7, num, value, value2)) ShouldForceGuestExitOnImportLoop(in importStubEntry, num7, num, value, value2))
@ -1245,10 +1230,56 @@ public sealed partial class DirectExecutionBackend
} }
} }
// Every import reads its stack arguments. On POSIX a region query takes the global region lock,
// so keep the last readable range per thread until any mapping changes. The signal handlers
// use TryReadStackU64 instead: they must not touch thread-static storage.
[ThreadStatic] private static ulong _importReadableStart;
[ThreadStatic] private static ulong _importReadableEnd;
[ThreadStatic] private static long _importReadableGeneration;
private unsafe static bool TryReadImportStackU64(ulong address, out ulong value)
{
if (OperatingSystem.IsWindows())
{
return TryReadHostQword(address, out value);
}
// Stack arguments sit on the calling guest thread's own stack, which the backend mapped read-write
// for the thread's lifetime and no tracker ever protects. Reading inside it needs no query: the
// cached range below is keyed by a mapping generation that every tracker protection change bumps,
// so falling through here cost a locked host region query per argument on nearly every import.
if (_activeGuestThreadState is { StackSize: > 0 } thread &&
address >= thread.StackBase && address <= thread.StackBase + thread.StackSize - sizeof(ulong))
{
value = *(ulong*)address;
return true;
}
var generation = HostMemory.MappingGeneration;
if (generation == _importReadableGeneration &&
address >= _importReadableStart && address <= _importReadableEnd - 8)
{
value = *(ulong*)address;
return true;
}
if (!TryQueryReadableRange(address, out var start, out var end))
{
value = 0;
return false;
}
_importReadableStart = start;
_importReadableEnd = end;
_importReadableGeneration = generation;
value = *(ulong*)address;
return true;
}
private static ulong ReadImportStackArgument(nint argPackPtr, int index) private static ulong ReadImportStackArgument(nint argPackPtr, int index)
{ {
var address = checked((ulong)argPackPtr + 104UL + (ulong)index * sizeof(ulong)); var address = checked((ulong)argPackPtr + 104UL + (ulong)index * sizeof(ulong));
return TryReadHostQword(address, out var value) ? value : 0; return TryReadImportStackU64(address, out var value) ? value : 0;
} }
private static GuestCpuContinuation CaptureImportBoundaryContinuation( private static GuestCpuContinuation CaptureImportBoundaryContinuation(
@ -1359,6 +1390,13 @@ public sealed partial class DirectExecutionBackend
cpuContext[CpuRegister.R14] = *(ulong*)(argPackPtr + 80); cpuContext[CpuRegister.R14] = *(ulong*)(argPackPtr + 80);
cpuContext[CpuRegister.R15] = *(ulong*)(argPackPtr + 88); cpuContext[CpuRegister.R15] = *(ulong*)(argPackPtr + 88);
cpuContext[CpuRegister.Rsp] = (ulong)argPackPtr + 96uL; cpuContext[CpuRegister.Rsp] = (ulong)argPackPtr + 96uL;
cpuContext.SetImportStackArguments(
ReadImportStackArgument(argPackPtr, 0),
ReadImportStackArgument(argPackPtr, 1),
ReadImportStackArgument(argPackPtr, 2),
ReadImportStackArgument(argPackPtr, 3),
ReadImportStackArgument(argPackPtr, 4),
ReadImportStackArgument(argPackPtr, 5));
if (_activeGuestThreadState is { } activeGuestThreadState) if (_activeGuestThreadState is { } activeGuestThreadState)
{ {
@ -1480,6 +1518,68 @@ public sealed partial class DirectExecutionBackend
return true; return true;
} }
private static readonly bool _disableTrivialLeafDispatch = string.Equals(
Environment.GetEnvironmentVariable("SHARPEMU_DISABLE_TRIVIAL_LEAF"), "1", StringComparison.Ordinal);
// Tiny exports called millions of times per second, where the ~250ns of full
// import bookkeeping costs more than the export itself. Each one reads only
// argument registers (RDI..R9) and thread-local state, returns in RAX, never
// blocks, yields, calls back into the guest or reads the guest stack.
private static bool IsTrivialLeafImport(string nid) =>
nid is
"0-KXaS70xy4" or // pthread_getspecific
"eoht7mQOCmo" or // scePthreadGetspecific
"EI-5-jlq2dE" or // scePthreadGetthreadid
"3eqs37G74-s" or // pthread_getthreadid_np
"BNowx2l588E" or // sceKernelGetProcessTimeCounterFrequency
"fgxnMeTNUtY" or // sceKernelGetProcessTimeCounter
"4J2sUJmuHZQ" or // sceKernelGetProcessTime
"-2IRUCO--PM" or // sceKernelReadTsc
"1j3S3n-tTW4" or // sceKernelGetTscFrequency
"ob5xAW4ln-0" or // strchr
"9yDWMxEFdJU" or // strrchr
"V++UgBtQhn0"; // sceAgcGetDataPacketPayloadAddress
private unsafe ulong DispatchTrivialLeaf(
CpuContext cpuContext,
in ImportStubEntry importStubEntry,
nint argPackPtr,
long dispatchIndex)
{
// Polling loops on the host main thread use the time queries as loop-guard
// boundaries; keep resetting the pattern so skipping the guard here cannot
// turn a legitimate time-polling loop into a forced exit.
if (importStubEntry.IsLoopGuardBoundary && !GuestThreadExecution.IsGuestThread)
{
ResetImportLoopPattern();
}
cpuContext.Rip = importStubEntry.Address;
cpuContext[CpuRegister.Rdi] = *(ulong*)argPackPtr;
cpuContext[CpuRegister.Rsi] = *(ulong*)(argPackPtr + 8);
cpuContext[CpuRegister.Rdx] = *(ulong*)(argPackPtr + 16);
cpuContext[CpuRegister.Rcx] = *(ulong*)(argPackPtr + 24);
cpuContext[CpuRegister.R8] = *(ulong*)(argPackPtr + 32);
cpuContext[CpuRegister.R9] = *(ulong*)(argPackPtr + 40);
cpuContext.ClearRaxWriteFlag();
var returnValue = importStubEntry.Export!.Function(cpuContext);
if (!cpuContext.WasRaxWritten)
{
cpuContext[CpuRegister.Rax] = unchecked((ulong)returnValue);
}
if (returnValue != (int)OrbisGen2Result.ORBIS_GEN2_OK &&
ShouldLogImportResult(importStubEntry.Nid, (OrbisGen2Result)returnValue))
{
Console.Error.WriteLine(
$"[LOADER][WARN] Import#{dispatchIndex} result: {(OrbisGen2Result)returnValue} ({importStubEntry.Nid}) " +
$"rdi=0x{cpuContext[CpuRegister.Rdi]:X16} rsi=0x{cpuContext[CpuRegister.Rsi]:X16} " +
$"ret=0x{*(ulong*)(argPackPtr + 96):X16}");
}
return cpuContext[CpuRegister.Rax];
}
private static bool IsNoBlockLeafImport(string nid) => private static bool IsNoBlockLeafImport(string nid) =>
nid is nid is
"8aI7R7WaOlc" or // sceAmprCommandBufferConstructor "8aI7R7WaOlc" or // sceAmprCommandBufferConstructor
@ -1537,6 +1637,19 @@ public sealed partial class DirectExecutionBackend
var expectedEqueueTimeout = var expectedEqueueTimeout =
string.Equals(nid, "fzyMKs9kim0", StringComparison.Ordinal) && string.Equals(nid, "fzyMKs9kim0", StringComparison.Ordinal) &&
result == OrbisGen2Result.ORBIS_GEN2_ERROR_TIMED_OUT; result == OrbisGen2Result.ORBIS_GEN2_ERROR_TIMED_OUT;
// scePthreadCondTimedwait and sceKernelWaitEventFlag report an elapsed timeout.
var expectedWaitTimeout =
(nid is "BmMjYxmew1w" or "JTvBflhYazQ") &&
result == OrbisGen2Result.ORBIS_GEN2_ERROR_TIMED_OUT;
// scePthreadMutexLock on an error-checking mutex the caller already owns; titles use it
// to build their own recursive locks.
var expectedErrorCheckRelock =
string.Equals(nid, "9UK1vLZQft4", StringComparison.Ordinal) &&
result == OrbisGen2Result.ORBIS_GEN2_ERROR_DEADLOCK;
// scePadReadState on a handle that is not open; titles poll every pad slot.
var expectedPadNotOpen =
string.Equals(nid, "YndgXqQVV7c", StringComparison.Ordinal) &&
resultValue == unchecked((int)0x80920003);
var expectedMutexTrylockBusy = var expectedMutexTrylockBusy =
(nid is "K-jXhbt2gn4" or "upoVrzMHFeE") && (nid is "K-jXhbt2gn4" or "upoVrzMHFeE") &&
result == OrbisGen2Result.ORBIS_GEN2_ERROR_BUSY; result == OrbisGen2Result.ORBIS_GEN2_ERROR_BUSY;
@ -1561,6 +1674,9 @@ public sealed partial class DirectExecutionBackend
if (!expectedFileProbeMiss && if (!expectedFileProbeMiss &&
!expectedTimedWaitTimeout && !expectedTimedWaitTimeout &&
!expectedEqueueTimeout && !expectedEqueueTimeout &&
!expectedWaitTimeout &&
!expectedErrorCheckRelock &&
!expectedPadNotOpen &&
!expectedMutexTrylockBusy && !expectedMutexTrylockBusy &&
!expectedSemaphoreTrywaitAgain && !expectedSemaphoreTrywaitAgain &&
!expectedPollSemaBusy && !expectedPollSemaBusy &&
@ -1619,7 +1735,7 @@ public sealed partial class DirectExecutionBackend
"8aI7R7WaOlc" or // sceAmprCommandBufferConstructor "8aI7R7WaOlc" or // sceAmprCommandBufferConstructor
"zgXifHT9ErY" or // sceVideoOutIsFlipPending "zgXifHT9ErY" or // sceVideoOutIsFlipPending
"V++UgBtQhn0" or // sceAgcGetDataPacketPayloadAddress "V++UgBtQhn0" or // sceAgcGetDataPacketPayloadAddress
"qj7QZpgr9Uw" or // Gen5 graphics type-2 packet "qj7QZpgr9Uw" or // Graphics context-state operation
"LtTouSCZjHM" or // sceAgcCbNop "LtTouSCZjHM" or // sceAgcCbNop
"k3GhuSNmBLU" or // sceAgcCbDispatch "k3GhuSNmBLU" or // sceAgcCbDispatch
"UZbQjYAwwXM" or // sceAgcCbSetShRegistersDirect "UZbQjYAwwXM" or // sceAgcCbSetShRegistersDirect
@ -1753,6 +1869,20 @@ public sealed partial class DirectExecutionBackend
} }
} }
// Returns the import straight to the host entry stub, which ends this guest slice.
private unsafe bool TryEndGuestSliceForShutdown(nint argPackPtr)
{
ulong sentinel = ActiveEntryReturnSentinelRip;
if (sentinel < 65536 || !TryPatchActiveGuestReturnSlot(sentinel))
{
return false;
}
*(ulong*)(argPackPtr + 96) = sentinel;
ActiveForcedGuestExit = true;
return true;
}
private unsafe bool TryForceGuestExitToHostStub(nint argPackPtr, long dispatchIndex, ulong returnRip, string nid) private unsafe bool TryForceGuestExitToHostStub(nint argPackPtr, long dispatchIndex, ulong returnRip, string nid)
{ {
ulong num = ActiveEntryReturnSentinelRip; ulong num = ActiveEntryReturnSentinelRip;
@ -1883,10 +2013,18 @@ public sealed partial class DirectExecutionBackend
private static bool IsImportLoopGuardBoundary(string nid) => private static bool IsImportLoopGuardBoundary(string nid) =>
nid is nid is
"1jfXLRVzisc" or // sceKernelUsleep "1jfXLRVzisc" or // sceKernelUsleep
"1j3S3n-tTW4" or // sceKernelGetTscFrequency (polling/time base query)
"WKAXJ4XBPQ4" or // scePthreadCondWait "WKAXJ4XBPQ4" or // scePthreadCondWait
"BmMjYxmew1w" or // scePthreadCondTimedwait "BmMjYxmew1w" or // scePthreadCondTimedwait
"Op8TBGY5KHg" or // pthread_cond_wait "Op8TBGY5KHg" or // pthread_cond_wait
"27bAgiJmOh0"; // pthread_cond_timedwait "27bAgiJmOh0" or // pthread_cond_timedwait
"Zxa0VhQVTsk" or // sceKernelWaitSema
"n88vx3C5nW8" or // gettimeofday
"lLMT9vJAck0" or // clock_gettime
"-2IRUCO--PM" or // sceKernelReadTsc
"4J2sUJmuHZQ" or // sceKernelGetProcessTime
"fgxnMeTNUtY" or // sceKernelGetProcessTimeCounter
"yH17Q6NWtVg"; // sceUserServiceGetEvent (non-blocking event poll)
private void ResetImportLoopPattern() private void ResetImportLoopPattern()
{ {
@ -2285,17 +2423,18 @@ public sealed partial class DirectExecutionBackend
{ {
return false; return false;
} }
if (_runtimeSymbolsByName.TryGetValue(symbolName, out var value) && IsRuntimeSymbolAddressUsable(value)) var runtimeSymbolsByName = Volatile.Read(ref _runtimeSymbolsByName);
if (runtimeSymbolsByName.TryGetValue(symbolName, out var value) && IsRuntimeSymbolAddressUsable(value))
{ {
address = value; address = value;
return true; return true;
} }
if (symbolName.StartsWith("_", StringComparison.Ordinal) && _runtimeSymbolsByName.TryGetValue(symbolName[1..], out value) && IsRuntimeSymbolAddressUsable(value)) if (symbolName.StartsWith("_", StringComparison.Ordinal) && runtimeSymbolsByName.TryGetValue(symbolName[1..], out value) && IsRuntimeSymbolAddressUsable(value))
{ {
address = value; address = value;
return true; return true;
} }
if (_runtimeSymbolsByName.TryGetValue("_" + symbolName, out value) && IsRuntimeSymbolAddressUsable(value)) if (runtimeSymbolsByName.TryGetValue("_" + symbolName, out value) && IsRuntimeSymbolAddressUsable(value))
{ {
address = value; address = value;
return true; return true;

View File

@ -0,0 +1,51 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System;
using System.Runtime.InteropServices;
namespace SharpEmu.Core.Cpu.Native;
// On macOS the runtime receives EXC_BAD_ACCESS on each of its threads through a Mach exception
// port before the kernel raises SIGSEGV or SIGBUS. It calls any fault in the page holding RSP, or
// the page below it, a stack overflow and aborts, assuming RSP is on a stack it owns. Guest code
// runs on guest stacks, and those pages fault whenever GPU or image write tracking has protected
// them, so a thread running guest code must leave its access faults to the signal handler. The
// handler resolves guest faults and chains every other one to the runtime's own signal handler,
// the same path the runtime uses on Linux.
public sealed unsafe partial class DirectExecutionBackend
{
private const uint ExceptionMaskBadAccess = 1u << 1;
private const int ExceptionDefault = 1;
private const int ThreadStateNone = 13;
[ThreadStatic]
private static bool _guestFaultsUseSignals;
private static int _machExceptionPortWarning;
[DllImport("libSystem.dylib", EntryPoint = "mach_thread_self")]
private static extern uint MachThreadSelf();
[DllImport("libSystem.dylib", EntryPoint = "thread_set_exception_ports")]
private static extern int ThreadSetExceptionPorts(uint thread, uint exceptionMask, uint newPort, int behavior, int newFlavor);
[DllImport("libSystem.dylib", EntryPoint = "mach_port_deallocate")]
private static extern int MachPortDeallocate(uint task, uint name);
private static readonly uint _machTaskSelf = OperatingSystem.IsMacOS()
? (uint)Marshal.ReadInt32(NativeLibrary.GetExport(NativeLibrary.Load("libSystem.dylib"), "mach_task_self_"))
: 0;
private static void RouteGuestAccessFaultsToSignals()
{
if (_guestFaultsUseSignals || !OperatingSystem.IsMacOS())
return;
_guestFaultsUseSignals = true;
var thread = MachThreadSelf();
var result = ThreadSetExceptionPorts(thread, ExceptionMaskBadAccess, 0, ExceptionDefault, ThreadStateNone);
_ = MachPortDeallocate(_machTaskSelf, thread);
if (result != 0 && System.Threading.Interlocked.Exchange(ref _machExceptionPortWarning, 1) == 0)
Console.Error.WriteLine($"[LOADER][WARN] Cannot hand guest access faults to the signal handler: thread_set_exception_ports={result}.");
}
}

View File

@ -79,7 +79,7 @@ public sealed partial class DirectExecutionBackend
// Callers set the Active* thread-statics before emitting the stub and read the // Callers set the Active* thread-statics before emitting the stub and read the
// yield/forced-exit flags right after this returns, so the worker outcome is // yield/forced-exit flags right after this returns, so the worker outcome is
// copied back into this thread's statics before returning. // copied back into this thread's statics before returning.
private unsafe int RunGuestEntryStub(void* entryStub, ulong hostRspSlot, bool requireNativeWorker = false) private unsafe ulong RunGuestEntryStub(void* entryStub, ulong hostRspSlot, bool requireNativeWorker = false)
{ {
// Limit in-flight native Runs before renting so the idle pool is not // Limit in-flight native Runs before renting so the idle pool is not
// drained by threads blocked on the concurrency gate. // drained by threads blocked on the concurrency gate.
@ -124,7 +124,7 @@ public sealed partial class DirectExecutionBackend
_activeGuestThreadYieldRequested = true; _activeGuestThreadYieldRequested = true;
_activeGuestThreadYieldReason = "tbb_native_worker_unavailable"; _activeGuestThreadYieldReason = "tbb_native_worker_unavailable";
_activeForcedGuestExit = true; _activeForcedGuestExit = true;
return unchecked((int)0x80020012); return 0x80020012UL;
} }
TlsSetValue(_hostRspSlotTlsIndex, (nint)hostRspSlot); TlsSetValue(_hostRspSlotTlsIndex, (nint)hostRspSlot);
@ -134,7 +134,7 @@ public sealed partial class DirectExecutionBackend
try try
{ {
var state = _activeGuestThreadState; var state = _activeGuestThreadState;
if (state is { Name: "tbb_thead" }) if (LogThreadMode && state is { Name: "tbb_thead" })
{ {
var n = Interlocked.Increment(ref _tbbNativeRunEnterCount); var n = Interlocked.Increment(ref _tbbNativeRunEnterCount);
if (n <= 12 || n % 64 == 0) if (n <= 12 || n % 64 == 0)
@ -302,8 +302,8 @@ public sealed partial class DirectExecutionBackend
// loop: WaitForSingleObject(work); // loop: WaitForSingleObject(work);
// if (*stopFlag) { SetEvent(done); ExitThread(0); } // if (*stopFlag) { SetEvent(done); ExitThread(0); }
// rax = RunPrologue(self); // managed: binds per-run ambient, returns stub // rax = RunPrologue(self); // managed: binds per-run ambient, returns stub
// if (rax != 0) eax = rax(); // guest entry stub — zero managed frames below // if (rax != 0) rax = rax(); // guest entry stub — zero managed frames below
// RunEpilogue(self, eax); // managed: captures outcome, restores ambient // RunEpilogue(self, rax); // managed: captures outcome, restores ambient
// SetEvent(done); goto loop; // SetEvent(done); goto loop;
// //
// Workers carry no per-guest identity of their own: the prologue rebinds guest TLS, // Workers carry no per-guest identity of their own: the prologue rebinds guest TLS,
@ -348,7 +348,7 @@ public sealed partial class DirectExecutionBackend
private nint _runHostRspSlot; private nint _runHostRspSlot;
private nint _runEntryStub; private nint _runEntryStub;
private ulong _runAffinityMask; private ulong _runAffinityMask;
private int _runNativeResult; private ulong _runNativeResult;
private bool _runYieldRequested; private bool _runYieldRequested;
private string? _runYieldReason; private string? _runYieldReason;
private bool _runForcedExit; private bool _runForcedExit;
@ -425,7 +425,7 @@ public sealed partial class DirectExecutionBackend
} }
var prologuePtr = (nint)(delegate* unmanaged<nint, nint>)&RunPrologue; var prologuePtr = (nint)(delegate* unmanaged<nint, nint>)&RunPrologue;
var epiloguePtr = (nint)(delegate* unmanaged<nint, int, void>)&RunEpilogue; var epiloguePtr = (nint)(delegate* unmanaged<nint, ulong, void>)&RunEpilogue;
var executorHandle = GCHandle.ToIntPtr(_selfHandle); var executorHandle = GCHandle.ToIntPtr(_selfHandle);
nint workHandle; nint workHandle;
nint doneHandle; nint doneHandle;
@ -504,9 +504,9 @@ public sealed partial class DirectExecutionBackend
Emit(0x0F); Emit(0x84); // je skipEntry Emit(0x0F); Emit(0x84); // je skipEntry
int skipJump = offset; int skipJump = offset;
offset += sizeof(int); offset += sizeof(int);
EmitCallRax(); // guest entry stub -> eax EmitCallRax(); // guest entry stub -> rax
int skipEntryOffset = offset; int skipEntryOffset = offset;
Emit(0x89); Emit(0xC2); // mov edx, eax Emit(0x48); Emit(0x89); Emit(0xC2); // mov rdx, rax
EmitMovRcxImm64((ulong)executorHandle); EmitMovRcxImm64((ulong)executorHandle);
EmitMovRaxImm64((ulong)epiloguePtr); EmitMovRaxImm64((ulong)epiloguePtr);
EmitCallRax(); EmitCallRax();
@ -565,7 +565,7 @@ public sealed partial class DirectExecutionBackend
return true; return true;
} }
public int Run( public ulong Run(
CpuContext context, CpuContext context,
GuestThreadState? state, GuestThreadState? state,
ulong guestThreadHandle, ulong guestThreadHandle,
@ -657,7 +657,7 @@ public sealed partial class DirectExecutionBackend
yieldRequested = true; yieldRequested = true;
yieldReason = "tbb_worker_prologue_fault"; yieldReason = "tbb_worker_prologue_fault";
forcedExit = true; forcedExit = true;
return unchecked((int)0x80020012); return 0x80020012UL;
} }
return _runNativeResult; return _runNativeResult;
} }
@ -707,7 +707,7 @@ public sealed partial class DirectExecutionBackend
} }
[UnmanagedCallersOnly] [UnmanagedCallersOnly]
private static void RunEpilogue(nint executorHandle, int nativeResult) private static void RunEpilogue(nint executorHandle, ulong nativeResult)
{ {
try try
{ {
@ -750,6 +750,7 @@ public sealed partial class DirectExecutionBackend
_activeGuestThreadYieldReason = null; _activeGuestThreadYieldReason = null;
_activeGuestThreadState = _runState; _activeGuestThreadState = _runState;
backend.BindTlsBase(_runContext!); backend.BindTlsBase(_runContext!);
RouteGuestAccessFaultsToSignals();
TlsSetValue(backend._hostRspSlotTlsIndex, _runHostRspSlot); TlsSetValue(backend._hostRspSlotTlsIndex, _runHostRspSlot);
if (backend._workerDoneEventTlsIndex != uint.MaxValue) if (backend._workerDoneEventTlsIndex != uint.MaxValue)
{ {
@ -781,7 +782,7 @@ public sealed partial class DirectExecutionBackend
return _runEntryStub; return _runEntryStub;
} }
private void ExitRun(int nativeResult) private void ExitRun(ulong nativeResult)
{ {
_runNativeResult = nativeResult; _runNativeResult = nativeResult;
_runYieldRequested = _activeGuestThreadYieldRequested; _runYieldRequested = _activeGuestThreadYieldRequested;
@ -821,7 +822,7 @@ public sealed partial class DirectExecutionBackend
if (LogThreadMode) if (LogThreadMode)
{ {
TraceThreadMode( TraceThreadMode(
$"worker_exit guest=0x{_runGuestThreadHandle:X16} result=0x{nativeResult:X8} yield={_runYieldRequested}"); $"worker_exit guest=0x{_runGuestThreadHandle:X16} result=0x{nativeResult:X16} yield={_runYieldRequested}");
} }
} }

View File

@ -0,0 +1,140 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System;
using System.Runtime.InteropServices;
using Iced.Intel;
using SharpEmu.HLE;
using static Iced.Intel.AssemblerRegisters;
namespace SharpEmu.Core.Cpu.Native;
// Guest faults are delivered on the guest stack. The runtime only knows the thread's own stack,
// so managed code that runs on the guest stack can make a garbage collection misread the frames
// of that thread. Windows swaps the stack bounds in the TEB while guest code runs; POSIX cannot,
// so the signal handler moves to the host stack below the frames that entered guest code first.
public sealed unsafe partial class DirectExecutionBackend
{
// Host stack below the saved host RSP that is still treated as the host frames in use.
private const ulong HostStackSearchBytes = 0x100_0000;
private const int SignalStackGap = 0x1000;
// [0] the host RSP TLS slot (uint.MaxValue while unknown), [8] the Win64 TlsGetValue stub.
private static nint _signalStackCells;
private static unsafe nint CreatePosixSignalTrampoline()
{
_signalStackCells = (nint)NativeMemory.AllocZeroed(16);
*(uint*)_signalStackCells = uint.MaxValue;
var a = new Assembler(64);
var direct = a.CreateLabel();
var call = a.CreateLabel();
var done = a.CreateLabel();
a.push(rbx);
a.push(r12);
a.push(r13);
a.push(r14);
a.push(r15);
a.mov(r12d, edi);
a.mov(r13, rsi);
a.mov(r14, rdx);
a.mov(rbx, rsp);
// The saved host RSP of this thread, when it entered guest code.
a.mov(rax, (ulong)_signalStackCells);
a.mov(ecx, __dword_ptr[rax]);
a.cmp(ecx, -1);
a.je(direct);
a.mov(rax, __qword_ptr[rax + 8]);
a.test(rax, rax);
a.je(direct);
a.sub(rsp, 48);
a.call(rax);
a.add(rsp, 48);
a.test(rax, rax);
a.je(direct);
a.mov(r15, __qword_ptr[rax]);
a.test(r15, r15);
a.je(direct);
// Already on the host stack below the saved RSP: an import or host code faulted.
a.cmp(rbx, r15);
a.jae(call);
a.mov(rax, r15);
a.sub(rax, rbx);
a.cmp(rax, (int)HostStackSearchBytes);
a.jb(direct);
a.Label(ref call);
a.lea(rsp, __[r15 - SignalStackGap]);
a.and(rsp, -16);
a.Label(ref direct);
a.mov(edi, r12d);
a.mov(rsi, r13);
a.mov(rdx, r14);
a.mov(rax, (ulong)(nint)(delegate* unmanaged<int, nint, nint, void>)&HandlePosixSignal);
a.call(rax);
a.Label(ref done);
a.mov(rsp, rbx);
a.pop(r15);
a.pop(r14);
a.pop(r13);
a.pop(r12);
a.pop(rbx);
a.ret();
var page = (byte*)HostMemory.Alloc(null, 4096, HostMemory.MEM_COMMIT | HostMemory.MEM_RESERVE, HostMemory.PAGE_EXECUTE_READWRITE);
if (page == null)
{
throw new OutOfMemoryException("Failed to allocate the POSIX signal trampoline page");
}
var writer = new SpanCodeWriter(new Span<byte>(page, 4096));
a.Assemble(writer, (ulong)page);
if (!HostMemory.Protect(page, 4096, HostMemory.PAGE_EXECUTE_READ, out _))
{
throw new InvalidOperationException("Failed to protect the POSIX signal trampoline page");
}
return (nint)page;
}
private unsafe void PublishSignalStackState()
{
if (_signalStackCells == 0)
{
return;
}
*(nint*)(_signalStackCells + 8) = _tlsGetValueAddress;
*(uint*)_signalStackCells = _hostRspSlotTlsIndex;
}
private sealed unsafe class SpanCodeWriter : CodeWriter
{
private readonly byte* _start;
private readonly int _length;
private int _offset;
public SpanCodeWriter(Span<byte> destination)
{
fixed (byte* start = destination)
{
_start = start;
}
_length = destination.Length;
}
public override void WriteByte(byte value)
{
if (_offset >= _length)
{
throw new InvalidOperationException("The POSIX signal trampoline does not fit its page.");
}
_start[_offset++] = value;
}
}
}

View File

@ -5,6 +5,7 @@ using System;
using System.Runtime.InteropServices; using System.Runtime.InteropServices;
using System.Threading; using System.Threading;
using SharpEmu.HLE; using SharpEmu.HLE;
using SharpEmu.HLE.GpuMemory;
namespace SharpEmu.Core.Cpu.Native; namespace SharpEmu.Core.Cpu.Native;
@ -23,6 +24,7 @@ public sealed unsafe partial class DirectExecutionBackend
private const int PosixSigIll = 4; private const int PosixSigIll = 4;
private const int PosixSigTrap = 5; private const int PosixSigTrap = 5;
private const int PosixSigAbort = 6; private const int PosixSigAbort = 6;
private const int PosixSigFpe = 8;
private const int PosixSigSegv = 11; private const int PosixSigSegv = 11;
private static readonly int PosixSigBus = OperatingSystem.IsMacOS() ? 10 : 7; private static readonly int PosixSigBus = OperatingSystem.IsMacOS() ? 10 : 7;
@ -45,6 +47,10 @@ public sealed unsafe partial class DirectExecutionBackend
// registers in gregs[23]. Rosetta 2 delivers the regular x86-64 layout // registers in gregs[23]. Rosetta 2 delivers the regular x86-64 layout
// to translated processes. // to translated processes.
private const int DarwinUcontextMcontextOffset = 48; private const int DarwinUcontextMcontextOffset = 48;
private const int DarwinUserContextMachineContextSizeOffset = 40;
// Darwin stores vector registers at the same offset in both signal frame formats.
// The system headers i386/_mcontext.h and mach/i386/_structs.h define this offset.
private const int DarwinMachineContextVectorRegistersOffset = 352;
private const int DarwinMcontextErrOffset = 4; private const int DarwinMcontextErrOffset = 4;
private const int DarwinMcontextFaultAddressOffset = 8; private const int DarwinMcontextFaultAddressOffset = 8;
private const int LinuxUcontextGregsOffset = 40; private const int LinuxUcontextGregsOffset = 40;
@ -73,6 +79,7 @@ public sealed unsafe partial class DirectExecutionBackend
private static DirectExecutionBackend? _posixSignalBackend; private static DirectExecutionBackend? _posixSignalBackend;
private static bool _posixSignalHandlersInstalled; private static bool _posixSignalHandlersInstalled;
private static nint _posixSignalTrampoline;
private static bool _posixRawRecoveryEnabled; private static bool _posixRawRecoveryEnabled;
private static bool _posixSignalWarmup; private static bool _posixSignalWarmup;
private static readonly nint[] _posixPreviousActions = new nint[32]; private static readonly nint[] _posixPreviousActions = new nint[32];
@ -84,12 +91,8 @@ public sealed unsafe partial class DirectExecutionBackend
[ThreadStatic] [ThreadStatic]
private static int _posixSignalHandlerDepth; private static int _posixSignalHandlerDepth;
// True while the current thread's in-flight POSIX fault carries the real // True when the signal context contains the current vector register values.
// XMM registers in the CONTEXT scratch buffer and writes to them will // Copy changes back to these registers before the guest continues.
// reach the mcontext on resume. Gates recovery paths (SSE4a EXTRQ/
// INSERTQ) that would otherwise compute results from a zeroed XMM area
// and silently discard what they "wrote". Darwin is not bridged yet, so
// the flag stays false there.
[ThreadStatic] [ThreadStatic]
private static bool _posixXmmContextBridged; private static bool _posixXmmContextBridged;
@ -104,6 +107,7 @@ public sealed unsafe partial class DirectExecutionBackend
_posixSignalBackend = this; _posixSignalBackend = this;
if (_posixSignalHandlersInstalled) if (_posixSignalHandlersInstalled)
{ {
PublishSignalStackState();
return; return;
} }
@ -117,17 +121,20 @@ public sealed unsafe partial class DirectExecutionBackend
WarmUpPosixSignalPath(); WarmUpPosixSignalPath();
SharpEmu.HLE.GuestImageWriteTracker.WarmUp(); SharpEmu.HLE.GuestImageWriteTracker.WarmUp();
_posixSignalTrampoline = CreatePosixSignalTrampoline();
PublishSignalStackState();
if (!InstallPosixSignalHandler(PosixSigSegv) || if (!InstallPosixSignalHandler(PosixSigSegv) ||
!InstallPosixSignalHandler(PosixSigBus) || !InstallPosixSignalHandler(PosixSigBus) ||
!InstallPosixSignalHandler(PosixSigIll) || !InstallPosixSignalHandler(PosixSigIll) ||
!InstallPosixSignalHandler(PosixSigTrap) || !InstallPosixSignalHandler(PosixSigTrap) ||
!InstallPosixSignalHandler(PosixSigAbort)) !InstallPosixSignalHandler(PosixSigAbort) ||
!InstallPosixSignalHandler(PosixSigFpe))
{ {
throw new InvalidOperationException("Failed to install POSIX fault signal handlers"); throw new InvalidOperationException("Failed to install POSIX fault signal handlers");
} }
_posixSignalHandlersInstalled = true; _posixSignalHandlersInstalled = true;
Console.Error.WriteLine("[LOADER][INFO] POSIX signal exception bridge installed (SIGSEGV/SIGBUS/SIGILL)"); Console.Error.WriteLine("[LOADER][INFO] POSIX signal exception bridge installed (SIGSEGV/SIGBUS/SIGILL/SIGFPE)");
} }
/// <summary> /// <summary>
@ -141,19 +148,23 @@ public sealed unsafe partial class DirectExecutionBackend
/// </summary> /// </summary>
private void WarmUpPosixSignalPath() private void WarmUpPosixSignalPath()
{ {
byte* fakeUcontext = stackalloc byte[512]; byte* testUserContext = stackalloc byte[512];
new Span<byte>(fakeUcontext, 512).Clear(); new Span<byte>(testUserContext, 512).Clear();
byte* fakeMcontext = stackalloc byte[512]; byte* testMachineContext = stackalloc byte[1024];
new Span<byte>(fakeMcontext, 512).Clear(); new Span<byte>(testMachineContext, 1024).Clear();
if (OperatingSystem.IsMacOS()) if (OperatingSystem.IsMacOS())
{ {
*(byte**)(fakeUcontext + DarwinUcontextMcontextOffset) = fakeMcontext; *(byte**)(testUserContext + DarwinUcontextMcontextOffset) = testMachineContext;
*(ulong*)(testUserContext + DarwinUserContextMachineContextSizeOffset) = 1024;
// Load the Mach memory functions before the first signal uses them.
byte readProbe = 0;
_ = TryReadMacOsMemory((ulong)testMachineContext, &readProbe, 1);
} }
_posixSignalWarmup = true; _posixSignalWarmup = true;
try try
{ {
((delegate* unmanaged<int, nint, nint, void>)&HandlePosixSignal)(PosixSigSegv, 0, (nint)fakeUcontext); ((delegate* unmanaged<int, nint, nint, void>)&HandlePosixSignal)(PosixSigSegv, 0, (nint)testUserContext);
// Warm the branches the fabricated fault above skips without // Warm the branches the fabricated fault above skips without
// spamming diagnostics: the benign-exception path through // spamming diagnostics: the benign-exception path through
@ -187,7 +198,7 @@ public sealed unsafe partial class DirectExecutionBackend
{ {
byte* action = stackalloc byte[PosixSigactionSize]; byte* action = stackalloc byte[PosixSigactionSize];
new Span<byte>(action, PosixSigactionSize).Clear(); new Span<byte>(action, PosixSigactionSize).Clear();
*(nint*)action = (nint)(delegate* unmanaged<int, nint, nint, void>)&HandlePosixSignal; *(nint*)action = _posixSignalTrampoline;
// No SA_ONSTACK: the runtime's alternate stacks are far too small for // No SA_ONSTACK: the runtime's alternate stacks are far too small for
// the recovery/diagnostic path (JIT compilation of cold handler code // the recovery/diagnostic path (JIT compilation of cold handler code
// can run inside the signal frame). Guest faults deliver onto the 2MB // can run inside the signal frame). Guest faults deliver onto the 2MB
@ -234,6 +245,7 @@ public sealed unsafe partial class DirectExecutionBackend
// address (safe for host and guest threads alike) and must resume // address (safe for host and guest threads alike) and must resume
// the faulting write immediately after restoring write access. // the faulting write immediately after restoring write access.
if (signal != PosixSigIll && if (signal != PosixSigIll &&
signal != PosixSigFpe &&
siginfo != 0 && siginfo != 0 &&
SharpEmu.HLE.GuestImageWriteTracker.TryHandleWriteFault( SharpEmu.HLE.GuestImageWriteTracker.TryHandleWriteFault(
*(ulong*)((byte*)siginfo + PosixSigInfoAddressOffset))) *(ulong*)((byte*)siginfo + PosixSigInfoAddressOffset)))
@ -241,6 +253,17 @@ public sealed unsafe partial class DirectExecutionBackend
return; return;
} }
// GPU-tracked pages fault on every first CPU access after the GPU or an upload used them,
// thousands of times a second in a frame. Resolving them needs only the address and the
// access kind, so they skip the Win64 context conversion and the other handlers.
if (PosixGpuFaultFastPath && !_posixSignalWarmup &&
(signal == PosixSigSegv || signal == PosixSigBus) &&
siginfo != 0 &&
TryResolvePosixGpuFault(siginfo, ucontext))
{
return;
}
if (TryHandlePosixFault(signal, siginfo, ucontext)) if (TryHandlePosixFault(signal, siginfo, ucontext))
{ {
return; return;
@ -258,6 +281,28 @@ public sealed unsafe partial class DirectExecutionBackend
ChainPreviousPosixAction(signal, siginfo, ucontext); ChainPreviousPosixAction(signal, siginfo, ucontext);
} }
private static readonly bool PosixGpuFaultFastPath =
Environment.GetEnvironmentVariable("SHARPEMU_POSIX_GPU_FAULT_FAST_PATH") != "0";
private static bool TryResolvePosixGpuFault(nint siginfo, nint ucontext)
{
byte* registers = GetPosixRegisterBase(ucontext);
if (registers == null)
{
return false;
}
ulong faultAddress = GetPosixFaultAddress(siginfo, registers);
ulong rip = *(ulong*)(registers + PosixRegisterOffsets[16]);
var kind = GetPosixAccessType(registers, faultAddress, rip) switch
{
0 => FaultKind.Read,
1 => FaultKind.Write,
_ => FaultKind.Unknown,
};
return kind != FaultKind.Unknown && GuestGpuMemoryHook.TryResolveFault(kind, faultAddress);
}
private static bool TryHandlePosixFault(int signal, nint siginfo, nint ucontext) private static bool TryHandlePosixFault(int signal, nint siginfo, nint ucontext)
{ {
byte* registers = GetPosixRegisterBase(ucontext); byte* registers = GetPosixRegisterBase(ucontext);
@ -274,25 +319,18 @@ public sealed unsafe partial class DirectExecutionBackend
WriteCtxU64(contextRecord, CTX_RAX + i * 8, *(ulong*)(registers + offsets[i])); WriteCtxU64(contextRecord, CTX_RAX + i * 8, *(ulong*)(registers + offsets[i]));
} }
// Bridge the XMM registers alongside the GPRs where the layout is // Copy the vector registers that instruction recovery can change.
// known: on Linux the fpstate pointer and FXSAVE image are kernel // Keep all other floating-point state unchanged.
// ABI, so recovery paths that read or write XMM state (SSE4a byte* vectorRegisters = GetSignalVectorRegisterAddress(ucontext, registers);
// EXTRQ/INSERTQ) see the live registers and their writes reach the if (vectorRegisters != null)
// guest through sigreturn.
byte* fpstate = null;
if (OperatingSystem.IsLinux())
{ {
fpstate = *(byte**)(registers + LinuxGregsFpstateOffset); Buffer.MemoryCopy(
if (fpstate != null) vectorRegisters,
{ contextRecord + Win64ContextXmm0Offset,
Buffer.MemoryCopy( XmmBlockSize,
fpstate + FxsaveXmmOffset, XmmBlockSize);
contextRecord + Win64ContextXmm0Offset,
XmmBlockSize,
XmmBlockSize);
}
} }
_posixXmmContextBridged = fpstate != null; _posixXmmContextBridged = vectorRegisters != null;
EXCEPTION_RECORD record = default; EXCEPTION_RECORD record = default;
record.ExceptionAddress = (void*)ReadCtxU64(contextRecord, CTX_RIP); record.ExceptionAddress = (void*)ReadCtxU64(contextRecord, CTX_RIP);
@ -308,6 +346,11 @@ public sealed unsafe partial class DirectExecutionBackend
{ {
record.ExceptionCode = 1073741845u; record.ExceptionCode = 1073741845u;
} }
else if (signal == PosixSigFpe)
{
// STATUS_INTEGER_DIVIDE_BY_ZERO: #DE from div/idiv (zero divisor or quotient overflow).
record.ExceptionCode = 3221225620u;
}
else else
{ {
ulong faultAddress = GetPosixFaultAddress(siginfo, registers); ulong faultAddress = GetPosixFaultAddress(siginfo, registers);
@ -359,17 +402,36 @@ public sealed unsafe partial class DirectExecutionBackend
{ {
*(ulong*)(registers + offsets[i]) = ReadCtxU64(contextRecord, CTX_RAX + i * 8); *(ulong*)(registers + offsets[i]) = ReadCtxU64(contextRecord, CTX_RAX + i * 8);
} }
if (fpstate != null) if (vectorRegisters != null)
{ {
Buffer.MemoryCopy( Buffer.MemoryCopy(
contextRecord + Win64ContextXmm0Offset, contextRecord + Win64ContextXmm0Offset,
fpstate + FxsaveXmmOffset, vectorRegisters,
XmmBlockSize, XmmBlockSize,
XmmBlockSize); XmmBlockSize);
} }
return true; return true;
} }
private static byte* GetSignalVectorRegisterAddress(nint userContextAddress, byte* machineContext)
{
if (OperatingSystem.IsMacOS())
{
var machineContextSize = *(ulong*)((byte*)userContextAddress + DarwinUserContextMachineContextSizeOffset);
return machineContextSize >= DarwinMachineContextVectorRegistersOffset + XmmBlockSize
? machineContext + DarwinMachineContextVectorRegistersOffset
: null;
}
if (OperatingSystem.IsLinux())
{
byte* floatingPointState = *(byte**)(machineContext + LinuxGregsFpstateOffset);
return floatingPointState != null ? floatingPointState + FxsaveXmmOffset : null;
}
return null;
}
private static byte* GetPosixRegisterBase(nint ucontext) private static byte* GetPosixRegisterBase(nint ucontext)
{ {
if (ucontext == 0) if (ucontext == 0)

View File

@ -0,0 +1,107 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.Buffers.Binary;
using System.Threading;
using Iced.Intel;
using SharpEmu.Core.Cpu.Emulation;
namespace SharpEmu.Core.Cpu.Native;
// The PS5 CPU has the SHA extensions and titles use them without a CPUID check.
// Rosetta 2 does not translate them, so they raise #UD on Apple Silicon hosts.
public sealed partial class DirectExecutionBackend
{
private static int _shaSoftwareFallbackAnnounced;
private static long _shaInstructionsEmulated;
private unsafe bool TryRecoverShaInstruction(void* contextRecord, ulong rip)
{
if (!OperatingSystem.IsWindows() && !_posixXmmContextBridged ||
!TryReadFaultingInstruction(rip, out var instruction))
{
return false;
}
switch (instruction.Mnemonic)
{
case Mnemonic.Sha1rnds4:
case Mnemonic.Sha1nexte:
case Mnemonic.Sha1msg1:
case Mnemonic.Sha1msg2:
case Mnemonic.Sha256rnds2:
case Mnemonic.Sha256msg1:
case Mnemonic.Sha256msg2:
break;
default:
return false;
}
if (instruction.GetOpKind(0) != OpKind.Register ||
!TryGetXmmOffset(instruction.GetOpRegister(0), out var destOffset) ||
!TryReadXmmOperand(contextRecord, in instruction, 1, out var source2))
{
return false;
}
var source1 = ReadCtxXmm(contextRecord, destOffset);
var result = instruction.Mnemonic switch
{
Mnemonic.Sha1rnds4 => ShaInstructionEmulator.Sha1Rnds4(source1, source2, instruction.Immediate8),
Mnemonic.Sha1nexte => ShaInstructionEmulator.Sha1Nexte(source1, source2),
Mnemonic.Sha1msg1 => ShaInstructionEmulator.Sha1Msg1(source1, source2),
Mnemonic.Sha1msg2 => ShaInstructionEmulator.Sha1Msg2(source1, source2),
Mnemonic.Sha256rnds2 => ShaInstructionEmulator.Sha256Rnds2(
source1, source2, ReadCtxXmm(contextRecord, Win64ContextXmm0Offset)),
Mnemonic.Sha256msg1 => ShaInstructionEmulator.Sha256Msg1(source1, source2),
_ => ShaInstructionEmulator.Sha256Msg2(source1, source2),
};
WriteCtxU64(contextRecord, destOffset, (ulong)result);
WriteCtxU64(contextRecord, destOffset + 8, (ulong)(result >> 64));
WriteCtxU64(contextRecord, CTX_RIP, rip + (ulong)instruction.Length);
Interlocked.Increment(ref _shaInstructionsEmulated);
if (Interlocked.Exchange(ref _shaSoftwareFallbackAnnounced, 1) == 0)
{
Console.Error.WriteLine(
"[LOADER][INFO] Host lacks the SHA extensions used by the guest; " +
"emulating those instructions in software.");
}
return true;
}
private unsafe bool TryReadXmmOperand(void* contextRecord, in Instruction instruction, int operandIndex, out UInt128 value)
{
value = 0;
switch (instruction.GetOpKind(operandIndex))
{
case OpKind.Register:
if (!TryGetXmmOffset(instruction.GetOpRegister(operandIndex), out var offset))
{
return false;
}
value = ReadCtxXmm(contextRecord, offset);
return true;
case OpKind.Memory:
var buffer = new byte[16];
if (!TryComputeMemoryAddress(contextRecord, in instruction, out var address) ||
!TryReadHostBytes(address, buffer))
{
return false;
}
value = BinaryPrimitives.ReadUInt128LittleEndian(buffer);
return true;
default:
return false;
}
}
private static unsafe UInt128 ReadCtxXmm(void* contextRecord, int offset) =>
new(ReadCtxU64(contextRecord, offset + 8), ReadCtxU64(contextRecord, offset));
}

View File

@ -0,0 +1,206 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.Runtime.InteropServices;
namespace SharpEmu.Core.Cpu.Native;
public sealed partial class DirectExecutionBackend
{
private const int HostStackStateBytes = 3 * sizeof(ulong);
internal static unsafe bool TryGetGuestStackBounds(ulong stackPointer, out ulong bottom, out ulong top)
{
if (OperatingSystem.IsWindows() &&
QueryVirtualMemoryInformation(-1, (void*)stackPointer, 0, out var allocation,
(nuint)sizeof(StackMemoryRegionInformation), null) != 0 &&
((allocation.Flags & 1) == 0 || allocation.CommitSize == allocation.RegionSize) &&
allocation.RegionSize != 0 && allocation.RegionSize <= ulong.MaxValue - allocation.AllocationBase &&
stackPointer >= allocation.AllocationBase && stackPointer - allocation.AllocationBase < allocation.RegionSize)
{
bottom = allocation.AllocationBase;
top = bottom + allocation.RegionSize;
return true;
}
bottom = top = 0;
var queried = VirtualQuery((void*)stackPointer, out var region, (nuint)sizeof(MEMORY_BASIC_INFORMATION64));
if (queried == 0 ||
region.State != 0x1000 || region.RegionSize == 0 || region.RegionSize > ulong.MaxValue - region.BaseAddress)
{
return false;
}
bottom = region.BaseAddress;
top = region.BaseAddress + region.RegionSize;
return stackPointer >= bottom && stackPointer < top;
}
private static unsafe void EmitStackBound(byte* code, ref int offset, byte register, uint field, bool store)
{
EmitByte(code, ref offset, 0x65);
EmitByte(code, ref offset, (byte)(0x48 | (register >= 8 ? 4 : 0)));
EmitByte(code, ref offset, store ? (byte)0x89 : (byte)0x8B);
EmitByte(code, ref offset, (byte)(0x04 | ((register & 7) << 3)));
EmitByte(code, ref offset, 0x25);
EmitUInt32(code, ref offset, field);
}
// Fiber switches replace the guest stack without passing through a guest-entry stub, so the
// context-transfer stub keeps the Windows TEB bounds in sync from the target state in R11
// (stack top at +160, bottom at +168). Only Windows keeps stack bounds at gs:[8]/gs:[16]: on
// macOS gs addresses the pthread TSD, where those slots hold errno's address and another key.
// Writing a fiber's bounds there nulled errno, and the next failed libc call on the thread
// crashed reading it (Demon's Souls, about 10 s into boot).
private static unsafe void EmitFiberStackBounds(byte* code, ref int offset)
{
if (!OperatingSystem.IsWindows()) return;
ReadOnlySpan<byte> loadTop = [0x4D, 0x8B, 0x93, 160, 0, 0, 0]; // mov r10, [r11+160]
foreach (var value in loadTop) EmitByte(code, ref offset, value);
EmitStackBound(code, ref offset, 10, 8, store: true);
ReadOnlySpan<byte> loadBottom = [0x4D, 0x8B, 0x93, 168, 0, 0, 0]; // mov r10, [r11+168]
foreach (var value in loadBottom) EmitByte(code, ref offset, value);
EmitStackBound(code, ref offset, 10, 16, store: true);
}
// Test hook: the bytes the fiber stack-bounds sync emits on this host.
internal static unsafe byte[] EmitFiberStackBoundsForTest()
{
var buffer = new byte[64];
var offset = 0;
fixed (byte* code = buffer)
{
EmitFiberStackBounds(code, ref offset);
}
return buffer[..offset];
}
// R10 points to the entry state. R11 is scratch; RAX remains unchanged.
private static unsafe void EmitHostStackBounds(byte* code, ref int offset, bool save)
{
if (!OperatingSystem.IsWindows()) return;
for (byte field = 8; field <= 16; field += 8)
{
if (save) EmitStackBound(code, ref offset, 11, field, store: false);
EmitByte(code, ref offset, 0x4D);
EmitByte(code, ref offset, save ? (byte)0x89 : (byte)0x8B);
EmitByte(code, ref offset, 0x5A);
EmitByte(code, ref offset, field);
if (!save) EmitStackBound(code, ref offset, 11, field, store: true);
}
}
private static unsafe void EmitGuestStackBounds(byte* code, ref int offset, ulong stackPointer)
{
if (!OperatingSystem.IsWindows()) return;
if (!TryGetGuestStackBounds(stackPointer, out var bottom, out var top))
{
throw new InvalidOperationException("Guest stack has no committed host mapping.");
}
EmitHostStackBounds(code, ref offset, save: true);
for (uint field = 8; field <= 16; field += 8)
{
EmitByte(code, ref offset, 0x49);
EmitByte(code, ref offset, 0xBB);
*(ulong*)(code + offset) = field == 8 ? top : bottom;
offset += sizeof(ulong);
EmitStackBound(code, ref offset, 11, field, store: true);
}
}
private static unsafe void EmitSavedStackBounds(byte* code, ref int offset, bool restore)
{
if (!OperatingSystem.IsWindows()) return;
EmitStackBound(code, ref offset, 14, 8, restore);
EmitStackBound(code, ref offset, 15, 16, restore);
}
private unsafe void EmitExceptionHostStackBounds(byte* code, ref int offset)
{
EmitSavedStackBounds(code, ref offset, restore: false);
ReadOnlySpan<byte> reserve = [0x48, 0x83, 0xEC, 0x28, 0xB9];
foreach (var value in reserve) EmitByte(code, ref offset, value);
EmitUInt32(code, ref offset, _hostRspSlotTlsIndex);
EmitByte(code, ref offset, 0x48); EmitByte(code, ref offset, 0xB8);
*(nint*)(code + offset) = _tlsGetValueAddress;
offset += sizeof(nint);
ReadOnlySpan<byte> lookup = [0xFF, 0xD0, 0x48, 0x83, 0xC4, 0x28, 0x48, 0x85, 0xC0, 0x0F, 0x84];
foreach (var value in lookup) EmitByte(code, ref offset, value);
var missingState = offset;
EmitUInt32(code, ref offset, 0);
// The state is zeroed at allocation; bounds the entry stub has not saved yet stay untouched.
ReadOnlySpan<byte> unsaved = [0x48, 0x83, 0x78, 0x08, 0x00, 0x0F, 0x84];
foreach (var value in unsaved) EmitByte(code, ref offset, value);
var missingBounds = offset;
EmitUInt32(code, ref offset, 0);
EmitByte(code, ref offset, 0x49); EmitByte(code, ref offset, 0x89); EmitByte(code, ref offset, 0xC2);
// A host fault already has live bounds. Do not replace a grown limit with an old one.
ReadOnlySpan<byte> sameStack = [0x4C, 0x3B, 0x70, 0x08, 0x0F, 0x85];
foreach (var value in sameStack) EmitByte(code, ref offset, value);
var guestStack = offset;
EmitUInt32(code, ref offset, 0);
EmitHostStackBounds(code, ref offset, save: true);
EmitByte(code, ref offset, 0xE9);
var hostStack = offset;
EmitUInt32(code, ref offset, 0);
*(int*)(code + guestStack) = offset - guestStack - sizeof(int);
EmitHostStackBounds(code, ref offset, save: false);
*(int*)(code + hostStack) = offset - hostStack - sizeof(int);
*(int*)(code + missingState) = offset - missingState - sizeof(int);
*(int*)(code + missingBounds) = offset - missingBounds - sizeof(int);
}
[UnmanagedCallersOnly]
private static unsafe int SelectExceptionStackBounds(void* exceptionInfo, int disposition, ulong* bounds)
{
if (disposition != -1) return disposition;
var context = ((EXCEPTION_POINTERS*)exceptionInfo)->ContextRecord;
if (context == null) return 0;
var stackPointer = ReadCtxU64(context, 152);
if (stackPointer >= bounds[1] && stackPointer < bounds[0]) return disposition;
GetCurrentThreadStackLimits(out var nativeBottom, out var nativeTop);
if (stackPointer >= nativeBottom && stackPointer < nativeTop)
{
bounds[0] = nativeTop;
bounds[1] = nativeBottom;
return disposition;
}
if (!TryGetGuestStackBounds(stackPointer, out var bottom, out var top)) return 0;
bounds[0] = top;
bounds[1] = bottom;
return disposition;
}
private static unsafe void EmitExceptionStackSelection(byte* code, ref int offset)
{
// The caller reserves 72 bytes: ABI home space and two stack bounds.
ReadOnlySpan<byte> arguments = [0x4C, 0x89, 0x74, 0x24, 0x28, 0x4C, 0x89, 0x7C, 0x24, 0x30,
0x89, 0xC2, 0x4C, 0x89, 0xE9, 0x4C, 0x8D, 0x44, 0x24, 0x28, 0x48, 0xB8];
foreach (var value in arguments) EmitByte(code, ref offset, value);
*(nint*)(code + offset) = (nint)(delegate* unmanaged<void*, int, ulong*, int>)&SelectExceptionStackBounds;
offset += sizeof(nint);
ReadOnlySpan<byte> result = [0xFF, 0xD0, 0x4C, 0x8B, 0x74, 0x24, 0x28, 0x4C, 0x8B, 0x7C, 0x24, 0x30];
foreach (var value in result) EmitByte(code, ref offset, value);
}
[DllImport("kernel32.dll", ExactSpelling = true)]
private static extern void GetCurrentThreadStackLimits(out ulong lowLimit, out ulong highLimit);
[StructLayout(LayoutKind.Sequential)]
private struct StackMemoryRegionInformation
{
public ulong AllocationBase;
public uint AllocationProtect;
public uint Flags;
public ulong RegionSize;
public ulong CommitSize;
}
[DllImport("api-ms-win-core-memory-l1-1-4.dll", ExactSpelling = true)]
private static extern unsafe int QueryVirtualMemoryInformation(nint process, void* address, int informationClass,
out StackMemoryRegionInformation information, nuint informationSize, nuint* returnSize);
}

View File

@ -0,0 +1,182 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.Diagnostics;
using System.ComponentModel;
using System.Runtime.InteropServices;
using Microsoft.Win32.SafeHandles;
namespace SharpEmu.Core.Cpu.Native;
public sealed unsafe partial class DirectExecutionBackend
{
private SafeWaitHandle? _mainExecutionThreadHandle;
// One immutable code page serves all diagnostic samples for the process lifetime.
private static readonly Lazy<ThreadContextCaptureCode> ThreadCaptureCode = new(() => new());
private sealed class ThreadContextCaptureCode : SafeHandle
{
public override bool IsInvalid => handle == 0;
public ThreadContextCaptureCode() : base(0, ownsHandle: true)
{
var kernelModule = GetModuleHandle("kernel32.dll");
var suspendAddress = GetProcAddress(kernelModule, "SuspendThread");
var contextAddress = GetProcAddress(kernelModule, "GetThreadContext");
var resumeAddress = GetProcAddress(kernelModule, "ResumeThread");
if (suspendAddress == 0 || contextAddress == 0 || resumeAddress == 0) return;
var instructions = BuildThreadContextCaptureCode(suspendAddress, contextAddress, resumeAddress);
SetHandle((nint)VirtualAlloc(null, (nuint)instructions.Length, 0x3000, 0x04));
if (IsInvalid) return;
instructions.CopyTo(new Span<byte>((void*)handle, instructions.Length));
uint previousProtection = 0;
if (!VirtualProtect((void*)handle, (nuint)instructions.Length, 0x20, &previousProtection))
{
Dispose();
return;
}
FlushInstructionCache(GetCurrentProcess(), (void*)handle, (nuint)instructions.Length);
}
protected override bool ReleaseHandle() => VirtualFree((void*)handle, 0, 0x8000);
}
private static SafeWaitHandle? OpenThreadForContext(uint threadId)
{
if (!OperatingSystem.IsWindows() || RuntimeInformation.ProcessArchitecture != Architecture.X64 || threadId == 0)
return null;
const uint queryLimitedInformation = 0x0800;
var threadHandle = OpenThread(ThreadGetContext | ThreadSuspendResume | queryLimitedInformation, false, threadId);
return threadHandle == 0 ? null : new SafeWaitHandle(threadHandle, ownsHandle: true);
}
private static bool TryCaptureHostThreadContext(int threadId, out HostThreadContextSnapshot snapshot)
{
using var threadHandle = OpenThreadForContext(unchecked((uint)threadId));
return TryCaptureThreadContext(threadHandle, out snapshot);
}
private static bool TryCaptureThreadContext(SafeWaitHandle? threadHandle, out HostThreadContextSnapshot snapshot)
{
snapshot = default;
if (threadHandle is null || !OperatingSystem.IsWindows() || RuntimeInformation.ProcessArchitecture != Architecture.X64)
return false;
var handleReferenced = false;
try
{
threadHandle.DangerousAddRef(ref handleReferenced);
var nativeHandle = threadHandle.DangerousGetHandle();
var threadId = GetThreadId(nativeHandle);
if (threadId == 0 || threadId == GetCurrentThreadId()) return false;
var captureCode = ThreadCaptureCode.Value;
if (captureCode.IsInvalid || captureCode.IsClosed) return false;
byte* contextStorage = stackalloc byte[Win64ContextSize + 15];
var contextRecord = (void*)(((nuint)contextStorage + 15) & ~(nuint)15);
new Span<byte>(contextRecord, Win64ContextSize).Clear();
WriteCtxU32(contextRecord, Win64ContextFlagsOffset, ContextAmd64ControlInteger);
// One native transition keeps managed work outside the suspended interval.
var captured = ((delegate* unmanaged<nint, void*, int>)captureCode.DangerousGetHandle())(nativeHandle, contextRecord);
if (captured == 0) return false;
snapshot = DecodeHostThreadContext(threadId, contextRecord);
return true;
}
catch (ObjectDisposedException)
{
return false;
}
finally
{
if (handleReferenced) threadHandle!.DangerousRelease();
}
}
private static HostThreadContextSnapshot DecodeHostThreadContext(uint threadId, void* contextRecord) => new(
threadId,
ReadCtxU64(contextRecord, 248), ReadCtxU64(contextRecord, 152), ReadCtxU64(contextRecord, 160),
ReadCtxU64(contextRecord, 120), ReadCtxU64(contextRecord, 144), ReadCtxU64(contextRecord, 128),
ReadCtxU64(contextRecord, 136), ReadCtxU64(contextRecord, 168), ReadCtxU64(contextRecord, 176),
ReadCtxU64(contextRecord, 184), ReadCtxU64(contextRecord, 192), ReadCtxU64(contextRecord, 200),
ReadCtxU64(contextRecord, 208), ReadCtxU64(contextRecord, 216), ReadCtxU64(contextRecord, 224),
ReadCtxU64(contextRecord, 232), ReadCtxU64(contextRecord, 240));
internal static byte[] BuildThreadContextCaptureCode(nint suspendAddress, nint contextAddress, nint resumeAddress)
{
var instructions = new List<byte>();
void CallAddress(nint address)
{
instructions.AddRange([0x48, 0xB8]);
instructions.AddRange(BitConverter.GetBytes((long)address));
instructions.AddRange([0xFF, 0xD0]);
}
// Preserve nonvolatile registers and reserve aligned argument space.
instructions.AddRange([0x53, 0x56, 0x57, 0x48, 0x83, 0xEC, 0x20,
0x48, 0x89, 0xCB, 0x48, 0x89, 0xD6, 0x31, 0xFF]);
CallAddress(suspendAddress);
instructions.AddRange([0x83, 0xF8, 0xFF, 0x74, 0]);
var failedSuspendJump = instructions.Count - 1;
instructions.AddRange([0x48, 0x89, 0xD9, 0x48, 0x89, 0xF2]);
CallAddress(contextAddress);
instructions.AddRange([0x89, 0xC7, 0x48, 0x89, 0xD9]);
CallAddress(resumeAddress);
instructions.AddRange([0x83, 0xF8, 0xFF, 0x75, 0x02, 0x31, 0xFF]);
var returnOffset = instructions.Count;
instructions.AddRange([0x89, 0xF8, 0x48, 0x83, 0xC4, 0x20, 0x5F, 0x5E, 0x5B, 0xC3]);
instructions[failedSuspendJump] = checked((byte)(returnOffset - failedSuspendJump - 1));
return instructions.ToArray();
}
private void LogMainThreadStallContext()
{
if (!TryCaptureThreadContext(Volatile.Read(ref _mainExecutionThreadHandle), out var context)) return;
Console.Error.WriteLine($"[LOADER][ERROR] Live hardware context (main thread {context.ThreadId}):");
Console.Error.WriteLine($"[LOADER][ERROR] RIP=0x{context.Rip:X16} RSP=0x{context.Rsp:X16} RBP=0x{context.Rbp:X16}");
Console.Error.WriteLine($"[LOADER][ERROR] RAX=0x{context.Rax:X16} RBX=0x{context.Rbx:X16} RCX=0x{context.Rcx:X16} RDX=0x{context.Rdx:X16}");
Console.Error.WriteLine($"[LOADER][ERROR] RSI=0x{context.Rsi:X16} RDI=0x{context.Rdi:X16} R8=0x{context.R8:X16} R9=0x{context.R9:X16}");
Console.Error.WriteLine($"[LOADER][ERROR] R10=0x{context.R10:X16} R11=0x{context.R11:X16} R12=0x{context.R12:X16} R13=0x{context.R13:X16} R14=0x{context.R14:X16} R15=0x{context.R15:X16}");
var modules = Array.Empty<(ulong Start, ulong Size, string Name)>();
try
{
using var process = Process.GetCurrentProcess();
modules = process.Modules.Cast<ProcessModule>().Select(module =>
(Start: unchecked((ulong)module.BaseAddress), Size: (ulong)module.ModuleMemorySize, Name: module.ModuleName)).ToArray();
}
catch (Win32Exception) { }
catch (InvalidOperationException) { }
string DescribeAddress(ulong address)
{
foreach (var module in modules)
if (address >= module.Start && address - module.Start < module.Size)
return $"{module.Name}+0x{address - module.Start:X}";
return $"0x{address:X16}";
}
Console.Error.WriteLine($"[LOADER][ERROR] RIP location: {DescribeAddress(context.Rip)}");
// The thread has resumed. These bytes are best-effort observations, not an atomic snapshot.
var instructionBytes = new byte[48];
if (context.Rip >= 32 && TryReadHostBytes(context.Rip - 32, instructionBytes))
Console.Error.WriteLine($"[LOADER][ERROR] Live bytes @[RIP-32..RIP+16]: {Convert.ToHexString(instructionBytes)}");
var currentInstruction = new byte[16];
if (TryReadHostBytes(context.Rip, currentInstruction))
Console.Error.WriteLine($"[LOADER][ERROR] Live bytes @RIP: {Convert.ToHexString(currentInstruction)}");
Console.Error.WriteLine("[LOADER][ERROR] Live stack pointer candidates:");
for (var offset = 0; offset < 256; offset += sizeof(ulong))
{
var address = context.Rsp + (ulong)offset;
if (address < context.Rsp || !TryReadDiagnosticHostQword(address, out var value)) break;
if (value != 0)
Console.Error.WriteLine($"[LOADER][ERROR] [rsp+0x{offset:X2}] = 0x{value:X16} ({DescribeAddress(value)})");
}
}
[DllImport("kernel32.dll")]
private static extern uint GetThreadId(nint threadHandle);
}

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,100 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.Diagnostics;
namespace SharpEmu.Core.Cpu.Native;
internal sealed class GuestThreadFlowProfile(int capacity = 131072)
{
internal static readonly bool Enabled =
(Environment.GetEnvironmentVariable("SHARPEMU_PROFILE_PERFORMANCE") == "1" ||
Environment.GetEnvironmentVariable("SHARPEMU_PROFILE_GUEST_SCHEDULER") == "1") &&
Environment.GetEnvironmentVariable("SHARPEMU_PROFILE_PERFORMANCE_FRAME_TRACE") == "1";
internal enum EventKind
{
Blocked, Ready, Claimed, Scheduled, RunStarted, RunStopped, CallbackResumed,
ExecutorReleased, ClaimDeferred
}
internal readonly record struct TraceEvent(long Timestamp, int HostThreadId, ulong GuestThreadHandle,
string Name, EventKind Kind, string? Reason, string? WakeKey, string? ImportNid,
ulong Argument0, ulong Argument1, long DeadlineTimestamp);
internal readonly record struct Snapshot(TraceEvent[] Events, long TotalEvents);
private readonly int _capacity = capacity > 0 ? capacity : throw new ArgumentOutOfRangeException(nameof(capacity));
private readonly object _gate = new();
private readonly object _writeGate = new();
private TraceEvent[]? _events;
private long _eventCount;
private bool _closed;
internal void StartSession()
{
lock (_writeGate)
{
lock (_gate)
{
_events = null;
_eventCount = 0;
_closed = false;
}
}
}
internal void Record(in TraceEvent traceEvent)
{
lock (_gate)
{
if (_closed) return;
_events ??= new TraceEvent[_capacity];
_events[(int)(_eventCount % _capacity)] = traceEvent;
_eventCount++;
}
}
internal Snapshot Close()
{
lock (_gate)
{
_closed = true;
var retained = (int)Math.Min(_eventCount, _capacity);
var records = new TraceEvent[retained];
var first = _eventCount - retained;
for (var index = 0; index < retained; index++)
records[index] = _events![(int)((first + index) % _capacity)];
var snapshot = new Snapshot(records, _eventCount);
_events = null;
_eventCount = 0;
return snapshot;
}
}
internal void WriteTrace(TextWriter output)
{
// A concurrent shutdown caller must wait for the first writer to finish.
lock (_writeGate)
{
WriteRetainedEvents(output);
}
}
private void WriteRetainedEvents(TextWriter output)
{
var snapshot = Close();
if (snapshot.TotalEvents == 0) return;
output.WriteLine($"[PERF][GUEST_FLOW_TRACE] frequency={Stopwatch.Frequency} retained={snapshot.Events.Length} overwritten={snapshot.TotalEvents - snapshot.Events.Length}");
for (var index = 0; index < snapshot.Events.Length; index++)
{
var item = snapshot.Events[index];
output.WriteLine($"[PERF][GUEST_FLOW] sequence={snapshot.TotalEvents - snapshot.Events.Length + index} timestamp={item.Timestamp} thread={item.HostThreadId} guest=0x{item.GuestThreadHandle:X} name='{Quote(item.Name)}' event={item.Kind} reason='{Quote(item.Reason)}' wake='{Quote(item.WakeKey)}' nid='{Quote(item.ImportNid)}' arg0=0x{item.Argument0:X} arg1=0x{item.Argument1:X} deadline={item.DeadlineTimestamp}");
}
output.Flush();
}
// Guest names must not split one trace event across multiple output lines.
private static string Quote(string? value) => (value ?? "none")
.Replace("\\", "\\\\").Replace("'", "\\'").Replace("\r", "\\r").Replace("\n", "\\n");
}

View File

@ -274,7 +274,7 @@ internal static unsafe class PosixHostStubs
// Linux: call pthread_getspecific, preserving the registers that are // Linux: call pthread_getspecific, preserving the registers that are
// volatile in SysV but non-volatile in Win64 (rsi, rdi). // volatile in SysV but non-volatile in Win64 (rsi, rdi).
var pthreadGetSpecific = ResolveLibcExport("pthread_getspecific"); var pthreadGetSpecific = NativeLibrary.GetExport(NativeLibrary.Load("libpthread.so.0"), "pthread_getspecific");
Emit(page, ref offset, 0x56); // push rsi Emit(page, ref offset, 0x56); // push rsi
Emit(page, ref offset, 0x57); // push rdi Emit(page, ref offset, 0x57); // push rdi
Emit(page, ref offset, 0x48, 0x83, 0xEC, 0x08); // sub rsp, 8 Emit(page, ref offset, 0x48, 0x83, 0xEC, 0x08); // sub rsp, 8
@ -366,25 +366,25 @@ internal static unsafe class PosixHostStubs
[DllImport("libc", EntryPoint = "pthread_key_create", SetLastError = true)] [DllImport("libc", EntryPoint = "pthread_key_create", SetLastError = true)]
private static extern int pthread_key_create_mac(nuint* key, nint destructor); private static extern int pthread_key_create_mac(nuint* key, nint destructor);
[DllImport("libc", EntryPoint = "pthread_key_create", SetLastError = true)] [DllImport("libpthread.so.0", EntryPoint = "pthread_key_create", SetLastError = true)]
private static extern int pthread_key_create_linux(uint* key, nint destructor); private static extern int pthread_key_create_linux(uint* key, nint destructor);
[DllImport("libc", EntryPoint = "pthread_key_delete")] [DllImport("libc", EntryPoint = "pthread_key_delete")]
private static extern int pthread_key_delete_mac(nuint key); private static extern int pthread_key_delete_mac(nuint key);
[DllImport("libc", EntryPoint = "pthread_key_delete")] [DllImport("libpthread.so.0", EntryPoint = "pthread_key_delete")]
private static extern int pthread_key_delete_linux(uint key); private static extern int pthread_key_delete_linux(uint key);
[DllImport("libc", EntryPoint = "pthread_setspecific")] [DllImport("libc", EntryPoint = "pthread_setspecific")]
private static extern int pthread_setspecific_mac(nuint key, nint value); private static extern int pthread_setspecific_mac(nuint key, nint value);
[DllImport("libc", EntryPoint = "pthread_setspecific")] [DllImport("libpthread.so.0", EntryPoint = "pthread_setspecific")]
private static extern int pthread_setspecific_linux(uint key, nint value); private static extern int pthread_setspecific_linux(uint key, nint value);
[DllImport("libc", EntryPoint = "pthread_getspecific")] [DllImport("libc", EntryPoint = "pthread_getspecific")]
private static extern nint pthread_getspecific_mac(nuint key); private static extern nint pthread_getspecific_mac(nuint key);
[DllImport("libc", EntryPoint = "pthread_getspecific")] [DllImport("libpthread.so.0", EntryPoint = "pthread_getspecific")]
private static extern nint pthread_getspecific_linux(uint key); private static extern nint pthread_getspecific_linux(uint key);
[DllImport("libc")] [DllImport("libc")]

View File

@ -1,115 +0,0 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System;
namespace SharpEmu.Core.Cpu.Native;
/// <summary>
/// Recognizes Sony's AMD-only SSE4a EXTRQ+blend idiom and rewrites it into an
/// equivalent SSE4.1 sequence. SharpEmu executes guest x86-64 natively, but
/// Rosetta 2 and Intel hosts do not implement SSE4a, so the original opcode
/// raises #UD -> SIGILL. The compiler emits the idiom against whichever XMM
/// register it happens to allocate (Dead Cells uses xmm1, others xmm2), so the
/// source register is read from the ModRM r/m field rather than hard-coded.
///
/// The match/encode logic is deliberately free of native page-patching so it
/// can be unit-tested against handcrafted byte sequences.
/// </summary>
public static class Sse4aExtrqBlendPatch
{
/// <summary>Length in bytes of both the matched idiom and its replacement.</summary>
public const int SequenceLength = 12;
/// <summary>
/// Matches the 12-byte idiom, extracting the destination register D and the
/// source (scratch) register N:
/// <code>
/// EXTRQ xmmN, 0x28, 0x00 ; 66 0F 78 /0 28 00 mask xmmN to low 40 bits
/// VPBLENDD xmmD, xmmD, xmmN, 2 ; C4 E3 vvvv 02 /r 02 copy dword 1 into xmmD
/// </code>
/// N lives in the ModRM r/m field of both instructions; D (the blend
/// destination and src1) lives in the VPBLENDD ModRM reg field and VEX.vvvv.
/// Both are xmm0-xmm7 (the VEX byte1 0xE3 pins R/X/B, so no xmm8-15 extension).
/// The compiler allocates whichever registers it likes — Dead Cells builds use
/// D=xmm0 and D=xmm3, others differ — so both are read from the encoding.
/// </summary>
public static bool TryMatch(ReadOnlySpan<byte> source, out int destRegister, out int srcRegister)
{
destRegister = -1;
srcRegister = -1;
if (source.Length < SequenceLength)
{
return false;
}
// EXTRQ xmmN, 0x28, 0x00 : 66 0F 78, ModRM (mod=11 reg=000 rm=N), 28, 00.
if (source[0] != 0x66 || source[1] != 0x0F || source[2] != 0x78 ||
(source[3] & 0xF8) != 0xC0 || source[4] != 0x28 || source[5] != 0x00)
{
return false;
}
var n = source[3] & 0x07;
// VPBLENDD xmmD, xmmD, xmmN, 2 : C4 E3 <W=0 vvvv=~D L=0 pp=01> 02 ModRM 02.
// VEX.byte2 fixed bits (W, L, pp) must read 0b*0000*01; vvvv encodes ~D.
if (source[6] != 0xC4 || source[7] != 0xE3 || (source[8] & 0x87) != 0x01 ||
source[9] != 0x02 || source[11] != 0x02)
{
return false;
}
var d = (~(source[8] >> 3)) & 0x0F;
if (d > 7)
{
return false;
}
// ModRM: mod=11, reg=D (dest = src1), rm=N (src2 = the masked register).
if (source[10] != (0xC0 | (d << 3) | n))
{
return false;
}
destRegister = d;
srcRegister = n;
return true;
}
/// <summary>
/// Writes the SSE4.1 equivalent into <paramref name="destination"/>:
/// <code>
/// PEXTRB eax, xmmN, 4 ; 66 0F 3A 14 /r 04 extract byte 4 (zero-extended)
/// PINSRD xmmD, eax, 1 ; 66 0F 3A 22 /r 01 insert into xmmD dword lane 1
/// </code>
/// After EXTRQ masks xmmN to its low 40 bits, dword 1 is just byte 4
/// zero-extended, so the two-instruction extract/insert reproduces the exact
/// observable result the AMD idiom left in xmmD. eax is a caller-dead scratch
/// at every site the compiler emits this idiom.
/// </summary>
public static bool TryEncode(int destRegister, int srcRegister, Span<byte> destination)
{
if ((uint)destRegister > 7 || (uint)srcRegister > 7 || destination.Length < SequenceLength)
{
return false;
}
// PEXTRB eax, xmmN, 4 : ModRM (mod=11 reg=N rm=000 -> eax), imm8 = byte index 4.
destination[0] = 0x66;
destination[1] = 0x0F;
destination[2] = 0x3A;
destination[3] = 0x14;
destination[4] = (byte)(0xC0 | (srcRegister << 3));
destination[5] = 0x04;
// PINSRD xmmD, eax, 1 : ModRM (mod=11 reg=D -> xmmD, rm=000 -> eax), lane 1.
destination[6] = 0x66;
destination[7] = 0x0F;
destination[8] = 0x3A;
destination[9] = 0x22;
destination[10] = (byte)(0xC0 | (destRegister << 3));
destination[11] = 0x01;
return true;
}
}

View File

@ -16,6 +16,8 @@ internal static class WindowsFaultCodes
public const uint FastFail = 0xC0000409u; // 3221226505 public const uint FastFail = 0xC0000409u; // 3221226505
public const uint StackOverflow = 0xC00000FDu; public const uint StackOverflow = 0xC00000FDu;
public const uint ClrManagedException = 0xE0434352u; public const uint ClrManagedException = 0xE0434352u;
public const uint DebugOutputAnsi = 0x40010006u;
public const uint DebugOutputUnicode = 0x4001000Au;
// EXCEPTION_RECORD.ExceptionInformation[0] for access violations. // EXCEPTION_RECORD.ExceptionInformation[0] for access violations.
public const ulong AccessRead = 0; public const ulong AccessRead = 0;

View File

@ -47,7 +47,8 @@ internal sealed unsafe partial class WindowsFaultHandling : IHostFaultHandling
// FastFail (0xC0000409) is logged from this native path only: managed VEH never // FastFail (0xC0000409) is logged from this native path only: managed VEH never
// sees it (tLT18–21 silent exits after TBB AV recovery). // sees it (tLT18–21 silent exits after TBB AV recovery).
ReadOnlySpan<uint> nonManagedExceptionCodes = ReadOnlySpan<uint> nonManagedExceptionCodes =
[WindowsFaultCodes.ClrManagedException, 0xE06D7363u, WindowsFaultCodes.FastFail, WindowsFaultCodes.StackOverflow]; [WindowsFaultCodes.ClrManagedException, 0xE06D7363u, WindowsFaultCodes.FastFail, WindowsFaultCodes.StackOverflow,
WindowsFaultCodes.DebugOutputAnsi, WindowsFaultCodes.DebugOutputUnicode];
EmitByte(code, ref offset, 0x48); EmitByte(code, ref offset, 0x8B); EmitByte(code, ref offset, 0x01); // mov rax, [rcx] (ExceptionRecord*) EmitByte(code, ref offset, 0x48); EmitByte(code, ref offset, 0x8B); EmitByte(code, ref offset, 0x01); // mov rax, [rcx] (ExceptionRecord*)
EmitByte(code, ref offset, 0x8B); EmitByte(code, ref offset, 0x00); // mov eax, [rax] (ExceptionCode) EmitByte(code, ref offset, 0x8B); EmitByte(code, ref offset, 0x00); // mov eax, [rax] (ExceptionCode)
var passJumpOffsets = stackalloc int[nonManagedExceptionCodes.Length]; var passJumpOffsets = stackalloc int[nonManagedExceptionCodes.Length];

View File

@ -18,6 +18,8 @@ public sealed class TrackedCpuMemory : ICpuMemory, ITrackedCpuMemory, IGuestMemo
public ICpuMemory Inner => _inner; public ICpuMemory Inner => _inner;
public string DescribeReadRange(ulong address, ulong size) => _inner.DescribeReadRange(address, size);
public bool TryRead(ulong virtualAddress, Span<byte> destination) public bool TryRead(ulong virtualAddress, Span<byte> destination)
{ {
var result = _inner.TryRead(virtualAddress, destination); var result = _inner.TryRead(virtualAddress, destination);
@ -40,9 +42,20 @@ public sealed class TrackedCpuMemory : ICpuMemory, ITrackedCpuMemory, IGuestMemo
return result; return result;
} }
public bool TryCompare(
ulong virtualAddress,
ReadOnlySpan<byte> expected,
out bool equal) =>
_inner.TryCompare(virtualAddress, expected, out equal);
public bool TryCopy(ulong destinationAddress, ulong sourceAddress, ulong length) => public bool TryCopy(ulong destinationAddress, ulong sourceAddress, ulong length) =>
_inner.TryCopy(destinationAddress, sourceAddress, length); _inner.TryCopy(destinationAddress, sourceAddress, length);
public bool CanRead(ulong address, ulong size) => _inner.CanRead(address, size);
public bool TryScanCString(ulong address, byte needle, bool findLast, ulong maxLength, out ulong match) =>
_inner.TryScanCString(address, needle, findLast, maxLength, out match);
public bool TryAllocateGuestMemory(ulong size, ulong alignment, out ulong address) public bool TryAllocateGuestMemory(ulong size, ulong alignment, out ulong address)
{ {
if (_inner is IGuestMemoryAllocator allocator) if (_inner is IGuestMemoryAllocator allocator)

View File

@ -0,0 +1,122 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.Reflection.PortableExecutable;
using System.Text;
using Microsoft.Win32.SafeHandles;
namespace SharpEmu.Core.Diagnostics;
public static partial class WindowsCrashCapture
{
internal sealed class DebuggerBreakTracker
{
private readonly Dictionary<uint, nint> _threadStarts = new();
private nint _libraryBase;
private nint _breakThreadEntry;
private nint _breakpointAddress;
internal void Observe(DebugEvent debugEvent)
{
switch (debugEvent.Kind)
{
case CreateProcessEvent:
_threadStarts[debugEvent.ThreadId] = debugEvent.ProcessThreadStartAddress;
break;
case CreateThreadEvent:
_threadStarts[debugEvent.ThreadId] = debugEvent.ThreadStartAddress;
break;
case ExitThreadEvent:
_threadStarts.Remove(debugEvent.ThreadId);
break;
case LoadLibraryEvent:
if (TryReadDebuggerExports(debugEvent.FileHandle, out var threadOffset, out var breakpointOffset))
{
_libraryBase = debugEvent.LoadedLibraryBase;
_breakThreadEntry = checked(_libraryBase + threadOffset);
_breakpointAddress = checked(_libraryBase + breakpointOffset);
}
break;
case UnloadLibraryEvent when debugEvent.UnloadedLibraryBase == _libraryBase:
_libraryBase = _breakThreadEntry = _breakpointAddress = 0;
break;
}
}
internal bool IsDebuggerBreak(DebugEvent debugEvent) =>
debugEvent.Kind == ExceptionEvent && debugEvent.FirstChance != 0 &&
debugEvent.Exception.Code == BreakpointException && _libraryBase != 0 &&
debugEvent.Exception.Address == _breakpointAddress &&
_threadStarts.TryGetValue(debugEvent.ThreadId, out var startAddress) && startAddress == _breakThreadEntry;
}
private static unsafe bool TryReadDebuggerExports(nint fileHandle, out int threadOffset, out int breakpointOffset)
{
threadOffset = breakpointOffset = 0;
if (fileHandle == 0 || fileHandle == -1)
return false;
const int pathCapacity = 512;
var pathBuffer = stackalloc char[pathCapacity];
var pathLength = GetFinalPathNameByHandle(fileHandle, pathBuffer, pathCapacity, 0);
if (pathLength == 0 || pathLength >= pathCapacity)
return false;
var path = new string(pathBuffer, 0, (int)pathLength);
var systemLibrary = @"\\?\" + Path.Combine(Environment.SystemDirectory, "ntdll.dll");
if (!string.Equals(path, systemLibrary, StringComparison.OrdinalIgnoreCase))
return false;
try
{
// Read the file supplied by the debug event, then use the target's load address.
using var handle = new SafeFileHandle(fileHandle, ownsHandle: false);
using var stream = new FileStream(handle, FileAccess.Read);
using var image = new PEReader(stream);
if (image.PEHeaders.PEHeader is not { Magic: PEMagic.PE32Plus } header)
return false;
var directory = header.ExportTableDirectory;
if (directory.Size < 40)
return false;
var exports = image.GetSectionData(directory.RelativeVirtualAddress).GetReader(0, 40);
exports.Offset = 20;
var functionCount = exports.ReadInt32();
var nameCount = exports.ReadInt32();
var functionsAddress = exports.ReadInt32();
var namesAddress = exports.ReadInt32();
var ordinalsAddress = exports.ReadInt32();
var functions = image.GetSectionData(functionsAddress).GetReader(0, checked(functionCount * 4));
var names = image.GetSectionData(namesAddress).GetReader(0, checked(nameCount * 4));
var ordinals = image.GetSectionData(ordinalsAddress).GetReader(0, checked(nameCount * 2));
for (var nameIndex = 0; nameIndex < nameCount; nameIndex++)
{
var nameBlock = image.GetSectionData(names.ReadInt32());
var nameBytes = nameBlock.GetContent(0, Math.Min(nameBlock.Length, "DbgUiRemoteBreakin".Length + 1)).AsSpan();
var terminator = nameBytes.IndexOf((byte)0);
var ordinal = ordinals.ReadUInt16();
if (ordinal >= functionCount)
return false;
if (terminator < 0)
continue;
var name = Encoding.ASCII.GetString(nameBytes[..terminator]);
if (name is not ("DbgUiRemoteBreakin" or "DbgBreakPoint"))
continue;
functions.Offset = ordinal * 4;
var functionOffset = functions.ReadInt32();
// A forwarded export is not executable code in this image.
if (functionOffset <= 0 || functionOffset >= header.SizeOfImage ||
(functionOffset >= directory.RelativeVirtualAddress &&
functionOffset - directory.RelativeVirtualAddress < directory.Size))
return false;
if (name == "DbgUiRemoteBreakin")
threadOffset = functionOffset;
else
breakpointOffset = functionOffset;
}
return threadOffset != 0 && breakpointOffset != 0;
}
catch (Exception exception) when (exception is IOException or BadImageFormatException or ArgumentException or OverflowException)
{
threadOffset = breakpointOffset = 0;
return false;
}
}
}

View File

@ -0,0 +1,161 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.Runtime.InteropServices;
using Microsoft.Win32.SafeHandles;
namespace SharpEmu.Core.Diagnostics;
public static partial class WindowsCrashCapture
{
private const uint ExceptionEvent = 1;
private const uint CreateThreadEvent = 2;
private const uint CreateProcessEvent = 3;
private const uint ExitThreadEvent = 4;
private const uint ExitProcessEvent = 5;
private const uint LoadLibraryEvent = 6;
private const uint UnloadLibraryEvent = 7;
private const uint BreakpointException = 0x80000003;
private const uint DebugContinue = 0x00010002;
private const uint DebugExceptionNotHandled = 0x80010001;
private const uint ProcessReadAccess = 0x0450;
private const uint ThreadContextAccess = 0x0008;
private const uint DumpFullMemory = 0x00000002;
private const uint DumpHandleData = 0x00000004;
private const uint DumpUnloadedModules = 0x00000020;
private const uint DumpMemoryInformation = 0x00000800;
private const uint DumpThreadInformation = 0x00001000;
private const uint DumpIgnoreInaccessibleMemory = 0x00020000;
private const uint FullDumpFlags = DumpFullMemory | DumpHandleData | DumpUnloadedModules |
DumpMemoryInformation | DumpThreadInformation | DumpIgnoreInaccessibleMemory;
private const uint AllX64ContextFlags = 0x0010001F;
private static unsafe void WriteDump(uint processId, DebugEvent debugEvent, string dumpPath)
{
using var process = OpenProcess(ProcessReadAccess, false, processId);
if (process.IsInvalid)
throw NativeFailure("Open the crashed process");
using var thread = OpenThread(ThreadContextAccess, false, debugEvent.ThreadId);
if (thread.IsInvalid)
throw NativeFailure("Open the faulting thread");
var context = (ThreadContext*)NativeMemory.AlignedAlloc((nuint)sizeof(ThreadContext), 16);
if (context == null)
throw new OutOfMemoryException();
try
{
NativeMemory.Clear(context, (nuint)sizeof(ThreadContext));
context->Flags = AllX64ContextFlags;
if (!GetThreadContext(thread, context))
throw NativeFailure("Read the faulting thread context");
// The exception pointers refer to this helper, not to the crashed process.
var record = debugEvent.Exception;
record.NestedRecord = 0;
var pointers = new ExceptionPointers { Record = &record, Context = context };
var exception = new DumpExceptionInformation
{
ThreadId = debugEvent.ThreadId,
Pointers = &pointers,
ClientPointers = 0,
};
using var output = new FileStream(dumpPath, FileMode.CreateNew, FileAccess.Write, FileShare.Read);
if (!MiniDumpWriteDump(process, processId, output.SafeFileHandle, FullDumpFlags, &exception, 0, 0))
throw NativeFailure("Write the crash dump");
output.Flush(flushToDisk: true);
}
finally
{
NativeMemory.AlignedFree(context);
}
}
[StructLayout(LayoutKind.Explicit, Size = 176)]
internal struct DebugEvent
{
[FieldOffset(0)] public uint Kind;
[FieldOffset(4)] public uint ProcessId;
[FieldOffset(8)] public uint ThreadId;
[FieldOffset(16)] public ExceptionRecord Exception;
[FieldOffset(168)] public uint FirstChance;
[FieldOffset(16)] public nint FileHandle;
[FieldOffset(16)] public uint ExitCode;
[FieldOffset(24)] public nint LoadedLibraryBase;
[FieldOffset(16)] public nint UnloadedLibraryBase;
[FieldOffset(32)] public nint ThreadStartAddress;
[FieldOffset(64)] public nint ProcessThreadStartAddress;
}
[StructLayout(LayoutKind.Sequential)]
internal unsafe struct ExceptionRecord
{
public uint Code;
public uint Flags;
public nint NestedRecord;
public nint Address;
public uint ParameterCount;
public fixed ulong Parameters[15];
}
[StructLayout(LayoutKind.Explicit, Size = 1232)]
internal struct ThreadContext
{
[FieldOffset(48)] public uint Flags;
}
[StructLayout(LayoutKind.Sequential)]
private unsafe struct ExceptionPointers
{
public ExceptionRecord* Record;
public ThreadContext* Context;
}
[StructLayout(LayoutKind.Sequential, Pack = 4)]
internal unsafe struct DumpExceptionInformation
{
public uint ThreadId;
public void* Pointers;
public int ClientPointers;
}
[LibraryImport("kernel32.dll", SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
private static partial bool DebugActiveProcess(uint processId);
[LibraryImport("kernel32.dll", SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
private static partial bool DebugActiveProcessStop(uint processId);
[LibraryImport("kernel32.dll", SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
private static partial bool DebugSetProcessKillOnExit([MarshalAs(UnmanagedType.Bool)] bool killOnExit);
[LibraryImport("kernel32.dll", SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
private static partial bool WaitForDebugEventEx(out DebugEvent debugEvent, uint milliseconds);
[LibraryImport("kernel32.dll", SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
private static partial bool ContinueDebugEvent(uint processId, uint threadId, uint status);
[LibraryImport("kernel32.dll", SetLastError = true)]
private static partial SafeProcessHandle OpenProcess(uint access, [MarshalAs(UnmanagedType.Bool)] bool inherit, uint processId);
[LibraryImport("kernel32.dll", SetLastError = true)]
private static partial SafeWaitHandle OpenThread(uint access, [MarshalAs(UnmanagedType.Bool)] bool inherit, uint threadId);
[LibraryImport("kernel32.dll", SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
private static unsafe partial bool GetThreadContext(SafeWaitHandle thread, ThreadContext* context);
[LibraryImport("kernel32.dll")]
[return: MarshalAs(UnmanagedType.Bool)]
private static partial bool CloseHandle(nint handle);
[LibraryImport("kernel32.dll", EntryPoint = "GetFinalPathNameByHandleW", SetLastError = true)]
private static unsafe partial uint GetFinalPathNameByHandle(nint file, char* path, uint length, uint flags);
[LibraryImport("dbghelp.dll", SetLastError = true)]
[return: MarshalAs(UnmanagedType.Bool)]
private static unsafe partial bool MiniDumpWriteDump(SafeProcessHandle process, uint processId,
SafeFileHandle file, uint dumpType, DumpExceptionInformation* exception, nint userStream, nint callback);
}

View File

@ -0,0 +1,182 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.ComponentModel;
using System.Diagnostics;
using System.Globalization;
using System.Reflection;
using System.Runtime.InteropServices;
using Microsoft.Win32.SafeHandles;
namespace SharpEmu.Core.Diagnostics;
public static partial class WindowsCrashCapture
{
public const string HelperArgument = "--sharpemu-crash-helper";
private const string CaptureVariable = "SHARPEMU_CRASH_CAPTURE";
public static void StartIfEnabled(string? logFilePath)
{
if (!string.Equals(Environment.GetEnvironmentVariable(CaptureVariable), "1", StringComparison.Ordinal))
return;
if (!OperatingSystem.IsWindows() || RuntimeInformation.ProcessArchitecture != Architecture.X64)
{
Console.Error.WriteLine("[CRASH][WARN] Crash capture requires a Windows x64 process.");
return;
}
try
{
var logPath = string.IsNullOrWhiteSpace(logFilePath)
? Path.Combine(AppContext.BaseDirectory, "user", "logs", $"run-{DateTime.UtcNow:yyyyMMdd-HHmmss}.log")
: Path.GetFullPath(logFilePath);
var dumpPath = Path.ChangeExtension(logPath, $"crash-{Environment.ProcessId}.dmp");
Directory.CreateDirectory(Path.GetDirectoryName(dumpPath)!);
var readyEventName = $"Local\\SharpEmu-Crash-{Guid.NewGuid():N}";
using var readyEvent = new EventWaitHandle(false, EventResetMode.ManualReset, readyEventName);
var executable = Environment.ProcessPath ?? throw new InvalidOperationException("The executable path is not available.");
var startInfo = new ProcessStartInfo(executable) { UseShellExecute = false, CreateNoWindow = true };
if (string.Equals(Path.GetFileNameWithoutExtension(executable), "dotnet", StringComparison.OrdinalIgnoreCase))
startInfo.ArgumentList.Add(Assembly.GetEntryAssembly()!.Location);
startInfo.ArgumentList.Add(HelperArgument);
startInfo.ArgumentList.Add(Environment.ProcessId.ToString(CultureInfo.InvariantCulture));
startInfo.ArgumentList.Add(readyEventName);
startInfo.ArgumentList.Add(dumpPath);
startInfo.Environment.Remove(CaptureVariable);
// The helper stays attached until this process exits, including runtime teardown.
using var helper = Process.Start(startInfo) ?? throw new InvalidOperationException("The crash helper did not start.");
using var exited = new ProcessExitWaitHandle(helper);
WaitForHelper(readyEvent, exited);
Console.Error.WriteLine($"[CRASH][INFO] Crash capture ready. Dump: {dumpPath}");
Console.Error.WriteLine($"[CRASH][INFO] Capture report: {dumpPath}.capture.log");
Console.Error.WriteLine($"[CRASH][INFO] Runtime: {RuntimeInformation.FrameworkDescription}. Debugging can change timing.");
}
catch (Exception exception)
{
Console.Error.WriteLine($"[CRASH][ERROR] Crash capture is not active: {exception.Message}");
}
}
internal static void WaitForHelper(WaitHandle ready, WaitHandle exited)
{
if (WaitHandle.WaitAny([ready, exited]) != 0)
throw new InvalidOperationException("The crash helper exited before capture was ready. Check the capture report.");
}
private sealed class ProcessExitWaitHandle : WaitHandle
{
public ProcessExitWaitHandle(Process process) =>
SafeWaitHandle = new SafeWaitHandle(process.Handle, ownsHandle: false);
}
public static int RunHelper(string[] arguments)
{
if (!OperatingSystem.IsWindows() || RuntimeInformation.ProcessArchitecture != Architecture.X64 ||
arguments.Length != 4 || arguments[0] != HelperArgument ||
!uint.TryParse(arguments[1], NumberStyles.None, CultureInfo.InvariantCulture, out var processId) || processId == 0)
return 1;
var attached = false;
StreamWriter? report = null;
try
{
report = new StreamWriter(arguments[3] + ".capture.log", append: true) { AutoFlush = true };
report.WriteLine($"Capture helper started. Process: {processId}. Dump: {arguments[3]}");
report.WriteLine($"Runtime: {RuntimeInformation.FrameworkDescription}. OS: {Environment.OSVersion}.");
using var readyEvent = EventWaitHandle.OpenExisting(arguments[2]);
if (!DebugActiveProcess(processId))
throw NativeFailure("Attach to the game process");
attached = true;
if (!DebugSetProcessKillOnExit(false))
throw NativeFailure("Keep the game alive if the helper exits");
return ProcessDebugEvents(processId, arguments[3], readyEvent, report);
}
catch (Exception exception)
{
report?.WriteLine($"Capture failed: {exception.Message}");
Console.Error.WriteLine($"[CRASH][ERROR] Capture failed: {exception.Message}");
return 1;
}
finally
{
if (attached)
_ = DebugActiveProcessStop(processId);
report?.Dispose();
}
}
private static int ProcessDebugEvents(uint processId, string dumpPath, EventWaitHandle readyEvent, TextWriter report)
{
var initialBreakpoint = true;
var captured = false;
var debuggerBreaks = new DebuggerBreakTracker();
while (true)
{
if (!WaitForDebugEventEx(out var debugEvent, uint.MaxValue))
throw NativeFailure("Wait for a debug event");
var continuation = DebugContinue;
var ready = false;
try
{
try
{
debuggerBreaks.Observe(debugEvent);
}
finally
{
if (debugEvent.Kind is CreateProcessEvent or LoadLibraryEvent && debugEvent.FileHandle != 0)
_ = CloseHandle(debugEvent.FileHandle);
}
if (debugEvent.Kind == ExceptionEvent)
{
continuation = DebugExceptionNotHandled;
if (initialBreakpoint && debugEvent.FirstChance != 0 && debugEvent.Exception.Code == BreakpointException)
{
initialBreakpoint = false;
continuation = DebugContinue;
ready = true;
}
else if (debuggerBreaks.IsDebuggerBreak(debugEvent))
{
continuation = DebugContinue;
report.WriteLine($"Debugger break continued. Thread: {debugEvent.ThreadId}.");
}
else if (debugEvent.FirstChance == 0 && !captured)
{
captured = true;
report.WriteLine($"Unhandled exception: 0x{debugEvent.Exception.Code:X8}. " +
$"Address: 0x{debugEvent.Exception.Address:X16}. Thread: {debugEvent.ThreadId}.");
WriteDump(processId, debugEvent, dumpPath);
report.WriteLine("Dump complete.");
}
}
}
finally
{
// Even a failed dump must leave the original exception unhandled.
if (!ContinueDebugEvent(debugEvent.ProcessId, debugEvent.ThreadId, continuation))
throw NativeFailure("Continue a debug event");
}
if (ready)
{
report.WriteLine("Capture ready. Application exceptions remain unhandled by the helper.");
readyEvent.Set();
}
if (debugEvent.Kind == ExitProcessEvent)
{
report.WriteLine($"Process exited: 0x{debugEvent.ExitCode:X8}. Dump captured: {captured}.");
return 0;
}
}
}
private static Win32Exception NativeFailure(string operation)
{
var error = Marshal.GetLastPInvokeError();
return new Win32Exception(error, $"{operation} failed (Windows error {error}).");
}
}

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,66 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.Runtime.InteropServices;
using Iced.Intel;
namespace SharpEmu.Core.Loader;
// Use two 128-bit stores to let Rosetta report a memory fault.
// Keep the source register, general registers, and flags unchanged.
internal static class RosettaVectorStorePatch
{
internal static bool IsRequired { get; } = IsRosettaProcess();
private static unsafe bool IsRosettaProcess()
{
if (!OperatingSystem.IsMacOS() || RuntimeInformation.ProcessArchitecture != Architecture.X64)
{
return false;
}
int translationStatus = 0;
nuint valueByteCount = sizeof(int);
return ReadSystemControlValue("sysctl.proc_translated", &translationStatus, &valueByteCount, null, 0) == 0 && translationStatus == 1;
}
[DllImport("libSystem.B.dylib", EntryPoint = "sysctlbyname")]
private static extern unsafe int ReadSystemControlValue(string controlName, void* valueBuffer, nuint* valueByteCount, void* newValueBuffer, nuint newValueByteCount);
internal static bool RequiresStoreSplit(in Instruction instruction) =>
instruction.Code is Code.VEX_Vmovups_ymmm256_ymm or Code.VEX_Vmovupd_ymmm256_ymm or Code.VEX_Vmovdqu_ymmm256_ymm &&
instruction.Op0Kind == OpKind.Memory && instruction.Op1Register is >= Register.YMM0 and <= Register.YMM15;
internal static IList<Instruction> SplitVectorStores(IList<Instruction> instructions)
{
var splitInstructions = new List<Instruction>(instructions.Count * 2);
foreach (var instruction in instructions)
{
if (!RequiresStoreSplit(instruction))
{
splitInstructions.Add(instruction);
continue;
}
var lowerStore = instruction;
lowerStore.Code = Code.VEX_Vmovups_xmmm128_xmm;
lowerStore.Op1Register = Register.XMM0 + (instruction.Op1Register - Register.YMM0);
splitInstructions.Add(lowerStore);
var upperStore = instruction;
upperStore.Code = Code.VEX_Vextractf128_xmmm128_ymm_imm8;
upperStore.Op2Kind = OpKind.Immediate8;
upperStore.Immediate8 = 1;
upperStore.MemoryDisplacement64 = unchecked(instruction.MemoryDisplacement64 + 16);
// Use the address size for the displacement size that Iced requires.
upperStore.MemoryDisplSize = instruction.MemoryBase is >= Register.EAX and <= Register.R15D ||
instruction.MemoryIndex is >= Register.EAX and <= Register.R15D ? 4 : 8;
// Give the added instruction a separate address for the block encoder.
// Keep branch targets at the first store.
upperStore.IP = instruction.IP + 1;
splitInstructions.Add(upperStore);
}
return splitInstructions;
}
}

View File

@ -27,7 +27,8 @@ public sealed class SelfImage
string? version = null, string? version = null,
uint tlsModuleId = 0, uint tlsModuleId = 0,
ulong tlsMemorySize = 0, ulong tlsMemorySize = 0,
ulong tlsStaticOffset = 0) ulong tlsStaticOffset = 0,
IReadOnlyList<string>? importedModuleNames = null)
{ {
ArgumentNullException.ThrowIfNull(programHeaders); ArgumentNullException.ThrowIfNull(programHeaders);
ArgumentNullException.ThrowIfNull(mappedRegions); ArgumentNullException.ThrowIfNull(mappedRegions);
@ -50,6 +51,7 @@ public sealed class SelfImage
TlsModuleId = tlsModuleId; TlsModuleId = tlsModuleId;
TlsMemorySize = tlsMemorySize; TlsMemorySize = tlsMemorySize;
TlsStaticOffset = tlsStaticOffset; TlsStaticOffset = tlsStaticOffset;
ImportedModuleNames = importedModuleNames ?? Array.Empty<string>();
} }
public bool IsSelf { get; } public bool IsSelf { get; }
@ -88,4 +90,6 @@ public sealed class SelfImage
/// <summary>Variant II distance from the thread pointer to this module's static TLS base.</summary> /// <summary>Variant II distance from the thread pointer to this module's static TLS base.</summary>
public ulong TlsStaticOffset { get; } public ulong TlsStaticOffset { get; }
public IReadOnlyList<string> ImportedModuleNames { get; }
} }

View File

@ -56,6 +56,8 @@ public sealed class SelfLoader : ISelfLoader
private const long DtSceStrSize = 0x61000037; private const long DtSceStrSize = 0x61000037;
private const long DtSceSymTab = 0x61000039; private const long DtSceSymTab = 0x61000039;
private const long DtSceSymTabSize = 0x6100003F; private const long DtSceSymTabSize = 0x6100003F;
private const long DtSceNeededModule = 0x6100000F;
private const long DtSceNeededModuleNext = 0x61000045;
private const uint RelocationTypeNone = 0; private const uint RelocationTypeNone = 0;
private const uint RelocationTypeAbsolute64 = 1; private const uint RelocationTypeAbsolute64 = 1;
@ -169,6 +171,7 @@ public sealed class SelfLoader : ISelfLoader
if (clearVirtualMemory) if (clearVirtualMemory)
{ {
SharpEmu.Libs.Kernel.KernelMemoryCompatExports.ResetBackingMappings(virtualMemory as IGuestBackedSpace);
virtualMemory.Clear(); virtualMemory.Clear();
_nextTlsModuleId = 1; _nextTlsModuleId = 1;
GuestTlsTemplate.Reset(); GuestTlsTemplate.Reset();
@ -259,7 +262,14 @@ public sealed class SelfLoader : ISelfLoader
imageBase, imageBase,
_moduleManager, _moduleManager,
tlsModuleId, tlsModuleId,
out var importedRelocations); out var importedRelocations,
out var importedModuleNames);
if (tlsModuleId != 0)
{
// Thread copies must include pointers written by relocation.
GuestTlsTemplate.UpdateInitializationImage(
tlsModuleId, ReadTlsInitializationImage(processTlsHeader, virtualMemory, imageBase));
}
var effectiveImportStubs = importStubs.Count == 0 var effectiveImportStubs = importStubs.Count == 0
? new Dictionary<ulong, string>() ? new Dictionary<ulong, string>()
: new Dictionary<ulong, string>(importStubs); : new Dictionary<ulong, string>(importStubs);
@ -290,6 +300,16 @@ public sealed class SelfLoader : ISelfLoader
out var initializerFunctions); out var initializerFunctions);
var procParamAddress = ResolveProcParamAddress(programHeaders, imageBase); var procParamAddress = ResolveProcParamAddress(programHeaders, imageBase);
if (virtualMemory is PhysicalVirtualMemory patchableMemory)
{
_ = GuestRedZonePatcher.Patch(
virtualMemory,
patchableMemory,
programHeaders,
imageBase,
totalImageSize);
}
Console.WriteLine($"[LOADER] ELF e_entry: 0x{elfHeader.EntryPoint:X16}"); Console.WriteLine($"[LOADER] ELF e_entry: 0x{elfHeader.EntryPoint:X16}");
Console.WriteLine($"[LOADER] Generation: {(isNextGen ? "Gen5 (PS5)" : "Gen4 (PS4)")}"); Console.WriteLine($"[LOADER] Generation: {(isNextGen ? "Gen5 (PS5)" : "Gen4 (PS4)")}");
Console.WriteLine($"[LOADER] Using image base: 0x{imageBase:X16}"); Console.WriteLine($"[LOADER] Using image base: 0x{imageBase:X16}");
@ -331,7 +351,8 @@ public sealed class SelfLoader : ISelfLoader
applicationInfo.Version, applicationInfo.Version,
tlsModuleId, tlsModuleId,
tlsInfo.MemorySize, tlsInfo.MemorySize,
tlsInfo.StaticOffset); tlsInfo.StaticOffset,
importedModuleNames);
} }
private static (string? Title, string? TitleId, string? Version) TryLoadParamJson( private static (string? Title, string? TitleId, string? Version) TryLoadParamJson(
@ -539,18 +560,7 @@ public sealed class SelfLoader : ISelfLoader
return default; return default;
} }
// tdata (initialized) bytes come from the mapped segment; tbss is the var initImage = ReadTlsInitializationImage(tlsHeader, virtualMemory, imageBase);
// implicitly-zero remainder up to MemorySize.
var fileSize = (int)Math.Min(tlsHeader.FileSize, tlsHeader.MemorySize);
var initImage = fileSize > 0 ? new byte[fileSize] : [];
if (fileSize > 0 &&
!virtualMemory.TryRead(imageBase + tlsHeader.VirtualAddress, initImage))
{
Console.Error.WriteLine(
$"[LOADER][TLS] Failed to read TLS init image at 0x{imageBase + tlsHeader.VirtualAddress:X}; seeding zeros.");
initImage = [];
}
var staticOffset = GuestTlsTemplate.RegisterModule( var staticOffset = GuestTlsTemplate.RegisterModule(
tlsModuleId, tlsModuleId,
initImage, initImage,
@ -564,6 +574,19 @@ public sealed class SelfLoader : ISelfLoader
return new ModuleTlsInfo(tlsHeader.MemorySize, staticOffset); return new ModuleTlsInfo(tlsHeader.MemorySize, staticOffset);
} }
private static byte[] ReadTlsInitializationImage(
ProgramHeader header, IVirtualMemory virtualMemory, ulong imageBase)
{
if (header.FileSize > header.MemorySize || header.FileSize > int.MaxValue)
throw new InvalidDataException("PT_TLS initialization size is invalid.");
var initializationImage = new byte[(int)header.FileSize];
var address = checked(imageBase + header.VirtualAddress);
if (initializationImage.Length != 0 && !virtualMemory.TryRead(address, initializationImage))
throw new InvalidDataException($"Cannot read TLS initialization bytes at 0x{address:X}.");
return initializationImage;
}
private static IReadOnlyDictionary<ulong, string> ResolveAndPatchImportStubs( private static IReadOnlyDictionary<ulong, string> ResolveAndPatchImportStubs(
ReadOnlySpan<byte> imageData, ReadOnlySpan<byte> imageData,
LoadContext loadContext, LoadContext loadContext,
@ -573,9 +596,11 @@ public sealed class SelfLoader : ISelfLoader
ulong imageBase, ulong imageBase,
IModuleManager? moduleManager, IModuleManager? moduleManager,
uint tlsModuleId, uint tlsModuleId,
out IReadOnlyList<ImportedSymbolRelocation> importedRelocations) out IReadOnlyList<ImportedSymbolRelocation> importedRelocations,
out IReadOnlyList<string> importedModuleNames)
{ {
importedRelocations = Array.Empty<ImportedSymbolRelocation>(); importedRelocations = Array.Empty<ImportedSymbolRelocation>();
importedModuleNames = Array.Empty<string>();
if (!TryGetProgramHeader(programHeaders, ProgramHeaderType.Dynamic, out var dynamicHeader, out var dynamicHeaderIndex)) if (!TryGetProgramHeader(programHeaders, ProgramHeaderType.Dynamic, out var dynamicHeader, out var dynamicHeaderIndex))
{ {
return EmptyImportStubs; return EmptyImportStubs;
@ -666,15 +691,21 @@ public sealed class SelfLoader : ISelfLoader
byte[] stringTable = Array.Empty<byte>(); byte[] stringTable = Array.Empty<byte>();
byte[] symbolTable = Array.Empty<byte>(); byte[] symbolTable = Array.Empty<byte>();
if (dynamicInfo.StrTabOffset != 0 && dynamicInfo.StrTabSize != 0 &&
!TryLoadTableBytes(
elfData,
virtualMemory,
imageBase,
dynamicInfo.StrTabOffset,
dynamicInfo.StrTabSize,
out stringTable))
{
return EmptyImportStubs;
}
if (maxSymbolIndex != 0) if (maxSymbolIndex != 0)
{ {
if (!TryLoadTableBytes( if (stringTable.Length == 0)
elfData,
virtualMemory,
imageBase,
dynamicInfo.StrTabOffset,
dynamicInfo.StrTabSize,
out stringTable))
{ {
return EmptyImportStubs; return EmptyImportStubs;
} }
@ -694,6 +725,8 @@ public sealed class SelfLoader : ISelfLoader
} }
} }
importedModuleNames = ReadImportedModuleNames(dynamicTable, stringTable);
var descriptors = new List<RelocationDescriptor>(256); var descriptors = new List<RelocationDescriptor>(256);
var orderedImportNids = new List<string>(128); var orderedImportNids = new List<string>(128);
var seenImportNids = new HashSet<string>(StringComparer.Ordinal); var seenImportNids = new HashSet<string>(StringComparer.Ordinal);
@ -1985,6 +2018,39 @@ public sealed class SelfLoader : ISelfLoader
preInitArraySize); preInitArraySize);
} }
private static IReadOnlyList<string> ReadImportedModuleNames(
ReadOnlySpan<byte> dynamicTable,
ReadOnlySpan<byte> stringTable)
{
if (stringTable.IsEmpty)
{
return Array.Empty<string>();
}
var names = new List<string>();
for (var offset = 0; offset + DynamicEntrySize <= dynamicTable.Length; offset += DynamicEntrySize)
{
var tag = BinaryPrimitives.ReadInt64LittleEndian(dynamicTable.Slice(offset, sizeof(long)));
var value = BinaryPrimitives.ReadUInt64LittleEndian(dynamicTable.Slice(offset + sizeof(long), sizeof(ulong)));
if (tag == DtNull)
{
break;
}
if (tag is not (DtSceNeededModule or DtSceNeededModuleNext) ||
!TryReadNullTerminatedAscii(stringTable, (uint)value, out var name) ||
string.IsNullOrWhiteSpace(name) ||
names.Contains(name, StringComparer.OrdinalIgnoreCase))
{
continue;
}
names.Add(name);
}
return names.Count == 0 ? Array.Empty<string>() : names;
}
private static bool IsSupportedRelocationType(uint relocationType) private static bool IsSupportedRelocationType(uint relocationType)
{ {
return relocationType is return relocationType is

View File

@ -0,0 +1,405 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.Runtime.Intrinsics.X86;
using Iced.Intel;
using static Iced.Intel.AssemblerRegisters;
namespace SharpEmu.Core.Loader;
// Rewrite SHA extension instructions into general-register code when the host CPU lacks them.
// Rosetta 2 and some x86 hosts raise #UD for them, and a signal per instruction is far too slow
// for titles that hash whole files. The expansion keeps every register except the destination
// XMM register and keeps the flags. It runs inside the trampoline, after the red zone is skipped.
internal static class ShaInstructionRewrite
{
// pushfq plus the saved general registers.
private const int SavedBytes = 8 * 13;
// Scratch layout: source 1 (and result), source 2, XMM0 (SHA256RNDS2 round inputs).
private const int Source1 = 0;
private const int Source2 = 16;
private const int Xmm0Copy = 32;
private const int ScratchBytes = 48;
private static readonly Register[] SavedRegisters =
{
Register.RAX, Register.RCX, Register.RDX, Register.RBX, Register.RSI, Register.RDI,
Register.R8, Register.R9, Register.R10, Register.R11, Register.R12, Register.R13,
};
internal static bool IsRequired { get; } = HostLacksSha() &&
!string.Equals(Environment.GetEnvironmentVariable("SHARPEMU_DISABLE_SHA_REWRITE"), "1", StringComparison.Ordinal);
// Bytes the expansion of one instruction needs at most in the trampoline.
internal const int MaximumExpansionBytes = 1024;
private static bool HostLacksSha()
{
if (!X86Base.IsSupported)
{
return false;
}
var (_, ebx, _, _) = X86Base.CpuId(7, 0);
return (ebx & (1 << 29)) == 0;
}
internal static bool IsShaInstruction(in Instruction instruction) => instruction.Mnemonic is
Mnemonic.Sha1rnds4 or Mnemonic.Sha1nexte or Mnemonic.Sha1msg1 or Mnemonic.Sha1msg2 or
Mnemonic.Sha256rnds2 or Mnemonic.Sha256msg1 or Mnemonic.Sha256msg2;
// A memory source with a segment prefix or an RIP-relative address cannot be rebuilt here.
internal static bool CanRewrite(in Instruction instruction)
{
if (!IsShaInstruction(instruction) || instruction.Op0Kind != OpKind.Register)
{
return false;
}
return instruction.Op1Kind == OpKind.Register ||
(instruction.Op1Kind == OpKind.Memory &&
instruction.SegmentPrefix == Register.None &&
!instruction.IsIPRelativeMemoryOperand);
}
internal static IList<Instruction> Expand(IList<Instruction> instructions)
{
var expanded = new List<Instruction>(instructions.Count);
foreach (var instruction in instructions)
{
if (!CanRewrite(instruction))
{
expanded.Add(instruction);
continue;
}
var assembler = new Assembler(64);
EmitExpansion(assembler, instruction);
var first = true;
ulong generatedIp = 0xFFFF_0000_0000_0000UL + ((instruction.IP & 0xFFFF_FFFF) << 12);
foreach (var generated in assembler.Instructions)
{
var copy = generated;
// Keep branch targets at the first generated instruction.
copy.IP = first ? instruction.IP : generatedIp++;
first = false;
expanded.Add(copy);
}
}
return expanded;
}
internal static void EmitExpansion(Assembler a, in Instruction instruction)
{
var destination = ToXmm(instruction.Op0Register);
a.pushfq();
foreach (var register in SavedRegisters)
{
a.push(ToGpr64(register));
}
a.sub(rsp, ScratchBytes);
if (instruction.Op1Kind == OpKind.Memory)
{
// LEA reads the guest registers before any of them change.
a.lea(rax, RebaseMemory(instruction));
a.mov(rcx, __qword_ptr[rax]);
a.mov(__qword_ptr[rsp + Source2], rcx);
a.mov(rcx, __qword_ptr[rax + 8]);
a.mov(__qword_ptr[rsp + Source2 + 8], rcx);
}
else
{
a.movdqu(__xmmword_ptr[rsp + Source2], ToXmm(instruction.Op1Register));
}
a.movdqu(__xmmword_ptr[rsp + Source1], destination);
if (instruction.Mnemonic == Mnemonic.Sha256rnds2)
{
a.movdqu(__xmmword_ptr[rsp + Xmm0Copy], xmm0);
}
switch (instruction.Mnemonic)
{
case Mnemonic.Sha1rnds4: EmitSha1Rnds4(a, instruction.Immediate8 & 3); break;
case Mnemonic.Sha1nexte: EmitSha1Nexte(a); break;
case Mnemonic.Sha1msg1: EmitSha1Msg1(a); break;
case Mnemonic.Sha1msg2: EmitSha1Msg2(a); break;
case Mnemonic.Sha256rnds2: EmitSha256Rnds2(a); break;
case Mnemonic.Sha256msg1: EmitSha256Msg1(a); break;
default: EmitSha256Msg2(a); break;
}
a.movdqu(destination, __xmmword_ptr[rsp + Source1]);
a.add(rsp, ScratchBytes);
for (var index = SavedRegisters.Length - 1; index >= 0; index--)
{
a.pop(ToGpr64(SavedRegisters[index]));
}
a.popfq();
}
// The guest stack pointer is above the scratch area, the saved registers and the red zone.
private static AssemblerMemoryOperand RebaseMemory(in Instruction instruction)
{
var displacement = unchecked((long)instruction.MemoryDisplacement64);
if (instruction.MemoryBase == Register.RSP)
{
displacement += ScratchBytes + SavedBytes + 128;
}
var baseRegister = instruction.MemoryBase == Register.None ? default : ToGpr64(instruction.MemoryBase);
var memory = instruction.MemoryBase == Register.None ? __[displacement] : __[baseRegister + displacement];
if (instruction.MemoryIndex != Register.None)
{
memory = instruction.MemoryBase == Register.None
? __[ToGpr64(instruction.MemoryIndex) * instruction.MemoryIndexScale + displacement]
: __[baseRegister + ToGpr64(instruction.MemoryIndex) * instruction.MemoryIndexScale + displacement];
}
return memory;
}
private static AssemblerMemoryOperand Dword(int slot, int index) => __dword_ptr[rsp + slot + 4 * index];
private static void EmitSha1Rnds4(Assembler a, int function)
{
var k = function switch
{
0 => 0x5A827999,
1 => 0x6ED9EBA1,
2 => unchecked((int)0x8F1BBCDC),
_ => unchecked((int)0xCA62C1D6),
};
a.mov(eax, Dword(Source1, 3));
a.mov(ebx, Dword(Source1, 2));
a.mov(ecx, Dword(Source1, 1));
a.mov(edx, Dword(Source1, 0));
a.xor(esi, esi);
for (var round = 0; round < 4; round++)
{
switch (function)
{
case 0:
// (b & c) ^ (~b & d) == d ^ (b & (c ^ d))
a.mov(edi, ecx);
a.xor(edi, edx);
a.and(edi, ebx);
a.xor(edi, edx);
break;
case 2:
// (b & c) | (d & (b | c)) is the majority of b, c and d.
a.mov(edi, ebx);
a.or(edi, ecx);
a.and(edi, edx);
a.mov(r8d, ebx);
a.and(r8d, ecx);
a.or(edi, r8d);
break;
default:
a.mov(edi, ebx);
a.xor(edi, ecx);
a.xor(edi, edx);
break;
}
a.add(edi, Dword(Source2, 3 - round));
a.add(edi, esi);
a.add(edi, k);
a.mov(r8d, eax);
a.rol(r8d, (byte)5);
a.add(edi, r8d);
a.mov(esi, edx);
a.mov(edx, ecx);
a.mov(ecx, ebx);
a.rol(ecx, (byte)30);
a.mov(ebx, eax);
a.mov(eax, edi);
}
a.mov(Dword(Source1, 3), eax);
a.mov(Dword(Source1, 2), ebx);
a.mov(Dword(Source1, 1), ecx);
a.mov(Dword(Source1, 0), edx);
}
private static void EmitSha1Nexte(Assembler a)
{
a.mov(eax, Dword(Source1, 3));
a.rol(eax, (byte)30);
a.add(eax, Dword(Source2, 3));
a.mov(Dword(Source1, 3), eax);
for (var index = 0; index < 3; index++)
{
a.mov(ecx, Dword(Source2, index));
a.mov(Dword(Source1, index), ecx);
}
}
private static void EmitSha1Msg1(Assembler a)
{
// w0..w3 from source 1 (w0 in dword 3), w4 and w5 from source 2.
a.mov(eax, Dword(Source1, 3));
a.mov(ebx, Dword(Source1, 2));
a.mov(ecx, Dword(Source1, 1));
a.mov(edx, Dword(Source1, 0));
a.mov(esi, Dword(Source2, 3));
a.mov(edi, Dword(Source2, 2));
a.xor(eax, ecx);
a.xor(ebx, edx);
a.xor(ecx, esi);
a.xor(edx, edi);
a.mov(Dword(Source1, 3), eax);
a.mov(Dword(Source1, 2), ebx);
a.mov(Dword(Source1, 1), ecx);
a.mov(Dword(Source1, 0), edx);
}
private static void EmitSha1Msg2(Assembler a)
{
a.mov(eax, Dword(Source1, 3));
a.xor(eax, Dword(Source2, 2));
a.rol(eax, (byte)1);
a.mov(ebx, Dword(Source1, 2));
a.xor(ebx, Dword(Source2, 1));
a.rol(ebx, (byte)1);
a.mov(ecx, Dword(Source1, 1));
a.xor(ecx, Dword(Source2, 0));
a.rol(ecx, (byte)1);
a.mov(edx, Dword(Source1, 0));
a.xor(edx, eax);
a.rol(edx, (byte)1);
a.mov(Dword(Source1, 3), eax);
a.mov(Dword(Source1, 2), ebx);
a.mov(Dword(Source1, 1), ecx);
a.mov(Dword(Source1, 0), edx);
}
private static void EmitSha256Rnds2(Assembler a)
{
// a..h in eax, ebx, ecx, edx, esi, edi, r8d, r9d.
a.mov(eax, Dword(Source2, 3));
a.mov(ebx, Dword(Source2, 2));
a.mov(ecx, Dword(Source1, 3));
a.mov(edx, Dword(Source1, 2));
a.mov(esi, Dword(Source2, 1));
a.mov(edi, Dword(Source2, 0));
a.mov(r8d, Dword(Source1, 1));
a.mov(r9d, Dword(Source1, 0));
for (var round = 0; round < 2; round++)
{
// r10d = h + Sigma1(e) + Ch(e, f, g) + wk
EmitRotateXor(a, r10d, esi, r11d, 6, 11, 25);
a.add(r10d, r9d);
a.add(r10d, Dword(Xmm0Copy, round));
a.mov(r11d, edi);
a.xor(r11d, r8d);
a.and(r11d, esi);
a.xor(r11d, r8d);
a.add(r10d, r11d);
// r11d = Sigma0(a) + Maj(a, b, c)
EmitRotateXor(a, r11d, eax, r12d, 2, 13, 22);
a.mov(r12d, eax);
a.or(r12d, ebx);
a.and(r12d, ecx);
a.mov(r13d, eax);
a.and(r13d, ebx);
a.or(r12d, r13d);
a.add(r11d, r12d);
a.mov(r9d, r8d);
a.mov(r8d, edi);
a.mov(edi, esi);
a.mov(esi, edx);
a.add(esi, r10d);
a.mov(edx, ecx);
a.mov(ecx, ebx);
a.mov(ebx, eax);
a.mov(eax, r10d);
a.add(eax, r11d);
}
a.mov(Dword(Source1, 3), eax);
a.mov(Dword(Source1, 2), ebx);
a.mov(Dword(Source1, 1), esi);
a.mov(Dword(Source1, 0), edi);
}
private static void EmitSha256Msg1(Assembler a)
{
// w0..w3 in edx, ecx, ebx, eax; w4 in esi. Results go to r9d..r12d.
a.mov(eax, Dword(Source1, 3));
a.mov(ebx, Dword(Source1, 2));
a.mov(ecx, Dword(Source1, 1));
a.mov(edx, Dword(Source1, 0));
a.mov(esi, Dword(Source2, 0));
EmitSmallSigma(a, r9d, esi, r8d, 7, 18, 3);
a.add(r9d, eax);
EmitSmallSigma(a, r10d, eax, r8d, 7, 18, 3);
a.add(r10d, ebx);
EmitSmallSigma(a, r11d, ebx, r8d, 7, 18, 3);
a.add(r11d, ecx);
EmitSmallSigma(a, r12d, ecx, r8d, 7, 18, 3);
a.add(r12d, edx);
a.mov(Dword(Source1, 3), r9d);
a.mov(Dword(Source1, 2), r10d);
a.mov(Dword(Source1, 1), r11d);
a.mov(Dword(Source1, 0), r12d);
}
private static void EmitSha256Msg2(Assembler a)
{
// w16 = s1[0] + sigma1(w14); w17 = s1[1] + sigma1(w15); w18 and w19 use w16 and w17.
a.mov(esi, Dword(Source2, 2));
EmitSmallSigma(a, eax, esi, r8d, 17, 19, 10);
a.add(eax, Dword(Source1, 0));
a.mov(esi, Dword(Source2, 3));
EmitSmallSigma(a, ebx, esi, r8d, 17, 19, 10);
a.add(ebx, Dword(Source1, 1));
EmitSmallSigma(a, ecx, eax, r8d, 17, 19, 10);
a.add(ecx, Dword(Source1, 2));
EmitSmallSigma(a, edx, ebx, r8d, 17, 19, 10);
a.add(edx, Dword(Source1, 3));
a.mov(Dword(Source1, 0), eax);
a.mov(Dword(Source1, 1), ebx);
a.mov(Dword(Source1, 2), ecx);
a.mov(Dword(Source1, 3), edx);
}
// result = ror(x, r1) ^ ror(x, r2) ^ ror(x, r3)
private static void EmitRotateXor(
Assembler a, AssemblerRegister32 result, AssemblerRegister32 x, AssemblerRegister32 temp, int r1, int r2, int r3)
{
a.mov(result, x);
a.ror(result, (byte)r1);
a.mov(temp, x);
a.ror(temp, (byte)r2);
a.xor(result, temp);
a.mov(temp, x);
a.ror(temp, (byte)r3);
a.xor(result, temp);
}
// result = ror(x, r1) ^ ror(x, r2) ^ (x >> shift)
private static void EmitSmallSigma(
Assembler a, AssemblerRegister32 result, AssemblerRegister32 x, AssemblerRegister32 temp, int r1, int r2, int shift)
{
a.mov(result, x);
a.ror(result, (byte)r1);
a.mov(temp, x);
a.ror(temp, (byte)r2);
a.xor(result, temp);
a.mov(temp, x);
a.shr(temp, (byte)shift);
a.xor(result, temp);
}
private static AssemblerRegisterXMM ToXmm(Register register) => new(register);
private static AssemblerRegister64 ToGpr64(Register register) => new(register.GetFullRegister());
}

View File

@ -10,6 +10,8 @@ public interface IVirtualMemory : ICpuMemory
{ {
void Clear(); void Clear();
bool IsBackedView(ulong address);
void Map(ulong virtualAddress, ulong memorySize, ulong fileOffset, ReadOnlySpan<byte> fileData, ProgramHeaderFlags protection); void Map(ulong virtualAddress, ulong memorySize, ulong fileOffset, ReadOnlySpan<byte> fileData, ProgramHeaderFlags protection);
IReadOnlyList<VirtualMemoryRegion> SnapshotRegions(); IReadOnlyList<VirtualMemoryRegion> SnapshotRegions();

File diff suppressed because it is too large Load Diff

View File

@ -11,6 +11,8 @@ public sealed class VirtualMemory : IVirtualMemory
private readonly object _gate = new(); private readonly object _gate = new();
private readonly List<MappedRegion> _regions = new(); private readonly List<MappedRegion> _regions = new();
public bool IsBackedView(ulong address) => false;
public void Clear() public void Clear()
{ {
lock (_gate) lock (_gate)

View File

@ -7,12 +7,16 @@ using SharpEmu.Core.Cpu.Disasm;
using SharpEmu.Core.Loader; using SharpEmu.Core.Loader;
using SharpEmu.Core.Memory; using SharpEmu.Core.Memory;
using SharpEmu.HLE; using SharpEmu.HLE;
using SharpEmu.HLE.Host;
using SharpEmu.HLE.GpuMemory;
using SharpEmu.Libs.VideoOut; using SharpEmu.Libs.VideoOut;
using SharpEmu.Libs.Kernel; using SharpEmu.Libs.Kernel;
using SharpEmu.Libs.AppContent; using SharpEmu.Libs.AppContent;
using SharpEmu.Libs.SaveData; using SharpEmu.Libs.SaveData;
using SharpEmu.Libs.Fiber; using SharpEmu.Libs.Fiber;
using SharpEmu.Libs.SystemService; using SharpEmu.Libs.SystemService;
using SharpEmu.Libs.Network;
using SharpEmu.Libs.Np;
using System.Buffers.Binary; using System.Buffers.Binary;
using System.Collections.Generic; using System.Collections.Generic;
using System.Linq; using System.Linq;
@ -37,6 +41,9 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
private readonly ISymbolCatalog _symbolCatalog; private readonly ISymbolCatalog _symbolCatalog;
private readonly CpuExecutionOptions _cpuExecutionOptions; private readonly CpuExecutionOptions _cpuExecutionOptions;
private readonly IFileSystem _fileSystem; private readonly IFileSystem _fileSystem;
private readonly GuestGpuMemory? _gpuMemory;
private readonly int _systemLanguage;
private readonly object _dynamicModuleGate = new();
private bool _disposed; private bool _disposed;
public string? LastExecutionDiagnostics { get; private set; } public string? LastExecutionDiagnostics { get; private set; }
@ -56,8 +63,11 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
IModuleManager moduleManager, IModuleManager moduleManager,
ISymbolCatalog? symbolCatalog = null, ISymbolCatalog? symbolCatalog = null,
CpuExecutionOptions cpuExecutionOptions = default, CpuExecutionOptions cpuExecutionOptions = default,
IFileSystem? fileSystem = null) IFileSystem? fileSystem = null,
GuestGpuMemory? gpuMemory = null,
int systemLanguage = 1)
{ {
_gpuMemory = gpuMemory;
_selfLoader = selfLoader ?? throw new ArgumentNullException(nameof(selfLoader)); _selfLoader = selfLoader ?? throw new ArgumentNullException(nameof(selfLoader));
_virtualMemory = virtualMemory ?? throw new ArgumentNullException(nameof(virtualMemory)); _virtualMemory = virtualMemory ?? throw new ArgumentNullException(nameof(virtualMemory));
_cpuDispatcher = cpuDispatcher ?? throw new ArgumentNullException(nameof(cpuDispatcher)); _cpuDispatcher = cpuDispatcher ?? throw new ArgumentNullException(nameof(cpuDispatcher));
@ -71,6 +81,7 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
DebugHook = cpuExecutionOptions.DebugHook, DebugHook = cpuExecutionOptions.DebugHook,
}; };
_fileSystem = fileSystem ?? new PhysicalFileSystem(); _fileSystem = fileSystem ?? new PhysicalFileSystem();
_systemLanguage = systemLanguage;
} }
public static ISharpEmuRuntime CreateDefault(SharpEmuRuntimeOptions options = default) public static ISharpEmuRuntime CreateDefault(SharpEmuRuntimeOptions options = default)
@ -82,13 +93,17 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
ImportTraceLimit = Math.Max(0, options.ImportTraceLimit), ImportTraceLimit = Math.Max(0, options.ImportTraceLimit),
DebugHook = options.DebugHook, DebugHook = options.DebugHook,
}; };
var virtualMemory = new PhysicalVirtualMemory(
viewHost: HostViewMemory.Create(),
preReserveGuestAddressSpace: true);
var moduleManager = new ModuleManager(); var moduleManager = new ModuleManager();
// The compile-time generated registry (SharpEmu.SourceGenerators) is the sole // The compile-time generated registry (SharpEmu.SourceGenerators) is the sole
// registration source; content tests in SharpEmu.Libs.Tests pin its invariants. // registration source; content tests in SharpEmu.Libs.Tests pin its invariants.
moduleManager.RegisterExports(SharpEmu.Generated.SysAbiExportRegistry.CreateExports(Generation.Gen4 | Generation.Gen5)); moduleManager.RegisterExports(SharpEmu.Generated.SysAbiExportRegistry.CreateExports(Generation.Gen4 | Generation.Gen5));
moduleManager.Freeze(); moduleManager.Freeze();
var virtualMemory = new PhysicalVirtualMemory(); var gpuMemory = new GuestGpuMemory(virtualMemory);
GuestGpuMemoryHook.Attach(gpuMemory);
var fileSystem = new PhysicalFileSystem(); var fileSystem = new PhysicalFileSystem();
@ -99,7 +114,9 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
moduleManager, moduleManager,
Aerolib.Instance, Aerolib.Instance,
cpuExecutionOptions, cpuExecutionOptions,
fileSystem); fileSystem,
gpuMemory,
options.SystemLanguage ?? 1);
} }
public SelfImage LoadImage(string ebootPath) public SelfImage LoadImage(string ebootPath)
@ -140,12 +157,15 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
LastBasicBlockTrace = null; LastBasicBlockTrace = null;
LastMilestoneLog = null; LastMilestoneLog = null;
FiberExports.ResetRuntimeState(); FiberExports.ResetRuntimeState();
Http2Exports.ResetRuntimeState();
NpAuthExports.ResetRuntimeState();
NpUniversalDataSystemExports.ResetRuntimeState();
KernelModuleRegistry.Reset(); KernelModuleRegistry.Reset();
var image = LoadImage(normalizedEbootPath); var image = LoadImage(normalizedEbootPath);
VideoOutExports.ConfigureApplicationInfo(image.Title, image.TitleId, image.Version); VideoOutExports.ConfigureApplicationInfo(image.Title, image.TitleId, image.Version);
KernelMemoryCompatExports.ConfigureApplicationInfo(image.TitleId); KernelMemoryCompatExports.ConfigureApplicationInfo(image.TitleId);
SaveDataExports.ConfigureApplicationInfo(image.TitleId); SaveDataExports.ConfigureApplicationInfo(image.TitleId);
SystemServiceExports.ConfigureApplicationInfo(image.TitleId); SystemServiceExports.ConfigureApplicationInfo(image.TitleId, _systemLanguage);
_ = RegisterLoadedModule(normalizedEbootPath, image, isMain: true, isSystemModule: false); _ = RegisterLoadedModule(normalizedEbootPath, image, isMain: true, isSystemModule: false);
KernelRuntimeCompatExports.ConfigureProcessProcParamAddress(image.ProcParamAddress); KernelRuntimeCompatExports.ConfigureProcessProcParamAddress(image.ProcParamAddress);
Console.Error.WriteLine($"[RUNTIME] Entry: 0x{image.EntryPoint:X16}"); Console.Error.WriteLine($"[RUNTIME] Entry: 0x{image.EntryPoint:X16}");
@ -160,8 +180,16 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
HleDataSymbols.ConfigureProcessImageName(processImageName); HleDataSymbols.ConfigureProcessImageName(processImageName);
MergeKnownHleDataSymbols(activeRuntimeSymbols); MergeKnownHleDataSymbols(activeRuntimeSymbols);
var loadedModuleImages = LoadAdjacentSceModules(ebootPath, activeImportStubs, activeRuntimeSymbols); var loadedModuleImages = LoadAdjacentSceModules(ebootPath, image, activeImportStubs, activeRuntimeSymbols);
RebindImportedDataSymbols(image, loadedModuleImages, activeRuntimeSymbols); RebindImportedDataSymbols(image, loadedModuleImages, activeRuntimeSymbols);
var app0Root = Path.GetDirectoryName(normalizedEbootPath) ?? string.Empty;
KernelModuleRegistry.ConfigureModuleLoader(modulePath => LoadRequestedAppModule(
modulePath,
app0Root,
image,
loadedModuleImages,
activeImportStubs,
activeRuntimeSymbols));
var initializerResult = RunAllInitializers( var initializerResult = RunAllInitializers(
image, image,
loadedModuleImages, loadedModuleImages,
@ -627,6 +655,7 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
private List<LoadedModuleImage> LoadAdjacentSceModules( private List<LoadedModuleImage> LoadAdjacentSceModules(
string ebootPath, string ebootPath,
SelfImage mainImage,
IDictionary<ulong, string> importStubs, IDictionary<ulong, string> importStubs,
IDictionary<string, ulong> runtimeSymbols) IDictionary<string, ulong> runtimeSymbols)
{ {
@ -639,16 +668,20 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
var moduleDirectories = new[] var moduleDirectories = new[]
{ {
(Path: Path.Combine(ebootDirectory, "sce_module"), StartAtBoot: true), (Path: Path.Combine(ebootDirectory, "sce_module"), StartAtBoot: true, LinkedOnly: false, SearchOption: SearchOption.TopDirectoryOnly),
(Path: Path.Combine(ebootDirectory, "sce_modules"), StartAtBoot: true), (Path: Path.Combine(ebootDirectory, "sce_modules"), StartAtBoot: true, LinkedOnly: false, SearchOption: SearchOption.TopDirectoryOnly),
(Path: Path.Combine(ebootDirectory, "Media", "Modules"), StartAtBoot: true), (Path: Path.Combine(ebootDirectory, "Media", "Modules"), StartAtBoot: true, LinkedOnly: false, SearchOption: SearchOption.TopDirectoryOnly),
// A linked PRX can be beside eboot.bin. Load only the app-root modules
// named by the main image at boot, after the normal module directories
// they may depend on. Map the other app-root modules so
// sceKernelLoadStartModule can start them later.
(Path: ebootDirectory, StartAtBoot: true, LinkedOnly: true, SearchOption: SearchOption.TopDirectoryOnly),
(Path: ebootDirectory, StartAtBoot: false, LinkedOnly: false, SearchOption: SearchOption.TopDirectoryOnly),
// Unity native plugins are loaded later through sceKernelLoadStartModule. Map // Unity native plugins are loaded later through sceKernelLoadStartModule. Map
// them up front so the HLE loader can return a real module handle and dlsym // them up front so the HLE loader can return a real module handle and dlsym
// can resolve their exports, but defer DT_INIT until the guest requests them. // can resolve their exports, but defer DT_INIT until the guest requests them.
(Path: Path.Combine(ebootDirectory, "Media", "Plugins"), StartAtBoot: false), (Path: Path.Combine(ebootDirectory, "Media", "Plugins"), StartAtBoot: false, LinkedOnly: false, SearchOption: SearchOption.TopDirectoryOnly),
} }
.GroupBy(entry => entry.Path, StringComparer.OrdinalIgnoreCase)
.Select(group => group.First())
.Where(entry => Directory.Exists(entry.Path)) .Where(entry => Directory.Exists(entry.Path))
.ToArray(); .ToArray();
@ -659,8 +692,9 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
var allModulePaths = moduleDirectories var allModulePaths = moduleDirectories
.SelectMany(directory => Directory .SelectMany(directory => Directory
.EnumerateFiles(directory.Path) .EnumerateFiles(directory.Path, "*", directory.SearchOption)
.OrderBy(path => path, StringComparer.OrdinalIgnoreCase) .OrderBy(path => path, StringComparer.OrdinalIgnoreCase)
.Where(path => !directory.LinkedOnly || IsMainImageLinkedModule(path, mainImage.ImportedModuleNames))
.Select(path => (Path: path, directory.StartAtBoot))) .Select(path => (Path: path, directory.StartAtBoot)))
.Where(entry => .Where(entry =>
{ {
@ -747,6 +781,176 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
return loadedImages; return loadedImages;
} }
private KernelModuleRegistry.ModuleLoadResult LoadRequestedAppModule(
string guestModulePath,
string app0Root,
SelfImage mainImage,
List<LoadedModuleImage> loadedModuleImages,
Dictionary<ulong, string> activeImportStubs,
Dictionary<string, ulong> activeRuntimeSymbols)
{
lock (_dynamicModuleGate)
{
if (!TryResolveApp0ModulePath(app0Root, guestModulePath, out var modulePath))
{
Console.Error.WriteLine(
$"[RUNTIME] Runtime module path rejected: '{guestModulePath}'");
return KernelModuleRegistry.ModuleLoadResult.Failure(
(int)OrbisGen2Result.ORBIS_GEN2_ERROR_NOT_FOUND);
}
if (KernelModuleRegistry.TryFindByExactPath(modulePath, out var existingModule))
{
return KernelModuleRegistry.ModuleLoadResult.Success(existingModule.Handle);
}
try
{
var fileInfo = new FileInfo(modulePath);
if (!fileInfo.Exists || fileInfo.Length <= 0 || fileInfo.Length > int.MaxValue)
{
return KernelModuleRegistry.ModuleLoadResult.Failure(
(int)OrbisGen2Result.ORBIS_GEN2_ERROR_NOT_FOUND);
}
var moduleBytes = GC.AllocateUninitializedArray<byte>((int)fileInfo.Length);
using (var stream = File.OpenRead(modulePath))
{
stream.ReadExactly(moduleBytes);
}
var moduleImage = _selfLoader.LoadAdditional(
moduleBytes.AsSpan(),
_virtualMemory,
_moduleManager,
_fileSystem,
Path.GetDirectoryName(modulePath));
var candidateImportStubs = new Dictionary<ulong, string>(activeImportStubs);
var candidateRuntimeSymbols = new Dictionary<string, ulong>(activeRuntimeSymbols, StringComparer.Ordinal);
_ = MergeImportStubs(candidateImportStubs, moduleImage.ImportStubs, modulePath);
_ = MergeRuntimeSymbols(candidateRuntimeSymbols, moduleImage.RuntimeSymbols);
InstallNativePluginCompatibilityHooks(candidateImportStubs, moduleImage, modulePath);
string? installError = null;
if (_cpuDispatcher is not CpuDispatcher dispatcher ||
!dispatcher.TryInstallAdditionalModule(
candidateImportStubs,
candidateRuntimeSymbols,
out installError))
{
Console.Error.WriteLine(
$"[RUNTIME] Runtime module import installation failed: {modulePath} " +
$"({installError ?? "unsupported CPU backend"})");
return KernelModuleRegistry.ModuleLoadResult.Failure(
(int)OrbisGen2Result.ORBIS_GEN2_ERROR_NOT_IMPLEMENTED);
}
ReplaceDictionary(activeImportStubs, candidateImportStubs);
ReplaceDictionary(activeRuntimeSymbols, candidateRuntimeSymbols);
var handle = RegisterLoadedModule(
modulePath,
moduleImage,
isMain: false,
isSystemModule: false);
loadedModuleImages.Add(new LoadedModuleImage(modulePath, moduleImage, handle, StartAtBoot: false));
RebindImportedDataSymbols(mainImage, loadedModuleImages, activeRuntimeSymbols);
Console.Error.WriteLine(
$"[RUNTIME] Loaded requested module '{guestModulePath}' as {Path.GetFileName(modulePath)}: " +
$"handle={handle}, imports={moduleImage.ImportStubs.Count}, symbols={moduleImage.RuntimeSymbols.Count}");
return KernelModuleRegistry.ModuleLoadResult.Success(handle);
}
catch (Exception ex)
{
Console.Error.WriteLine(
$"[RUNTIME] Runtime module load failed: {modulePath} " +
$"({ex.GetType().Name}: {ex.Message})");
return KernelModuleRegistry.ModuleLoadResult.Failure(
(int)OrbisGen2Result.ORBIS_GEN2_ERROR_NOT_FOUND);
}
}
}
private static bool TryResolveApp0ModulePath(
string app0Root,
string guestModulePath,
out string modulePath)
{
modulePath = string.Empty;
if (string.IsNullOrWhiteSpace(app0Root) || string.IsNullOrWhiteSpace(guestModulePath))
{
return false;
}
var normalizedGuestPath = guestModulePath.Replace('\\', '/');
string relativePath;
if (normalizedGuestPath.StartsWith("/app0/", StringComparison.OrdinalIgnoreCase))
{
relativePath = normalizedGuestPath[6..];
}
else if (normalizedGuestPath.StartsWith("app0/", StringComparison.OrdinalIgnoreCase))
{
relativePath = normalizedGuestPath[5..];
}
else if (!normalizedGuestPath.StartsWith("/", StringComparison.Ordinal))
{
relativePath = normalizedGuestPath;
}
else
{
return false;
}
var root = Path.GetFullPath(app0Root);
var candidate = Path.GetFullPath(
Path.Combine(root, relativePath.Replace('/', Path.DirectorySeparatorChar)));
var rootPrefix = Path.TrimEndingDirectorySeparator(root) + Path.DirectorySeparatorChar;
if (!candidate.StartsWith(rootPrefix, HostPathComparison))
{
return false;
}
modulePath = candidate;
return true;
}
private static StringComparison HostPathComparison => OperatingSystem.IsWindows()
? StringComparison.OrdinalIgnoreCase
: StringComparison.Ordinal;
private static void ReplaceDictionary<TKey, TValue>(
IDictionary<TKey, TValue> destination,
IReadOnlyDictionary<TKey, TValue> source)
where TKey : notnull
{
destination.Clear();
foreach (var entry in source)
{
destination.Add(entry);
}
}
private static bool IsMainImageLinkedModule(string modulePath, IReadOnlyList<string> importedModuleNames)
{
var fileName = Path.GetFileName(modulePath);
var fileNameWithoutExtension = Path.GetFileNameWithoutExtension(modulePath);
if (string.IsNullOrWhiteSpace(fileName) || string.IsNullOrWhiteSpace(fileNameWithoutExtension))
{
return false;
}
for (var i = 0; i < importedModuleNames.Count; i++)
{
var importedName = importedModuleNames[i];
if (string.Equals(importedName, fileName, StringComparison.OrdinalIgnoreCase) ||
string.Equals(importedName, fileNameWithoutExtension, StringComparison.OrdinalIgnoreCase))
{
return true;
}
}
return false;
}
private static void InstallNativePluginCompatibilityHooks( private static void InstallNativePluginCompatibilityHooks(
IDictionary<ulong, string> importStubs, IDictionary<ulong, string> importStubs,
SelfImage moduleImage, SelfImage moduleImage,
@ -805,6 +1009,7 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
Environment.GetEnvironmentVariable("SHARPEMU_LOG_DATA_REBIND"), Environment.GetEnvironmentVariable("SHARPEMU_LOG_DATA_REBIND"),
"1", "1",
StringComparison.Ordinal); StringComparison.Ordinal);
Span<byte> relocationValueBytes = stackalloc byte[sizeof(ulong)];
for (var i = 0; i < image.ImportedRelocations.Count; i++) for (var i = 0; i < image.ImportedRelocations.Count; i++)
{ {
var relocation = image.ImportedRelocations[i]; var relocation = image.ImportedRelocations[i];
@ -831,8 +1036,19 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
{ {
if (logRebind) if (logRebind)
{ {
var readable = _virtualMemory.TryRead(relocation.TargetAddress, relocationValueBytes);
var currentValue = readable ? BinaryPrimitives.ReadUInt64LittleEndian(relocationValueBytes) : 0;
Console.Error.WriteLine( Console.Error.WriteLine(
$"[RUNTIME] Imported data write-failed: nid={relocation.Nid} target=0x{relocation.TargetAddress:X16} value=0x{reboundValue:X16}"); $"[RUNTIME] Imported data write-failed: nid={relocation.Nid} target=0x{relocation.TargetAddress:X16} value=0x{reboundValue:X16} readable={readable} current=0x{currentValue:X16}");
foreach (var region in _virtualMemory.SnapshotRegions())
{
if (relocation.TargetAddress >= region.VirtualAddress &&
relocation.TargetAddress - region.VirtualAddress < region.MemorySize)
{
Console.Error.WriteLine(
$"[RUNTIME] Imported data target-region: start=0x{region.VirtualAddress:X16} size=0x{region.MemorySize:X} protection={region.Protection}");
}
}
} }
unresolved++; unresolved++;
@ -1162,6 +1378,7 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
} }
_disposed = true; _disposed = true;
KernelModuleRegistry.ConfigureModuleLoader(null);
if (_cpuDispatcher is IDisposable disposableDispatcher) if (_cpuDispatcher is IDisposable disposableDispatcher)
{ {
@ -1178,6 +1395,17 @@ public sealed class SharpEmuRuntime : ISharpEmuRuntime
return; return;
} }
if (_gpuMemory != null)
{
if (GuestGpuMemoryHook.TryTakeShutdownSummary(out var gpuSummary))
{
Console.Error.WriteLine("[LOADER][INFO] " + gpuSummary);
}
GuestGpuMemoryHook.Attach(null);
_gpuMemory.Dispose();
}
KernelMemoryCompatExports.ResetBackingMappings(_virtualMemory as IGuestBackedSpace);
if (_virtualMemory is IDisposable disposableMemory) if (_virtualMemory is IDisposable disposableMemory)
{ {
disposableMemory.Dispose(); disposableMemory.Dispose();

View File

@ -10,6 +10,8 @@ public readonly struct SharpEmuRuntimeOptions
{ {
public CpuExecutionEngine CpuEngine { get; init; } public CpuExecutionEngine CpuEngine { get; init; }
public int? SystemLanguage { get; init; }
public bool StrictDynlibResolution { get; init; } public bool StrictDynlibResolution { get; init; }
public int ImportTraceLimit { get; init; } public int ImportTraceLimit { get; init; }

View File

@ -22,18 +22,22 @@ public sealed class ConsoleWindow : Window
private readonly ListBox _list; private readonly ListBox _list;
private readonly TextBox _searchBox; private readonly TextBox _searchBox;
private readonly CheckBox _autoScrollCheck; private readonly CheckBox _autoScrollCheck;
private readonly GuiSettings _settings;
private bool _placementRestored;
public ConsoleWindow( public ConsoleWindow(
AvaloniaList<LogLine> lines, AvaloniaList<LogLine> lines,
Action clear, Action clear,
bool autoScroll) bool autoScroll,
GuiSettings settings)
{ {
var loc = Localization.Instance; var loc = Localization.Instance;
_sourceLines = lines; _sourceLines = lines;
_settings = settings;
Title = loc.Get("Console.WindowTitle"); Title = loc.Get("Console.WindowTitle");
Width = 980; Width = settings.ConsoleWindowWidth;
Height = 620; Height = settings.ConsoleWindowHeight;
MinWidth = 520; MinWidth = 520;
MinHeight = 320; MinHeight = 320;
Background = new SolidColorBrush(Color.Parse("#0D1017")); Background = new SolidColorBrush(Color.Parse("#0D1017"));
@ -115,9 +119,66 @@ public sealed class ConsoleWindow : Window
lines.CollectionChanged += OnLinesChanged; lines.CollectionChanged += OnLinesChanged;
Closed += (_, _) => lines.CollectionChanged -= OnLinesChanged; Closed += (_, _) => lines.CollectionChanged -= OnLinesChanged;
Opened += (_, _) => RestorePlacement();
PositionChanged += (_, _) => RememberNormalBounds();
SizeChanged += (_, _) => RememberNormalBounds();
PropertyChanged += (_, change) =>
{
if (_placementRestored && change.Property == WindowStateProperty && WindowState != WindowState.Minimized)
_settings.ConsoleWindowMaximized = WindowState == WindowState.Maximized;
};
Closing += (_, _) =>
{
RememberNormalBounds();
if (WindowState != WindowState.Minimized)
_settings.ConsoleWindowMaximized = WindowState == WindowState.Maximized;
_settings.Save();
};
RefreshVisibleLines(); RefreshVisibleLines();
} }
private void RestorePlacement()
{
if (_settings.ConsoleWindowLeft is { } left && _settings.ConsoleWindowTop is { } top)
{
var savedPosition = new PixelPoint(left, top);
var screen = Screens.ScreenFromPoint(savedPosition) ?? Screens.ScreenFromWindow(Owner ?? this) ?? Screens.Primary;
if (screen is not null)
{
Width = Math.Min(Width, Math.Max(MinWidth, screen.WorkingArea.Width / screen.Scaling));
Height = Math.Min(Height, Math.Max(MinHeight, screen.WorkingArea.Height / screen.Scaling));
Position = ConstrainPosition(savedPosition, screen.WorkingArea, new Size(Width, Height), screen.Scaling);
}
}
_placementRestored = true;
RememberNormalBounds();
if (_settings.ConsoleWindowMaximized)
WindowState = WindowState.Maximized;
}
private void RememberNormalBounds()
{
if (!_placementRestored || !IsVisible || WindowState != WindowState.Normal)
return;
_settings.ConsoleWindowLeft = Position.X;
_settings.ConsoleWindowTop = Position.Y;
if (ClientSize.Width >= MinWidth && ClientSize.Height >= MinHeight)
{
_settings.ConsoleWindowWidth = ClientSize.Width;
_settings.ConsoleWindowHeight = ClientSize.Height;
}
}
internal static PixelPoint ConstrainPosition(PixelPoint position, PixelRect workingArea, Size size, double scaling)
{
var maximumLeft = workingArea.Right - (int)Math.Ceiling(size.Width * scaling);
var maximumTop = workingArea.Bottom - (int)Math.Ceiling(size.Height * scaling);
return new PixelPoint(
Math.Clamp(position.X, workingArea.X, Math.Max(workingArea.X, maximumLeft)),
Math.Clamp(position.Y, workingArea.Y, Math.Max(workingArea.Y, maximumTop)));
}
private void OnLinesChanged(object? sender, NotifyCollectionChangedEventArgs e) private void OnLinesChanged(object? sender, NotifyCollectionChangedEventArgs e)
{ {
RefreshVisibleLines(); RefreshVisibleLines();

View File

@ -0,0 +1,76 @@
<!--
Copyright (C) 2026 SharpEmu Emulator Project
SPDX-License-Identifier: GPL-2.0-or-later
-->
<Window xmlns="https://github.com/avaloniaui"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="clr-namespace:SharpEmu.GUI"
x:Class="SharpEmu.GUI.CustomEnvironmentDialog"
Width="620"
Height="520"
MinWidth="520"
MinHeight="430"
CanResize="True"
WindowStartupLocation="CenterOwner"
Background="{StaticResource BgBrush}"
Title="{Binding [Launch.CustomEnv.Title], Source={x:Static local:Localization.Instance}}">
<Grid Margin="24" RowDefinitions="Auto,Auto,Auto,*,Auto,Auto">
<TextBlock Grid.Row="0"
Text="{Binding [Launch.CustomEnv.Title], Source={x:Static local:Localization.Instance}}"
FontSize="24"
FontWeight="Bold" />
<TextBlock Grid.Row="1"
Margin="0,8,0,16"
Text="{Binding [Launch.CustomEnv.Desc], Source={x:Static local:Localization.Instance}}"
Foreground="{StaticResource MutedBrush}"
TextWrapping="Wrap" />
<Button x:Name="DocumentationButton"
Grid.Row="2"
Classes="ghost"
HorizontalAlignment="Left"
Margin="0,0,0,12"
Padding="0,4"
Content="{Binding [Launch.CustomEnv.Documentation], Source={x:Static local:Localization.Instance}}" />
<TextBox x:Name="EnvironmentTextBox"
Grid.Row="3"
AcceptsReturn="True"
TextWrapping="NoWrap"
FontFamily="Consolas,monospace"
FontSize="13"
VerticalContentAlignment="Top"
PlaceholderText="{Binding [Launch.CustomEnv.Placeholder], Source={x:Static local:Localization.Instance}}" />
<TextBlock x:Name="StatusText"
Grid.Row="4"
Margin="0,12,0,0"
Foreground="{StaticResource MutedBrush}"
TextWrapping="Wrap" />
<Grid Grid.Row="5"
Margin="0,18,0,0"
ColumnDefinitions="Auto,Auto,*,Auto,Auto">
<Button x:Name="SaveGameButton"
Grid.Column="0"
Classes="ghost"
Margin="0,0,8,0"
Content="{Binding [Launch.CustomEnv.SaveGame], Source={x:Static local:Localization.Instance}}" />
<Button x:Name="SaveGlobalButton"
Grid.Column="1"
Classes="ghost"
Content="{Binding [Launch.CustomEnv.SaveGlobal], Source={x:Static local:Localization.Instance}}" />
<Button x:Name="CancelButton"
Grid.Column="3"
Classes="ghost"
Margin="0,0,8,0"
Content="{Binding [Common.Cancel], Source={x:Static local:Localization.Instance}}" />
<Button x:Name="PlayButton"
Grid.Column="4"
Classes="accent"
Content="{Binding [Launch.CustomEnv.Play], Source={x:Static local:Localization.Instance}}" />
</Grid>
</Grid>
</Window>

View File

@ -0,0 +1,92 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using Avalonia.Controls;
using System.Diagnostics;
namespace SharpEmu.GUI;
public partial class CustomEnvironmentDialog : Window
{
private readonly string? _titleId;
public CustomEnvironmentDialog()
: this(null, [])
{
}
public CustomEnvironmentDialog(string? titleId, IEnumerable<string> initialEntries)
{
InitializeComponent();
_titleId = titleId;
EnvironmentTextBox.Text = string.Join(Environment.NewLine, initialEntries);
SaveGameButton.IsEnabled = !string.IsNullOrWhiteSpace(titleId);
SaveGameButton.Click += (_, _) => SaveForGame();
SaveGlobalButton.Click += (_, _) => SaveGlobally();
DocumentationButton.Click += (_, _) => OpenDocumentation();
CancelButton.Click += (_, _) => Close(null);
PlayButton.Click += (_, _) => Play();
}
public event Action<IReadOnlyList<string>>? SaveGlobalRequested;
public event Action<string, IReadOnlyList<string>>? SaveGameRequested;
private static void OpenDocumentation()
{
Process.Start(new ProcessStartInfo
{
FileName = ProjectLinks.DocumentUrl("docs/sharpemu-gui-undocumented-env-vars.md"),
UseShellExecute = true,
});
}
private bool TryGetEntries(out IReadOnlyList<string> entries)
{
if (!CustomEnvironmentVariables.TryParseLines(
EnvironmentTextBox.Text,
out var parsed,
out var invalidLine))
{
StatusText.Text = string.Format(
Localization.Instance.Get("Launch.CustomEnv.Invalid"),
invalidLine);
entries = [];
return false;
}
StatusText.Text = string.Empty;
entries = parsed;
return true;
}
private void SaveForGame()
{
if (string.IsNullOrWhiteSpace(_titleId) || !TryGetEntries(out var entries))
{
return;
}
SaveGameRequested?.Invoke(_titleId, entries);
StatusText.Text = Localization.Instance.Get("Launch.CustomEnv.SavedGame");
}
private void SaveGlobally()
{
if (!TryGetEntries(out var entries))
{
return;
}
SaveGlobalRequested?.Invoke(entries);
StatusText.Text = Localization.Instance.Get("Launch.CustomEnv.SavedGlobal");
}
private void Play()
{
if (TryGetEntries(out var entries))
{
Close(entries);
}
}
}

View File

@ -0,0 +1,70 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
namespace SharpEmu.GUI;
internal static class CustomEnvironmentVariables
{
public static bool TryParseLines(
string? text,
out IReadOnlyList<string> entries,
out string invalidLine)
{
var parsed = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
foreach (var rawLine in (text ?? string.Empty).Split(['\r', '\n'], StringSplitOptions.RemoveEmptyEntries))
{
var line = rawLine.Trim();
if (line.Length == 0 || line.StartsWith('#'))
{
continue;
}
if (!TryParseEntry(line, out var name, out var value))
{
entries = [];
invalidLine = line;
return false;
}
parsed[name] = value;
}
entries = parsed.Select(pair => $"{pair.Key}={pair.Value}").ToArray();
invalidLine = string.Empty;
return true;
}
public static IReadOnlyList<string> Merge(
params IEnumerable<string>?[] sources)
{
var merged = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
foreach (var source in sources)
{
if (source is null)
{
continue;
}
foreach (var entry in source)
{
if (TryParseEntry(entry, out var name, out var value))
{
merged[name] = value;
}
}
}
return merged.Select(pair => $"{pair.Key}={pair.Value}").ToArray();
}
public static bool TryParseEntry(string entry, out string name, out string value)
{
var separator = entry.IndexOf('=');
name = (separator >= 0 ? entry[..separator] : entry).Trim();
value = separator >= 0 ? entry[(separator + 1)..] : "1";
return name.Length != 0 &&
!name.Contains('\0') &&
!name.Contains('=');
}
}

View File

@ -0,0 +1,58 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
using System.Text.Json;
namespace SharpEmu.GUI;
internal sealed class GlobalCustomEnvironmentSettings
{
private static readonly JsonSerializerOptions SerializerOptions = new()
{
WriteIndented = true,
};
public List<string> EnvironmentVariables { get; set; } = new();
public static string FilePath =>
Path.Combine(AppContext.BaseDirectory, "user", "custom_envs.json");
public static IReadOnlyList<string> Load()
{
try
{
if (!File.Exists(FilePath))
{
return [];
}
var settings = JsonSerializer.Deserialize<GlobalCustomEnvironmentSettings>(
File.ReadAllText(FilePath),
SerializerOptions);
return Normalize(settings?.EnvironmentVariables);
}
catch (Exception)
{
return [];
}
}
public static void Save(IEnumerable<string> entries)
{
try
{
Directory.CreateDirectory(Path.GetDirectoryName(FilePath)!);
var settings = new GlobalCustomEnvironmentSettings
{
EnvironmentVariables = Normalize(entries).ToList(),
};
File.WriteAllText(FilePath, JsonSerializer.Serialize(settings, SerializerOptions));
}
catch (Exception)
{
}
}
private static IReadOnlyList<string> Normalize(IEnumerable<string>? entries) =>
CustomEnvironmentVariables.Merge(entries);
}

View File

@ -42,11 +42,22 @@ public sealed class GuiSettings
public string LibraryLayout { get; set; } = "Carousel"; public string LibraryLayout { get; set; } = "Carousel";
public double EmbeddedConsoleHeight { get; set; } = 240;
public double ConsoleWindowWidth { get; set; } = 980;
public double ConsoleWindowHeight { get; set; } = 620;
public int? ConsoleWindowLeft { get; set; }
public int? ConsoleWindowTop { get; set; }
public bool ConsoleWindowMaximized { get; set; }
public string? EmulatorPath { get; set; } public string? EmulatorPath { get; set; }
/// <summary>UI language, matching a file code under Languages/ (e.g. "en", "tr").</summary> /// <summary>UI language, matching a file code under Languages/ (e.g. "en", "tr").</summary>
public string Language { get; set; } = "en"; public string Language { get; set; } = "en";
public string ConsoleType { get; set; } = "PS5";
public string ConsoleLanguage { get; set; } = "EnglishUS";
/// <summary>Default text-entry profile exposed to games.</summary> /// <summary>Default text-entry profile exposed to games.</summary>
public string DefaultProfile { get; set; } = "Sharp"; public string DefaultProfile { get; set; } = "Sharp";
@ -69,8 +80,14 @@ public sealed class GuiSettings
public string HdrMode { get; set; } = "Auto"; public string HdrMode { get; set; } = "Auto";
public bool OverlayEnabled { get; set; } = true;
public string OverlayCorner { get; set; } = "TopRight";
public string OverlayMode { get; set; } = "TitleBar";
/// <summary>Names of SHARPEMU_* switches set to "1" in the emulator's environment at launch.</summary> /// <summary>Names of SHARPEMU_* switches set to "1" in the emulator's environment at launch.</summary>
public List<string> EnvironmentToggles { get; set; } = new(); public List<string> EnvironmentToggles { get; set; } = ["SHARPEMU_WRITABLE_APP0", "SHARPEMU_DISABLE_IMPORT_LOOP_GUARD"];
public string BinkPlaybackMode { get; set; } = "Guest";
/// <summary>Internal render resolution scale (1.0 = native, 0.5 = half).</summary> /// <summary>Internal render resolution scale (1.0 = native, 0.5 = half).</summary>
public double RenderResolutionScale { get; set; } = 1.0; public double RenderResolutionScale { get; set; } = 1.0;
@ -114,7 +131,7 @@ public sealed class GuiSettings
settings.GameFolders = FilterNullOrEmpty(settings.GameFolders); settings.GameFolders = FilterNullOrEmpty(settings.GameFolders);
settings.ExcludedGames = FilterNullOrEmpty(settings.ExcludedGames); settings.ExcludedGames = FilterNullOrEmpty(settings.ExcludedGames);
settings.EnvironmentToggles = FilterNullOrEmpty(settings.EnvironmentToggles); settings.EnvironmentToggles = FilterNullOrEmpty(settings.EnvironmentToggles ?? ["SHARPEMU_WRITABLE_APP0", "SHARPEMU_DISABLE_IMPORT_LOOP_GUARD"]);
settings.LogLevel ??= "Info"; settings.LogLevel ??= "Info";
settings.Language ??= "en"; settings.Language ??= "en";
var legacyProfile = settings.EnvironmentToggles var legacyProfile = settings.EnvironmentToggles
@ -130,17 +147,58 @@ public sealed class GuiSettings
settings.DefaultProfile = NormalizeDefaultProfile( settings.DefaultProfile = NormalizeDefaultProfile(
legacyProfile is { Length: 2 } ? legacyProfile[1] : settings.DefaultProfile); legacyProfile is { Length: 2 } ? legacyProfile[1] : settings.DefaultProfile);
settings.DiscordClientId ??= "1525606762248540221"; settings.DiscordClientId ??= "1525606762248540221";
if (settings.RenderResolutionScale <= 0 || settings.RenderResolutionScale > 2.0)
{
settings.RenderResolutionScale = 1.0;
}
settings.LibraryLayout = NormalizeChoice(settings.LibraryLayout, "Carousel", "Grid"); settings.LibraryLayout = NormalizeChoice(settings.LibraryLayout, "Carousel", "Grid");
settings.ConsoleType = NormalizeChoice(settings.ConsoleType, "PS5");
settings.ConsoleLanguage = NormalizeChoice(
settings.ConsoleLanguage,
"EnglishUS",
"Japanese",
"French",
"SpanishSpain",
"German",
"Italian",
"Dutch",
"PortuguesePortugal",
"Russian",
"Korean",
"ChineseTraditional",
"ChineseSimplified",
"Finnish",
"Swedish",
"Danish",
"Norwegian",
"Polish",
"PortugueseBrazil",
"EnglishUK",
"Turkish",
"SpanishLatinAmerica",
"Arabic",
"FrenchCanada",
"Czech",
"Hungarian",
"Greek",
"Romanian",
"Thai",
"Vietnamese",
"Indonesian",
"Ukrainian");
settings.WindowMode = NormalizeChoice(settings.WindowMode, "Windowed", "Borderless", "Exclusive"); settings.WindowMode = NormalizeChoice(settings.WindowMode, "Windowed", "Borderless", "Exclusive");
settings.Resolution = NormalizeResolution(settings.Resolution); settings.Resolution = NormalizeResolution(settings.Resolution);
settings.ScalingMode = NormalizeChoice(settings.ScalingMode, "Fit", "Cover", "Stretch", "Integer"); settings.ScalingMode = NormalizeChoice(settings.ScalingMode, "Fit", "Cover", "Stretch", "Integer");
settings.HdrMode = NormalizeChoice(settings.HdrMode, "Auto", "On", "Off"); settings.HdrMode = NormalizeChoice(settings.HdrMode, "Auto", "On", "Off");
settings.BinkPlaybackMode = NormalizeChoice(settings.BinkPlaybackMode, "Guest", "Host", "Skip");
settings.OverlayCorner = NormalizeChoice(settings.OverlayCorner, "TopRight", "TopLeft", "BottomRight", "BottomLeft");
settings.OverlayMode = NormalizeChoice(settings.OverlayMode, "TitleBar", "Full", "Minimal");
settings.DisplayIndex = Math.Max(0, settings.DisplayIndex); settings.DisplayIndex = Math.Max(0, settings.DisplayIndex);
settings.RefreshRate = Math.Clamp(settings.RefreshRate, 0, 1000); settings.RefreshRate = Math.Clamp(settings.RefreshRate, 0, 1000);
settings.EmbeddedConsoleHeight = NormalizeConsoleSize(settings.EmbeddedConsoleHeight, 240, 120);
settings.ConsoleWindowWidth = NormalizeConsoleSize(settings.ConsoleWindowWidth, 980, 520);
settings.ConsoleWindowHeight = NormalizeConsoleSize(settings.ConsoleWindowHeight, 620, 320);
if (!settings.ConsoleWindowLeft.HasValue || !settings.ConsoleWindowTop.HasValue)
{
settings.ConsoleWindowLeft = null;
settings.ConsoleWindowTop = null;
}
return settings; return settings;
} }
@ -160,6 +218,9 @@ public sealed class GuiSettings
choices.Prepend(fallback).FirstOrDefault( choices.Prepend(fallback).FirstOrDefault(
choice => string.Equals(choice, value, StringComparison.OrdinalIgnoreCase)) ?? fallback; choice => string.Equals(choice, value, StringComparison.OrdinalIgnoreCase)) ?? fallback;
private static double NormalizeConsoleSize(double value, double fallback, double minimum) =>
double.IsFinite(value) && value >= minimum ? Math.Min(value, 16384) : fallback;
private static string NormalizeResolution(string? value) private static string NormalizeResolution(string? value)
{ {
if (!HostDisplayOptions.TryParseResolution(value, out var width, out var height)) if (!HostDisplayOptions.TryParseResolution(value, out var width, out var height))

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "العربية", "_languageName": "العربية",
"Options.Env.StrictCompute.Desc": "التوقف عند رفض مظللات الحوسبة والرسم (افتراضي).\nأوقف الخيار لتخطي العمل المتأثر. قد تظهر صور مفقودة أو أخطاء أو توقفات. أعد تشغيل اللعبة بعد التغيير.",
"Options.Env.PerformanceProfile.Desc": "سجّل أزمنة الأداء ومعدل FPS من التشغيل التالي للعبة.\nقد يقلل هذا من الأداء.",
"Options.Env.PerformanceFrameTrace.Desc": "احتفظ بآخر 4,096 فاصل عرض واكتبها في السجل عند الإغلاق.\nيتطلب تسجيل الأداء. أغلق اللعبة بشكل طبيعي لحفظ التتبع.",
"Options.OverlayEnabled.Label": "عرض الأداء",
"Options.OverlayEnabled.Desc": "عرض إحصاءات الأداء. يبدّل F1 العرض لهذه الجلسة فقط. يبدأ العرض مخفيًا عند ضبط SHARPEMU_OVERLAY=0.",
"Options.OverlayMode.Label": "نمط العرض",
"Options.OverlayMode.Desc": "يعرض الكامل جميع العدادات. يعرض المختصر وشريط العنوان FPS واستخدام CPU وGPU والوقت المنقضي. يُقاس GPU لكل عملية في Windows؛ وإلا يظهر N/A.",
"Options.OverlayCorner.Label": "زاوية الشاشة",
"Options.OverlayCorner.Desc": "اختر الزاوية المحفوظة. يغيّر F2 الزاوية لهذه الجلسة فقط. لا ينقل إحصاءات شريط العنوان.",
"Options.OverlayMode.Full": "كامل",
"Options.OverlayMode.Minimal": "مختصر",
"Options.OverlayMode.TitleBar": "شريط العنوان (مختصر)",
"Options.OverlayCorner.TopLeft": "أعلى اليسار",
"Options.OverlayCorner.TopRight": "أعلى اليمين",
"Options.OverlayCorner.BottomRight": "أسفل اليمين",
"Options.OverlayCorner.BottomLeft": "أسفل اليسار",
"Page.Library": "المكتبة", "Page.Library": "المكتبة",
"Page.Options": "الخيارات", "Page.Options": "الخيارات",
@ -53,6 +69,8 @@
"Options.TraceImports.Label": "حد تتبع الاستيراد", "Options.TraceImports.Label": "حد تتبع الاستيراد",
"Options.TraceImports.Desc": "تتبع أول N استيراد لكل وحدة (0 = إيقاف).", "Options.TraceImports.Desc": "تتبع أول N استيراد لكل وحدة (0 = إيقاف).",
"Options.CrashDump.Label": "تفريغات الأعطال",
"Options.CrashDump.Desc": "احفظ تفريغات الأعطال بجانب سجل التشغيل (Windows x64 فقط). قد تكون التفريغات كبيرة وتحتوي على بيانات خاصة.",
"Options.LogToFile.Label": "التسجيل في ملف", "Options.LogToFile.Label": "التسجيل في ملف",
"Options.LogToFile.Desc": "نسخ مخرجات المحاكي إلى ملف سجل.", "Options.LogToFile.Desc": "نسخ مخرجات المحاكي إلى ملف سجل.",
@ -90,6 +108,17 @@
"Launch.Idle": "خامل", "Launch.Idle": "خامل",
"Launch.Console": "≡ نافذة السجلات", "Launch.Console": "≡ نافذة السجلات",
"Launch.Launch": "▶ تشغيل", "Launch.Launch": "▶ تشغيل",
"Launch.CustomEnv": "تشغيل بمتغيرات بيئة مخصصة",
"Launch.CustomEnv.Title": "تشغيل بمتغيرات بيئة مخصصة",
"Launch.CustomEnv.Desc": "أدخل متغير بيئة واحدًا في كل سطر بصيغة NAME=VALUE. القيم المخصصة تتجاوز إعدادات الواجهة وإعدادات اللعبة التي تحمل الاسم نفسه.",
"Launch.CustomEnv.Documentation": "عرض متغيرات البيئة غير الموثقة ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_EXAMPLE=1",
"Launch.CustomEnv.SaveGame": "حفظ للعبة",
"Launch.CustomEnv.SaveGlobal": "حفظ بشكل عام",
"Launch.CustomEnv.Play": "تشغيل",
"Launch.CustomEnv.Invalid": "متغير بيئة غير صالح: {0}",
"Launch.CustomEnv.SavedGame": "تم الحفظ لهذه اللعبة.",
"Launch.CustomEnv.SavedGlobal": "تم الحفظ بشكل عام.",
"Launch.Stop": "■ إيقاف", "Launch.Stop": "■ إيقاف",
"Launch.Running": "قيد التشغيل — {0}", "Launch.Running": "قيد التشغيل — {0}",
"Launch.Stopping": "جارٍ الإيقاف...", "Launch.Stopping": "جارٍ الإيقاف...",
@ -145,7 +174,10 @@
"Options.Env.LogDirectMemory.Desc": "تسجيل تخصيصات الذاكرة المباشرة وإخفاقاتها في وحدة التحكم.\nاستخدمه عندما تنهار لعبة أو تُغلق أثناء الإقلاع.", "Options.Env.LogDirectMemory.Desc": "تسجيل تخصيصات الذاكرة المباشرة وإخفاقاتها في وحدة التحكم.\nاستخدمه عندما تنهار لعبة أو تُغلق أثناء الإقلاع.",
"Options.Env.LogIo.Desc": "تسجيل فتح الملفات وقراءتها وحلّ المسارات في وحدة التحكم.\nاستخدمه عندما لا تجد لعبة ملفات بياناتها أثناء الإقلاع.", "Options.Env.LogIo.Desc": "تسجيل فتح الملفات وقراءتها وحلّ المسارات في وحدة التحكم.\nاستخدمه عندما لا تجد لعبة ملفات بياناتها أثناء الإقلاع.",
"Options.Env.LogNp.Desc": "تسجيل نداءات مكتبة NP (شبكة PlayStation) في وحدة التحكم.", "Options.Env.LogNp.Desc": "تسجيل نداءات مكتبة NP (شبكة PlayStation) في وحدة التحكم.",
"Options.Env.GuestImageCpuSync.Desc": "إعادة رفع أسطح الضيف التي تعيد كتابتها شيفرة المعالج الخاصة باللعبة.\nاتركه مغلقًا عادة. شغّله للألعاب التي لا تصل أسطحها المرسومة بالمعالج إلى الشاشة.\nيكلّف أداءً ويسبب مشاكل في بعض الألعاب مثل GTA V.", "Options.Env.Group.Debug": "تصحيح الأخطاء",
"Options.Env.Group.General": "عام",
"Options.Env.RenderDoc.Desc": "يحمّل واجهة RenderDoc داخل التطبيق حتى يمكن التقاط الإطارات من داخل المحاكي.\nاضغط F12 أثناء تشغيل اللعبة لالتقاط إطار واحد؛ تُحفظ اللقطات في user/logs/capture_logs/<TITLE_ID>.\nيتطلب تثبيت RenderDoc. يبطئ وحدة معالجة الرسوميات ويسبب تعليق بعض الألعاب، لذا اتركه معطلاً ما لم تكن تصحح الأخطاء.",
"Options.Env.DisableVkImplicitLayers.Desc": "عند تفعيل RenderDoc، قد تتسبب التراكبات الأخرى المتعارضة في فقدان الجهاز. قد يؤدي تفعيل هذا الخيار إلى حل المشكلة.",
"Common.Save": "حفظ", "Common.Save": "حفظ",
"Common.Cancel": "إلغاء", "Common.Cancel": "إلغاء",
"Options.About": "حول", "Options.About": "حول",
@ -156,7 +188,7 @@
"About.Discord.Label": "دسكورد", "About.Discord.Label": "دسكورد",
"About.Discord.Desc": "انضم إلى المجتمع واحصل على الدعم وتابع التطوير.", "About.Discord.Desc": "انضم إلى المجتمع واحصل على الدعم وتابع التطوير.",
"About.GithubButton": "ساهم على GitHub!", "About.GithubButton": "ساهم على GitHub!",
"About.DiscordComingSoon": "قريبًا", "About.DiscordButton": "انضم إلى ديسكورد الخاص بنا!",
"Updater.Auto.Label": "التحقق من التحديثات عند بدء التشغيل", "Updater.Auto.Label": "التحقق من التحديثات عند بدء التشغيل",
"Updater.Auto.Desc": "يتحقق من GitHub دون تأخير بدء التشغيل.", "Updater.Auto.Desc": "يتحقق من GitHub دون تأخير بدء التشغيل.",
"Updater.Label": "التحديثات", "Updater.Label": "التحديثات",
@ -173,11 +205,13 @@
"Updater.Status.ChecksumFailed": "فشل التحديث المنزَّل في اجتياز تحقق SHA-256.", "Updater.Status.ChecksumFailed": "فشل التحديث المنزَّل في اجتياز تحقق SHA-256.",
"Updater.Status.Unsupported": "يتطلب التحديث التلقائي إصدار x64 لنظام Windows أو Linux أو macOS.", "Updater.Status.Unsupported": "يتطلب التحديث التلقائي إصدار x64 لنظام Windows أو Linux أو macOS.",
"Options.Graphics": "الرسومات", "Options.Graphics": "الرسومات",
"Options.Console.Type.Label": "وحدة التحكم",
"Options.Console.Type.Desc": "طراز وحدة التحكم الذي يتم إبلاغ الألعاب به.",
"Options.Console.Language.Label": "لغة وحدة التحكم",
"Options.Console.Language.Desc": "لغة النظام التي يتم إبلاغ الألعاب بها.",
"Options.Section.Rendering": "التصيير", "Options.Section.Rendering": "التصيير",
"Options.Section.Display": "العرض", "Options.Section.Display": "العرض",
"Options.RenderResolution.Label": "الدقة الداخلية",
"Options.RenderResolution.Desc": "تصيير الأهداف خارج الشاشة بدقة أقل من الدقة الأصلية ثم رفع دقتها عند العرض. تمنح القيم الأقل مساحة أكبر لوحدة معالجة الرسوميات مقابل جودة الصورة؛ يُطبق عند التشغيل التالي.",
"Options.RenderResolution.Native": "100% (أصلية)",
"Options.WindowMode.Label": "وضع النافذة", "Options.WindowMode.Label": "وضع النافذة",
"Options.WindowMode.Desc": "نافذة عادية، أو سطح مكتب بلا حدود، أو ملء شاشة حصري.", "Options.WindowMode.Desc": "نافذة عادية، أو سطح مكتب بلا حدود، أو ملء شاشة حصري.",
"Options.WindowMode.Windowed": "نافذة", "Options.WindowMode.Windowed": "نافذة",
@ -200,5 +234,10 @@
"Options.VSync.Desc": "استخدام عرض FIFO لإخراج خالٍ من تمزق الصورة.", "Options.VSync.Desc": "استخدام عرض FIFO لإخراج خالٍ من تمزق الصورة.",
"Options.Hdr.Label": "إخراج HDR", "Options.Hdr.Label": "إخراج HDR",
"Options.Hdr.Desc": "استخدام HDR عندما تدعمه الشاشة المحددة وواجهة الرسومات. يعود الوضع التلقائي إلى SDR.", "Options.Hdr.Desc": "استخدام HDR عندما تدعمه الشاشة المحددة وواجهة الرسومات. يعود الوضع التلقائي إلى SDR.",
"Options.Hdr.Auto": "تلقائي" "Options.Hdr.Auto": "تلقائي",
"Options.Env.BinkPlayback.Label": "تشغيل فيديو Bink",
"Options.Env.BinkPlayback.Desc": "يقوم Host بتشغيل فيديوهات Bink عبر جسر FFmpeg، لكن قد تظهر مشكلات في بعض الألعاب.\nيستخدم Guest وحدة فك الترميز الخاصة بمحرك اللعبة.\nيتخطى Skip فيديوهات Bink، مما قد يجعل التطوير أسهل.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "تخطي"
} }

View File

@ -0,0 +1,243 @@
{
"_languageName": "Azərbaycanca",
"Page.Library": "Kitabxana",
"Page.Options": "Parametrlər",
"Page.GameCount.One": "1 oyun",
"Page.GameCount.Other": "{0} oyun",
"Library.SearchWatermark": "Kitabxanada axtar…",
"Library.AddFolder": "Qovluq əlavə et",
"Library.OpenFile": "Fayl aç…",
"Library.View.Grid": "Üst-üstə görünüş",
"Library.View.Carousel": "Sıra görünüşü",
"Library.Context.Launch": "İşə sal",
"Library.Context.OpenFolder": "Oyunun qovluğunu aç",
"Library.Context.CopyPath": "Yolu kopyala",
"Library.Context.CopyTitleId": "Oyunun ID-sini kopyala",
"Library.Context.GameSettings": "Oyunun parametrləri…",
"Library.Context.Remove": "Kitabxanadan çıxar",
"Library.Empty.Title": "Kitabxananız boşdur",
"Library.Empty.Hint": "Başlamaq üçün oyunlarınızın olduğu qovluğu əlavə edin.",
"Library.Empty.SearchTitle": "Axtarışınıza uyğun oyun tapılmadı",
"Library.Empty.SearchHint": "Kitabxanada “{0}” axtarışına uyğun heç nə yoxdur.",
"Library.Empty.AddFolder": "+ Oyun qovluğu əlavə et",
"Library.Loading": "Kitabxana yüklənir…",
"Library.Stat.Version": "Versiya",
"Library.Stat.Installed": "Quraşdırılıb",
"Library.Stat.TitleId": "Oyunun ID-si",
"Common.Back": "Geri qayıt",
"Options.General": "Ümumi",
"Options.Logging": "Jurnala yazma",
"Options.Env.Tab": "Mühit",
"Options.Section.Environment": "Mühit dəyişənləri",
"Options.Env.Desc": "İşə salınarkən emulyatora mühit dəyişənləri kimi ötürülən parametrlər.",
"Options.Env.Bthid.Desc": "Sükan/FFB üçün aralıq proqram təminatı fasiləsiz sorğu göndərən oyunlarda Bluetooth HID əlçatmaz kimi bildirilsin.\nAdətən söndürülmüş saxlayın. İlkin hazırlıq uğursuz olduqda bəzi oyunlar donur.",
"Options.Env.LoopGuard.Desc": "Eyni çağırışı həddindən artıq uzun müddət təkrarlayan oyunlar məcburi bağlanmasın.\nOyun yüklənərkən öz-özünə bağlanırsa, bunu sınayın.",
"Options.Env.WritableApp0.Desc": "Oyunlara quraşdırıldıqları qovluqda fayl yaratmağa və yazmağa icazə verilsin.\nYadda saxlanan oyun və ya konfiqurasiya məlumatlarını /app0 daxilinə yazan paketlənməmiş oyun nüsxələri üçün lazımdır.",
"Options.Env.VkValidation.Desc": "GPU xətalarını araşdırmaq üçün Vulkan yoxlama qatlarını aktivləşdirin.\nİşi ləngidir. Vulkan SDK quraşdırılmalıdır.",
"Options.Env.DumpSpirv.Desc": "AGC kölgələndiricilərini və onların SPIR-V formasına çevrilmiş nüsxələrini shader-dumps qovluğuna yazın.\nKölgələndirici və ya təsvirin yaradılması ilə bağlı xətaları bildirərkən istifadə edin.",
"Options.Env.LogDirectMemory.Desc": "Birbaşa yaddaş ayırmalarını və uğursuzluqları konsola yazın.\nOyun başlanarkən qəfil dayandıqda və ya bağlandıqda istifadə edin.",
"Options.Env.LogIo.Desc": "Faylların açılması, oxunması və yolların müəyyənləşdirilməsi əməliyyatlarını konsola yazın.\nOyun başlanarkən məlumat fayllarını tapa bilmədikdə istifadə edin.",
"Options.Env.LogNp.Desc": "NP (PlayStation Network) kitabxanasına edilən çağırışları konsola yazın.",
"Options.Env.Group.Debug": "Xətaların araşdırılması",
"Options.Env.Group.General": "Ümumi",
"Options.Env.RenderDoc.Desc": "Kadrları emulyatorun daxilindən çəkmək üçün RenderDoc tətbiqdaxili API-sini yükləyin.\nOyun işləyərkən bir kadr çəkmək üçün F10 düyməsini basın; çəkilən kadrlar user/logs/capture_logs/<TITLE_ID> qovluğunda saxlanılır.\nRenderDoc quraşdırılmalıdır. GPU-nu ləngidir və bəzi oyunların donmasına səbəb olur, buna görə xətaları araşdırmadıqda söndürülmüş saxlayın.",
"Options.Env.DisableVkImplicitLayers.Desc": "RenderDoc aktiv olduqda digər ziddiyyətli overlay-lər device loss-a səbəb ola bilər. Bu seçimi aktivləşdirmək problemi həll edə bilər.",
"Options.Env.GuestImageCpuSync.Desc": "Emulyasiya olunan sistemdə oyunun öz CPU kodunun yenidən yazdığı təsvir səthlərini təkrar yükləyin.\nAdətən söndürülmüş saxlayın. CPU ilə çəkilən səthləri ekranda görünməyən oyunlar üçün aktivləşdirin.\nPerformansı azaldır və GTA V kimi bəzi oyunların işini pisləşdirir.",
"Options.Env.ForceSubmitOrphanPreambles.Desc": "GPU əmr buferlərinin giriş əmrlərini hədəf növbəsi onları qəbul etmədikdə belə ötürün.\nAdətən söndürülmüş saxlayın. Heç vaxt siqnal verməyən GPU sinxronlaşdırma səddini gözləyərkən donan oyunlar üçün aktivləşdirin.",
"Options.DefaultProfile.Label": "Standart profil adı",
"Options.DefaultProfile.Desc": "Oyun mətn daxil edilməsini istədikdə istifadə olunan ad. Standart ad Sharp-dır.",
"Options.Section.Emulation": "Emulyasiya",
"Options.Section.Logging": "Jurnala yazma",
"Options.Section.Launcher": "Başladıcı",
"Options.Section.Rendering": "Təsvirin yaradılması",
"Options.Section.Display": "Ekran",
"Options.Graphics": "Qrafika",
"Options.Console.Type.Label": "Konsol",
"Options.Console.Type.Desc": "Oyunlara bildirilən konsol modeli.",
"Options.Console.Language.Label": "Konsol dili",
"Options.Console.Language.Desc": "Oyunlara bildirilən sistem dili.",
"Options.RenderResolution.Label": "Daxili təsvir ölçüsü",
"Options.RenderResolution.Desc": "Ekrandan kənar təsvir hədəflərini ilkin ölçüdən aşağı ölçüdə yaradıb göstərərkən böyüdün. Aşağı dəyərlər təsvir keyfiyyətini azaldaraq GPU yükünü yüngülləşdirir; növbəti işə salınmada qüvvəyə minir.",
"Options.RenderResolution.Native": "100% (ilkin)",
"Options.WindowMode.Label": "Pəncərə rejimi",
"Options.WindowMode.Desc": "Adi pəncərə, iş masasını tutan çərçivəsiz pəncərə və ya eksklüziv tam ekran.",
"Options.WindowMode.Windowed": "Pəncərəli",
"Options.WindowMode.Borderless": "Çərçivəsiz",
"Options.WindowMode.Exclusive": "Eksklüziv",
"Options.Resolution.Label": "Təsvir ölçüsü",
"Options.Resolution.Desc": "Pəncərənin başlanğıc ölçüsü və ya eksklüziv tam ekranın təsvir ölçüsü.",
"Options.Display.Label": "Ekran",
"Options.Display.Desc": "Pəncərənin mərkəzə yerləşdirilməsi və tam ekran üçün istifadə olunan monitor.",
"Options.RefreshRate.Label": "Yenilənmə tezliyi",
"Options.RefreshRate.Desc": "Eksklüziv tam ekranın yenilənmə tezliyi. Avtomatik seçim ən yaxın rejimi seçir.",
"Options.RefreshRate.Automatic": "Avtomatik",
"Options.Scaling.Label": "Miqyaslama",
"Options.Scaling.Desc": "Emulyasiya olunan sistemin ilkin təsvirini daxili ölçüsünü dəyişmədən miqyaslayın.",
"Options.Scaling.Fit": "Sığdır",
"Options.Scaling.Cover": "Tam ört",
"Options.Scaling.Stretch": "Dart",
"Options.Scaling.Integer": "Tam ədəd əmsalı ilə",
"Options.VSync.Label": "VSync",
"Options.VSync.Desc": "Təsvirin parçalanmadan göstərilməsi üçün FIFO təqdimatından istifadə edin.",
"Options.Hdr.Label": "HDR çıxışı",
"Options.Hdr.Desc": "Seçilmiş ekran və qrafik alt sistem dəstəklədikdə HDR istifadə edin. Avtomatik rejimdə dəstək yoxdursa, SDR istifadə olunur.",
"Options.Hdr.Auto": "Avtomatik",
"Options.Env.BinkPlayback.Label": "Bink video oynadılması",
"Options.Env.BinkPlayback.Desc": "Host Bink videolarını FFmpeg körpüsü vasitəsilə oynadır, lakin bəzi oyunlarda problemlər yarana bilər.\nGuest oyunun öz dekoderindən istifadə edir.\nSkip Bink videolarını ötürür və bu, inkişaf prosesini asanlaşdıra bilər.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Skip",
"Options.CpuEngine.Label": "CPU icra mühərriki",
"Options.CpuEngine.Desc": "Oyun kodunu işlətmək üçün istifadə olunan icra mühərriki.",
"Options.CpuEngine.Native": "Birbaşa icra",
"Options.Strict.Label": "Dinamik kitabxana simvollarının ciddi yoxlanması",
"Options.Strict.Desc": "İdxal olunan simvol tapılmadıqda işə salınmanı dayandırın.",
"Options.LogLevel.Label": "Jurnal səviyyəsi",
"Options.LogLevel.Desc": "Emulyatorun konsol çıxışının təfərrüat səviyyəsi.",
"Options.LogLevel.Trace": "İzləmə",
"Options.LogLevel.Debug": "Xətaların araşdırılması",
"Options.LogLevel.Info": "Məlumat",
"Options.LogLevel.Warning": "Xəbərdarlıq",
"Options.LogLevel.Error": "Xəta",
"Options.LogLevel.Critical": "Kritik",
"Options.TraceImports.Label": "İdxalların izlənmə həddi",
"Options.TraceImports.Desc": "Hər modulun ilk N idxalını izləyin (0 = sönülü).",
"Options.LogToFile.Label": "Jurnalı fayla yaz",
"Options.LogToFile.Desc": "Emulyatorun çıxışını jurnal faylına da yazın.",
"Options.LogFilePath.Label": "Jurnal faylının yolu",
"Options.LogFilePath.Default": "Fərdi yol yoxdur. Jurnallar emulyatorun yanındakı user/logs qovluğuna yazılır.",
"Options.LogFilePath.Select": "Seç…",
"Options.OverrideLogFile.Label": "Jurnal faylının yolunu olduğu kimi istifadə et",
"Options.OverrideLogFile.Desc": "Oyunun ID-sini və vaxt nişanını əlavə etmək əvəzinə fayl yolunu olduğu kimi istifadə edin.",
"Options.TitleMusic.Label": "Oyun musiqisi",
"Options.TitleMusic.Desc": "Kitabxanada seçilmiş oyunun önbaxış musiqisini təkrar səsləndirin.",
"Options.Discord.Label": "Discord vəziyyəti",
"Options.Discord.Desc": "İşləyən oyunu Discord profilinizdə göstərin.",
"Options.Language.Label": "Emulyatorun dili",
"Options.Language.Desc": "Başladıcı daxilində istifadə olunan dil. Dərhal tətbiq olunur.",
"Common.On": "Aktiv",
"Common.Off": "Deaktiv",
"Common.Save": "Yadda saxla",
"Common.Cancel": "Ləğv et",
"Console.Title": "Konsol",
"Console.SearchWatermark": "Axtar...",
"Console.AutoScroll": "Avtomatik sürüşdürmə",
"Console.Split": "Böl",
"Console.Copy": "Kopyala",
"Console.Clear": "Təmizlə",
"Console.WindowTitle": "SharpEmu konsolu",
"Launch.NoGameSelected": "Oyun seçilməyib",
"Launch.NoGameHint": "Kitabxanadan oyun seçin və ya birbaşa eboot.bin faylını açın.",
"Launch.Idle": "Gözləmədə",
"Launch.Console": "≡ Konsol",
"Launch.Launch": "▶ İşə sal",
"Launch.Stop": "■ Dayandır",
"Launch.Running": "İşləyir: {0}",
"Launch.Stopping": "Dayandırılır…",
"Launch.Exited": "{0} kodu ilə bağlandı ({1})",
"Launch.ExeNotFound": "SharpEmu icra faylı tapılmadı. Əvvəlcə SharpEmu.CLI layihəsini yığın (dotnet build).",
"Launch.LogFile": "Jurnal faylı: {0}",
"Launch.Command": "$ SharpEmu {0}",
"Launch.StartFailed": "Emulyatoru işə salmaq mümkün olmadı: {0}",
"Launch.ProcessExited": "Proses {0} kodu ilə bağlandı ({1}).",
"Exit.Ok": "Uğurlu",
"Exit.InvalidArguments": "yanlış arqumentlər",
"Exit.EbootNotFound": "eboot tapılmadı",
"Exit.RuntimeException": "icra zamanı istisna",
"Options.CrashDump.Label": "Qəza yaddaş faylları",
"Options.CrashDump.Desc": "Qəza yaddaş fayllarını icra jurnalının yanında saxla (yalnız Windows x64). Fayllar böyük ola və şəxsi məlumatlar ehtiva edə bilər.",
"Options.Env.PerformanceProfile.Desc": "Növbəti oyun başladıqda performans vaxtlarını və FPS-i jurnala yaz.\nBu, performansı azalda bilər.",
"Options.Env.PerformanceFrameTrace.Desc": "Son 4 096 təqdimat intervalını saxla və oyun bağlandıqda jurnala yaz.\nPerformans profilləşdirilməsi tələb olunur. İzi saxlamaq üçün oyunu normal qaydada bağlayın.",
"Options.Env.StrictCompute.Desc": "Hesablama və çəkim üçün şeyderin rədd edilməsi yoxlamalarında dayan (standart).\nTəsirlənən əməliyyatları ötürmək üçün söndürün. Görüntülər itə, xətalar və ya donmalar baş verə bilər. Dəyişiklikdən sonra oyunu yenidən başladın.",
"Options.OverlayEnabled.Label": "Performans göstəriciləri",
"Options.OverlayEnabled.Desc": "Performans statistikasını göstər. F1 cari icra üçün göstəriciləri açır və bağlayır. SHARPEMU_OVERLAY=0 onları başlanğıcda gizlədir.",
"Options.OverlayMode.Label": "Göstərmə rejimi",
"Options.OverlayMode.Desc": "Tam rejim bütün sayğacları göstərir. Minimal və başlıq sətri rejimləri FPS, CPU, GPU istifadəsini və keçən vaxtı göstərir. GPU istifadəsi Windows-da hər proses üçün ölçülür; digər sistemlərdə N/A göstərilir.",
"Options.OverlayCorner.Label": "Ekran küncü",
"Options.OverlayCorner.Desc": "Saxlanacaq küncü seçin. F2 yalnız cari icra üçün küncləri dəyişir. Bu, başlıq sətrindəki statistikanın yerini dəyişmir.",
"Options.OverlayMode.Full": "Tam",
"Options.OverlayMode.Minimal": "Minimal",
"Options.OverlayMode.TitleBar": "Başlıq sətri (minimal)",
"Options.OverlayCorner.TopLeft": "Yuxarı sol",
"Options.OverlayCorner.TopRight": "Yuxarı sağ",
"Options.OverlayCorner.BottomRight": "Aşağı sağ",
"Options.OverlayCorner.BottomLeft": "Aşağı sol",
"Exit.EmulationError": "emulyasiya xətası",
"Exit.Unknown": "naməlum",
"Status.EmulatorLocating": "Emulyator: axtarılır…",
"Status.EmulatorPath": "Emulyator: {0}",
"Status.EmulatorNotFound": "Emulyator: SharpEmu icra faylı tapılmadı. Əvvəlcə SharpEmu.CLI layihəsini yığın.",
"Status.ScanningLibrary": "Kitabxana yoxlanılır…",
"Status.AddFolderPrompt": "Kitabxananı doldurmaq üçün oyun qovluğu əlavə edin.",
"Status.LibraryScanned": "Kitabxana yoxlanıldı: {0} oyun, {1} qovluqda.",
"Status.CouldNotOpenFolder": "Qovluğu açmaq mümkün olmadı: {0}",
"Status.CopiedToClipboard": "{0} mübadilə buferinə kopyalandı.",
"Status.RemovedFromLibrary": "“{0}” kitabxanadan çıxarıldı. Bərpa etmək üçün qovluğunu yenidən əlavə edin.",
"Status.Running": "İşləyir: {0}",
"Status.Stopping": "Dayandırılır…",
"Status.Idle": "Gözləmədə",
"Clipboard.Path": "Yol",
"Clipboard.TitleId": "Oyunun ID-si",
"Discord.Playing": "{0} oynayır",
"Discord.Browsing": "Kitabxanaya baxır",
"Dialog.ChooseGameFolder": "Oyunların olduğu qovluğu seç",
"Dialog.OpenExecutable": "İşə salmaq üçün icra faylını aç",
"Dialog.PsExecutables": "PS icra faylları",
"Dialog.SaveLogFile": "Jurnal faylının saxlanacağı yeri seç",
"Dialog.PlainTextFiles": "Sadə mətn faylları",
"Dialog.LogFiles": "Jurnal faylları",
"Options.About" : "Haqqında",
"About.Github.Label": "GitHub",
"About.Github.Desc": "Mənbə kodu, problemlər və layihənin inkişafı.",
"About.Github.LatestCommitLabel": "Son kod dəyişikliyi",
"About.Github.LatestCommitDescription": "Əsas budaqdakı son kod dəyişikliyi",
"About.Discord.Label": "Discord",
"About.Discord.Desc": "İcmaya qoşulun, dəstək alın və layihənin inkişafını izləyin.",
"About.GithubButton": "GitHub-da töhfə ver!",
"About.DiscordButton": "Discord icmamıza qoşul!",
"Updater.Auto.Label": "Başlanğıcda yeniləmələri yoxla",
"Updater.Auto.Desc": "Başlanğıcı ləngitmədən GitHub-da yoxlayır.",
"Updater.Label": "Yeniləmələr",
"Updater.Check": "Yeniləmələri yoxla",
"Updater.DownloadRestart": "Endir və yenidən başlat",
"Updater.Status.Ready": "Cari yığım: {0}",
"Updater.Status.Checking": "Yeniləmələr yoxlanılır…",
"Updater.Status.Current": "Ən son versiyadan istifadə edirsiniz ({0}).",
"Updater.Status.Available": "Yeni yığım mövcuddur: {0}",
"Updater.Status.Downloading": "Yeniləmə endirilir… {0}%",
"Updater.Status.Installing": "Yeniləmə quraşdırılır…",
"Updater.Status.Timeout": "Yeniləmələrin yoxlanması üçün ayrılmış 10 saniyə bitdi.",
"Updater.Status.Failed": "Yeniləmələri yoxlamaq mümkün olmadı.",
"Updater.Status.ChecksumFailed": "Endirilmiş yeniləmə SHA-256 yoxlamasından keçmədi.",
"Updater.Status.Unsupported": "Avtomatik yeniləmə üçün Windows, Linux və ya macOS x64 yığımı tələb olunur."
}

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "Português (Brasil)", "_languageName": "Português (Brasil)",
"Options.Env.StrictCompute.Desc": "Parar nas rejeições de shaders de cálculo e desenho (padrão).\nDesative para ignorar o trabalho afetado. Podem ocorrer imagens ausentes, erros ou travamentos. Reinicie o jogo após uma alteração.",
"Options.Env.PerformanceProfile.Desc": "Registre os tempos de desempenho e FPS a partir da próxima execução do jogo.\nIsso pode reduzir o desempenho.",
"Options.Env.PerformanceFrameTrace.Desc": "Guarde os últimos 4.096 intervalos de apresentação e grave-os no log ao encerrar.\nRequer o perfil de desempenho. Feche o jogo normalmente para salvar o rastreamento.",
"Options.OverlayEnabled.Label": "Indicador de desempenho",
"Options.OverlayEnabled.Desc": "Mostrar estatísticas. F1 ativa ou oculta o indicador nesta sessão. SHARPEMU_OVERLAY=0 oculta o indicador ao iniciar.",
"Options.OverlayMode.Label": "Modo de exibição",
"Options.OverlayMode.Desc": "Completo mostra todos os contadores. Mínimo e Barra de título mostram FPS, CPU, uso da GPU e tempo. A GPU é medida por processo no Windows; nos outros sistemas, N/A.",
"Options.OverlayCorner.Label": "Canto da tela",
"Options.OverlayCorner.Desc": "Escolher o canto salvo. F2 muda de canto apenas nesta sessão. Não move as estatísticas da barra de título.",
"Options.OverlayMode.Full": "Completo",
"Options.OverlayMode.Minimal": "Mínimo",
"Options.OverlayMode.TitleBar": "Barra de título (mínimo)",
"Options.OverlayCorner.TopLeft": "Superior esquerdo",
"Options.OverlayCorner.TopRight": "Superior direito",
"Options.OverlayCorner.BottomRight": "Inferior direito",
"Options.OverlayCorner.BottomLeft": "Inferior esquerdo",
"Page.Library": "Biblioteca", "Page.Library": "Biblioteca",
"Page.Options": "Opções", "Page.Options": "Opções",
@ -39,7 +55,10 @@
"Options.Env.DumpSpirv.Desc": "Extrai os shaders AGC e suas traduções SPIR-V para a pasta shader-dumps.\nUse ao reportar bugs de shader ou renderização.", "Options.Env.DumpSpirv.Desc": "Extrai os shaders AGC e suas traduções SPIR-V para a pasta shader-dumps.\nUse ao reportar bugs de shader ou renderização.",
"Options.Env.LogDirectMemory.Desc": "Registra alocações de memória direta e falhas no console.\nUse quando um jogo aborta ou fecha durante a inicialização (boot).", "Options.Env.LogDirectMemory.Desc": "Registra alocações de memória direta e falhas no console.\nUse quando um jogo aborta ou fecha durante a inicialização (boot).",
"Options.Env.LogNp.Desc": "Registra chamadas da biblioteca NP (PlayStation Network) no console.", "Options.Env.LogNp.Desc": "Registra chamadas da biblioteca NP (PlayStation Network) no console.",
"Options.Env.GuestImageCpuSync.Desc": "Recarrega as superfícies do convidado que o próprio código de CPU do jogo reescreve.\nDeixe desativado normalmente. Ative para títulos cujas superfícies desenhadas pela CPU nunca chegam à tela.\nCusta desempenho e causa regressões em alguns títulos, como GTA V.", "Options.Env.Group.Debug": "Depuração",
"Options.Env.Group.General": "Geral",
"Options.Env.RenderDoc.Desc": "Carrega a API in-application do RenderDoc para capturar frames de dentro do emulador.\nPressione F12 enquanto o jogo roda para capturar um frame; as capturas vão para user/logs/capture_logs/<TITLE_ID>.\nExige o RenderDoc instalado. Deixa a GPU mais lenta e trava alguns títulos, então mantenha desativado a menos que esteja depurando.",
"Options.Env.DisableVkImplicitLayers.Desc": "Quando o RenderDoc está ativado, outros overlays conflitantes podem causar device loss. Ativar esta opção pode corrigir o problema.",
"Options.Section.Emulation": "EMULAÇÃO", "Options.Section.Emulation": "EMULAÇÃO",
"Options.Section.Logging": "LOGS", "Options.Section.Logging": "LOGS",
"Options.Section.Launcher": "INICIALIZADOR", "Options.Section.Launcher": "INICIALIZADOR",
@ -63,6 +82,8 @@
"Options.TraceImports.Label": "Limite de rastreamento de importações", "Options.TraceImports.Label": "Limite de rastreamento de importações",
"Options.TraceImports.Desc": "Rastreia as primeiras N importações de cada módulo (0 = desativado).", "Options.TraceImports.Desc": "Rastreia as primeiras N importações de cada módulo (0 = desativado).",
"Options.CrashDump.Label": "Despejos de falha",
"Options.CrashDump.Desc": "Salva despejos de falha ao lado do log da execução (somente Windows x64). Os arquivos podem ser grandes e conter dados privados.",
"Options.LogToFile.Label": "Salvar log em arquivo", "Options.LogToFile.Label": "Salvar log em arquivo",
"Options.LogToFile.Desc": "Copia a saída do emulador para um arquivo de log.", "Options.LogToFile.Desc": "Copia a saída do emulador para um arquivo de log.",
@ -100,6 +121,17 @@
"Launch.Idle": "Ocioso", "Launch.Idle": "Ocioso",
"Launch.Console": "≡ Console", "Launch.Console": "≡ Console",
"Launch.Launch": "▶ Iniciar", "Launch.Launch": "▶ Iniciar",
"Launch.CustomEnv": "Iniciar com variáveis de ambiente personalizadas",
"Launch.CustomEnv.Title": "Iniciar com variáveis de ambiente personalizadas",
"Launch.CustomEnv.Desc": "Digite uma variável de ambiente por linha no formato NOME=VALOR. Os valores personalizados substituem as configurações da GUI e específicas do jogo com o mesmo nome.",
"Launch.CustomEnv.Documentation": "Ver variáveis de ambiente não documentadas ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_EXEMPLO=1",
"Launch.CustomEnv.SaveGame": "Salvar para o jogo",
"Launch.CustomEnv.SaveGlobal": "Salvar globalmente",
"Launch.CustomEnv.Play": "Jogar",
"Launch.CustomEnv.Invalid": "Variável de ambiente inválida: {0}",
"Launch.CustomEnv.SavedGame": "Salvo para este jogo.",
"Launch.CustomEnv.SavedGlobal": "Salvo globalmente.",
"Launch.Stop": "■ Parar", "Launch.Stop": "■ Parar",
"Launch.Running": "Em execução — {0}", "Launch.Running": "Em execução — {0}",
"Launch.Stopping": "Encerrando…", "Launch.Stopping": "Encerrando…",
@ -149,7 +181,7 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "Participe da comunidade, obtenha suporte e acompanhe o desenvolvimento.", "About.Discord.Desc": "Participe da comunidade, obtenha suporte e acompanhe o desenvolvimento.",
"About.GithubButton": "Contribua no GitHub!", "About.GithubButton": "Contribua no GitHub!",
"About.DiscordComingSoon": "Em breve", "About.DiscordButton": "Junte-se ao nosso Discord!",
"Library.Context.GameSettings": "Configurações do jogo…", "Library.Context.GameSettings": "Configurações do jogo…",
"Options.Env.WritableApp0.Desc": "Permite que os jogos criem e gravem arquivos dentro da própria pasta de instalação.\nNecessário para dumps não empacotados que gravam seus saves ou configurações em /app0.", "Options.Env.WritableApp0.Desc": "Permite que os jogos criem e gravem arquivos dentro da própria pasta de instalação.\nNecessário para dumps não empacotados que gravam seus saves ou configurações em /app0.",
@ -174,11 +206,13 @@
"Updater.Status.ChecksumFailed": "A atualização baixada falhou na verificação SHA-256.", "Updater.Status.ChecksumFailed": "A atualização baixada falhou na verificação SHA-256.",
"Updater.Status.Unsupported": "A atualização automática requer um build x64 para Windows, Linux ou macOS.", "Updater.Status.Unsupported": "A atualização automática requer um build x64 para Windows, Linux ou macOS.",
"Options.Graphics": "Gráficos", "Options.Graphics": "Gráficos",
"Options.Console.Type.Label": "Console",
"Options.Console.Type.Desc": "Modelo de console informado aos jogos.",
"Options.Console.Language.Label": "Idioma do console",
"Options.Console.Language.Desc": "Idioma do sistema informado aos jogos.",
"Options.Section.Rendering": "RENDERIZAÇÃO", "Options.Section.Rendering": "RENDERIZAÇÃO",
"Options.Section.Display": "TELA", "Options.Section.Display": "TELA",
"Options.RenderResolution.Label": "Resolução interna",
"Options.RenderResolution.Desc": "Renderiza alvos fora da tela abaixo da resolução nativa e amplia na apresentação. Valores menores trocam qualidade de imagem por folga da GPU; entra em vigor na próxima inicialização.",
"Options.RenderResolution.Native": "100% (nativa)",
"Options.WindowMode.Label": "Modo de janela", "Options.WindowMode.Label": "Modo de janela",
"Options.WindowMode.Desc": "Janela normal, área de trabalho sem bordas ou tela cheia exclusiva.", "Options.WindowMode.Desc": "Janela normal, área de trabalho sem bordas ou tela cheia exclusiva.",
"Options.WindowMode.Windowed": "Em janela", "Options.WindowMode.Windowed": "Em janela",
@ -201,5 +235,10 @@
"Options.VSync.Desc": "Usa apresentação FIFO para evitar cortes na imagem.", "Options.VSync.Desc": "Usa apresentação FIFO para evitar cortes na imagem.",
"Options.Hdr.Label": "Saída HDR", "Options.Hdr.Label": "Saída HDR",
"Options.Hdr.Desc": "Usa HDR quando a tela selecionada e o backend gráfico oferecem suporte. O modo automático retorna ao SDR.", "Options.Hdr.Desc": "Usa HDR quando a tela selecionada e o backend gráfico oferecem suporte. O modo automático retorna ao SDR.",
"Options.Hdr.Auto": "Automático" "Options.Hdr.Auto": "Automático",
"Options.Env.BinkPlayback.Label": "Reprodução de vídeo Bink",
"Options.Env.BinkPlayback.Desc": "Host reproduz vídeos Bink pela ponte FFmpeg, mas alguns jogos podem apresentar problemas.\nGuest usa o decodificador do próprio motor do jogo.\nSkip ignora os vídeos Bink, o que pode facilitar o desenvolvimento.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Ignorar"
} }

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "Deutsch", "_languageName": "Deutsch",
"Options.Env.StrictCompute.Desc": "Bei Shader-Ablehnungen für Compute und Zeichenbefehle stoppen (Standard).\nAusschalten, um betroffene Arbeit zu überspringen. Fehlende Bilder, Fehler oder Stillstände sind möglich. Spiel nach Änderungen neu starten.",
"Options.Env.PerformanceProfile.Desc": "Leistungszeiten und FPS ab dem nächsten Spielstart protokollieren.\nDies kann die Leistung verringern.",
"Options.Env.PerformanceFrameTrace.Desc": "Die letzten 4.096 Präsentationsintervalle speichern und beim Beenden ins Protokoll schreiben.\nErfordert Leistungsprofilierung. Das Spiel normal schließen, um die Aufzeichnung zu speichern.",
"Options.OverlayEnabled.Label": "Leistungsanzeige",
"Options.OverlayEnabled.Desc": "Leistungsdaten anzeigen. F1 schaltet die Anzeige nur für diesen Lauf um. SHARPEMU_OVERLAY=0 blendet sie beim Start aus.",
"Options.OverlayMode.Label": "Anzeigemodus",
"Options.OverlayMode.Desc": "Vollständig zeigt alle Zähler. Minimal und Titelleiste zeigen FPS, CPU, GPU-Auslastung und Laufzeit. GPU-Auslastung gilt unter Windows pro Prozess; sonst N/A.",
"Options.OverlayCorner.Label": "Bildschirmecke",
"Options.OverlayCorner.Desc": "Gespeicherte Ecke wählen. F2 wechselt die Ecke nur für diesen Lauf. Die Titelleistenanzeige bleibt unverändert.",
"Options.OverlayMode.Full": "Vollständig",
"Options.OverlayMode.Minimal": "Minimal",
"Options.OverlayMode.TitleBar": "Titelleiste (minimal)",
"Options.OverlayCorner.TopLeft": "Oben links",
"Options.OverlayCorner.TopRight": "Oben rechts",
"Options.OverlayCorner.BottomRight": "Unten rechts",
"Options.OverlayCorner.BottomLeft": "Unten links",
"Page.Library": "Bibliothek", "Page.Library": "Bibliothek",
"Page.Options": "Optionen", "Page.Options": "Optionen",
@ -53,6 +69,8 @@
"Options.TraceImports.Label": "Import-Trace-Limit", "Options.TraceImports.Label": "Import-Trace-Limit",
"Options.TraceImports.Desc": "Die ersten N Imports pro Modul verfolgen (0 = aus).", "Options.TraceImports.Desc": "Die ersten N Imports pro Modul verfolgen (0 = aus).",
"Options.CrashDump.Label": "Absturzabbilder",
"Options.CrashDump.Desc": "Speichert Absturzabbilder neben dem Laufprotokoll (nur Windows x64). Die Dateien können groß sein und private Daten enthalten.",
"Options.LogToFile.Label": "In Datei protokollieren", "Options.LogToFile.Label": "In Datei protokollieren",
"Options.LogToFile.Desc": "Emulator-Ausgabe zusätzlich in eine Log-Datei schreiben.", "Options.LogToFile.Desc": "Emulator-Ausgabe zusätzlich in eine Log-Datei schreiben.",
@ -90,6 +108,17 @@
"Launch.Idle": "Bereit", "Launch.Idle": "Bereit",
"Launch.Console": "≡ Konsole", "Launch.Console": "≡ Konsole",
"Launch.Launch": "▶ Starten", "Launch.Launch": "▶ Starten",
"Launch.CustomEnv": "Mit benutzerdefinierten Umgebungsvariablen starten",
"Launch.CustomEnv.Title": "Mit benutzerdefinierten Umgebungsvariablen starten",
"Launch.CustomEnv.Desc": "Gib pro Zeile eine Umgebungsvariable im Format NAME=WERT ein. Benutzerdefinierte Werte überschreiben gleichnamige GUI- und spielspezifische Einstellungen.",
"Launch.CustomEnv.Documentation": "Undokumentierte Umgebungsvariablen anzeigen ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_BEISPIEL=1",
"Launch.CustomEnv.SaveGame": "Für Spiel speichern",
"Launch.CustomEnv.SaveGlobal": "Global speichern",
"Launch.CustomEnv.Play": "Spielen",
"Launch.CustomEnv.Invalid": "Ungültige Umgebungsvariable: {0}",
"Launch.CustomEnv.SavedGame": "Für dieses Spiel gespeichert.",
"Launch.CustomEnv.SavedGlobal": "Global gespeichert.",
"Launch.Stop": "■ Stoppen", "Launch.Stop": "■ Stoppen",
"Launch.Running": "Läuft -- {0}", "Launch.Running": "Läuft -- {0}",
"Launch.Stopping": "Wird beendet…", "Launch.Stopping": "Wird beendet…",
@ -145,7 +174,10 @@
"Options.Env.LogDirectMemory.Desc": "Direkte Speicherzuweisungen und Fehler in der Konsole protokollieren.\nVerwenden, wenn ein Spiel beim Start abbricht oder sich beendet.", "Options.Env.LogDirectMemory.Desc": "Direkte Speicherzuweisungen und Fehler in der Konsole protokollieren.\nVerwenden, wenn ein Spiel beim Start abbricht oder sich beendet.",
"Options.Env.LogIo.Desc": "Datei-Öffnen, -Lesen und Pfadauflösung in der Konsole protokollieren.\nVerwenden, wenn ein Spiel beim Start seine Datendateien nicht findet.", "Options.Env.LogIo.Desc": "Datei-Öffnen, -Lesen und Pfadauflösung in der Konsole protokollieren.\nVerwenden, wenn ein Spiel beim Start seine Datendateien nicht findet.",
"Options.Env.LogNp.Desc": "NP-Bibliotheksaufrufe (PlayStation Network) in der Konsole protokollieren.", "Options.Env.LogNp.Desc": "NP-Bibliotheksaufrufe (PlayStation Network) in der Konsole protokollieren.",
"Options.Env.GuestImageCpuSync.Desc": "Gast-Oberflächen neu hochladen, die der eigene CPU-Code des Spiels überschreibt.\nNormalerweise aus lassen. Für Titel aktivieren, deren CPU-gezeichnete Oberflächen nie auf dem Bildschirm erscheinen.\nKostet Leistung und verursacht bei einigen Titeln wie GTA V Regressionen.", "Options.Env.Group.Debug": "Debug",
"Options.Env.Group.General": "Allgemein",
"Options.Env.RenderDoc.Desc": "Lädt die RenderDoc-In-Application-API, damit Frames aus dem Emulator heraus aufgezeichnet werden können.\nDrücke F12 während das Spiel läuft, um ein Frame aufzuzeichnen; Aufzeichnungen landen in user/logs/capture_logs/<TITLE_ID>.\nErfordert eine RenderDoc-Installation. Verlangsamt die GPU und lässt manche Titel hängen, lass es also aus, wenn du nicht debuggst.",
"Options.Env.DisableVkImplicitLayers.Desc": "Wenn RenderDoc aktiviert ist, können andere kollidierende Overlays einen Device Loss verursachen. Das Aktivieren dieser Option kann das Problem beheben.",
"Common.Save": "Speichern", "Common.Save": "Speichern",
"Common.Cancel": "Abbrechen", "Common.Cancel": "Abbrechen",
"Options.About": "Über", "Options.About": "Über",
@ -156,7 +188,7 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "Tritt der Community bei, erhalte Support und verfolge die Entwicklung.", "About.Discord.Desc": "Tritt der Community bei, erhalte Support und verfolge die Entwicklung.",
"About.GithubButton": "Auf GitHub mitwirken!", "About.GithubButton": "Auf GitHub mitwirken!",
"About.DiscordComingSoon": "Demnächst verfügbar", "About.DiscordButton": "Tritt unserem Discord bei!",
"Updater.Auto.Label": "Beim Start nach Updates suchen", "Updater.Auto.Label": "Beim Start nach Updates suchen",
"Updater.Auto.Desc": "Fragt GitHub ab, ohne den Start zu verzögern.", "Updater.Auto.Desc": "Fragt GitHub ab, ohne den Start zu verzögern.",
"Updater.Label": "Updates", "Updater.Label": "Updates",
@ -173,11 +205,13 @@
"Updater.Status.ChecksumFailed": "Das heruntergeladene Update hat die SHA-256-Prüfung nicht bestanden.", "Updater.Status.ChecksumFailed": "Das heruntergeladene Update hat die SHA-256-Prüfung nicht bestanden.",
"Updater.Status.Unsupported": "Automatische Updates erfordern einen x64-Build für Windows, Linux oder macOS.", "Updater.Status.Unsupported": "Automatische Updates erfordern einen x64-Build für Windows, Linux oder macOS.",
"Options.Graphics": "Grafik", "Options.Graphics": "Grafik",
"Options.Console.Type.Label": "Konsole",
"Options.Console.Type.Desc": "Konsolenmodell, das Spielen gemeldet wird.",
"Options.Console.Language.Label": "Konsolensprache",
"Options.Console.Language.Desc": "Systemsprache, die Spielen gemeldet wird.",
"Options.Section.Rendering": "DARSTELLUNG", "Options.Section.Rendering": "DARSTELLUNG",
"Options.Section.Display": "ANZEIGE", "Options.Section.Display": "ANZEIGE",
"Options.RenderResolution.Label": "Interne Auflösung",
"Options.RenderResolution.Desc": "Offscreen-Ziele unterhalb der nativen Auflösung rendern und bei der Ausgabe hochskalieren. Niedrigere Werte tauschen Bildqualität gegen GPU-Reserven; wird beim nächsten Start wirksam.",
"Options.RenderResolution.Native": "100 % (nativ)",
"Options.WindowMode.Label": "Fenstermodus", "Options.WindowMode.Label": "Fenstermodus",
"Options.WindowMode.Desc": "Normales Fenster, randloser Desktop oder exklusiver Vollbildmodus.", "Options.WindowMode.Desc": "Normales Fenster, randloser Desktop oder exklusiver Vollbildmodus.",
"Options.WindowMode.Windowed": "Fenster", "Options.WindowMode.Windowed": "Fenster",
@ -200,5 +234,10 @@
"Options.VSync.Desc": "FIFO-Präsentation für eine Ausgabe ohne Tearing verwenden.", "Options.VSync.Desc": "FIFO-Präsentation für eine Ausgabe ohne Tearing verwenden.",
"Options.Hdr.Label": "HDR-Ausgabe", "Options.Hdr.Label": "HDR-Ausgabe",
"Options.Hdr.Desc": "HDR verwenden, wenn die ausgewählte Anzeige und das Grafik-Backend es unterstützen. Automatisch fällt auf SDR zurück.", "Options.Hdr.Desc": "HDR verwenden, wenn die ausgewählte Anzeige und das Grafik-Backend es unterstützen. Automatisch fällt auf SDR zurück.",
"Options.Hdr.Auto": "Automatisch" "Options.Hdr.Auto": "Automatisch",
"Options.Env.BinkPlayback.Label": "Bink-Videowiedergabe",
"Options.Env.BinkPlayback.Desc": "Host spielt Bink-Videos über die FFmpeg-Brücke ab, bei einigen Spielen können jedoch Probleme auftreten.\nGuest verwendet den spieleigenen Decoder.\nSkip überspringt Bink-Videos, was die Entwicklung erleichtern kann.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Überspringen"
} }

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "Dansk", "_languageName": "Dansk",
"Options.Env.StrictCompute.Desc": "Stop ved shaderafvisninger for beregning og tegning (standard).\nSlå fra for at springe det berørte arbejde over. Manglende billeder, fejl eller stop kan forekomme. Genstart spillet efter en ændring.",
"Options.Env.PerformanceProfile.Desc": "Log ydelsestider og FPS fra næste spilstart.\nDette kan reducere ydelsen.",
"Options.Env.PerformanceFrameTrace.Desc": "Gem de sidste 4.096 præsentationsintervaller, og skriv dem til loggen ved afslutning.\nKræver ydelsesprofilering. Luk spillet normalt for at gemme sporingen.",
"Options.OverlayEnabled.Label": "Ydelsesvisning",
"Options.OverlayEnabled.Desc": "Vis ydelsesdata. F1 slår visningen til eller fra i denne session. SHARPEMU_OVERLAY=0 skjuler den ved start.",
"Options.OverlayMode.Label": "Visningstilstand",
"Options.OverlayMode.Desc": "Fuld viser alle tællere. Minimal og Titellinje viser FPS, CPU, GPU-forbrug og forløbet tid. GPU-forbrug måles pr. proces i Windows; ellers N/A.",
"Options.OverlayCorner.Label": "Skærmhjørne",
"Options.OverlayCorner.Desc": "Vælg det gemte hjørne. F2 skifter hjørne kun i denne session. Statistik i titellinjen flyttes ikke.",
"Options.OverlayMode.Full": "Fuld",
"Options.OverlayMode.Minimal": "Minimal",
"Options.OverlayMode.TitleBar": "Titellinje (minimal)",
"Options.OverlayCorner.TopLeft": "Øverst til venstre",
"Options.OverlayCorner.TopRight": "Øverst til højre",
"Options.OverlayCorner.BottomRight": "Nederst til højre",
"Options.OverlayCorner.BottomLeft": "Nederst til venstre",
"Page.Library": "Bibliotek", "Page.Library": "Bibliotek",
"Page.Options": "Indstillinger", "Page.Options": "Indstillinger",
@ -53,6 +69,8 @@
"Options.TraceImports.Label": "Grænse for import-trace", "Options.TraceImports.Label": "Grænse for import-trace",
"Options.TraceImports.Desc": "Spor de første N imports pr. modul (0 = fra).", "Options.TraceImports.Desc": "Spor de første N imports pr. modul (0 = fra).",
"Options.CrashDump.Label": "Nedbrudsdumps",
"Options.CrashDump.Desc": "Gem nedbrudsdumps ved siden af kørselsloggen (kun Windows x64). Filerne kan være store og indeholde private data.",
"Options.LogToFile.Label": "Log til fil", "Options.LogToFile.Label": "Log til fil",
"Options.LogToFile.Desc": "Spejl emulatorens output til en logfil.", "Options.LogToFile.Desc": "Spejl emulatorens output til en logfil.",
@ -90,6 +108,17 @@
"Launch.Idle": "Inaktiv", "Launch.Idle": "Inaktiv",
"Launch.Console": "≡ Konsol", "Launch.Console": "≡ Konsol",
"Launch.Launch": "▶ Start", "Launch.Launch": "▶ Start",
"Launch.CustomEnv": "Start med brugerdefinerede miljøvariabler",
"Launch.CustomEnv.Title": "Start med brugerdefinerede miljøvariabler",
"Launch.CustomEnv.Desc": "Indtast én miljøvariabel pr. linje som NAVN=VÆRDI. Brugerdefinerede værdier tilsidesætter GUI- og spilspecifikke indstillinger med samme navn.",
"Launch.CustomEnv.Documentation": "Vis udokumenterede miljøvariabler ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_EKSEMPEL=1",
"Launch.CustomEnv.SaveGame": "Gem for spil",
"Launch.CustomEnv.SaveGlobal": "Gem globalt",
"Launch.CustomEnv.Play": "Spil",
"Launch.CustomEnv.Invalid": "Ugyldig miljøvariabel: {0}",
"Launch.CustomEnv.SavedGame": "Gemt for dette spil.",
"Launch.CustomEnv.SavedGlobal": "Gemt globalt.",
"Launch.Stop": "■ Stop", "Launch.Stop": "■ Stop",
"Launch.Running": "Kører — {0}", "Launch.Running": "Kører — {0}",
"Launch.Stopping": "Stopper…", "Launch.Stopping": "Stopper…",
@ -145,7 +174,10 @@
"Options.Env.LogDirectMemory.Desc": "Log direkte hukommelsestildelinger og fejl til konsollen.\nBrug dette, når et spil afbryder eller lukker under opstart.", "Options.Env.LogDirectMemory.Desc": "Log direkte hukommelsestildelinger og fejl til konsollen.\nBrug dette, når et spil afbryder eller lukker under opstart.",
"Options.Env.LogIo.Desc": "Log åbning og læsning af filer samt stiopslag til konsollen.\nBrug dette, når et spil ikke kan finde sine datafiler under opstart.", "Options.Env.LogIo.Desc": "Log åbning og læsning af filer samt stiopslag til konsollen.\nBrug dette, når et spil ikke kan finde sine datafiler under opstart.",
"Options.Env.LogNp.Desc": "Log NP-bibliotekskald (PlayStation Network) til konsollen.", "Options.Env.LogNp.Desc": "Log NP-bibliotekskald (PlayStation Network) til konsollen.",
"Options.Env.GuestImageCpuSync.Desc": "Genindlæs gæsteoverflader, som spillets egen CPU-kode omskriver.\nLad den være slået fra normalt. Slå til for titler, hvis CPU-tegnede overflader aldrig når skærmen.\nKoster ydeevne og giver regressioner i nogle titler, såsom GTA V.", "Options.Env.Group.Debug": "Fejlfinding",
"Options.Env.Group.General": "Generelt",
"Options.Env.RenderDoc.Desc": "Indlæser RenderDocs in-application-API, så frames kan optages inde fra emulatoren.\nTryk på F12 mens spillet kører for at optage ét frame; optagelser havner i user/logs/capture_logs/<TITLE_ID>.\nKræver at RenderDoc er installeret. Gør GPU'en langsommere og får nogle titler til at hænge, så lad den være slået fra, medmindre du fejlfinder.",
"Options.Env.DisableVkImplicitLayers.Desc": "Når RenderDoc er aktiveret, kan andre konflikterende overlays forårsage device loss. Aktivering af denne indstilling kan løse problemet.",
"Common.Save": "Gem", "Common.Save": "Gem",
"Common.Cancel": "Annuller", "Common.Cancel": "Annuller",
"Options.About": "Om", "Options.About": "Om",
@ -156,7 +188,7 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "Bliv en del af fællesskabet, få hjælp og følg udviklingen.", "About.Discord.Desc": "Bliv en del af fællesskabet, få hjælp og følg udviklingen.",
"About.GithubButton": "Bidrag på GitHub!", "About.GithubButton": "Bidrag på GitHub!",
"About.DiscordComingSoon": "Kommer snart", "About.DiscordButton": "Deltag i vores Discord!",
"Updater.Auto.Label": "Søg efter opdateringer ved start", "Updater.Auto.Label": "Søg efter opdateringer ved start",
"Updater.Auto.Desc": "Tjekker GitHub uden at forsinke opstarten.", "Updater.Auto.Desc": "Tjekker GitHub uden at forsinke opstarten.",
"Updater.Label": "Opdateringer", "Updater.Label": "Opdateringer",
@ -173,11 +205,13 @@
"Updater.Status.ChecksumFailed": "Den downloadede opdatering bestod ikke SHA-256-verifikationen.", "Updater.Status.ChecksumFailed": "Den downloadede opdatering bestod ikke SHA-256-verifikationen.",
"Updater.Status.Unsupported": "Automatisk opdatering kræver et x64-build til Windows, Linux eller macOS.", "Updater.Status.Unsupported": "Automatisk opdatering kræver et x64-build til Windows, Linux eller macOS.",
"Options.Graphics": "Grafik", "Options.Graphics": "Grafik",
"Options.Console.Type.Label": "Konsol",
"Options.Console.Type.Desc": "Konsolmodel der rapporteres til spil.",
"Options.Console.Language.Label": "Konsolsprog",
"Options.Console.Language.Desc": "Systemsprog der rapporteres til spil.",
"Options.Section.Rendering": "GENGIVELSE", "Options.Section.Rendering": "GENGIVELSE",
"Options.Section.Display": "SKÆRM", "Options.Section.Display": "SKÆRM",
"Options.RenderResolution.Label": "Intern opløsning",
"Options.RenderResolution.Desc": "Render offscreen-mål under den oprindelige opløsning, og opskaler dem ved visning. Lavere værdier bytter billedkvalitet for GPU-kapacitet; træder i kraft ved næste start.",
"Options.RenderResolution.Native": "100 % (oprindelig)",
"Options.WindowMode.Label": "Vinduestilstand", "Options.WindowMode.Label": "Vinduestilstand",
"Options.WindowMode.Desc": "Normalt vindue, kantløst skrivebord eller eksklusiv fuldskærm.", "Options.WindowMode.Desc": "Normalt vindue, kantløst skrivebord eller eksklusiv fuldskærm.",
"Options.WindowMode.Windowed": "Vindue", "Options.WindowMode.Windowed": "Vindue",
@ -200,5 +234,10 @@
"Options.VSync.Desc": "Brug FIFO-præsentation for output uden tearing.", "Options.VSync.Desc": "Brug FIFO-præsentation for output uden tearing.",
"Options.Hdr.Label": "HDR-output", "Options.Hdr.Label": "HDR-output",
"Options.Hdr.Desc": "Brug HDR, når den valgte skærm og grafik-backend understøtter det. Automatisk falder tilbage til SDR.", "Options.Hdr.Desc": "Brug HDR, når den valgte skærm og grafik-backend understøtter det. Automatisk falder tilbage til SDR.",
"Options.Hdr.Auto": "Automatisk" "Options.Hdr.Auto": "Automatisk",
"Options.Env.BinkPlayback.Label": "Bink-videoafspilning",
"Options.Env.BinkPlayback.Desc": "Host afspiller Bink-videoer via FFmpeg-broen, men nogle spil kan opleve problemer.\nGuest bruger spilmotorens egen dekoder.\nSkip springer Bink-videoer over, hvilket kan gøre udviklingen nemmere.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Spring over"
} }

View File

@ -0,0 +1,248 @@
{
"_languageName": "Eesti",
"Options.Env.StrictCompute.Desc": "Peata arvutus- ja joonistusvarjutajate tagasilükkamisel (vaikimisi).\nLülita välja, et mõjutatud töö vahele jätta. Võimalikud on puuduvad pildid, vead või hangumine. Pärast muudatust taaskäivita mäng.",
"Options.Env.PerformanceProfile.Desc": "Logi jõudlusajad ja FPS alates järgmisest mängu käivitamisest.\nSee võib jõudlust vähendada.",
"Options.Env.PerformanceFrameTrace.Desc": "Säilita viimased 4096 esitamisintervalli ja kirjuta need sulgemisel logisse.\nVajab jõudluse profileerimist. Jälje salvestamiseks sulge mäng tavapäraselt.",
"Options.OverlayEnabled.Label": "Jõudlusnäidik",
"Options.OverlayEnabled.Desc": "Kuva jõudlusandmed. F1 lülitab näidiku selleks seansiks sisse või välja. SHARPEMU_OVERLAY=0 peidab selle käivitamisel.",
"Options.OverlayMode.Label": "Kuvarežiim",
"Options.OverlayMode.Desc": "Täielik kuvab kõik loendurid. Minimaalne ja Tiitliriba kuvavad FPS-i, CPU, GPU kasutuse ja kestuse. GPU kasutus on Windowsis protsessipõhine; mujal N/A.",
"Options.OverlayCorner.Label": "Ekraaninurk",
"Options.OverlayCorner.Desc": "Vali salvestatav nurk. F2 vahetab nurka ainult selleks seansiks. Tiitliriba näitu see ei liiguta.",
"Options.OverlayMode.Full": "Täielik",
"Options.OverlayMode.Minimal": "Minimaalne",
"Options.OverlayMode.TitleBar": "Tiitliriba (minimaalne)",
"Options.OverlayCorner.TopLeft": "Ülal vasakul",
"Options.OverlayCorner.TopRight": "Ülal paremal",
"Options.OverlayCorner.BottomRight": "All paremal",
"Options.OverlayCorner.BottomLeft": "All vasakul",
"Page.Library": "Teek",
"Page.Options": "Seaded",
"Page.GameCount.One": "1 mäng",
"Page.GameCount.Other": "{0} mängu",
"Library.SearchWatermark": "Otsi teegist…",
"Library.AddFolder": "Lisa kaust",
"Library.OpenFile": "Ava fail…",
"Library.View.Grid": "Ruudustikvaade",
"Library.View.Carousel": "Karussellvaade",
"Library.Context.Launch": "Käivita",
"Library.Context.OpenFolder": "Ava mängukaust",
"Library.Context.CopyPath": "Kopeeri tee",
"Library.Context.CopyTitleId": "Kopeeri Title ID",
"Library.Context.GameSettings": "Mängu seaded…",
"Library.Context.Remove": "Eemalda teegist",
"Library.Empty.Title": "Sinu teek on tühi",
"Library.Empty.Hint": "Alustamiseks lisa kaust, kus sinu mängud asuvad.",
"Library.Empty.SearchTitle": "Otsingule ei vasta ükski mäng",
"Library.Empty.SearchHint": "Ükski teegis olev mäng ei vasta otsingule “{0}”.",
"Library.Empty.AddFolder": "+ Lisa mängukaust",
"Library.Loading": "Teeki laaditakse…",
"Library.Stat.Version": "Versioon",
"Library.Stat.Installed": "Paigaldatud",
"Library.Stat.TitleId": "Title ID",
"Common.Back": "Tagasi",
"Options.General": "Üldine",
"Options.Logging": "Logimine",
"Options.Env.Tab": "Keskkond",
"Options.Section.Environment": "KESKKONNAMUUTUJAD",
"Options.Env.Desc": "Lülitid, mis edastatakse emulaatorile käivitamisel keskkonnamuutujatena.",
"Options.Env.Bthid.Desc": "Märgi Bluetooth HID kättesaamatuks mängude puhul, mille rooli/FFB-vahetarkvara küsib andmeid lõputult.\nTavaliselt jäta välja lülitatuks. Mõni mäng hangub, kui initsialiseerimine ebaõnnestub.",
"Options.Env.LoopGuard.Desc": "Ära sulge sundkorras mänge, mis kordavad sama kutset liiga kaua.\nProovi seda, kui mäng laadimise ajal iseenesest sulgub.",
"Options.Env.WritableApp0.Desc": "Luba mängudel luua ja kirjutada faile oma paigalduskausta.\nVajalik pakendamata koopiatele, mis salvestavad oma andmed või seadistused kausta /app0.",
"Options.Env.VkValidation.Desc": "Luba Vulkani valideerimiskihid GPU silumiseks.\nAeglane. Nõuab paigaldatud Vulkan SDK-d.",
"Options.Env.DumpSpirv.Desc": "Salvesta AGC-shaderid ja nende SPIR-V tõlked kausta shader-dumps.\nKasuta shaderi- või kuvamisvea teatamisel.",
"Options.Env.LogDirectMemory.Desc": "Logi konsooli otsese mälu eraldamised ja tõrked.\nKasuta siis, kui mäng katkeb või sulgub käivitamise ajal.",
"Options.Env.LogIo.Desc": "Logi konsooli failide avamise, lugemise ja tee lahendamise tegevused.\nKasuta siis, kui mäng ei leia käivitamisel oma andmefaile.",
"Options.Env.LogNp.Desc": "Logi konsooli NP (PlayStation Network) teegi kutsed.",
"Options.Env.Group.Debug": "Silumine",
"Options.Env.Group.General": "Üldine",
"Options.Env.RenderDoc.Desc": "Laadib RenderDoc'i rakendusesisese API, et kaadreid saaks hõivata otse emulaatorist.\nVajuta mängu käigus F12 ühe kaadri hõivamiseks; hõivatised salvestatakse kausta user/logs/capture_logs/<TITLE_ID>.\nNõuab paigaldatud RenderDoc'i. Aeglustab GPU-d ja põhjustab mõningate mängude hangumist, seega hoia välja lülitatuna, kui sa ei silu.",
"Options.Env.DisableVkImplicitLayers.Desc": "Kui RenderDoc on lubatud, võivad teised konfliktis overlay'd põhjustada device loss'i. Selle valiku lubamine võib probleemi lahendada.",
"Options.DefaultProfile.Label": "Vaikimisi profiili nimi",
"Options.DefaultProfile.Desc": "Nimi, mida kasutatakse, kui mäng küsib tekstisisestust. Vaikimisi Sharp.",
"Options.Section.Emulation": "EMULATSIOON",
"Options.Section.Logging": "LOGIMINE",
"Options.Section.Launcher": "KÄIVITI",
"Options.Section.Rendering": "RENDERDAMINE",
"Options.Section.Display": "KUVA",
"Options.Graphics": "Graafika",
"Options.Console.Type.Label": "Konsool",
"Options.Console.Type.Desc": "Mängudele teatatud konsoolimudel.",
"Options.Console.Language.Label": "Konsooli keel",
"Options.Console.Language.Desc": "Mängudele teatatud süsteemikeel.",
"Options.WindowMode.Label": "Aknarežiim",
"Options.WindowMode.Desc": "Tavaline aken, äärteta töölauavaade või eksklusiivne täisekraan.",
"Options.WindowMode.Windowed": "Aken",
"Options.WindowMode.Borderless": "Äärteta",
"Options.WindowMode.Exclusive": "Eksklusiivne",
"Options.Resolution.Label": "Eraldusvõime",
"Options.Resolution.Desc": "Algne akna suurus või eksklusiivse täisekraani eraldusvõime.",
"Options.Display.Label": "Kuvar",
"Options.Display.Desc": "Monitor, mida kasutatakse tsentreerimiseks ja täisekraanrežiimiks.",
"Options.RefreshRate.Label": "Värskendussagedus",
"Options.RefreshRate.Desc": "Eksklusiivse täisekraani värskendussagedus. Automaatne valib lähima režiimi.",
"Options.RefreshRate.Automatic": "Automaatne",
"Options.Scaling.Label": "Skaleerimine",
"Options.Scaling.Desc": "Skaleeri algset mängupilti muutmata selle sisemist eraldusvõimet.",
"Options.Scaling.Fit": "Mahuta",
"Options.Scaling.Cover": "Kata",
"Options.Scaling.Stretch": "Venita",
"Options.Scaling.Integer": "Täisarvuline",
"Options.VSync.Label": "VSync",
"Options.VSync.Desc": "Kasuta FIFO-esitust pildi rebimise vältimiseks.",
"Options.Hdr.Label": "HDR-väljund",
"Options.Hdr.Desc": "Kasuta HDR-i, kui valitud kuvar ja graafikaliides seda toetavad. Automaatrežiim lülitub tagasi SDR-ile.",
"Options.Hdr.Auto": "Automaatne",
"Options.Env.BinkPlayback.Label": "Bink-video taasesitus",
"Options.Env.BinkPlayback.Desc": "Host esitab Bink-videoid FFmpegi silla kaudu, kuid mõnes mängus võib esineda probleeme.\nGuest kasutab mängumootori enda dekoodrit.\nSkip jätab Bink-videod vahele, mis võib arendust lihtsustada.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Jäta vahele",
"Options.CpuEngine.Label": "CPU-mootor",
"Options.CpuEngine.Desc": "Käitusmootor, mida kasutatakse mängukoodi käivitamiseks.",
"Options.CpuEngine.Native": "Natiivne",
"Options.Strict.Label": "Range dynlib-lahendamine",
"Options.Strict.Desc": "Katkesta käivitamine, kui imporditud sümbolit ei õnnestu lahendada.",
"Options.LogLevel.Label": "Logimise tase",
"Options.LogLevel.Desc": "Emulaatori konsooliväljundi üksikasjalikkus.",
"Options.LogLevel.Trace": "Trace (Jälitus)",
"Options.LogLevel.Debug": "Debug (Silumine)",
"Options.LogLevel.Info": "Info",
"Options.LogLevel.Warning": "Hoiatus",
"Options.LogLevel.Error": "Viga",
"Options.LogLevel.Critical": "Kriitiline",
"Options.TraceImports.Label": "Impordi jälituse piir",
"Options.TraceImports.Desc": "Jälita iga mooduli esimesi N importi (0 = väljas).",
"Options.CrashDump.Label": "Krahhitõmmised",
"Options.CrashDump.Desc": "Salvesta krahhitõmmised käivituslogi kõrvale (ainult Windows x64). Failid võivad olla suured ja sisaldada privaatseid andmeid.",
"Options.LogToFile.Label": "Logi faili",
"Options.LogToFile.Desc": "Kopeeri emulaatori väljund logifaili.",
"Options.LogFilePath.Label": "Logifaili tee",
"Options.LogFilePath.Default": "Kohandatud tee puudub — logid salvestatakse emulaatori kõrvale kausta user/logs.",
"Options.LogFilePath.Select": "Vali…",
"Options.OverrideLogFile.Label": "Kirjuta logifail üle",
"Options.OverrideLogFile.Desc": "Kasuta täpset failiteed selle asemel, et lisada Title ID ja ajatempel.",
"Options.TitleMusic.Label": "Mängu muusika",
"Options.TitleMusic.Desc": "Esita valitud mängu eelvaatemuusikat teegis korduvalt.",
"Options.Discord.Label": "Discordi olek",
"Options.Discord.Desc": "Näita käimasolevat mängu oma Discordi profiilis.",
"Options.Language.Label": "Emulaatori keel",
"Options.Language.Desc": "Käivitis kasutatav keel. Rakendub kohe.",
"Common.On": "Sisse",
"Common.Off": "Välja",
"Common.Save": "Salvesta",
"Common.Cancel": "Tühista",
"Console.Title": "KONSOOL",
"Console.SearchWatermark": "Otsi…",
"Console.AutoScroll": "Automaatne kerimine",
"Console.Split": "Poolita",
"Console.Copy": "Kopeeri",
"Console.Clear": "Tühjenda",
"Console.WindowTitle": "SharpEmu konsool",
"Launch.NoGameSelected": "Mäng pole valitud",
"Launch.NoGameHint": "Vali mäng teegist või ava eboot.bin fail otse.",
"Launch.Idle": "Ootel",
"Launch.Console": "≡ Konsool",
"Launch.Launch": "▶ Käivita",
"Launch.CustomEnv": "Käivita kohandatud keskkonnamuutujatega",
"Launch.CustomEnv.Title": "Käivita kohandatud keskkonnamuutujatega",
"Launch.CustomEnv.Desc": "Sisesta üks keskkonnamuutuja rea kohta kujul NIMI=VÄÄRTUS. Kohandatud väärtused alistavad sama nimega GUI ja mängupõhised seaded.",
"Launch.CustomEnv.Documentation": "Vaata dokumenteerimata keskkonnamuutujaid ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_NAIDE=1",
"Launch.CustomEnv.SaveGame": "Salvesta mängule",
"Launch.CustomEnv.SaveGlobal": "Salvesta globaalselt",
"Launch.CustomEnv.Play": "Mängi",
"Launch.CustomEnv.Invalid": "Vigane keskkonnamuutuja: {0}",
"Launch.CustomEnv.SavedGame": "Selle mängu jaoks salvestatud.",
"Launch.CustomEnv.SavedGlobal": "Globaalselt salvestatud.",
"Launch.Stop": "■ Peata",
"Launch.Running": "Käib — {0}",
"Launch.Stopping": "Peatamine…",
"Launch.Exited": "Väljus koodiga {0} ({1})",
"Launch.ExeNotFound": "SharpEmu käivitavat faili ei leitud. Ehita esmalt SharpEmu.CLI projekt (dotnet build).",
"Launch.LogFile": "Logifail: {0}",
"Launch.Command": "$ SharpEmu {0}",
"Launch.StartFailed": "Emulaatori käivitamine nurjus: {0}",
"Launch.ProcessExited": "Protsess väljus koodiga {0} ({1}).",
"Exit.Ok": "OK",
"Exit.InvalidArguments": "vigased argumendid",
"Exit.EbootNotFound": "eboot-faili ei leitud",
"Exit.RuntimeException": "käitusaegne erand",
"Exit.EmulationError": "emulatsioonitõrge",
"Exit.Unknown": "tundmatu",
"Status.EmulatorLocating": "Emulaator: otsimine…",
"Status.EmulatorPath": "Emulaator: {0}",
"Status.EmulatorNotFound": "Emulaator: SharpEmu käivitavat faili ei leitud — ehita esmalt SharpEmu.CLI.",
"Status.ScanningLibrary": "Teegi skaneerimine…",
"Status.AddFolderPrompt": "Lisa mängukaust teegi täitmiseks.",
"Status.LibraryScanned": "Teek skaneeritud: {0} mängu {1} kaustas.",
"Status.CouldNotOpenFolder": "Kausta ei saanud avada: {0}",
"Status.CopiedToClipboard": "{0} kopeeritud lõikelauale.",
"Status.RemovedFromLibrary": "Eemaldati “{0}” teegist. Taastamiseks lisa selle kaust uuesti.",
"Status.Running": "Käib: {0}",
"Status.Stopping": "Peatamine…",
"Status.Idle": "Ootel",
"Clipboard.Path": "Asukoht",
"Clipboard.TitleId": "Title ID",
"Discord.Playing": "Mängib: {0}",
"Discord.Browsing": "Sirvib teeki",
"Dialog.ChooseGameFolder": "Vali mänge sisaldav kaust",
"Dialog.OpenExecutable": "Ava käivitatav fail käivitamiseks",
"Dialog.PsExecutables": "PS käivitusfailid",
"Dialog.SaveLogFile": "Vali logifaili salvestamiskoht",
"Dialog.PlainTextFiles": "Tavatekstifailid",
"Dialog.LogFiles": "Logifailid",
"Options.About": "Teave",
"About.Github.Label": "GitHub",
"About.Github.Desc": "Lähtekood, vearaportid ja projekti arendus.",
"About.Github.LatestCommitLabel": "Viimane muudatus (commit)",
"About.Github.LatestCommitDescription": "Viimane muudatus peaharul",
"About.Discord.Label": "Discord",
"About.Discord.Desc": "Liitu kogukonnaga, saa tuge ja jälgi arendust.",
"About.GithubButton": "Löö GitHubis kaasa!",
"About.DiscordButton": "Liitu meie Discordiga!",
"Updater.Auto.Label": "Kontrolli värskendusi käivitamisel",
"Updater.Auto.Desc": "Kontrollib GitHubist värskendusi käivitamist viivitamata.",
"Updater.Label": "Värskendused",
"Updater.Check": "Kontrolli värskendusi",
"Updater.DownloadRestart": "Laadi alla ja taaskäivita",
"Updater.Status.Ready": "Praegune versioon: {0}",
"Updater.Status.Checking": "Värskenduste kontrollimine…",
"Updater.Status.Current": "Sinu versioon on ajakohane ({0}).",
"Updater.Status.Available": "Uus versioon on saadaval: {0}",
"Updater.Status.Downloading": "Värskenduse allalaadimine… {0}%",
"Updater.Status.Installing": "Värskenduse paigaldamine…",
"Updater.Status.Timeout": "Värskenduste kontroll aegus 10 sekundi järel.",
"Updater.Status.Failed": "Värskendusi ei saanud kontrollida.",
"Updater.Status.ChecksumFailed": "Allalaaditud värskendus ei läbinud SHA-256 kontrolli.",
"Updater.Status.Unsupported": "Automaatne värskendamine nõuab Windowsi, Linuxi või macOS-i x64 versiooni."
}

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "English", "_languageName": "English",
"Options.Env.StrictCompute.Desc": "Stop on shader rejection checks for compute and draws (default).\nTurn off to skip affected work. Missing images, errors, or stalls can occur. Restart the game after a change.",
"Options.Env.PerformanceProfile.Desc": "Log performance timings and FPS from the next game launch.\nThis can reduce performance.",
"Options.Env.PerformanceFrameTrace.Desc": "Keep the last 4,096 presentation intervals and write them to the log at shutdown.\nRequires performance profiling. Close the game normally to save the trace.",
"Options.OverlayEnabled.Label": "Performance display",
"Options.OverlayEnabled.Desc": "Show performance statistics. F1 toggles the display for this run. SHARPEMU_OVERLAY=0 starts it hidden.",
"Options.OverlayMode.Label": "Display mode",
"Options.OverlayMode.Desc": "Full shows all counters. Minimal and Title bar show FPS, CPU, GPU usage, and elapsed time. GPU usage is per-process on Windows; otherwise N/A.",
"Options.OverlayCorner.Label": "Screen corner",
"Options.OverlayCorner.Desc": "Select the saved corner. F2 cycles corners for this run only. This does not move title-bar statistics.",
"Options.OverlayMode.Full": "Full",
"Options.OverlayMode.Minimal": "Minimal",
"Options.OverlayMode.TitleBar": "Title bar (minimal)",
"Options.OverlayCorner.TopLeft": "Top left",
"Options.OverlayCorner.TopRight": "Top right",
"Options.OverlayCorner.BottomRight": "Bottom right",
"Options.OverlayCorner.BottomLeft": "Bottom left",
"Page.Library": "Library", "Page.Library": "Library",
"Page.Options": "Options", "Page.Options": "Options",
@ -44,7 +60,10 @@
"Options.Env.LogDirectMemory.Desc": "Log direct memory allocations and failures to the console.\nUse when a game aborts or exits during boot.", "Options.Env.LogDirectMemory.Desc": "Log direct memory allocations and failures to the console.\nUse when a game aborts or exits during boot.",
"Options.Env.LogIo.Desc": "Log file open, read, and path-resolve activity to the console.\nUse when a game cannot find its data files during boot.", "Options.Env.LogIo.Desc": "Log file open, read, and path-resolve activity to the console.\nUse when a game cannot find its data files during boot.",
"Options.Env.LogNp.Desc": "Log NP (PlayStation Network) library calls to the console.", "Options.Env.LogNp.Desc": "Log NP (PlayStation Network) library calls to the console.",
"Options.Env.GuestImageCpuSync.Desc": "Re-upload guest surfaces the game's own CPU code rewrites.\nLeave off normally. Turn on for titles whose CPU-drawn surfaces never reach the screen.\nCosts performance and regresses some titles, such as GTA V.", "Options.Env.Group.Debug": "Debug",
"Options.Env.Group.General": "General",
"Options.Env.RenderDoc.Desc": "Load the RenderDoc in-application API so frames can be captured from inside the emulator.\nPress F12 while the game runs to capture one frame; captures land in user/logs/capture_logs/<TITLE_ID>.\nRequires RenderDoc to be installed. Slows the GPU down and hangs some titles, so leave it off unless you are debugging.",
"Options.Env.DisableVkImplicitLayers.Desc": "When RenderDoc is enabled, other conflicting overlays can cause device loss. Enabling this option may fix it.",
"Options.DefaultProfile.Label": "Default profile name", "Options.DefaultProfile.Label": "Default profile name",
"Options.DefaultProfile.Desc": "Name used when a game asks for text input. Defaults to Sharp.", "Options.DefaultProfile.Desc": "Name used when a game asks for text input. Defaults to Sharp.",
"Options.Section.Emulation": "EMULATION", "Options.Section.Emulation": "EMULATION",
@ -54,9 +73,11 @@
"Options.Section.Display": "DISPLAY", "Options.Section.Display": "DISPLAY",
"Options.Graphics": "Graphics", "Options.Graphics": "Graphics",
"Options.RenderResolution.Label": "Internal resolution", "Options.Console.Type.Label": "Console",
"Options.RenderResolution.Desc": "Render offscreen targets below native resolution and upscale on present. Lower values trade image quality for GPU headroom; takes effect on next launch.", "Options.Console.Type.Desc": "Console model exposed to games.",
"Options.RenderResolution.Native": "100% (native)", "Options.Console.Language.Label": "Console language",
"Options.Console.Language.Desc": "System language reported to games.",
"Options.WindowMode.Label": "Window mode", "Options.WindowMode.Label": "Window mode",
"Options.WindowMode.Desc": "Regular window, desktop borderless, or exclusive fullscreen.", "Options.WindowMode.Desc": "Regular window, desktop borderless, or exclusive fullscreen.",
"Options.WindowMode.Windowed": "Windowed", "Options.WindowMode.Windowed": "Windowed",
@ -80,6 +101,11 @@
"Options.Hdr.Label": "HDR output", "Options.Hdr.Label": "HDR output",
"Options.Hdr.Desc": "Use HDR when the selected display and graphics backend support it. Auto falls back to SDR.", "Options.Hdr.Desc": "Use HDR when the selected display and graphics backend support it. Auto falls back to SDR.",
"Options.Hdr.Auto": "Auto", "Options.Hdr.Auto": "Auto",
"Options.Env.BinkPlayback.Label": "Bink video playback",
"Options.Env.BinkPlayback.Desc": "Host plays Bink videos through the FFmpeg bridge, but some games may have issues.\nGuest uses the game engine's own decoder.\nSkip skips Bink videos, which can make development easier.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Skip",
"Options.CpuEngine.Label": "CPU engine", "Options.CpuEngine.Label": "CPU engine",
"Options.CpuEngine.Desc": "Execution engine used to run game code.", "Options.CpuEngine.Desc": "Execution engine used to run game code.",
@ -100,6 +126,8 @@
"Options.TraceImports.Label": "Import trace limit", "Options.TraceImports.Label": "Import trace limit",
"Options.TraceImports.Desc": "Trace the first N imports per module (0 = off).", "Options.TraceImports.Desc": "Trace the first N imports per module (0 = off).",
"Options.CrashDump.Label": "Crash dumps",
"Options.CrashDump.Desc": "Save crash dumps beside the run log (Windows x64 only). Dumps can be large and contain private data.",
"Options.LogToFile.Label": "Log to file", "Options.LogToFile.Label": "Log to file",
"Options.LogToFile.Desc": "Mirror emulator output to a log file.", "Options.LogToFile.Desc": "Mirror emulator output to a log file.",
@ -138,6 +166,17 @@
"Launch.Idle": "Idle", "Launch.Idle": "Idle",
"Launch.Console": "≡ Console", "Launch.Console": "≡ Console",
"Launch.Launch": "▶ Launch", "Launch.Launch": "▶ Launch",
"Launch.CustomEnv": "Launch with custom env",
"Launch.CustomEnv.Title": "Launch with custom env",
"Launch.CustomEnv.Desc": "Enter environment variables one per line as NAME=VALUE. Custom values override matching GUI and per-game environment settings.",
"Launch.CustomEnv.Documentation": "View undocumented environment variables ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_EXAMPLE=1",
"Launch.CustomEnv.SaveGame": "Save for game",
"Launch.CustomEnv.SaveGlobal": "Save globally",
"Launch.CustomEnv.Play": "Play",
"Launch.CustomEnv.Invalid": "Invalid environment variable: {0}",
"Launch.CustomEnv.SavedGame": "Saved for this game.",
"Launch.CustomEnv.SavedGlobal": "Saved globally.",
"Launch.Stop": "■ Stop", "Launch.Stop": "■ Stop",
"Launch.Running": "Running — {0}", "Launch.Running": "Running — {0}",
"Launch.Stopping": "Stopping…", "Launch.Stopping": "Stopping…",
@ -189,7 +228,7 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "Join the community, get support and follow development.", "About.Discord.Desc": "Join the community, get support and follow development.",
"About.GithubButton": "Contribute in GitHub!", "About.GithubButton": "Contribute in GitHub!",
"About.DiscordComingSoon": "Coming soon", "About.DiscordButton": "Join our Discord!",
"Updater.Auto.Label": "Check for updates on startup", "Updater.Auto.Label": "Check for updates on startup",
"Updater.Auto.Desc": "Checks GitHub without delaying startup.", "Updater.Auto.Desc": "Checks GitHub without delaying startup.",

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "Español", "_languageName": "Español",
"Options.Env.StrictCompute.Desc": "Detener ante rechazos de shaders de cálculo y dibujo (predeterminado).\nDesactivar para omitir el trabajo afectado. Puede haber imágenes ausentes, errores o bloqueos. Reinicia el juego tras un cambio.",
"Options.Env.PerformanceProfile.Desc": "Registra tiempos de rendimiento y FPS desde el próximo inicio del juego.\nEsto puede reducir el rendimiento.",
"Options.Env.PerformanceFrameTrace.Desc": "Conserva los últimos 4096 intervalos de presentación y escríbelos en el registro al salir.\nRequiere el perfil de rendimiento. Cierra el juego normalmente para guardar la traza.",
"Options.OverlayEnabled.Label": "Indicador de rendimiento",
"Options.OverlayEnabled.Desc": "Mostrar estadísticas. F1 activa o desactiva el indicador durante esta sesión. SHARPEMU_OVERLAY=0 lo oculta al iniciar.",
"Options.OverlayMode.Label": "Modo del indicador",
"Options.OverlayMode.Desc": "Completo muestra todos los contadores. Mínimo y Barra de título muestran FPS, CPU, uso de GPU y tiempo. La GPU se mide por proceso en Windows; en otros sistemas, N/A.",
"Options.OverlayCorner.Label": "Esquina de pantalla",
"Options.OverlayCorner.Desc": "Elegir la esquina guardada. F2 cambia de esquina solo en esta sesión. No mueve las estadísticas de la barra de título.",
"Options.OverlayMode.Full": "Completo",
"Options.OverlayMode.Minimal": "Mínimo",
"Options.OverlayMode.TitleBar": "Barra de título (mínimo)",
"Options.OverlayCorner.TopLeft": "Superior izquierda",
"Options.OverlayCorner.TopRight": "Superior derecha",
"Options.OverlayCorner.BottomRight": "Inferior derecha",
"Options.OverlayCorner.BottomLeft": "Inferior izquierda",
"Page.Library": "Biblioteca", "Page.Library": "Biblioteca",
"Page.Options": "Opciones", "Page.Options": "Opciones",
@ -53,6 +69,8 @@
"Options.TraceImports.Label": "Límite de trazado de importaciones", "Options.TraceImports.Label": "Límite de trazado de importaciones",
"Options.TraceImports.Desc": "Trazar las primeras N importaciones por módulo (0 = off).", "Options.TraceImports.Desc": "Trazar las primeras N importaciones por módulo (0 = off).",
"Options.CrashDump.Label": "Volcados de fallos",
"Options.CrashDump.Desc": "Guarda los volcados de fallos junto al registro de ejecución (solo Windows x64). Los archivos pueden ser grandes y contener datos privados.",
"Options.LogToFile.Label": "Registrar log en archivo", "Options.LogToFile.Label": "Registrar log en archivo",
"Options.LogToFile.Desc": "Duplicar la salida del emulador en un archivo de logs.", "Options.LogToFile.Desc": "Duplicar la salida del emulador en un archivo de logs.",
@ -90,6 +108,17 @@
"Launch.Idle": "Inactivo", "Launch.Idle": "Inactivo",
"Launch.Console": "≡ Consola", "Launch.Console": "≡ Consola",
"Launch.Launch": "▶ Iniciar", "Launch.Launch": "▶ Iniciar",
"Launch.CustomEnv": "Iniciar con variables de entorno personalizadas",
"Launch.CustomEnv.Title": "Iniciar con variables de entorno personalizadas",
"Launch.CustomEnv.Desc": "Introduce una variable de entorno por línea con el formato NOMBRE=VALOR. Los valores personalizados reemplazan los ajustes de la GUI y del juego con el mismo nombre.",
"Launch.CustomEnv.Documentation": "Ver variables de entorno no documentadas ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_EJEMPLO=1",
"Launch.CustomEnv.SaveGame": "Guardar para el juego",
"Launch.CustomEnv.SaveGlobal": "Guardar globalmente",
"Launch.CustomEnv.Play": "Jugar",
"Launch.CustomEnv.Invalid": "Variable de entorno no válida: {0}",
"Launch.CustomEnv.SavedGame": "Guardado para este juego.",
"Launch.CustomEnv.SavedGlobal": "Guardado globalmente.",
"Launch.Stop": "■ Detener", "Launch.Stop": "■ Detener",
"Launch.Running": "En ejecución — {0}", "Launch.Running": "En ejecución — {0}",
"Launch.Stopping": "Deteniendo…", "Launch.Stopping": "Deteniendo…",
@ -141,7 +170,7 @@
"About.Github.LatestCommitDescription": "Último commit en la rama main", "About.Github.LatestCommitDescription": "Último commit en la rama main",
"About.Discord.Desc": "Únete a la comunidad, recibe soporte y sigue el desarrollo.", "About.Discord.Desc": "Únete a la comunidad, recibe soporte y sigue el desarrollo.",
"About.GithubButton": "Contribuye en GitHub!", "About.GithubButton": "Contribuye en GitHub!",
"About.DiscordComingSoon": "Próximamente", "About.DiscordButton": "¡Únete a nuestro Discord!",
"Library.Context.GameSettings": "Ajustes del juego…", "Library.Context.GameSettings": "Ajustes del juego…",
"Options.Env.Tab": "Entorno", "Options.Env.Tab": "Entorno",
@ -155,7 +184,10 @@
"Options.Env.LogDirectMemory.Desc": "Registrar en la consola las asignaciones de memoria directa y sus fallos.\nÚsalo cuando un juego se aborte o se cierre durante el arranque.", "Options.Env.LogDirectMemory.Desc": "Registrar en la consola las asignaciones de memoria directa y sus fallos.\nÚsalo cuando un juego se aborte o se cierre durante el arranque.",
"Options.Env.LogIo.Desc": "Registrar en la consola la apertura y lectura de archivos y la resolución de rutas.\nÚsalo cuando un juego no encuentre sus archivos de datos durante el arranque.", "Options.Env.LogIo.Desc": "Registrar en la consola la apertura y lectura de archivos y la resolución de rutas.\nÚsalo cuando un juego no encuentre sus archivos de datos durante el arranque.",
"Options.Env.LogNp.Desc": "Registrar en la consola las llamadas a la biblioteca NP (PlayStation Network).", "Options.Env.LogNp.Desc": "Registrar en la consola las llamadas a la biblioteca NP (PlayStation Network).",
"Options.Env.GuestImageCpuSync.Desc": "Volver a subir las superficies del invitado que reescribe el propio código de CPU del juego.\nDejar desactivado normalmente. Activar en títulos cuyas superficies dibujadas por CPU nunca llegan a la pantalla.\nCuesta rendimiento y causa regresiones en algunos títulos, como GTA V.", "Options.Env.Group.Debug": "Depuración",
"Options.Env.Group.General": "General",
"Options.Env.RenderDoc.Desc": "Carga la API in-application de RenderDoc para poder capturar fotogramas desde el emulador.\nPulsa F12 mientras el juego se ejecuta para capturar un fotograma; las capturas se guardan en user/logs/capture_logs/<TITLE_ID>.\nRequiere tener RenderDoc instalado. Ralentiza la GPU y bloquea algunos títulos, así que déjalo desactivado salvo que estés depurando.",
"Options.Env.DisableVkImplicitLayers.Desc": "Cuando RenderDoc está activado, otros overlays en conflicto pueden provocar una pérdida del dispositivo. Activar esta opción puede solucionar el problema.",
"Common.Save": "Guardar", "Common.Save": "Guardar",
"Common.Cancel": "Cancelar", "Common.Cancel": "Cancelar",
"Updater.Auto.Label": "Buscar actualizaciones al iniciar", "Updater.Auto.Label": "Buscar actualizaciones al iniciar",
@ -174,11 +206,13 @@
"Updater.Status.ChecksumFailed": "La actualización descargada no superó la verificación SHA-256.", "Updater.Status.ChecksumFailed": "La actualización descargada no superó la verificación SHA-256.",
"Updater.Status.Unsupported": "La actualización automática requiere un build x64 de Windows, Linux o macOS.", "Updater.Status.Unsupported": "La actualización automática requiere un build x64 de Windows, Linux o macOS.",
"Options.Graphics": "Gráficos", "Options.Graphics": "Gráficos",
"Options.Console.Type.Label": "Consola",
"Options.Console.Type.Desc": "Modelo de consola que se comunica a los juegos.",
"Options.Console.Language.Label": "Idioma de la consola",
"Options.Console.Language.Desc": "Idioma del sistema que se comunica a los juegos.",
"Options.Section.Rendering": "RENDERIZADO", "Options.Section.Rendering": "RENDERIZADO",
"Options.Section.Display": "PANTALLA", "Options.Section.Display": "PANTALLA",
"Options.RenderResolution.Label": "Resolución interna",
"Options.RenderResolution.Desc": "Renderiza objetivos fuera de pantalla por debajo de la resolución nativa y los reescala al presentar. Los valores inferiores sacrifican calidad de imagen para liberar carga de la GPU; se aplica en el próximo inicio.",
"Options.RenderResolution.Native": "100 % (nativa)",
"Options.WindowMode.Label": "Modo de ventana", "Options.WindowMode.Label": "Modo de ventana",
"Options.WindowMode.Desc": "Ventana normal, escritorio sin bordes o pantalla completa exclusiva.", "Options.WindowMode.Desc": "Ventana normal, escritorio sin bordes o pantalla completa exclusiva.",
"Options.WindowMode.Windowed": "En ventana", "Options.WindowMode.Windowed": "En ventana",
@ -201,5 +235,10 @@
"Options.VSync.Desc": "Usa presentación FIFO para evitar el desgarro de imagen.", "Options.VSync.Desc": "Usa presentación FIFO para evitar el desgarro de imagen.",
"Options.Hdr.Label": "Salida HDR", "Options.Hdr.Label": "Salida HDR",
"Options.Hdr.Desc": "Usa HDR cuando la pantalla seleccionada y el backend gráfico sean compatibles. El modo automático vuelve a SDR.", "Options.Hdr.Desc": "Usa HDR cuando la pantalla seleccionada y el backend gráfico sean compatibles. El modo automático vuelve a SDR.",
"Options.Hdr.Auto": "Automático" "Options.Hdr.Auto": "Automático",
"Options.Env.BinkPlayback.Label": "Reproducción de vídeo Bink",
"Options.Env.BinkPlayback.Desc": "Host reproduce los vídeos Bink mediante el puente FFmpeg, aunque algunos juegos pueden presentar problemas.\nGuest usa el decodificador propio del motor del juego.\nSkip omite los vídeos Bink, lo que puede facilitar el desarrollo.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Omitir"
} }

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "Français", "_languageName": "Français",
"Options.Env.StrictCompute.Desc": "Arrêter lors des rejets de shaders pour le calcul et le dessin (par défaut).\nDésactiver pour ignorer le travail concerné. Des images manquantes, des erreurs ou des blocages sont possibles. Redémarrer le jeu après modification.",
"Options.Env.PerformanceProfile.Desc": "Enregistrer les temps de performance et les FPS au prochain lancement du jeu.\nCela peut réduire les performances.",
"Options.Env.PerformanceFrameTrace.Desc": "Conserver les 4 096 derniers intervalles de présentation et les écrire dans le journal à la fermeture.\nNécessite le profilage des performances. Fermez le jeu normalement pour enregistrer la trace.",
"Options.OverlayEnabled.Label": "Affichage des performances",
"Options.OverlayEnabled.Desc": "Afficher les statistiques. F1 active ou masque l’affichage pour cette session. SHARPEMU_OVERLAY=0 le masque au démarrage.",
"Options.OverlayMode.Label": "Mode d’affichage",
"Options.OverlayMode.Desc": "Complet affiche tous les compteurs. Minimal et Barre de titre affichent FPS, CPU, utilisation GPU et durée. Le GPU est mesuré par processus sous Windows ; sinon N/A.",
"Options.OverlayCorner.Label": "Coin de l’écran",
"Options.OverlayCorner.Desc": "Choisir le coin enregistré. F2 change de coin pour cette session uniquement, sans déplacer les statistiques de la barre de titre.",
"Options.OverlayMode.Full": "Complet",
"Options.OverlayMode.Minimal": "Minimal",
"Options.OverlayMode.TitleBar": "Barre de titre (minimal)",
"Options.OverlayCorner.TopLeft": "En haut à gauche",
"Options.OverlayCorner.TopRight": "En haut à droite",
"Options.OverlayCorner.BottomRight": "En bas à droite",
"Options.OverlayCorner.BottomLeft": "En bas à gauche",
"Page.Library": "Bibliothèque", "Page.Library": "Bibliothèque",
"Page.Options": "Options", "Page.Options": "Options",
@ -39,7 +55,10 @@
"Options.Env.DumpSpirv.Desc": "Exporter les shaders AGC et leurs traductions SPIR-V dans le dossier shader-dumps.\nÀ utiliser pour signaler des bugs de shader ou de rendu.", "Options.Env.DumpSpirv.Desc": "Exporter les shaders AGC et leurs traductions SPIR-V dans le dossier shader-dumps.\nÀ utiliser pour signaler des bugs de shader ou de rendu.",
"Options.Env.LogDirectMemory.Desc": "Journaliser les allocations de mémoire directe et les échecs dans la console.\nÀ utiliser quand un jeu plante ou se ferme pendant le démarrage.", "Options.Env.LogDirectMemory.Desc": "Journaliser les allocations de mémoire directe et les échecs dans la console.\nÀ utiliser quand un jeu plante ou se ferme pendant le démarrage.",
"Options.Env.LogNp.Desc": "Journaliser les appels de la bibliothèque NP (PlayStation Network) dans la console.", "Options.Env.LogNp.Desc": "Journaliser les appels de la bibliothèque NP (PlayStation Network) dans la console.",
"Options.Env.GuestImageCpuSync.Desc": "Recharger les surfaces invité que le code CPU du jeu réécrit lui-même.\nLaisser désactivé normalement. Activer pour les titres dont les surfaces dessinées par le CPU n'atteignent jamais l'écran.\nCoûte des performances et provoque des régressions sur certains titres, comme GTA V.", "Options.Env.Group.Debug": "Débogage",
"Options.Env.Group.General": "Général",
"Options.Env.RenderDoc.Desc": "Charge l'API in-application de RenderDoc afin de capturer des images depuis l'émulateur.\nAppuyez sur F12 pendant le jeu pour capturer une image ; les captures sont écrites dans user/logs/capture_logs/<TITLE_ID>.\nNécessite l'installation de RenderDoc. Ralentit le GPU et bloque certains jeux : laissez cette option désactivée sauf en cas de débogage.",
"Options.Env.DisableVkImplicitLayers.Desc": "Lorsque RenderDoc est activé, d'autres overlays en conflit peuvent provoquer une perte du périphérique. Activer cette option peut corriger le problème.",
"Options.Section.Emulation": "ÉMULATION", "Options.Section.Emulation": "ÉMULATION",
"Options.Section.Logging": "JOURNALISATION", "Options.Section.Logging": "JOURNALISATION",
"Options.Section.Launcher": "LANCEUR", "Options.Section.Launcher": "LANCEUR",
@ -63,6 +82,8 @@
"Options.TraceImports.Label": "Limite de traçage des imports", "Options.TraceImports.Label": "Limite de traçage des imports",
"Options.TraceImports.Desc": "Tracer les N premiers imports de chaque module (0 = désactivé).", "Options.TraceImports.Desc": "Tracer les N premiers imports de chaque module (0 = désactivé).",
"Options.CrashDump.Label": "Fichiers de vidage après plantage",
"Options.CrashDump.Desc": "Enregistre les fichiers de vidage à côté du journal d’exécution (Windows x64 uniquement). Ces fichiers peuvent être volumineux et contenir des données privées.",
"Options.LogToFile.Label": "Enregistrer dans un fichier", "Options.LogToFile.Label": "Enregistrer dans un fichier",
"Options.LogToFile.Desc": "Copier la sortie de l’émulateur dans un fichier journal.", "Options.LogToFile.Desc": "Copier la sortie de l’émulateur dans un fichier journal.",
@ -100,6 +121,17 @@
"Launch.Idle": "Inactif", "Launch.Idle": "Inactif",
"Launch.Console": "≡ Console", "Launch.Console": "≡ Console",
"Launch.Launch": "▶ Lancer", "Launch.Launch": "▶ Lancer",
"Launch.CustomEnv": "Lancer avec des variables d'environnement personnalisées",
"Launch.CustomEnv.Title": "Lancer avec des variables d'environnement personnalisées",
"Launch.CustomEnv.Desc": "Saisissez une variable d'environnement par ligne au format NOM=VALEUR. Les valeurs personnalisées remplacent les réglages GUI et spécifiques au jeu portant le même nom.",
"Launch.CustomEnv.Documentation": "Voir les variables d'environnement non documentées ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_EXEMPLE=1",
"Launch.CustomEnv.SaveGame": "Enregistrer pour le jeu",
"Launch.CustomEnv.SaveGlobal": "Enregistrer globalement",
"Launch.CustomEnv.Play": "Jouer",
"Launch.CustomEnv.Invalid": "Variable d'environnement invalide : {0}",
"Launch.CustomEnv.SavedGame": "Enregistré pour ce jeu.",
"Launch.CustomEnv.SavedGlobal": "Enregistré globalement.",
"Launch.Stop": "■ Arrêter", "Launch.Stop": "■ Arrêter",
"Launch.Running": "En cours d’exécution — {0}", "Launch.Running": "En cours d’exécution — {0}",
"Launch.Stopping": "Arrêt en cours…", "Launch.Stopping": "Arrêt en cours…",
@ -149,7 +181,7 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "Rejoignez la communauté, obtenez de l’aide et suivez le développement.", "About.Discord.Desc": "Rejoignez la communauté, obtenez de l’aide et suivez le développement.",
"About.GithubButton": "Contribuer sur GitHub !", "About.GithubButton": "Contribuer sur GitHub !",
"About.DiscordComingSoon": "Bientôt disponible", "About.DiscordButton": "Rejoignez notre Discord !",
"Library.Context.GameSettings": "Paramètres du jeu…", "Library.Context.GameSettings": "Paramètres du jeu…",
"Options.Env.WritableApp0.Desc": "Autoriser les jeux à créer et écrire des fichiers dans leur dossier d’installation.\nNécessaire pour les dumps non empaquetés qui écrivent leurs sauvegardes ou leur configuration sous /app0.", "Options.Env.WritableApp0.Desc": "Autoriser les jeux à créer et écrire des fichiers dans leur dossier d’installation.\nNécessaire pour les dumps non empaquetés qui écrivent leurs sauvegardes ou leur configuration sous /app0.",
@ -174,11 +206,13 @@
"Updater.Status.ChecksumFailed": "La mise à jour téléchargée a échoué à la vérification SHA-256.", "Updater.Status.ChecksumFailed": "La mise à jour téléchargée a échoué à la vérification SHA-256.",
"Updater.Status.Unsupported": "La mise à jour automatique nécessite un build x64 pour Windows, Linux ou macOS.", "Updater.Status.Unsupported": "La mise à jour automatique nécessite un build x64 pour Windows, Linux ou macOS.",
"Options.Graphics": "Graphismes", "Options.Graphics": "Graphismes",
"Options.Console.Type.Label": "Console",
"Options.Console.Type.Desc": "Modèle de console signalé aux jeux.",
"Options.Console.Language.Label": "Langue de la console",
"Options.Console.Language.Desc": "Langue système signalée aux jeux.",
"Options.Section.Rendering": "RENDU", "Options.Section.Rendering": "RENDU",
"Options.Section.Display": "AFFICHAGE", "Options.Section.Display": "AFFICHAGE",
"Options.RenderResolution.Label": "Résolution interne",
"Options.RenderResolution.Desc": "Effectuer le rendu des cibles hors écran sous la résolution native et les mettre à l’échelle lors de l’affichage. Les valeurs inférieures réduisent la qualité d’image pour libérer des ressources GPU ; prend effet au prochain lancement.",
"Options.RenderResolution.Native": "100 % (native)",
"Options.WindowMode.Label": "Mode fenêtre", "Options.WindowMode.Label": "Mode fenêtre",
"Options.WindowMode.Desc": "Fenêtre standard, bureau sans bordures ou plein écran exclusif.", "Options.WindowMode.Desc": "Fenêtre standard, bureau sans bordures ou plein écran exclusif.",
"Options.WindowMode.Windowed": "Fenêtré", "Options.WindowMode.Windowed": "Fenêtré",
@ -201,5 +235,10 @@
"Options.VSync.Desc": "Utiliser la présentation FIFO pour un affichage sans déchirement.", "Options.VSync.Desc": "Utiliser la présentation FIFO pour un affichage sans déchirement.",
"Options.Hdr.Label": "Sortie HDR", "Options.Hdr.Label": "Sortie HDR",
"Options.Hdr.Desc": "Utiliser le HDR lorsque l’écran sélectionné et le backend graphique le prennent en charge. Le mode automatique revient au SDR.", "Options.Hdr.Desc": "Utiliser le HDR lorsque l’écran sélectionné et le backend graphique le prennent en charge. Le mode automatique revient au SDR.",
"Options.Hdr.Auto": "Automatique" "Options.Hdr.Auto": "Automatique",
"Options.Env.BinkPlayback.Label": "Lecture vidéo Bink",
"Options.Env.BinkPlayback.Desc": "Host lit les vidéos Bink via le pont FFmpeg, mais certains jeux peuvent rencontrer des problèmes.\nGuest utilise le décodeur propre au moteur du jeu.\nSkip ignore les vidéos Bink, ce qui peut faciliter le développement.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Ignorer"
} }

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "Hungarian", "_languageName": "Hungarian",
"Options.Env.StrictCompute.Desc": "Leállás a számítási és rajzolási shaderek elutasításakor (alapértelmezett).\nKikapcsolva az érintett munka kimarad. Hiányzó képek, hibák vagy lefagyás fordulhat elő. Módosítás után indítsd újra a játékot.",
"Options.Env.PerformanceProfile.Desc": "Teljesítményidők és FPS naplózása a játék következő indításától.\nEz csökkentheti a teljesítményt.",
"Options.Env.PerformanceFrameTrace.Desc": "Az utolsó 4096 megjelenítési intervallum megőrzése és naplóba írása kilépéskor.\nTeljesítményprofilozást igényel. A nyomkövetés mentéséhez zárd be a játékot szabályosan.",
"Options.OverlayEnabled.Label": "Teljesítménykijelzés",
"Options.OverlayEnabled.Desc": "Teljesítményadatok megjelenítése. Az F1 csak erre a futásra kapcsolja a kijelzést. SHARPEMU_OVERLAY=0 esetén rejtve indul.",
"Options.OverlayMode.Label": "Kijelzési mód",
"Options.OverlayMode.Desc": "A Teljes minden számlálót mutat. A Minimális és Címsor az FPS-t, CPU-, GPU-használatot és eltelt időt mutatja. A GPU-adat Windows alatt folyamatonkénti; máshol N/A.",
"Options.OverlayCorner.Label": "Képernyősarok",
"Options.OverlayCorner.Desc": "Válassza ki a mentett sarkot. Az F2 csak erre a futásra vált sarkot. A címsor adatait nem helyezi át.",
"Options.OverlayMode.Full": "Teljes",
"Options.OverlayMode.Minimal": "Minimális",
"Options.OverlayMode.TitleBar": "Címsor (minimális)",
"Options.OverlayCorner.TopLeft": "Bal felső",
"Options.OverlayCorner.TopRight": "Jobb felső",
"Options.OverlayCorner.BottomRight": "Jobb alsó",
"Options.OverlayCorner.BottomLeft": "Bal alsó",
"Page.Library": "Könyvtár", "Page.Library": "Könyvtár",
"Page.Options": "Beállítások", "Page.Options": "Beállítások",
@ -39,7 +55,10 @@
"Options.Env.DumpSpirv.Desc": "Az AGC-shaderek és azok SPIR-V-fordításainak mentése a shader-dumps mappába.\nHasználd shader- vagy renderelési hibák jelentésekor.", "Options.Env.DumpSpirv.Desc": "Az AGC-shaderek és azok SPIR-V-fordításainak mentése a shader-dumps mappába.\nHasználd shader- vagy renderelési hibák jelentésekor.",
"Options.Env.LogDirectMemory.Desc": "A közvetlen memóriaallokációk és hibák naplózása a konzolra.\nHasználd, ha egy játék a rendszerindítás során megszakad vagy kilép.", "Options.Env.LogDirectMemory.Desc": "A közvetlen memóriaallokációk és hibák naplózása a konzolra.\nHasználd, ha egy játék a rendszerindítás során megszakad vagy kilép.",
"Options.Env.LogNp.Desc": "Az NP (PlayStation Network) könyvtárhívásokat naplózza a konzolra.", "Options.Env.LogNp.Desc": "Az NP (PlayStation Network) könyvtárhívásokat naplózza a konzolra.",
"Options.Env.GuestImageCpuSync.Desc": "Újratölti azokat a vendégfelületeket, amelyeket a játék saját CPU-kódja ír felül.\nNormál esetben hagyd kikapcsolva. Kapcsold be azoknál a címeknél, amelyek CPU-val rajzolt felületei sosem jutnak ki a képernyőre.\nTeljesítménybe kerül, és egyes címeknél, például a GTA V-nél regressziót okoz.", "Options.Env.Group.Debug": "Hibakeresés",
"Options.Env.Group.General": "Általános",
"Options.Env.RenderDoc.Desc": "Betölti a RenderDoc alkalmazáson belüli API-ját, így képkockák rögzíthetők az emulátorból.\nNyomd meg az F12-et futó játék közben egy képkocka rögzítéséhez; a felvételek a user/logs/capture_logs/<TITLE_ID> mappába kerülnek.\nTelepített RenderDocot igényel. Lassítja a GPU-t és egyes játékokat lefagyaszt, ezért hagyd kikapcsolva, hacsak nem hibakeresel.",
"Options.Env.DisableVkImplicitLayers.Desc": "Ha a RenderDoc engedélyezve van, más ütköző overlayek device loss hibát okozhatnak. Ennek a beállításnak az engedélyezése megoldhatja a problémát.",
"Options.Section.Emulation": "EMULÁCIÓ", "Options.Section.Emulation": "EMULÁCIÓ",
"Options.Section.Logging": "LOGOLÁS", "Options.Section.Logging": "LOGOLÁS",
"Options.Section.Launcher": "INDITÓ", "Options.Section.Launcher": "INDITÓ",
@ -63,6 +82,8 @@
"Options.TraceImports.Label": "Import trace limit", "Options.TraceImports.Label": "Import trace limit",
"Options.TraceImports.Desc": "Az első N darab import nyomon követése modulonként (0 = ki).", "Options.TraceImports.Desc": "Az első N darab import nyomon követése modulonként (0 = ki).",
"Options.CrashDump.Label": "Összeomlási memóriaképek",
"Options.CrashDump.Desc": "Az összeomlási memóriaképeket a futási napló mellé menti (csak Windows x64). A fájlok nagyok lehetnek, és személyes adatokat tartalmazhatnak.",
"Options.LogToFile.Label": "Naplozás fájlba", "Options.LogToFile.Label": "Naplozás fájlba",
"Options.LogToFile.Desc": "Az emulátor kimenetének tükrözése egy log fájlba.", "Options.LogToFile.Desc": "Az emulátor kimenetének tükrözése egy log fájlba.",
@ -100,6 +121,17 @@
"Launch.Idle": "Tétlen", "Launch.Idle": "Tétlen",
"Launch.Console": "≡ Konzol", "Launch.Console": "≡ Konzol",
"Launch.Launch": "▶ Inditás", "Launch.Launch": "▶ Inditás",
"Launch.CustomEnv": "Indítás egyéni környezeti változókkal",
"Launch.CustomEnv.Title": "Indítás egyéni környezeti változókkal",
"Launch.CustomEnv.Desc": "Soronként egy környezeti változót adj meg NÉV=ÉRTÉK formában. Az egyéni értékek felülírják az azonos nevű GUI- és játékspecifikus beállításokat.",
"Launch.CustomEnv.Documentation": "Nem dokumentált környezeti változók megtekintése ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_PELDA=1",
"Launch.CustomEnv.SaveGame": "Mentés a játékhoz",
"Launch.CustomEnv.SaveGlobal": "Globális mentés",
"Launch.CustomEnv.Play": "Játék",
"Launch.CustomEnv.Invalid": "Érvénytelen környezeti változó: {0}",
"Launch.CustomEnv.SavedGame": "Mentve ehhez a játékhoz.",
"Launch.CustomEnv.SavedGlobal": "Globálisan mentve.",
"Launch.Stop": "■ Leállítás", "Launch.Stop": "■ Leállítás",
"Launch.Running": "Fut — {0}", "Launch.Running": "Fut — {0}",
"Launch.Stopping": "Leállítás…", "Launch.Stopping": "Leállítás…",
@ -149,7 +181,7 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "Csatlakozz a közösséghe, kérj segítéget és kövesd nyomon a fejlesztést.", "About.Discord.Desc": "Csatlakozz a közösséghe, kérj segítéget és kövesd nyomon a fejlesztést.",
"About.GithubButton": "Járulj hozzá GitHubon!", "About.GithubButton": "Járulj hozzá GitHubon!",
"About.DiscordComingSoon": "Hamarosan", "About.DiscordButton": "Csatlakozz a Discordunkhoz!",
"Library.Context.GameSettings": "Játékbeállítások…", "Library.Context.GameSettings": "Játékbeállítások…",
"Options.Env.WritableApp0.Desc": "Engedélyezi, hogy a játékok fájlokat hozzanak létre és írjanak a telepítési mappájukban.\nA kicsomagolt dumpokhoz szükséges, amelyek a mentéseiket vagy beállításaikat az /app0 alá írják.", "Options.Env.WritableApp0.Desc": "Engedélyezi, hogy a játékok fájlokat hozzanak létre és írjanak a telepítési mappájukban.\nA kicsomagolt dumpokhoz szükséges, amelyek a mentéseiket vagy beállításaikat az /app0 alá írják.",
@ -174,11 +206,13 @@
"Updater.Status.ChecksumFailed": "A letöltött frissítés nem ment át az SHA-256-ellenőrzésen.", "Updater.Status.ChecksumFailed": "A letöltött frissítés nem ment át az SHA-256-ellenőrzésen.",
"Updater.Status.Unsupported": "Az automatikus frissítéshez Windows, Linux vagy macOS x64 build szükséges.", "Updater.Status.Unsupported": "Az automatikus frissítéshez Windows, Linux vagy macOS x64 build szükséges.",
"Options.Graphics": "Grafika", "Options.Graphics": "Grafika",
"Options.Console.Type.Label": "Konzol",
"Options.Console.Type.Desc": "A játékoknak jelentett konzolmodell.",
"Options.Console.Language.Label": "Konzol nyelve",
"Options.Console.Language.Desc": "A játékoknak jelentett rendszer nyelve.",
"Options.Section.Rendering": "RENDERELÉS", "Options.Section.Rendering": "RENDERELÉS",
"Options.Section.Display": "KIJELZŐ", "Options.Section.Display": "KIJELZŐ",
"Options.RenderResolution.Label": "Belső felbontás",
"Options.RenderResolution.Desc": "A képernyőn kívüli célok renderelése a natívnál kisebb felbontáson, majd felskálázás megjelenítéskor. Az alacsonyabb értékek képminőséget cserélnek GPU-tartalékra; a következő indításkor lép érvénybe.",
"Options.RenderResolution.Native": "100% (natív)",
"Options.WindowMode.Label": "Ablakmód", "Options.WindowMode.Label": "Ablakmód",
"Options.WindowMode.Desc": "Normál ablak, keret nélküli asztal vagy kizárólagos teljes képernyő.", "Options.WindowMode.Desc": "Normál ablak, keret nélküli asztal vagy kizárólagos teljes képernyő.",
"Options.WindowMode.Windowed": "Ablakos", "Options.WindowMode.Windowed": "Ablakos",
@ -201,5 +235,10 @@
"Options.VSync.Desc": "FIFO megjelenítés használata képtörésmentes kimenethez.", "Options.VSync.Desc": "FIFO megjelenítés használata képtörésmentes kimenethez.",
"Options.Hdr.Label": "HDR-kimenet", "Options.Hdr.Label": "HDR-kimenet",
"Options.Hdr.Desc": "HDR használata, ha a kiválasztott kijelző és grafikus backend támogatja. Az automatikus mód SDR-re vált vissza.", "Options.Hdr.Desc": "HDR használata, ha a kiválasztott kijelző és grafikus backend támogatja. Az automatikus mód SDR-re vált vissza.",
"Options.Hdr.Auto": "Automatikus" "Options.Hdr.Auto": "Automatikus",
"Options.Env.BinkPlayback.Label": "Bink videólejátszás",
"Options.Env.BinkPlayback.Desc": "A Host az FFmpeg hídon keresztül játssza le a Bink videókat, de egyes játékoknál problémák jelentkezhetnek.\nA Guest a játékmotor saját dekóderét használja.\nA Skip kihagyja a Bink videókat, ami megkönnyítheti a fejlesztést.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Kihagyás"
} }

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "Italiano", "_languageName": "Italiano",
"Options.Env.StrictCompute.Desc": "Arresta in caso di rifiuto degli shader di calcolo e disegno (predefinito).\nDisattiva per saltare il lavoro interessato. Sono possibili immagini mancanti, errori o blocchi. Riavvia il gioco dopo una modifica.",
"Options.Env.PerformanceProfile.Desc": "Registra tempi di prestazione e FPS dal prossimo avvio del gioco.\nQuesto può ridurre le prestazioni.",
"Options.Env.PerformanceFrameTrace.Desc": "Conserva gli ultimi 4096 intervalli di presentazione e scrivili nel registro alla chiusura.\nRichiede la profilazione delle prestazioni. Chiudi il gioco normalmente per salvare la traccia.",
"Options.OverlayEnabled.Label": "Statistiche prestazioni",
"Options.OverlayEnabled.Desc": "Mostra le statistiche. F1 attiva o nasconde la visualizzazione per questa sessione. SHARPEMU_OVERLAY=0 la nasconde all’avvio.",
"Options.OverlayMode.Label": "Modalità di visualizzazione",
"Options.OverlayMode.Desc": "Completa mostra tutti i contatori. Minima e Barra del titolo mostrano FPS, CPU, uso GPU e tempo. La GPU è misurata per processo su Windows; altrimenti N/A.",
"Options.OverlayCorner.Label": "Angolo dello schermo",
"Options.OverlayCorner.Desc": "Scegli l’angolo salvato. F2 cambia angolo solo per questa sessione. Non sposta le statistiche nella barra del titolo.",
"Options.OverlayMode.Full": "Completa",
"Options.OverlayMode.Minimal": "Minima",
"Options.OverlayMode.TitleBar": "Barra del titolo (minima)",
"Options.OverlayCorner.TopLeft": "In alto a sinistra",
"Options.OverlayCorner.TopRight": "In alto a destra",
"Options.OverlayCorner.BottomRight": "In basso a destra",
"Options.OverlayCorner.BottomLeft": "In basso a sinistra",
"Page.Library": "Libreria", "Page.Library": "Libreria",
"Page.Options": "Opzioni", "Page.Options": "Opzioni",
@ -54,6 +70,8 @@
"Options.TraceImports.Desc": "Traccia i primi N import per modulo (0 = disattivato).", "Options.TraceImports.Desc": "Traccia i primi N import per modulo (0 = disattivato).",
"Options.CrashDump.Label": "Dump degli arresti anomali",
"Options.CrashDump.Desc": "Salva i dump accanto al registro di esecuzione (solo Windows x64). I file possono essere grandi e contenere dati privati.",
"Options.LogToFile.Label": "Salva log su file", "Options.LogToFile.Label": "Salva log su file",
"Options.LogToFile.Desc": "Duplica l'output dell'emulatore in un file di log.", "Options.LogToFile.Desc": "Duplica l'output dell'emulatore in un file di log.",
@ -93,6 +111,17 @@
"Launch.Idle": "Inattivo", "Launch.Idle": "Inattivo",
"Launch.Console": "≡ Console", "Launch.Console": "≡ Console",
"Launch.Launch": "▶ Avvia", "Launch.Launch": "▶ Avvia",
"Launch.CustomEnv": "Avvia con variabili d'ambiente personalizzate",
"Launch.CustomEnv.Title": "Avvia con variabili d'ambiente personalizzate",
"Launch.CustomEnv.Desc": "Inserisci una variabile d'ambiente per riga nel formato NOME=VALORE. I valori personalizzati sostituiscono le impostazioni GUI e specifiche del gioco con lo stesso nome.",
"Launch.CustomEnv.Documentation": "Visualizza le variabili d'ambiente non documentate ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_ESEMPIO=1",
"Launch.CustomEnv.SaveGame": "Salva per il gioco",
"Launch.CustomEnv.SaveGlobal": "Salva globalmente",
"Launch.CustomEnv.Play": "Gioca",
"Launch.CustomEnv.Invalid": "Variabile d'ambiente non valida: {0}",
"Launch.CustomEnv.SavedGame": "Salvato per questo gioco.",
"Launch.CustomEnv.SavedGlobal": "Salvato globalmente.",
"Launch.Stop": "■ Ferma", "Launch.Stop": "■ Ferma",
"Launch.Running": "In esecuzione — {0}", "Launch.Running": "In esecuzione — {0}",
"Launch.Stopping": "Arresto in corso…", "Launch.Stopping": "Arresto in corso…",
@ -150,7 +179,10 @@
"Options.Env.LogDirectMemory.Desc": "Registra in console le allocazioni di memoria diretta e i relativi errori.\nUsalo quando un gioco si interrompe o si chiude durante l'avvio.", "Options.Env.LogDirectMemory.Desc": "Registra in console le allocazioni di memoria diretta e i relativi errori.\nUsalo quando un gioco si interrompe o si chiude durante l'avvio.",
"Options.Env.LogIo.Desc": "Registra in console l'apertura e la lettura dei file e la risoluzione dei percorsi.\nUsalo quando un gioco non trova i propri file di dati durante l'avvio.", "Options.Env.LogIo.Desc": "Registra in console l'apertura e la lettura dei file e la risoluzione dei percorsi.\nUsalo quando un gioco non trova i propri file di dati durante l'avvio.",
"Options.Env.LogNp.Desc": "Registra in console le chiamate alla libreria NP (PlayStation Network).", "Options.Env.LogNp.Desc": "Registra in console le chiamate alla libreria NP (PlayStation Network).",
"Options.Env.GuestImageCpuSync.Desc": "Ricarica le superfici guest riscritte dal codice CPU del gioco.\nLasciare disattivato normalmente. Attivare per i titoli le cui superfici disegnate dalla CPU non raggiungono mai lo schermo.\nCosta prestazioni e causa regressioni in alcuni titoli, come GTA V.", "Options.Env.Group.Debug": "Debug",
"Options.Env.Group.General": "Generale",
"Options.Env.RenderDoc.Desc": "Carica l'API in-application di RenderDoc per catturare i frame dall'interno dell'emulatore.\nPremi F12 mentre il gioco è in esecuzione per catturare un frame; le catture finiscono in user/logs/capture_logs/<TITLE_ID>.\nRichiede RenderDoc installato. Rallenta la GPU e blocca alcuni titoli, quindi lascialo disattivato se non stai facendo debug.",
"Options.Env.DisableVkImplicitLayers.Desc": "Quando RenderDoc è attivo, altri overlay in conflitto possono causare una perdita del dispositivo. Abilitare questa opzione può risolvere il problema.",
"Common.Save": "Salva", "Common.Save": "Salva",
"Common.Cancel": "Annulla", "Common.Cancel": "Annulla",
"Options.About": "Informazioni", "Options.About": "Informazioni",
@ -161,7 +193,7 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "Unisciti alla community, ricevi supporto e segui lo sviluppo.", "About.Discord.Desc": "Unisciti alla community, ricevi supporto e segui lo sviluppo.",
"About.GithubButton": "Contribuisci su GitHub!", "About.GithubButton": "Contribuisci su GitHub!",
"About.DiscordComingSoon": "Prossimamente", "About.DiscordButton": "Unisciti al nostro Discord!",
"Updater.Auto.Label": "Controlla aggiornamenti all'avvio", "Updater.Auto.Label": "Controlla aggiornamenti all'avvio",
"Updater.Auto.Desc": "Interroga GitHub senza rallentare l'avvio.", "Updater.Auto.Desc": "Interroga GitHub senza rallentare l'avvio.",
"Updater.Label": "Aggiornamenti", "Updater.Label": "Aggiornamenti",
@ -178,11 +210,13 @@
"Updater.Status.ChecksumFailed": "L'aggiornamento scaricato non ha superato la verifica SHA-256.", "Updater.Status.ChecksumFailed": "L'aggiornamento scaricato non ha superato la verifica SHA-256.",
"Updater.Status.Unsupported": "L'aggiornamento automatico richiede un build x64 per Windows, Linux o macOS.", "Updater.Status.Unsupported": "L'aggiornamento automatico richiede un build x64 per Windows, Linux o macOS.",
"Options.Graphics": "Grafica", "Options.Graphics": "Grafica",
"Options.Console.Type.Label": "Console",
"Options.Console.Type.Desc": "Modello di console comunicato ai giochi.",
"Options.Console.Language.Label": "Lingua della console",
"Options.Console.Language.Desc": "Lingua di sistema comunicata ai giochi.",
"Options.Section.Rendering": "RENDERING", "Options.Section.Rendering": "RENDERING",
"Options.Section.Display": "SCHERMO", "Options.Section.Display": "SCHERMO",
"Options.RenderResolution.Label": "Risoluzione interna",
"Options.RenderResolution.Desc": "Renderizza i target fuori schermo sotto la risoluzione nativa e li ridimensiona in fase di presentazione. Valori inferiori sacrificano la qualità dell'immagine per lasciare margine alla GPU; ha effetto al prossimo avvio.",
"Options.RenderResolution.Native": "100% (nativa)",
"Options.WindowMode.Label": "Modalità finestra", "Options.WindowMode.Label": "Modalità finestra",
"Options.WindowMode.Desc": "Finestra normale, desktop senza bordi o schermo intero esclusivo.", "Options.WindowMode.Desc": "Finestra normale, desktop senza bordi o schermo intero esclusivo.",
"Options.WindowMode.Windowed": "In finestra", "Options.WindowMode.Windowed": "In finestra",
@ -205,5 +239,10 @@
"Options.VSync.Desc": "Usa la presentazione FIFO per evitare lo screen tearing.", "Options.VSync.Desc": "Usa la presentazione FIFO per evitare lo screen tearing.",
"Options.Hdr.Label": "Output HDR", "Options.Hdr.Label": "Output HDR",
"Options.Hdr.Desc": "Usa HDR quando lo schermo selezionato e il backend grafico lo supportano. La modalità automatica torna a SDR.", "Options.Hdr.Desc": "Usa HDR quando lo schermo selezionato e il backend grafico lo supportano. La modalità automatica torna a SDR.",
"Options.Hdr.Auto": "Automatico" "Options.Hdr.Auto": "Automatico",
"Options.Env.BinkPlayback.Label": "Riproduzione video Bink",
"Options.Env.BinkPlayback.Desc": "Host riproduce i video Bink tramite il bridge FFmpeg, ma alcuni giochi potrebbero avere problemi.\nGuest usa il decoder del motore di gioco.\nSkip salta i video Bink, facilitando lo sviluppo.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Salta"
} }

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "日本語", "_languageName": "日本語",
"Options.Env.StrictCompute.Desc": "計算と描画のシェーダー拒否時に停止します(既定)。\n無効にすると該当処理をスキップします。画像の欠落、エラー、停止が発生する場合があります。変更後はゲームを再起動してください。",
"Options.Env.PerformanceProfile.Desc": "次回のゲーム起動から処理時間とFPSを記録します。\nパフォーマンスが低下する場合があります。",
"Options.Env.PerformanceFrameTrace.Desc": "直近4,096件の表示間隔を保持し、終了時にログへ書き込みます。\nパフォーマンス計測が必要です。記録を保存するにはゲームを通常の手順で終了してください。",
"Options.OverlayEnabled.Label": "パフォーマンス表示",
"Options.OverlayEnabled.Desc": "統計を表示します。F1で今回の実行中のみ表示を切り替えます。SHARPEMU_OVERLAY=0では非表示で開始します。",
"Options.OverlayMode.Label": "表示モード",
"Options.OverlayMode.Desc": "詳細はすべてのカウンターを表示します。最小とタイトルバーはFPS、CPU、GPU使用率、経過時間を表示します。GPU使用率はWindowsのプロセス単位の値です。他の環境ではN/Aを表示します。",
"Options.OverlayCorner.Label": "画面の隅",
"Options.OverlayCorner.Desc": "保存する位置を選びます。F2は今回の実行中のみ位置を切り替えます。タイトルバーの統計は移動しません。",
"Options.OverlayMode.Full": "詳細",
"Options.OverlayMode.Minimal": "最小",
"Options.OverlayMode.TitleBar": "タイトルバー(最小)",
"Options.OverlayCorner.TopLeft": "左上",
"Options.OverlayCorner.TopRight": "右上",
"Options.OverlayCorner.BottomRight": "右下",
"Options.OverlayCorner.BottomLeft": "左下",
"Page.Library": "ライブラリ", "Page.Library": "ライブラリ",
"Page.Options": "オプション", "Page.Options": "オプション",
@ -53,6 +69,8 @@
"Options.TraceImports.Label": "インポートトレース制限", "Options.TraceImports.Label": "インポートトレース制限",
"Options.TraceImports.Desc": "各モジュールの最初のN個のインポートをトレースします(0 = 無効)。", "Options.TraceImports.Desc": "各モジュールの最初のN個のインポートをトレースします(0 = 無効)。",
"Options.CrashDump.Label": "クラッシュダンプ",
"Options.CrashDump.Desc": "実行ログと同じ場所にクラッシュダンプを保存します(Windows x64 のみ)。ダンプは大きくなることがあり、個人情報を含む場合があります。",
"Options.LogToFile.Label": "ファイルに保存", "Options.LogToFile.Label": "ファイルに保存",
"Options.LogToFile.Desc": "エミュレータの出力をログファイルにコピーします。", "Options.LogToFile.Desc": "エミュレータの出力をログファイルにコピーします。",
@ -90,6 +108,17 @@
"Launch.Idle": "待機中", "Launch.Idle": "待機中",
"Launch.Console": "≡ コンソール", "Launch.Console": "≡ コンソール",
"Launch.Launch": "▶ 起動", "Launch.Launch": "▶ 起動",
"Launch.CustomEnv": "カスタム環境変数で起動",
"Launch.CustomEnv.Title": "カスタム環境変数で起動",
"Launch.CustomEnv.Desc": "環境変数を 1 行に 1 つ、NAME=VALUE 形式で入力します。カスタム値は、同名の GUI およびゲーム固有の環境設定を上書きします。",
"Launch.CustomEnv.Documentation": "未文書化の環境変数を表示 ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_EXAMPLE=1",
"Launch.CustomEnv.SaveGame": "ゲーム用に保存",
"Launch.CustomEnv.SaveGlobal": "全体設定として保存",
"Launch.CustomEnv.Play": "プレイ",
"Launch.CustomEnv.Invalid": "無効な環境変数: {0}",
"Launch.CustomEnv.SavedGame": "このゲーム用に保存しました。",
"Launch.CustomEnv.SavedGlobal": "全体設定として保存しました。",
"Launch.Stop": "■ 停止", "Launch.Stop": "■ 停止",
"Launch.Running": "実行中 — {0}", "Launch.Running": "実行中 — {0}",
"Launch.Stopping": "停止中…", "Launch.Stopping": "停止中…",
@ -145,7 +174,10 @@
"Options.Env.LogDirectMemory.Desc": "ダイレクトメモリの割り当てと失敗をコンソールに記録します。\nゲームが起動中に中断・終了する場合に使用してください。", "Options.Env.LogDirectMemory.Desc": "ダイレクトメモリの割り当てと失敗をコンソールに記録します。\nゲームが起動中に中断・終了する場合に使用してください。",
"Options.Env.LogIo.Desc": "ファイルのオープン・読み込み・パス解決の動作をコンソールに記録します。\nゲームが起動中にデータファイルを見つけられない場合に使用してください。", "Options.Env.LogIo.Desc": "ファイルのオープン・読み込み・パス解決の動作をコンソールに記録します。\nゲームが起動中にデータファイルを見つけられない場合に使用してください。",
"Options.Env.LogNp.Desc": "NP(PlayStation Network)ライブラリの呼び出しをコンソールに記録します。", "Options.Env.LogNp.Desc": "NP(PlayStation Network)ライブラリの呼び出しをコンソールに記録します。",
"Options.Env.GuestImageCpuSync.Desc": "ゲーム自身の CPU コードが書き換えるゲスト表面を再アップロードします。\n通常はオフのままにしてください。CPU で描画した表面が画面に反映されないタイトルで有効にします。\n性能を犠牲にし、GTA V など一部のタイトルでは不具合が生じます。", "Options.Env.Group.Debug": "デバッグ",
"Options.Env.Group.General": "一般",
"Options.Env.RenderDoc.Desc": "RenderDoc のアプリ内 API を読み込み、エミュレーター内からフレームをキャプチャできるようにします。\nゲーム実行中に F12 を押すと 1 フレームをキャプチャします。保存先は user/logs/capture_logs/<TITLE_ID> です。\nRenderDoc のインストールが必要です。GPU が遅くなり一部のタイトルはハングするため、デバッグ時以外はオフのままにしてください。",
"Options.Env.DisableVkImplicitLayers.Desc": "RenderDoc が有効な場合、競合する他のオーバーレイによって device loss が発生することがあります。この設定を有効にすると解決する場合があります。",
"Common.Save": "保存", "Common.Save": "保存",
"Common.Cancel": "キャンセル", "Common.Cancel": "キャンセル",
"Options.About": "情報", "Options.About": "情報",
@ -156,7 +188,7 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "コミュニティに参加して、サポートを受けたり開発を追いかけたりしましょう。", "About.Discord.Desc": "コミュニティに参加して、サポートを受けたり開発を追いかけたりしましょう。",
"About.GithubButton": "GitHubで貢献しよう!", "About.GithubButton": "GitHubで貢献しよう!",
"About.DiscordComingSoon": "近日公開", "About.DiscordButton": "Discordに参加しよう!",
"Updater.Auto.Label": "起動時にアップデートを確認", "Updater.Auto.Label": "起動時にアップデートを確認",
"Updater.Auto.Desc": "起動を遅らせずにGitHubへ確認します。", "Updater.Auto.Desc": "起動を遅らせずにGitHubへ確認します。",
"Updater.Label": "アップデート", "Updater.Label": "アップデート",
@ -173,11 +205,13 @@
"Updater.Status.ChecksumFailed": "ダウンロードしたアップデートはSHA-256検証に失敗しました。", "Updater.Status.ChecksumFailed": "ダウンロードしたアップデートはSHA-256検証に失敗しました。",
"Updater.Status.Unsupported": "自動アップデートにはWindows、Linux、またはmacOSのx64ビルドが必要です。", "Updater.Status.Unsupported": "自動アップデートにはWindows、Linux、またはmacOSのx64ビルドが必要です。",
"Options.Graphics": "グラフィックス", "Options.Graphics": "グラフィックス",
"Options.Console.Type.Label": "コンソール",
"Options.Console.Type.Desc": "ゲームに通知するコンソールモデル。",
"Options.Console.Language.Label": "コンソールの言語",
"Options.Console.Language.Desc": "ゲームに通知するシステム言語。",
"Options.Section.Rendering": "レンダリング", "Options.Section.Rendering": "レンダリング",
"Options.Section.Display": "ディスプレイ", "Options.Section.Display": "ディスプレイ",
"Options.RenderResolution.Label": "内部解像度",
"Options.RenderResolution.Desc": "ネイティブ解像度より低い解像度でオフスクリーンターゲットを描画し、表示時にアップスケールします。値を下げると画質と引き換えにGPU負荷を軽減します。次回起動時に適用されます。",
"Options.RenderResolution.Native": "100%(ネイティブ)",
"Options.WindowMode.Label": "ウィンドウモード", "Options.WindowMode.Label": "ウィンドウモード",
"Options.WindowMode.Desc": "通常ウィンドウ、デスクトップのボーダーレス、または排他フルスクリーン。", "Options.WindowMode.Desc": "通常ウィンドウ、デスクトップのボーダーレス、または排他フルスクリーン。",
"Options.WindowMode.Windowed": "ウィンドウ", "Options.WindowMode.Windowed": "ウィンドウ",
@ -200,5 +234,10 @@
"Options.VSync.Desc": "ティアリングのない表示のためFIFOプレゼンテーションを使用します。", "Options.VSync.Desc": "ティアリングのない表示のためFIFOプレゼンテーションを使用します。",
"Options.Hdr.Label": "HDR出力", "Options.Hdr.Label": "HDR出力",
"Options.Hdr.Desc": "選択したディスプレイとグラフィックスバックエンドが対応している場合にHDRを使用します。自動ではSDRにフォールバックします。", "Options.Hdr.Desc": "選択したディスプレイとグラフィックスバックエンドが対応している場合にHDRを使用します。自動ではSDRにフォールバックします。",
"Options.Hdr.Auto": "自動" "Options.Hdr.Auto": "自動",
"Options.Env.BinkPlayback.Label": "Bink 動画再生",
"Options.Env.BinkPlayback.Desc": "Host は FFmpeg ブリッジ経由で Bink 動画を再生しますが、一部のゲームで問題が発生する場合があります。\nGuest はゲームエンジン独自のデコーダーを使用します。\nSkip は Bink 動画をスキップし、開発を容易にする場合があります。",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "スキップ"
} }

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "한국어", "_languageName": "한국어",
"Options.Env.StrictCompute.Desc": "컴퓨트 및 그리기 셰이더 거부 시 중지합니다(기본값).\n끄면 해당 작업을 건너뜁니다. 이미지 누락, 오류 또는 멈춤이 발생할 수 있습니다. 변경 후 게임을 다시 시작하세요.",
"Options.Env.PerformanceProfile.Desc": "다음 게임 실행부터 성능 시간과 FPS를 기록합니다.\n성능이 저하될 수 있습니다.",
"Options.Env.PerformanceFrameTrace.Desc": "최근 4,096개의 화면 표시 간격을 보관하고 종료 시 로그에 기록합니다.\n성능 프로파일링이 필요합니다. 추적을 저장하려면 게임을 정상적으로 종료하세요.",
"Options.OverlayEnabled.Label": "성능 표시",
"Options.OverlayEnabled.Desc": "성능 통계를 표시합니다. F1은 이번 실행에서만 표시를 켜거나 끕니다. SHARPEMU_OVERLAY=0이면 숨긴 상태로 시작합니다.",
"Options.OverlayMode.Label": "표시 모드",
"Options.OverlayMode.Desc": "전체는 모든 카운터를 표시합니다. 최소와 제목 표시줄은 FPS, CPU, GPU 사용률, 경과 시간을 표시합니다. GPU 사용률은 Windows에서 프로세스별로 측정하며 다른 환경에서는 N/A입니다.",
"Options.OverlayCorner.Label": "화면 모서리",
"Options.OverlayCorner.Desc": "저장할 모서리를 선택합니다. F2는 이번 실행에서만 모서리를 바꿉니다. 제목 표시줄의 통계는 이동하지 않습니다.",
"Options.OverlayMode.Full": "전체",
"Options.OverlayMode.Minimal": "최소",
"Options.OverlayMode.TitleBar": "제목 표시줄 (최소)",
"Options.OverlayCorner.TopLeft": "왼쪽 위",
"Options.OverlayCorner.TopRight": "오른쪽 위",
"Options.OverlayCorner.BottomRight": "오른쪽 아래",
"Options.OverlayCorner.BottomLeft": "왼쪽 아래",
"Page.Library": "라이브러리", "Page.Library": "라이브러리",
"Page.Options": "옵션", "Page.Options": "옵션",
@ -53,6 +69,8 @@
"Options.TraceImports.Label": "가져오기 트레이스 한도", "Options.TraceImports.Label": "가져오기 트레이스 한도",
"Options.TraceImports.Desc": "각 모듈의 처음 N개 가져오기를 트레이스합니다 (0 = 비활성화).", "Options.TraceImports.Desc": "각 모듈의 처음 N개 가져오기를 트레이스합니다 (0 = 비활성화).",
"Options.CrashDump.Label": "크래시 덤프",
"Options.CrashDump.Desc": "실행 로그 옆에 크래시 덤프를 저장합니다(Windows x64 전용). 덤프는 크기가 클 수 있으며 개인 데이터를 포함할 수 있습니다.",
"Options.LogToFile.Label": "파일로 저장", "Options.LogToFile.Label": "파일로 저장",
"Options.LogToFile.Desc": "에뮬레이터 출력을 로그 파일에 복사합니다.", "Options.LogToFile.Desc": "에뮬레이터 출력을 로그 파일에 복사합니다.",
@ -90,6 +108,17 @@
"Launch.Idle": "대기 중", "Launch.Idle": "대기 중",
"Launch.Console": "≡ 콘솔", "Launch.Console": "≡ 콘솔",
"Launch.Launch": "▶ 실행", "Launch.Launch": "▶ 실행",
"Launch.CustomEnv": "사용자 지정 환경 변수로 실행",
"Launch.CustomEnv.Title": "사용자 지정 환경 변수로 실행",
"Launch.CustomEnv.Desc": "환경 변수를 NAME=VALUE 형식으로 한 줄에 하나씩 입력하세요. 사용자 지정 값은 이름이 같은 GUI 및 게임별 환경 설정을 덮어씁니다.",
"Launch.CustomEnv.Documentation": "문서화되지 않은 환경 변수 보기 ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_EXAMPLE=1",
"Launch.CustomEnv.SaveGame": "게임용으로 저장",
"Launch.CustomEnv.SaveGlobal": "전역으로 저장",
"Launch.CustomEnv.Play": "플레이",
"Launch.CustomEnv.Invalid": "잘못된 환경 변수: {0}",
"Launch.CustomEnv.SavedGame": "이 게임용으로 저장했습니다.",
"Launch.CustomEnv.SavedGlobal": "전역으로 저장했습니다.",
"Launch.Stop": "■ 중지", "Launch.Stop": "■ 중지",
"Launch.Running": "실행 중 — {0}", "Launch.Running": "실행 중 — {0}",
"Launch.Stopping": "중지 중…", "Launch.Stopping": "중지 중…",
@ -145,7 +174,10 @@
"Options.Env.LogDirectMemory.Desc": "다이렉트 메모리 할당과 실패를 콘솔에 기록합니다.\n게임이 부팅 중 중단되거나 종료될 때 사용하세요.", "Options.Env.LogDirectMemory.Desc": "다이렉트 메모리 할당과 실패를 콘솔에 기록합니다.\n게임이 부팅 중 중단되거나 종료될 때 사용하세요.",
"Options.Env.LogIo.Desc": "파일 열기, 읽기, 경로 확인 동작을 콘솔에 기록합니다.\n게임이 부팅 중 데이터 파일을 찾지 못할 때 사용하세요.", "Options.Env.LogIo.Desc": "파일 열기, 읽기, 경로 확인 동작을 콘솔에 기록합니다.\n게임이 부팅 중 데이터 파일을 찾지 못할 때 사용하세요.",
"Options.Env.LogNp.Desc": "NP(PlayStation Network) 라이브러리 호출을 콘솔에 기록합니다.", "Options.Env.LogNp.Desc": "NP(PlayStation Network) 라이브러리 호출을 콘솔에 기록합니다.",
"Options.Env.GuestImageCpuSync.Desc": "게임의 자체 CPU 코드가 다시 쓰는 게스트 표면을 다시 업로드합니다.\n평소에는 꺼 두세요. CPU로 그린 표면이 화면에 나타나지 않는 타이틀에서 켜세요.\n성능을 소모하며 GTA V 등 일부 타이틀에서는 문제가 생깁니다.", "Options.Env.Group.Debug": "디버그",
"Options.Env.Group.General": "일반",
"Options.Env.RenderDoc.Desc": "RenderDoc의 인앱 API를 로드하여 에뮬레이터 내부에서 프레임을 캡처할 수 있게 합니다.\n게임 실행 중 F12을 누르면 한 프레임을 캡처하며, 캡처 파일은 user/logs/capture_logs/<TITLE_ID>에 저장됩니다.\nRenderDoc이 설치되어 있어야 합니다. GPU 속도가 느려지고 일부 타이틀은 멈추므로 디버깅할 때가 아니면 꺼 두세요.",
"Options.Env.DisableVkImplicitLayers.Desc": "RenderDoc이 활성화된 경우 다른 충돌하는 오버레이로 인해 device loss가 발생할 수 있습니다. 이 옵션을 활성화하면 문제가 해결될 수 있습니다.",
"Common.Save": "저장", "Common.Save": "저장",
"Common.Cancel": "취소", "Common.Cancel": "취소",
"Options.About": "정보", "Options.About": "정보",
@ -156,7 +188,7 @@
"About.Discord.Label": "디스코드", "About.Discord.Label": "디스코드",
"About.Discord.Desc": "커뮤니티에 참여해 지원을 받고 개발 소식을 확인하세요.", "About.Discord.Desc": "커뮤니티에 참여해 지원을 받고 개발 소식을 확인하세요.",
"About.GithubButton": "GitHub에서 기여하기!", "About.GithubButton": "GitHub에서 기여하기!",
"About.DiscordComingSoon": "곧 공개", "About.DiscordButton": "Discord에 참여하세요!",
"Updater.Auto.Label": "시작 시 업데이트 확인", "Updater.Auto.Label": "시작 시 업데이트 확인",
"Updater.Auto.Desc": "시작을 지연시키지 않고 GitHub를 확인합니다.", "Updater.Auto.Desc": "시작을 지연시키지 않고 GitHub를 확인합니다.",
"Updater.Label": "업데이트", "Updater.Label": "업데이트",
@ -173,11 +205,13 @@
"Updater.Status.ChecksumFailed": "다운로드한 업데이트가 SHA-256 검증에 실패했습니다.", "Updater.Status.ChecksumFailed": "다운로드한 업데이트가 SHA-256 검증에 실패했습니다.",
"Updater.Status.Unsupported": "자동 업데이트에는 Windows, Linux 또는 macOS x64 빌드가 필요합니다.", "Updater.Status.Unsupported": "자동 업데이트에는 Windows, Linux 또는 macOS x64 빌드가 필요합니다.",
"Options.Graphics": "그래픽", "Options.Graphics": "그래픽",
"Options.Console.Type.Label": "콘솔",
"Options.Console.Type.Desc": "게임에 보고할 콘솔 모델입니다.",
"Options.Console.Language.Label": "콘솔 언어",
"Options.Console.Language.Desc": "게임에 보고할 시스템 언어입니다.",
"Options.Section.Rendering": "렌더링", "Options.Section.Rendering": "렌더링",
"Options.Section.Display": "디스플레이", "Options.Section.Display": "디스플레이",
"Options.RenderResolution.Label": "내부 해상도",
"Options.RenderResolution.Desc": "네이티브 해상도보다 낮은 해상도로 오프스크린 대상을 렌더링한 뒤 표시할 때 업스케일합니다. 값이 낮을수록 화질을 희생해 GPU 여유를 확보하며 다음 실행부터 적용됩니다.",
"Options.RenderResolution.Native": "100% (네이티브)",
"Options.WindowMode.Label": "창 모드", "Options.WindowMode.Label": "창 모드",
"Options.WindowMode.Desc": "일반 창, 데스크톱 테두리 없음 또는 독점 전체 화면.", "Options.WindowMode.Desc": "일반 창, 데스크톱 테두리 없음 또는 독점 전체 화면.",
"Options.WindowMode.Windowed": "창", "Options.WindowMode.Windowed": "창",
@ -200,5 +234,10 @@
"Options.VSync.Desc": "티어링 없는 출력을 위해 FIFO 프레젠테이션을 사용합니다.", "Options.VSync.Desc": "티어링 없는 출력을 위해 FIFO 프레젠테이션을 사용합니다.",
"Options.Hdr.Label": "HDR 출력", "Options.Hdr.Label": "HDR 출력",
"Options.Hdr.Desc": "선택한 디스플레이와 그래픽 백엔드가 지원하는 경우 HDR을 사용합니다. 자동 모드는 SDR로 대체됩니다.", "Options.Hdr.Desc": "선택한 디스플레이와 그래픽 백엔드가 지원하는 경우 HDR을 사용합니다. 자동 모드는 SDR로 대체됩니다.",
"Options.Hdr.Auto": "자동" "Options.Hdr.Auto": "자동",
"Options.Env.BinkPlayback.Label": "Bink 비디오 재생",
"Options.Env.BinkPlayback.Desc": "Host는 FFmpeg 브리지를 통해 Bink 비디오를 재생하지만 일부 게임에서 문제가 발생할 수 있습니다.\nGuest는 게임 엔진 자체 디코더를 사용합니다.\nSkip은 Bink 비디오를 건너뛰어 개발을 더 쉽게 할 수 있습니다.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "건너뛰기"
} }

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "Nederlands", "_languageName": "Nederlands",
"Options.Env.StrictCompute.Desc": "Stop bij shaderafwijzingen voor berekeningen en tekenen (standaard).\nSchakel uit om betrokken werk over te slaan. Ontbrekende beelden, fouten of vastlopers zijn mogelijk. Herstart het spel na een wijziging.",
"Options.Env.PerformanceProfile.Desc": "Log prestatietijden en FPS vanaf de volgende start van het spel.\nDit kan de prestaties verminderen.",
"Options.Env.PerformanceFrameTrace.Desc": "Bewaar de laatste 4.096 presentatie-intervallen en schrijf ze bij afsluiten naar het logboek.\nVereist prestatieprofilering. Sluit het spel normaal af om de trace op te slaan.",
"Options.OverlayEnabled.Label": "Prestatiegegevens",
"Options.OverlayEnabled.Desc": "Toon prestatiegegevens. F1 schakelt de weergave voor deze sessie in of uit. SHARPEMU_OVERLAY=0 verbergt deze bij het starten.",
"Options.OverlayMode.Label": "Weergavemodus",
"Options.OverlayMode.Desc": "Volledig toont alle tellers. Minimaal en Titelbalk tonen FPS, CPU, GPU-gebruik en verstreken tijd. GPU-gebruik geldt per proces op Windows; anders N/A.",
"Options.OverlayCorner.Label": "Schermhoek",
"Options.OverlayCorner.Desc": "Kies de opgeslagen hoek. F2 wisselt de hoek alleen voor deze sessie. Dit verplaatst de gegevens in de titelbalk niet.",
"Options.OverlayMode.Full": "Volledig",
"Options.OverlayMode.Minimal": "Minimaal",
"Options.OverlayMode.TitleBar": "Titelbalk (minimaal)",
"Options.OverlayCorner.TopLeft": "Linksboven",
"Options.OverlayCorner.TopRight": "Rechtsboven",
"Options.OverlayCorner.BottomRight": "Rechtsonder",
"Options.OverlayCorner.BottomLeft": "Linksonder",
"Page.Library": "Bibliotheek", "Page.Library": "Bibliotheek",
"Page.Options": "Opties", "Page.Options": "Opties",
@ -53,6 +69,8 @@
"Options.TraceImports.Label": "Tracelimiet voor imports", "Options.TraceImports.Label": "Tracelimiet voor imports",
"Options.TraceImports.Desc": "Traceer de eerste N imports per module (0 = uit).", "Options.TraceImports.Desc": "Traceer de eerste N imports per module (0 = uit).",
"Options.CrashDump.Label": "Crashdumps",
"Options.CrashDump.Desc": "Sla crashdumps naast het uitvoeringslog op (alleen Windows x64). Dumps kunnen groot zijn en privégegevens bevatten.",
"Options.LogToFile.Label": "Loggen naar bestand", "Options.LogToFile.Label": "Loggen naar bestand",
"Options.LogToFile.Desc": "Stuur de uitvoer van de emulator ook naar een logbestand.", "Options.LogToFile.Desc": "Stuur de uitvoer van de emulator ook naar een logbestand.",
@ -90,6 +108,17 @@
"Launch.Idle": "Inactief", "Launch.Idle": "Inactief",
"Launch.Console": "≡ Console", "Launch.Console": "≡ Console",
"Launch.Launch": "▶ Starten", "Launch.Launch": "▶ Starten",
"Launch.CustomEnv": "Starten met aangepaste omgevingsvariabelen",
"Launch.CustomEnv.Title": "Starten met aangepaste omgevingsvariabelen",
"Launch.CustomEnv.Desc": "Voer per regel één omgevingsvariabele in als NAAM=WAARDE. Aangepaste waarden overschrijven GUI- en spelspecifieke instellingen met dezelfde naam.",
"Launch.CustomEnv.Documentation": "Ongedocumenteerde omgevingsvariabelen bekijken ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_VOORBEELD=1",
"Launch.CustomEnv.SaveGame": "Opslaan voor spel",
"Launch.CustomEnv.SaveGlobal": "Globaal opslaan",
"Launch.CustomEnv.Play": "Spelen",
"Launch.CustomEnv.Invalid": "Ongeldige omgevingsvariabele: {0}",
"Launch.CustomEnv.SavedGame": "Opgeslagen voor dit spel.",
"Launch.CustomEnv.SavedGlobal": "Globaal opgeslagen.",
"Launch.Stop": "■ Stoppen", "Launch.Stop": "■ Stoppen",
"Launch.Running": "Actief — {0}", "Launch.Running": "Actief — {0}",
"Launch.Stopping": "Stoppen…", "Launch.Stopping": "Stoppen…",
@ -145,7 +174,10 @@
"Options.Env.LogDirectMemory.Desc": "Log directe geheugentoewijzingen en fouten naar de console.\nGebruik dit wanneer een game tijdens het opstarten afbreekt of afsluit.", "Options.Env.LogDirectMemory.Desc": "Log directe geheugentoewijzingen en fouten naar de console.\nGebruik dit wanneer een game tijdens het opstarten afbreekt of afsluit.",
"Options.Env.LogIo.Desc": "Log het openen en lezen van bestanden en het oplossen van paden naar de console.\nGebruik dit wanneer een game zijn databestanden niet kan vinden tijdens het opstarten.", "Options.Env.LogIo.Desc": "Log het openen en lezen van bestanden en het oplossen van paden naar de console.\nGebruik dit wanneer een game zijn databestanden niet kan vinden tijdens het opstarten.",
"Options.Env.LogNp.Desc": "Log NP-bibliotheekaanroepen (PlayStation Network) naar de console.", "Options.Env.LogNp.Desc": "Log NP-bibliotheekaanroepen (PlayStation Network) naar de console.",
"Options.Env.GuestImageCpuSync.Desc": "Gastoppervlakken opnieuw uploaden die de eigen CPU-code van de game herschrijft.\nNormaal uit laten. Inschakelen voor titels waarvan de door de CPU getekende oppervlakken nooit het scherm bereiken.\nKost prestaties en veroorzaakt regressies in sommige titels, zoals GTA V.", "Options.Env.Group.Debug": "Debuggen",
"Options.Env.Group.General": "Algemeen",
"Options.Env.RenderDoc.Desc": "Laadt de RenderDoc in-application-API zodat frames vanuit de emulator kunnen worden vastgelegd.\nDruk op F12 terwijl het spel draait om één frame vast te leggen; opnamen komen in user/logs/capture_logs/<TITLE_ID>.\nVereist een geïnstalleerde RenderDoc. Vertraagt de GPU en laat sommige games vastlopen, dus laat dit uit tenzij je aan het debuggen bent.",
"Options.Env.DisableVkImplicitLayers.Desc": "Wanneer RenderDoc is ingeschakeld, kunnen andere conflicterende overlays device loss veroorzaken. Het inschakelen van deze optie kan het probleem oplossen.",
"Common.Save": "Opslaan", "Common.Save": "Opslaan",
"Common.Cancel": "Annuleren", "Common.Cancel": "Annuleren",
"Options.About": "Over", "Options.About": "Over",
@ -156,7 +188,7 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "Word lid van de community, krijg ondersteuning en volg de ontwikkeling.", "About.Discord.Desc": "Word lid van de community, krijg ondersteuning en volg de ontwikkeling.",
"About.GithubButton": "Draag bij op GitHub!", "About.GithubButton": "Draag bij op GitHub!",
"About.DiscordComingSoon": "Binnenkort", "About.DiscordButton": "Word lid van onze Discord!",
"Updater.Auto.Label": "Bij het opstarten controleren op updates", "Updater.Auto.Label": "Bij het opstarten controleren op updates",
"Updater.Auto.Desc": "Controleert GitHub zonder het opstarten te vertragen.", "Updater.Auto.Desc": "Controleert GitHub zonder het opstarten te vertragen.",
"Updater.Label": "Updates", "Updater.Label": "Updates",
@ -173,11 +205,13 @@
"Updater.Status.ChecksumFailed": "De gedownloade update is niet door de SHA-256-verificatie gekomen.", "Updater.Status.ChecksumFailed": "De gedownloade update is niet door de SHA-256-verificatie gekomen.",
"Updater.Status.Unsupported": "Automatisch updaten vereist een x64-build voor Windows, Linux of macOS.", "Updater.Status.Unsupported": "Automatisch updaten vereist een x64-build voor Windows, Linux of macOS.",
"Options.Graphics": "Grafisch", "Options.Graphics": "Grafisch",
"Options.Console.Type.Label": "Console",
"Options.Console.Type.Desc": "Consolemodel dat aan games wordt gemeld.",
"Options.Console.Language.Label": "Consoletaal",
"Options.Console.Language.Desc": "Systeemtaal die aan games wordt gemeld.",
"Options.Section.Rendering": "RENDERING", "Options.Section.Rendering": "RENDERING",
"Options.Section.Display": "BEELDSCHERM", "Options.Section.Display": "BEELDSCHERM",
"Options.RenderResolution.Label": "Interne resolutie",
"Options.RenderResolution.Desc": "Render offscreen-doelen onder de oorspronkelijke resolutie en schaal ze bij presentatie op. Lagere waarden ruilen beeldkwaliteit in voor GPU-marge; wordt bij de volgende start toegepast.",
"Options.RenderResolution.Native": "100% (native)",
"Options.WindowMode.Label": "Venstermodus", "Options.WindowMode.Label": "Venstermodus",
"Options.WindowMode.Desc": "Normaal venster, randloos bureaublad of exclusief volledig scherm.", "Options.WindowMode.Desc": "Normaal venster, randloos bureaublad of exclusief volledig scherm.",
"Options.WindowMode.Windowed": "Venster", "Options.WindowMode.Windowed": "Venster",
@ -200,5 +234,10 @@
"Options.VSync.Desc": "Gebruik FIFO-presentatie voor uitvoer zonder tearing.", "Options.VSync.Desc": "Gebruik FIFO-presentatie voor uitvoer zonder tearing.",
"Options.Hdr.Label": "HDR-uitvoer", "Options.Hdr.Label": "HDR-uitvoer",
"Options.Hdr.Desc": "Gebruik HDR wanneer het geselecteerde beeldscherm en de grafische backend dit ondersteunen. Automatisch valt terug op SDR.", "Options.Hdr.Desc": "Gebruik HDR wanneer het geselecteerde beeldscherm en de grafische backend dit ondersteunen. Automatisch valt terug op SDR.",
"Options.Hdr.Auto": "Automatisch" "Options.Hdr.Auto": "Automatisch",
"Options.Env.BinkPlayback.Label": "Bink-video afspelen",
"Options.Env.BinkPlayback.Desc": "Host speelt Bink-video's af via de FFmpeg-brug, maar sommige games kunnen problemen hebben.\nGuest gebruikt de eigen decoder van de game-engine.\nSkip slaat Bink-video's over, wat de ontwikkeling kan vergemakkelijken.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Overslaan"
} }

View File

@ -0,0 +1,248 @@
{
"_languageName": "Polski",
"Options.Env.StrictCompute.Desc": "Zatrzymuj przy odrzuceniu shaderów obliczeń i rysowania (domyślnie).\nWyłącz, aby pomijać te operacje. Mogą wystąpić brakujące obrazy, błędy lub zawieszenia. Po zmianie uruchom grę ponownie.",
"Options.Env.PerformanceProfile.Desc": "Zapisuj czasy wydajności i FPS od następnego uruchomienia gry.\nMoże to obniżyć wydajność.",
"Options.Env.PerformanceFrameTrace.Desc": "Zachowaj ostatnie 4096 odstępów prezentacji i zapisz je w dzienniku przy zamykaniu.\nWymaga profilowania wydajności. Zamknij grę normalnie, aby zapisać ślad.",
"Options.OverlayEnabled.Label": "Statystyki wydajności",
"Options.OverlayEnabled.Desc": "Pokaż statystyki. F1 włącza lub wyłącza widok tylko w tej sesji. SHARPEMU_OVERLAY=0 ukrywa go przy uruchomieniu.",
"Options.OverlayMode.Label": "Tryb wyświetlania",
"Options.OverlayMode.Desc": "Pełny pokazuje wszystkie liczniki. Minimalny i Pasek tytułu pokazują FPS, CPU, użycie GPU i czas. GPU jest mierzone dla procesu w Windows; w innych systemach N/A.",
"Options.OverlayCorner.Label": "Róg ekranu",
"Options.OverlayCorner.Desc": "Wybierz zapisany róg. F2 zmienia róg tylko w tej sesji. Nie przenosi statystyk z paska tytułu.",
"Options.OverlayMode.Full": "Pełny",
"Options.OverlayMode.Minimal": "Minimalny",
"Options.OverlayMode.TitleBar": "Pasek tytułu (minimalny)",
"Options.OverlayCorner.TopLeft": "Lewy górny",
"Options.OverlayCorner.TopRight": "Prawy górny",
"Options.OverlayCorner.BottomRight": "Prawy dolny",
"Options.OverlayCorner.BottomLeft": "Lewy dolny",
"Page.Library": "Biblioteka",
"Page.Options": "Opcje",
"Page.GameCount.One": "1 gra",
"Page.GameCount.Other": "{0} gier",
"Library.SearchWatermark": "Szukaj w bibliotece…",
"Library.AddFolder": "Dodaj folder",
"Library.OpenFile": "Otwórz plik…",
"Library.View.Grid": "Widok siatki",
"Library.View.Carousel": "Widok listy",
"Library.Context.Launch": "Uruchom",
"Library.Context.OpenFolder": "Otwórz folder gry",
"Library.Context.CopyPath": "Kopiuj ścieżkę",
"Library.Context.CopyTitleId": "Kopiuj numer seryjny",
"Library.Context.GameSettings": "Ustawienia gry…",
"Library.Context.Remove": "Usuń z biblioteki",
"Library.Empty.Title": "Twoja biblioteka jest pusta",
"Library.Empty.Hint": "Dodaj folder zawierający twoje gry, aby rozpocząć.",
"Library.Empty.SearchTitle": "Brak gier pasujących do twojego wyszukiwania",
"Library.Empty.SearchHint": "Nic w bibliotece nie pasuje do “{0}”.",
"Library.Empty.AddFolder": "+ Dodaj folder z grami",
"Library.Loading": "Ładowanie biblioteki…",
"Library.Stat.Version": "Wersja",
"Library.Stat.Installed": "Zainstalowano",
"Library.Stat.TitleId": "Numer seryjny",
"Common.Back": "Wstecz",
"Options.General": "Ogólne",
"Options.Logging": "Dziennik zdarzeń",
"Options.Env.Tab": "Środowisko",
"Options.Section.Environment": "ZMIENNE ŚRODOWISKOWE",
"Options.Env.Desc": "Przełączniki przekazywane emulatorowi jako zmienne środowiskowe przy uruchomieniu.",
"Options.Env.Bthid.Desc": "Zgłaszaj Bluetooth HID jako niedostępny dla tytułów, których middleware kierownicy/FFB odpytuje w nieskończoność.\nZostaw wyłączone normalnie. Niektóre tytuły zawieszają się, gdy inicjalizacja zawiedzie.",
"Options.Env.LoopGuard.Desc": "Nie wymuszaj zamknięcia tytułów, które powtarzają to samo wywołanie zbyt długo.\nSpróbuj tego, gdy gra zamyka się sama podczas ładowania.",
"Options.Env.WritableApp0.Desc": "Pozwól tytułom tworzyć i zapisywać pliki wewnątrz folderu instalacji.\nPotrzebne w przypadku niespakowanych zrzutów, które zapisują dane zapisu lub konfiguracji w /app0.",
"Options.Env.VkValidation.Desc": "Włącz warstwy walidacji Vulkan do debugowania GPU.\nWolne. Wymaga zainstalowanego Vulkan SDK.",
"Options.Env.DumpSpirv.Desc": "Zrzuć shadery AGC i ich translacje SPIR-V do folderu shader-dumps.\nUżyj przy zgłaszaniu błędów shaderów lub renderowania.",
"Options.Env.LogDirectMemory.Desc": "Loguj alokacje pamięci bezpośredniej i błędy do konsoli.\nUżyj, gdy gra przerywa działanie lub zamyka się podczas uruchamiania.",
"Options.Env.LogIo.Desc": "Loguj otwieranie plików, odczyt i rozwiązywanie ścieżek do konsoli.\nUżyj, gdy gra nie może znaleźć swoich plików danych podczas uruchamiania.",
"Options.Env.LogNp.Desc": "Loguj wywołania biblioteki NP (PlayStation Network) do konsoli.",
"Options.Env.Group.Debug": "Debugowanie",
"Options.Env.Group.General": "Ogólne",
"Options.Env.RenderDoc.Desc": "Załaduj API RenderDoc w aplikacji, aby można było przechwytywać klatki z wnętrza emulatora.\nNaciśnij F12 podczas działania gry, aby przechwycić jedną klatkę; przechwycone klatki trafiają do user/logs/capture_logs/<TITLE_ID>.\nWymaga zainstalowanego RenderDoc. Spowalnia GPU i zawiesza niektóre tytuły, więc zostaw wyłączone, chyba że debugujesz.",
"Options.Env.DisableVkImplicitLayers.Desc": "Gdy RenderDoc jest włączony, inne konfliktujące nakładki mogą powodować utratę urządzenia. Włączenie tej opcji może rozwiązać problem.",
"Options.DefaultProfile.Label": "Domyślna nazwa profilu",
"Options.DefaultProfile.Desc": "Nazwa używana, gdy gra prosi o wprowadzenie tekstu. Domyślnie Sharp.",
"Options.Section.Emulation": "EMULACJA",
"Options.Section.Logging": "DZIENNIK ZDARZEŃ",
"Options.Section.Launcher": "LAUNCHER",
"Options.Section.Rendering": "RENDEROWANIE",
"Options.Section.Display": "WYŚWIETLANIE",
"Options.Graphics": "Grafika",
"Options.Console.Type.Label": "Konsola",
"Options.Console.Type.Desc": "Model konsoli zgłaszany grom.",
"Options.Console.Language.Label": "Język konsoli",
"Options.Console.Language.Desc": "Język systemu zgłaszany grom.",
"Options.WindowMode.Label": "Tryb okna",
"Options.WindowMode.Desc": "Zwykłe okno, bezramkowe na pulpicie lub pełny ekran wyłączny.",
"Options.WindowMode.Windowed": "W oknie",
"Options.WindowMode.Borderless": "Bezramkowe",
"Options.WindowMode.Exclusive": "Wyłączne",
"Options.Resolution.Label": "Rozdzielczość",
"Options.Resolution.Desc": "Początkowy rozmiar okna lub rozdzielczość pełnego ekranu wyłącznego.",
"Options.Display.Label": "Wyświetlacz",
"Options.Display.Desc": "Monitor używany do centrowania i trybu pełnoekranowego.",
"Options.RefreshRate.Label": "Częstotliwość odświeżania",
"Options.RefreshRate.Desc": "Częstotliwość odświeżania w trybie pełnego ekranu wyłącznego. Automatyczna wybiera najbliższy tryb.",
"Options.RefreshRate.Automatic": "Automatyczna",
"Options.Scaling.Label": "Skalowanie",
"Options.Scaling.Desc": "Skaluj natywny obraz gościa bez zmiany jego wewnętrznej rozdzielczości.",
"Options.Scaling.Fit": "Dopasuj",
"Options.Scaling.Cover": "Wypełnij",
"Options.Scaling.Stretch": "Rozciągnij",
"Options.Scaling.Integer": "Całkowitoliczbowe",
"Options.VSync.Label": "VSync",
"Options.VSync.Desc": "Używaj prezentacji FIFO dla obrazu bez rozrywania.",
"Options.Hdr.Label": "Wyjście HDR",
"Options.Hdr.Desc": "Używaj HDR, gdy wybrany wyświetlacz i backend graficzny to obsługują. Automatyczny przełącza na SDR.",
"Options.Hdr.Auto": "Automatyczny",
"Options.Env.BinkPlayback.Label": "Odtwarzanie wideo Bink",
"Options.Env.BinkPlayback.Desc": "Host odtwarza filmy Bink przez most FFmpeg, ale w niektórych grach mogą wystąpić problemy.\nGuest używa dekodera silnika gry.\nSkip pomija filmy Bink, co może ułatwić rozwój.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Pomiń",
"Options.CpuEngine.Label": "Silnik CPU",
"Options.CpuEngine.Desc": "Silnik wykonawczy używany do uruchamiania kodu gry.",
"Options.CpuEngine.Native": "Natywny",
"Options.Strict.Label": "Ścisłe rozwiązywanie dynlib",
"Options.Strict.Desc": "Przerwij uruchomienie, gdy importowany symbol nie może zostać rozwiązany.",
"Options.LogLevel.Label": "Poziom logowania",
"Options.LogLevel.Desc": "Szczegółowość wyjścia konsoli emulatora.",
"Options.LogLevel.Trace": "Śledzenie",
"Options.LogLevel.Debug": "Debugowanie",
"Options.LogLevel.Info": "Informacja",
"Options.LogLevel.Warning": "Ostrzeżenie",
"Options.LogLevel.Error": "Błąd",
"Options.LogLevel.Critical": "Krytyczny",
"Options.TraceImports.Label": "Limit śledzenia importów",
"Options.TraceImports.Desc": "Śledź pierwszych N importów na moduł (0 = wyłączone).",
"Options.CrashDump.Label": "Zrzuty pamięci po awarii",
"Options.CrashDump.Desc": "Zapisuj zrzuty pamięci obok dziennika uruchomienia (tylko Windows x64). Pliki mogą być duże i zawierać prywatne dane.",
"Options.LogToFile.Label": "Loguj do pliku",
"Options.LogToFile.Desc": "Kopiuj wyjście emulatora do pliku logu.",
"Options.LogFilePath.Label": "Ścieżka pliku logu",
"Options.LogFilePath.Default": "Brak niestandardowej ścieżki — logi trafiają do user/logs obok emulatora.",
"Options.LogFilePath.Select": "Wybierz…",
"Options.OverrideLogFile.Label": "Nadpisz plik logu",
"Options.OverrideLogFile.Desc": "Użyj dokładnej ścieżki pliku zamiast dopisywania ID tytułu i znacznika czasu.",
"Options.TitleMusic.Label": "Muzyka tytułowa",
"Options.TitleMusic.Desc": "Odtwarzaj w pętli muzykę podglądu wybranej gry w bibliotece.",
"Options.Discord.Label": "Discord Rich Presence",
"Options.Discord.Desc": "Pokazuj uruchomioną grę na swoim profilu Discord.",
"Options.Language.Label": "Język emulatora",
"Options.Language.Desc": "Język używany w całym launcherze. Działa natychmiast.",
"Common.On": "Włącz",
"Common.Off": "Wyłącz",
"Common.Save": "Zapisz",
"Common.Cancel": "Anuluj",
"Console.Title": "KONSOLA",
"Console.SearchWatermark": "Szukaj...",
"Console.AutoScroll": "Autoprzewijanie",
"Console.Split": "Podziel",
"Console.Copy": "Kopiuj",
"Console.Clear": "Wyczyść",
"Console.WindowTitle": "Konsola SharpEmu",
"Launch.NoGameSelected": "Nie wybrano gry",
"Launch.NoGameHint": "Wybierz grę z biblioteki lub otwórz bezpośrednio plik eboot.bin.",
"Launch.Idle": "Bezczynny",
"Launch.Console": "≡ Konsola",
"Launch.Launch": "▶ Uruchom",
"Launch.CustomEnv": "Uruchom z własnymi zmiennymi środowiskowymi",
"Launch.CustomEnv.Title": "Uruchom z własnymi zmiennymi środowiskowymi",
"Launch.CustomEnv.Desc": "Wpisz po jednej zmiennej środowiskowej w wierszu w formacie NAZWA=WARTOŚĆ. Własne wartości zastępują ustawienia GUI i ustawienia gry o tej samej nazwie.",
"Launch.CustomEnv.Documentation": "Wyświetl nieudokumentowane zmienne środowiskowe ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_PRZYKLAD=1",
"Launch.CustomEnv.SaveGame": "Zapisz dla gry",
"Launch.CustomEnv.SaveGlobal": "Zapisz globalnie",
"Launch.CustomEnv.Play": "Graj",
"Launch.CustomEnv.Invalid": "Nieprawidłowa zmienna środowiskowa: {0}",
"Launch.CustomEnv.SavedGame": "Zapisano dla tej gry.",
"Launch.CustomEnv.SavedGlobal": "Zapisano globalnie.",
"Launch.Stop": "■ Zatrzymaj",
"Launch.Running": "Działa — {0}",
"Launch.Stopping": "Zatrzymywanie…",
"Launch.Exited": "Zakończono z kodem {0} ({1})",
"Launch.ExeNotFound": "Nie znaleziono pliku wykonywalnego SharpEmu. Najpierw zbuduj projekt SharpEmu.CLI (dotnet build).",
"Launch.LogFile": "Plik logu: {0}",
"Launch.Command": "$ SharpEmu {0}",
"Launch.StartFailed": "Nie udało się uruchomić emulatora: {0}",
"Launch.ProcessExited": "Proces zakończony z kodem {0} ({1}).",
"Exit.Ok": "OK",
"Exit.InvalidArguments": "nieprawidłowe argumenty",
"Exit.EbootNotFound": "nie znaleziono eboot",
"Exit.RuntimeException": "wyjątek czasu wykonania",
"Exit.EmulationError": "błąd emulacji",
"Exit.Unknown": "nieznany",
"Status.EmulatorLocating": "Emulator: lokalizowanie…",
"Status.EmulatorPath": "Emulator: {0}",
"Status.EmulatorNotFound": "Emulator: nie znaleziono pliku wykonywalnego SharpEmu — najpierw zbuduj SharpEmu.CLI.",
"Status.ScanningLibrary": "Skanowanie biblioteki…",
"Status.AddFolderPrompt": "Dodaj folder z grami, aby wypełnić bibliotekę.",
"Status.LibraryScanned": "Biblioteka przeskanowana: {0} gier w {1} folderach.",
"Status.CouldNotOpenFolder": "Nie można otworzyć folderu: {0}",
"Status.CopiedToClipboard": "{0} skopiowano do schowka.",
"Status.RemovedFromLibrary": "Usunięto \u201c{0}\u201d z biblioteki. Dodaj ponownie folder, aby przywrócić.",
"Status.Running": "Uruchomiono {0}",
"Status.Stopping": "Zatrzymywanie…",
"Status.Idle": "Bezczynny",
"Clipboard.Path": "Ścieżka",
"Clipboard.TitleId": "ID tytułu",
"Discord.Playing": "Gra w {0}",
"Discord.Browsing": "Przegląda bibliotekę",
"Dialog.ChooseGameFolder": "Wybierz folder zawierający gry",
"Dialog.OpenExecutable": "Otwórz plik wykonywalny do uruchomienia",
"Dialog.PsExecutables": "Pliki wykonywalne PS",
"Dialog.SaveLogFile": "Wybierz, gdzie zapisać plik logu",
"Dialog.PlainTextFiles": "Pliki tekstowe",
"Dialog.LogFiles": "Pliki logów",
"Options.About" : "O programie",
"About.Github.Label": "GitHub",
"About.Github.Desc": "Kod źródłowy, zgłoszenia i rozwój projektu.",
"About.Github.LatestCommitLabel": "Najnowszy commit",
"About.Github.LatestCommitDescription": "Najnowszy commit na gałęzi głównej",
"About.Discord.Label": "Discord",
"About.Discord.Desc": "Dołącz do społeczności, uzyskaj wsparcie i śledź rozwój.",
"About.GithubButton": "Wspieraj na GitHubie!",
"About.DiscordButton": "Dołącz do naszego Discorda!",
"Updater.Auto.Label": "Sprawdzaj aktualizacje przy uruchomieniu",
"Updater.Auto.Desc": "Sprawdza GitHub bez opóźniania uruchomienia.",
"Updater.Label": "Aktualizacje",
"Updater.Check": "Sprawdź aktualizacje",
"Updater.DownloadRestart": "Pobierz i uruchom ponownie",
"Updater.Status.Ready": "Obecna wersja: {0}",
"Updater.Status.Checking": "Sprawdzanie aktualizacji…",
"Updater.Status.Current": "Masz najnowszą wersję ({0}).",
"Updater.Status.Available": "Dostępna nowa wersja: {0}",
"Updater.Status.Downloading": "Pobieranie aktualizacji… {0}%",
"Updater.Status.Installing": "Instalowanie aktualizacji…",
"Updater.Status.Timeout": "Sprawdzanie aktualizacji przekroczyło limit 10 sekund.",
"Updater.Status.Failed": "Nie udało się sprawdzić aktualizacji.",
"Updater.Status.ChecksumFailed": "Pobrana aktualizacja nie przeszła weryfikacji SHA-256.",
"Updater.Status.Unsupported": "Automatyczna aktualizacja wymaga wersji dla Windows, Linux lub macOS x64."
}

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "Português (Portugal)", "_languageName": "Português (Portugal)",
"Options.Env.StrictCompute.Desc": "Parar nas rejeições de shaders de cálculo e desenho (predefinição).\nDesativa para ignorar o trabalho afetado. Podem ocorrer imagens em falta, erros ou bloqueios. Reinicia o jogo após uma alteração.",
"Options.Env.PerformanceProfile.Desc": "Regista os tempos de desempenho e FPS a partir do próximo arranque do jogo.\nIsto pode reduzir o desempenho.",
"Options.Env.PerformanceFrameTrace.Desc": "Guarda os últimos 4096 intervalos de apresentação e escreve-os no registo ao sair.\nRequer o perfil de desempenho. Fecha o jogo normalmente para guardar o rastreio.",
"Options.OverlayEnabled.Label": "Indicador de desempenho",
"Options.OverlayEnabled.Desc": "Mostrar estatísticas. F1 ativa ou oculta o indicador nesta sessão. SHARPEMU_OVERLAY=0 oculta-o no arranque.",
"Options.OverlayMode.Label": "Modo de apresentação",
"Options.OverlayMode.Desc": "Completo mostra todos os contadores. Mínimo e Barra de título mostram FPS, CPU, utilização da GPU e tempo. A GPU é medida por processo no Windows; nos restantes sistemas, N/A.",
"Options.OverlayCorner.Label": "Canto do ecrã",
"Options.OverlayCorner.Desc": "Escolher o canto guardado. F2 muda de canto apenas nesta sessão. Não move as estatísticas da barra de título.",
"Options.OverlayMode.Full": "Completo",
"Options.OverlayMode.Minimal": "Mínimo",
"Options.OverlayMode.TitleBar": "Barra de título (mínimo)",
"Options.OverlayCorner.TopLeft": "Superior esquerdo",
"Options.OverlayCorner.TopRight": "Superior direito",
"Options.OverlayCorner.BottomRight": "Inferior direito",
"Options.OverlayCorner.BottomLeft": "Inferior esquerdo",
"Page.Library": "Biblioteca", "Page.Library": "Biblioteca",
"Page.Options": "Opções", "Page.Options": "Opções",
@ -39,7 +55,10 @@
"Options.Env.DumpSpirv.Desc": "Extrai os shaders AGC e as respetivas traduções SPIR-V para a pasta shader-dumps.\nUtilize ao reportar problemas de shaders ou renderização.", "Options.Env.DumpSpirv.Desc": "Extrai os shaders AGC e as respetivas traduções SPIR-V para a pasta shader-dumps.\nUtilize ao reportar problemas de shaders ou renderização.",
"Options.Env.LogDirectMemory.Desc": "Regista alocações de memória direta e falhas na consola.\nUtilize quando um jogo aborta ou fecha durante o arranque.", "Options.Env.LogDirectMemory.Desc": "Regista alocações de memória direta e falhas na consola.\nUtilize quando um jogo aborta ou fecha durante o arranque.",
"Options.Env.LogNp.Desc": "Regista chamadas da biblioteca NP (PlayStation Network) na consola.", "Options.Env.LogNp.Desc": "Regista chamadas da biblioteca NP (PlayStation Network) na consola.",
"Options.Env.GuestImageCpuSync.Desc": "Recarrega as superfícies do convidado que o próprio código de CPU do jogo reescreve.\nDeixar desativado normalmente. Ativar para títulos cujas superfícies desenhadas pela CPU nunca chegam ao ecrã.\nCusta desempenho e causa regressões em alguns títulos, como GTA V.", "Options.Env.Group.Debug": "Depuração",
"Options.Env.Group.General": "Geral",
"Options.Env.RenderDoc.Desc": "Carrega a API in-application do RenderDoc para capturar frames a partir do emulador.\nPrime F12 enquanto o jogo corre para capturar um frame; as capturas vão para user/logs/capture_logs/<TITLE_ID>.\nRequer o RenderDoc instalado. Torna a GPU mais lenta e bloqueia alguns títulos, por isso deixa desativado a menos que estejas a depurar.",
"Options.Env.DisableVkImplicitLayers.Desc": "Quando o RenderDoc está ativado, outros overlays em conflito podem causar perda do dispositivo. Ativar esta opção pode corrigir o problema.",
"Options.Section.Emulation": "EMULAÇÃO", "Options.Section.Emulation": "EMULAÇÃO",
"Options.Section.Logging": "REGISTOS", "Options.Section.Logging": "REGISTOS",
"Options.Section.Launcher": "LANÇADOR", "Options.Section.Launcher": "LANÇADOR",
@ -63,6 +82,8 @@
"Options.TraceImports.Label": "Limite de rastreio de importações", "Options.TraceImports.Label": "Limite de rastreio de importações",
"Options.TraceImports.Desc": "Rastreia as primeiras N importações por módulo (0 = desativado).", "Options.TraceImports.Desc": "Rastreia as primeiras N importações por módulo (0 = desativado).",
"Options.CrashDump.Label": "Ficheiros de memória de falhas",
"Options.CrashDump.Desc": "Guarda os ficheiros de memória de falhas junto ao registo de execução (apenas Windows x64). Os ficheiros podem ser grandes e conter dados privados.",
"Options.LogToFile.Label": "Registar para ficheiro", "Options.LogToFile.Label": "Registar para ficheiro",
"Options.LogToFile.Desc": "Duplicar a saída do emulador para um ficheiro de registo.", "Options.LogToFile.Desc": "Duplicar a saída do emulador para um ficheiro de registo.",
@ -100,6 +121,17 @@
"Launch.Idle": "Inativo", "Launch.Idle": "Inativo",
"Launch.Console": "≡ Consola", "Launch.Console": "≡ Consola",
"Launch.Launch": "▶ Iniciar", "Launch.Launch": "▶ Iniciar",
"Launch.CustomEnv": "Iniciar com variáveis de ambiente personalizadas",
"Launch.CustomEnv.Title": "Iniciar com variáveis de ambiente personalizadas",
"Launch.CustomEnv.Desc": "Introduza uma variável de ambiente por linha no formato NOME=VALOR. Os valores personalizados substituem as definições da GUI e específicas do jogo com o mesmo nome.",
"Launch.CustomEnv.Documentation": "Ver variáveis de ambiente não documentadas ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_EXEMPLO=1",
"Launch.CustomEnv.SaveGame": "Guardar para o jogo",
"Launch.CustomEnv.SaveGlobal": "Guardar globalmente",
"Launch.CustomEnv.Play": "Jogar",
"Launch.CustomEnv.Invalid": "Variável de ambiente inválida: {0}",
"Launch.CustomEnv.SavedGame": "Guardado para este jogo.",
"Launch.CustomEnv.SavedGlobal": "Guardado globalmente.",
"Launch.Stop": "■ Parar", "Launch.Stop": "■ Parar",
"Launch.Running": "Em execução — {0}", "Launch.Running": "Em execução — {0}",
"Launch.Stopping": "A parar…", "Launch.Stopping": "A parar…",
@ -149,7 +181,7 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "Junte-se à comunidade, obtenha suporte e acompanhe o desenvolvimento.", "About.Discord.Desc": "Junte-se à comunidade, obtenha suporte e acompanhe o desenvolvimento.",
"About.GithubButton": "Contribua no GitHub!", "About.GithubButton": "Contribua no GitHub!",
"About.DiscordComingSoon": "Em breve", "About.DiscordButton": "Junte-se ao nosso Discord!",
"Library.Context.GameSettings": "Definições do jogo…", "Library.Context.GameSettings": "Definições do jogo…",
"Options.Env.WritableApp0.Desc": "Permitir que os jogos criem e escrevam ficheiros dentro da sua pasta de instalação.\nNecessário para dumps não empacotados que escrevem os seus dados guardados ou configurações em /app0.", "Options.Env.WritableApp0.Desc": "Permitir que os jogos criem e escrevam ficheiros dentro da sua pasta de instalação.\nNecessário para dumps não empacotados que escrevem os seus dados guardados ou configurações em /app0.",
@ -174,11 +206,13 @@
"Updater.Status.ChecksumFailed": "A atualização transferida falhou a verificação SHA-256.", "Updater.Status.ChecksumFailed": "A atualização transferida falhou a verificação SHA-256.",
"Updater.Status.Unsupported": "A atualização automática requer um build x64 para Windows, Linux ou macOS.", "Updater.Status.Unsupported": "A atualização automática requer um build x64 para Windows, Linux ou macOS.",
"Options.Graphics": "Gráficos", "Options.Graphics": "Gráficos",
"Options.Console.Type.Label": "Consola",
"Options.Console.Type.Desc": "Modelo de consola comunicado aos jogos.",
"Options.Console.Language.Label": "Idioma da consola",
"Options.Console.Language.Desc": "Idioma do sistema comunicado aos jogos.",
"Options.Section.Rendering": "RENDERIZAÇÃO", "Options.Section.Rendering": "RENDERIZAÇÃO",
"Options.Section.Display": "ECRÃ", "Options.Section.Display": "ECRÃ",
"Options.RenderResolution.Label": "Resolução interna",
"Options.RenderResolution.Desc": "Renderiza alvos fora do ecrã abaixo da resolução nativa e amplia-os na apresentação. Valores inferiores trocam qualidade de imagem por margem da GPU; entra em vigor no próximo arranque.",
"Options.RenderResolution.Native": "100% (nativa)",
"Options.WindowMode.Label": "Modo de janela", "Options.WindowMode.Label": "Modo de janela",
"Options.WindowMode.Desc": "Janela normal, ambiente de trabalho sem margens ou ecrã inteiro exclusivo.", "Options.WindowMode.Desc": "Janela normal, ambiente de trabalho sem margens ou ecrã inteiro exclusivo.",
"Options.WindowMode.Windowed": "Em janela", "Options.WindowMode.Windowed": "Em janela",
@ -201,5 +235,10 @@
"Options.VSync.Desc": "Utiliza apresentação FIFO para evitar cortes na imagem.", "Options.VSync.Desc": "Utiliza apresentação FIFO para evitar cortes na imagem.",
"Options.Hdr.Label": "Saída HDR", "Options.Hdr.Label": "Saída HDR",
"Options.Hdr.Desc": "Utiliza HDR quando o ecrã selecionado e o backend gráfico o suportam. O modo automático regressa a SDR.", "Options.Hdr.Desc": "Utiliza HDR quando o ecrã selecionado e o backend gráfico o suportam. O modo automático regressa a SDR.",
"Options.Hdr.Auto": "Automático" "Options.Hdr.Auto": "Automático",
"Options.Env.BinkPlayback.Label": "Reprodução de vídeo Bink",
"Options.Env.BinkPlayback.Desc": "Host reproduz vídeos Bink pela ponte FFmpeg, mas alguns jogos podem apresentar problemas.\nGuest usa o descodificador do próprio motor do jogo.\nSkip ignora os vídeos Bink, o que pode facilitar o desenvolvimento.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Ignorar"
} }

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "Русский", "_languageName": "Русский",
"Options.Env.StrictCompute.Desc": "Останавливать при отказах шейдеров вычисления и отрисовки (по умолчанию).\nОтключите, чтобы пропускать эти операции. Возможны пропавшие изображения, ошибки и зависания. После изменения перезапустите игру.",
"Options.Env.PerformanceProfile.Desc": "Записывать время выполнения операций и FPS со следующего запуска игры.\nЭто может снизить производительность.",
"Options.Env.PerformanceFrameTrace.Desc": "Сохранять последние 4096 интервалов показа кадров и записывать их в журнал при завершении.\nТребуется профилирование производительности. Закройте игру обычным способом, чтобы сохранить трассировку.",
"Options.OverlayEnabled.Label": "Показатели производительности",
"Options.OverlayEnabled.Desc": "Показывать статистику. F1 переключает показ только в текущем сеансе. SHARPEMU_OVERLAY=0 скрывает его при запуске.",
"Options.OverlayMode.Label": "Режим отображения",
"Options.OverlayMode.Desc": "Полный режим показывает все счётчики. Минимальный и Строка заголовка показывают FPS, CPU, загрузку GPU и время. GPU измеряется для процесса в Windows; иначе N/A.",
"Options.OverlayCorner.Label": "Угол экрана",
"Options.OverlayCorner.Desc": "Выберите сохраняемый угол. F2 меняет угол только в текущем сеансе. Статистика в строке заголовка не перемещается.",
"Options.OverlayMode.Full": "Полный",
"Options.OverlayMode.Minimal": "Минимальный",
"Options.OverlayMode.TitleBar": "Строка заголовка (минимум)",
"Options.OverlayCorner.TopLeft": "Слева вверху",
"Options.OverlayCorner.TopRight": "Справа вверху",
"Options.OverlayCorner.BottomRight": "Справа внизу",
"Options.OverlayCorner.BottomLeft": "Слева внизу",
"Page.Library": "Библиотека", "Page.Library": "Библиотека",
"Page.Options": "Настройки", "Page.Options": "Настройки",
@ -42,7 +58,10 @@
"Options.Env.LogDirectMemory.Desc": "Выводить в консоль выделения прямой памяти и ошибки выделения.\nИспользуйте, если игра аварийно завершает работу или закрывается при запуске.", "Options.Env.LogDirectMemory.Desc": "Выводить в консоль выделения прямой памяти и ошибки выделения.\nИспользуйте, если игра аварийно завершает работу или закрывается при запуске.",
"Options.Env.LogIo.Desc": "Выводить в консоль операции открытия и чтения файлов, а также разрешение путей.\nИспользуйте, если игра не может найти файлы данных при запуске.", "Options.Env.LogIo.Desc": "Выводить в консоль операции открытия и чтения файлов, а также разрешение путей.\nИспользуйте, если игра не может найти файлы данных при запуске.",
"Options.Env.LogNp.Desc": "Выводить в консоль вызовы библиотеки NP (PlayStation Network).", "Options.Env.LogNp.Desc": "Выводить в консоль вызовы библиотеки NP (PlayStation Network).",
"Options.Env.GuestImageCpuSync.Desc": "Повторно загружать гостевые поверхности, которые переписывает собственный код ЦП игры.\nОбычно оставляйте выключенным. Включайте для игр, чьи отрисованные ЦП поверхности не попадают на экран.\nСнижает производительность и вызывает регрессии в некоторых играх, например в GTA V.", "Options.Env.Group.Debug": "Отладка",
"Options.Env.Group.General": "Общие",
"Options.Env.RenderDoc.Desc": "Загружает внутренний API RenderDoc, чтобы кадры можно было захватывать из эмулятора.\nНажмите F12 во время игры, чтобы захватить один кадр; захваты сохраняются в user/logs/capture_logs/<TITLE_ID>.\nТребует установленного RenderDoc. Замедляет GPU и подвешивает некоторые игры, поэтому оставьте выключенным, если не занимаетесь отладкой.",
"Options.Env.DisableVkImplicitLayers.Desc": "Когда RenderDoc включён, другие конфликтующие оверлеи могут вызвать потерю устройства. Включение этой настройки может решить проблему.",
"Options.Section.Emulation": "ЭМУЛЯЦИЯ", "Options.Section.Emulation": "ЭМУЛЯЦИЯ",
"Options.Section.Logging": "ЛОГГИРОВАНИЕ", "Options.Section.Logging": "ЛОГГИРОВАНИЕ",
"Options.Section.Launcher": "ЛАУНЧЕР", "Options.Section.Launcher": "ЛАУНЧЕР",
@ -50,9 +69,11 @@
"Options.Section.Display": "ЭКРАН", "Options.Section.Display": "ЭКРАН",
"Options.Graphics": "Графика", "Options.Graphics": "Графика",
"Options.RenderResolution.Label": "Внутреннее разрешение", "Options.Console.Type.Label": "Консоль",
"Options.RenderResolution.Desc": "Рендерить внеэкранные буферы ниже нативного разрешения и масштабировать при выводе. Меньшие значения снижают качество изображения, но уменьшают нагрузку на GPU; применяется при следующем запуске.", "Options.Console.Type.Desc": "Модель консоли, сообщаемая играм.",
"Options.RenderResolution.Native": "100% (нативное)", "Options.Console.Language.Label": "Язык консоли",
"Options.Console.Language.Desc": "Системный язык, сообщаемый играм.",
"Options.WindowMode.Label": "Режим окна", "Options.WindowMode.Label": "Режим окна",
"Options.WindowMode.Desc": "Обычное окно, безрамочный режим рабочего стола или эксклюзивный полноэкранный режим.", "Options.WindowMode.Desc": "Обычное окно, безрамочный режим рабочего стола или эксклюзивный полноэкранный режим.",
"Options.WindowMode.Windowed": "Оконный", "Options.WindowMode.Windowed": "Оконный",
@ -76,6 +97,11 @@
"Options.Hdr.Label": "HDR-вывод", "Options.Hdr.Label": "HDR-вывод",
"Options.Hdr.Desc": "Использовать HDR, если выбранный монитор и графический бэкенд его поддерживают. Автоматический режим при необходимости переключается на SDR.", "Options.Hdr.Desc": "Использовать HDR, если выбранный монитор и графический бэкенд его поддерживают. Автоматический режим при необходимости переключается на SDR.",
"Options.Hdr.Auto": "Авто", "Options.Hdr.Auto": "Авто",
"Options.Env.BinkPlayback.Label": "Воспроизведение видео Bink",
"Options.Env.BinkPlayback.Desc": "Host воспроизводит видео Bink через мост FFmpeg, однако в некоторых играх могут возникать проблемы.\nGuest использует собственный декодер игрового движка.\nSkip пропускает видео Bink, что может упростить разработку.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Пропустить",
"Options.CpuEngine.Label": "Движок ЦП", "Options.CpuEngine.Label": "Движок ЦП",
"Options.CpuEngine.Desc": "Движок выполнения, используемый для запуска игрового кода.", "Options.CpuEngine.Desc": "Движок выполнения, используемый для запуска игрового кода.",
@ -96,6 +122,8 @@
"Options.TraceImports.Label": "Лимит трассировки импортов", "Options.TraceImports.Label": "Лимит трассировки импортов",
"Options.TraceImports.Desc": "Трассировать первые N импортов в каждом модуле (0 - выключено).", "Options.TraceImports.Desc": "Трассировать первые N импортов в каждом модуле (0 - выключено).",
"Options.CrashDump.Label": "Дампы сбоев",
"Options.CrashDump.Desc": "Сохранять дампы сбоев рядом с журналом запуска (только Windows x64). Файлы могут быть большими и содержать личные данные.",
"Options.LogToFile.Label": "Запись лога в файл", "Options.LogToFile.Label": "Запись лога в файл",
"Options.LogToFile.Desc": "Дублировать вывод эмулятора в файл лога.", "Options.LogToFile.Desc": "Дублировать вывод эмулятора в файл лога.",
@ -136,6 +164,17 @@
"Launch.Idle": "Ожидание", "Launch.Idle": "Ожидание",
"Launch.Console": "≡ Консоль", "Launch.Console": "≡ Консоль",
"Launch.Launch": "▶ Запустить", "Launch.Launch": "▶ Запустить",
"Launch.CustomEnv": "Запустить с пользовательскими переменными среды",
"Launch.CustomEnv.Title": "Запустить с пользовательскими переменными среды",
"Launch.CustomEnv.Desc": "Введите по одной переменной среды на строку в формате ИМЯ=ЗНАЧЕНИЕ. Пользовательские значения переопределяют одноимённые настройки GUI и игры.",
"Launch.CustomEnv.Documentation": "Показать недокументированные переменные среды ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_PRIMER=1",
"Launch.CustomEnv.SaveGame": "Сохранить для игры",
"Launch.CustomEnv.SaveGlobal": "Сохранить глобально",
"Launch.CustomEnv.Play": "Играть",
"Launch.CustomEnv.Invalid": "Недопустимая переменная среды: {0}",
"Launch.CustomEnv.SavedGame": "Сохранено для этой игры.",
"Launch.CustomEnv.SavedGlobal": "Сохранено глобально.",
"Launch.Stop": "■ Остановить", "Launch.Stop": "■ Остановить",
"Launch.Running": "Запущено - {0}", "Launch.Running": "Запущено - {0}",
"Launch.Stopping": "Остановка…", "Launch.Stopping": "Остановка…",
@ -187,7 +226,7 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "Присоединяйтесь к сообществу, получайте поддержку и следите за разработкой.", "About.Discord.Desc": "Присоединяйтесь к сообществу, получайте поддержку и следите за разработкой.",
"About.GithubButton": "Участвовать в разработке на GitHub!", "About.GithubButton": "Участвовать в разработке на GitHub!",
"About.DiscordComingSoon": "Скоро", "About.DiscordButton": "Присоединяйтесь к нашему Discord!",
"Updater.Auto.Label": "Проверять обновления при запуске", "Updater.Auto.Label": "Проверять обновления при запуске",
"Updater.Auto.Desc": "Проверяет GitHub без задержки запуска.", "Updater.Auto.Desc": "Проверяет GitHub без задержки запуска.",

View File

@ -1,5 +1,21 @@
{ {
"_languageName": "Türkçe", "_languageName": "Türkçe",
"Options.Env.StrictCompute.Desc": "Hesaplama ve çizim gölgelendiricisi retlerinde durdur (varsayılan).\nEtkilenen işlemleri atlamak için kapat. Eksik görüntüler, hatalar veya takılmalar olabilir. Değişiklikten sonra oyunu yeniden başlatın.",
"Options.Env.PerformanceProfile.Desc": "Sonraki oyun başlangıcından itibaren performans sürelerini ve FPS değerlerini kaydet.\nBu, performansı düşürebilir.",
"Options.Env.PerformanceFrameTrace.Desc": "Son 4.096 sunum aralığını sakla ve kapanışta günlüğe yaz.\nPerformans profillemesi gerektirir. İzi kaydetmek için oyunu normal şekilde kapat.",
"Options.OverlayEnabled.Label": "Performans göstergesi",
"Options.OverlayEnabled.Desc": "Performans istatistiklerini gösterir. F1 göstergeyi bu oturum için açar veya kapatır. SHARPEMU_OVERLAY=0 başlangıçta gizler.",
"Options.OverlayMode.Label": "Görüntüleme modu",
"Options.OverlayMode.Desc": "Tam tüm sayaçları gösterir. Asgari ve Başlık çubuğu FPS, CPU, GPU kullanımı ve geçen süreyi gösterir. GPU kullanımı Windows’ta işlem bazındadır; diğer sistemlerde N/A gösterilir.",
"Options.OverlayCorner.Label": "Ekran köşesi",
"Options.OverlayCorner.Desc": "Kaydedilecek köşeyi seçin. F2 köşeyi yalnızca bu oturum için değiştirir. Başlık çubuğundaki istatistikleri taşımaz.",
"Options.OverlayMode.Full": "Tam",
"Options.OverlayMode.Minimal": "Asgari",
"Options.OverlayMode.TitleBar": "Başlık çubuğu (asgari)",
"Options.OverlayCorner.TopLeft": "Sol üst",
"Options.OverlayCorner.TopRight": "Sağ üst",
"Options.OverlayCorner.BottomRight": "Sağ alt",
"Options.OverlayCorner.BottomLeft": "Sol alt",
"Page.Library": "Kütüphane", "Page.Library": "Kütüphane",
"Page.Options": "Ayarlar", "Page.Options": "Ayarlar",
@ -38,6 +54,11 @@
"Options.Section.Display": "GÖRÜNTÜ", "Options.Section.Display": "GÖRÜNTÜ",
"Options.Graphics": "Grafik", "Options.Graphics": "Grafik",
"Options.Console.Type.Label": "Konsol",
"Options.Console.Type.Desc": "Oyunlara bildirilen konsol modeli.",
"Options.Console.Language.Label": "Konsol dili",
"Options.Console.Language.Desc": "Oyunlara bildirilen sistem dili.",
"Options.WindowMode.Label": "Pencere modu", "Options.WindowMode.Label": "Pencere modu",
"Options.WindowMode.Desc": "Normal pencere, kenarlıksız masaüstü veya özel tam ekran.", "Options.WindowMode.Desc": "Normal pencere, kenarlıksız masaüstü veya özel tam ekran.",
"Options.Resolution.Label": "Çözünürlük", "Options.Resolution.Label": "Çözünürlük",
@ -73,6 +94,8 @@
"Options.TraceImports.Label": "Import izleme sınırı", "Options.TraceImports.Label": "Import izleme sınırı",
"Options.TraceImports.Desc": "Modül başına ilk N import'u izle (0 = kapalı).", "Options.TraceImports.Desc": "Modül başına ilk N import'u izle (0 = kapalı).",
"Options.CrashDump.Label": "Çökme dökümleri",
"Options.CrashDump.Desc": "Çökme dökümlerini çalıştırma günlüğünün yanına kaydeder (yalnızca Windows x64). Dökümler büyük olabilir ve özel veriler içerebilir.",
"Options.LogToFile.Label": "Dosyaya günlükle", "Options.LogToFile.Label": "Dosyaya günlükle",
"Options.LogToFile.Desc": "Emülatör çıktısını bir günlük dosyasına yansıt.", "Options.LogToFile.Desc": "Emülatör çıktısını bir günlük dosyasına yansıt.",
@ -108,6 +131,17 @@
"Launch.Idle": "Boşta", "Launch.Idle": "Boşta",
"Launch.Console": "≡ Konsol", "Launch.Console": "≡ Konsol",
"Launch.Launch": "▶ Başlat", "Launch.Launch": "▶ Başlat",
"Launch.CustomEnv": "Özel env ile başlat",
"Launch.CustomEnv.Title": "Özel env ile başlat",
"Launch.CustomEnv.Desc": "Ortam değişkenlerini NAME=VALUE biçiminde her satıra bir tane yazın. Özel değerler, aynı isimdeki GUI ve oyuna özel ortam ayarlarını geçersiz kılar.",
"Launch.CustomEnv.Documentation": "Belgelenmemiş ortam değişkenlerini görüntüle ↗",
"Launch.CustomEnv.Placeholder": "SHARPEMU_ORNEK=1",
"Launch.CustomEnv.SaveGame": "Oyun için kaydet",
"Launch.CustomEnv.SaveGlobal": "Genel olarak kaydet",
"Launch.CustomEnv.Play": "Oyna",
"Launch.CustomEnv.Invalid": "Geçersiz ortam değişkeni: {0}",
"Launch.CustomEnv.SavedGame": "Bu oyun için kaydedildi.",
"Launch.CustomEnv.SavedGlobal": "Genel olarak kaydedildi.",
"Launch.Stop": "■ Durdur", "Launch.Stop": "■ Durdur",
"Launch.Running": "Çalışıyor — {0}", "Launch.Running": "Çalışıyor — {0}",
"Launch.Stopping": "Durduruluyor…", "Launch.Stopping": "Durduruluyor…",
@ -179,7 +213,10 @@
"Options.Env.LogDirectMemory.Desc": "Doğrudan bellek tahsislerini ve hatalarını konsola günlükle.\nBir oyun açılış sırasında çöküyor veya kapanıyorsa kullanın.", "Options.Env.LogDirectMemory.Desc": "Doğrudan bellek tahsislerini ve hatalarını konsola günlükle.\nBir oyun açılış sırasında çöküyor veya kapanıyorsa kullanın.",
"Options.Env.LogIo.Desc": "Dosya açma, okuma ve yol çözümleme etkinliğini konsola günlükle.\nBir oyun açılışta veri dosyalarını bulamıyorsa kullanın.", "Options.Env.LogIo.Desc": "Dosya açma, okuma ve yol çözümleme etkinliğini konsola günlükle.\nBir oyun açılışta veri dosyalarını bulamıyorsa kullanın.",
"Options.Env.LogNp.Desc": "NP (PlayStation Network) kütüphane çağrılarını konsola günlükle.", "Options.Env.LogNp.Desc": "NP (PlayStation Network) kütüphane çağrılarını konsola günlükle.",
"Options.Env.GuestImageCpuSync.Desc": "Oyunun kendi CPU kodunun yeniden yazdığı misafir yüzeyleri tekrar yükler.\nNormalde kapalı bırakın. CPU ile çizilen yüzeyleri ekrana ulaşmayan oyunlarda açın.\nPerformansa mal olur ve GTA V gibi bazı oyunlarda soruna yol açar.", "Options.Env.Group.Debug": "Hata Ayıklama",
"Options.Env.Group.General": "Genel",
"Options.Env.RenderDoc.Desc": "RenderDoc uygulama içi API'sini yükler, böylece kareler emülatörün içinden yakalanabilir.\nOyun çalışırken F12'a basınca bir kare yakalanır; kayıtlar user/logs/capture_logs/<TITLE_ID> altına düşer.\nRenderDoc'un kurulu olmasını gerektirir. GPU'yu yavaşlatır ve bazı oyunları kilitler, hata ayıklamıyorsanız kapalı bırakın.",
"Options.Env.DisableVkImplicitLayers.Desc": "RenderDoc ayarı açıkken diğer çakışan overlayler device loss'a sebebiyet verebiliyor. Bu ayarı açmak bunu düzeltebilir.",
"Options.DefaultProfile.Label": "Varsayilan profil adi", "Options.DefaultProfile.Label": "Varsayilan profil adi",
"Options.DefaultProfile.Desc": "Oyun metin girisi istediginde kullanilacak ad. Varsayilan deger Sharp'tir.", "Options.DefaultProfile.Desc": "Oyun metin girisi istediginde kullanilacak ad. Varsayilan deger Sharp'tir.",
"Common.Save": "Kaydet", "Common.Save": "Kaydet",
@ -192,11 +229,8 @@
"About.Discord.Label": "Discord", "About.Discord.Label": "Discord",
"About.Discord.Desc": "Topluluğa katılın, destek alın ve geliştirmeyi takip edin.", "About.Discord.Desc": "Topluluğa katılın, destek alın ve geliştirmeyi takip edin.",
"About.GithubButton": "GitHub'da katkıda bulun!", "About.GithubButton": "GitHub'da katkıda bulun!",
"About.DiscordComingSoon": "Yakında", "About.DiscordButton": "Discord'a katıl!",
"Options.Section.Rendering": "GÖRÜNTÜ İŞLEME", "Options.Section.Rendering": "GÖRÜNTÜ İŞLEME",
"Options.RenderResolution.Label": "Dahili çözünürlük",
"Options.RenderResolution.Desc": "Ekran dışı hedefleri doğal çözünürlüğün altında işle ve sunum sırasında ölçeklendir. Daha düşük değerler GPU payı karşılığında görüntü kalitesini azaltır; bir sonraki başlatmada etkili olur.",
"Options.RenderResolution.Native": "%100 (doğal)",
"Options.WindowMode.Windowed": "Pencereli", "Options.WindowMode.Windowed": "Pencereli",
"Options.WindowMode.Borderless": "Kenarlıksız", "Options.WindowMode.Borderless": "Kenarlıksız",
"Options.WindowMode.Exclusive": "Özel", "Options.WindowMode.Exclusive": "Özel",
@ -204,5 +238,10 @@
"Options.Scaling.Cover": "Kapla", "Options.Scaling.Cover": "Kapla",
"Options.Scaling.Stretch": "Uzat", "Options.Scaling.Stretch": "Uzat",
"Options.Scaling.Integer": "Tam sayı", "Options.Scaling.Integer": "Tam sayı",
"Options.Hdr.Auto": "Otomatik" "Options.Hdr.Auto": "Otomatik",
"Options.Env.BinkPlayback.Label": "Bink video oynatma",
"Options.Env.BinkPlayback.Desc": "Host, Bink videolarını FFmpeg köprüsüyle oynatır ancak bazı oyunlarda sorunlarla karşılaşabilir.\nGuest, oyun motorunun kendi kod çözücüsünü kullanır.\nSkip, Bink videolarını atlar; bu, geliştirmeyi kolaylaştırabilir.",
"Options.Env.BinkPlayback.Host": "Host (FFmpeg)",
"Options.Env.BinkPlayback.Guest": "Guest",
"Options.Env.BinkPlayback.Skip": "Atla"
} }

View File

@ -0,0 +1,37 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
namespace SharpEmu.GUI;
internal readonly record struct LibraryTileMetrics(
double CoverSize,
double ItemWidth,
double RailItemHeight,
double GridItemHeight);
internal static class LibraryLayoutMetrics
{
internal const double MinimumCoverSize = 112;
internal const double MaximumCoverSize = 148;
private const double HorizontalPadding = 24;
private const double ItemWidthExtra = 12;
private const double ItemMargin = 12;
private const double RailHeightExtra = 24;
private const double GridHeightExtra = 52;
private const double TargetColumnCount = 9;
internal static LibraryTileMetrics Calculate(double availableWidth)
{
var contentWidth = Math.Max(0, availableWidth - HorizontalPadding);
var coverSize = Math.Clamp(
(contentWidth / TargetColumnCount) - ItemWidthExtra - ItemMargin,
MinimumCoverSize,
MaximumCoverSize);
return new LibraryTileMetrics(
CoverSize: coverSize,
ItemWidth: coverSize + ItemWidthExtra,
RailItemHeight: coverSize + RailHeightExtra,
GridItemHeight: coverSize + GridHeightExtra);
}
}

View File

@ -13,6 +13,9 @@ public partial class MainWindow
{ {
private static readonly string[] GameEnvironmentToggleNames = private static readonly string[] GameEnvironmentToggleNames =
[ [
"SHARPEMU_PROFILE_PERFORMANCE",
"SHARPEMU_PROFILE_PERFORMANCE_FRAME_TRACE",
StrictComputeSettings.VariableName,
"SHARPEMU_BTHID_UNAVAILABLE", "SHARPEMU_BTHID_UNAVAILABLE",
"SHARPEMU_DISABLE_IMPORT_LOOP_GUARD", "SHARPEMU_DISABLE_IMPORT_LOOP_GUARD",
"SHARPEMU_WRITABLE_APP0", "SHARPEMU_WRITABLE_APP0",
@ -21,7 +24,9 @@ public partial class MainWindow
"SHARPEMU_LOG_DIRECT_MEMORY", "SHARPEMU_LOG_DIRECT_MEMORY",
"SHARPEMU_LOG_IO", "SHARPEMU_LOG_IO",
"SHARPEMU_LOG_NP", "SHARPEMU_LOG_NP",
"SHARPEMU_GUEST_IMAGE_CPU_SYNC", "SHARPEMU_RENDERDOC",
"SHARPEMU_VK_DISABLE_IMPLICITS",
"SHARPEMU_CRASH_CAPTURE",
]; ];
private readonly List<string> _gameEnvironmentPassthrough = new(); private readonly List<string> _gameEnvironmentPassthrough = new();
@ -41,6 +46,8 @@ public partial class MainWindow
GameWindowModeBox.ItemsSource = _windowModeChoices; GameWindowModeBox.ItemsSource = _windowModeChoices;
GameScalingModeBox.ItemsSource = _scalingModeChoices; GameScalingModeBox.ItemsSource = _scalingModeChoices;
GameHdrModeBox.ItemsSource = _hdrModeChoices; GameHdrModeBox.ItemsSource = _hdrModeChoices;
GameOverlayModeBox.ItemsSource = _overlayModeChoices;
GameOverlayCornerBox.ItemsSource = _overlayCornerChoices;
var navigationButtons = GameOptionsNavigationButtons(); var navigationButtons = GameOptionsNavigationButtons();
for (var index = 0; index < navigationButtons.Length; index++) for (var index = 0; index < navigationButtons.Length; index++)
@ -109,6 +116,9 @@ public partial class MainWindow
GameScalingModeBox.SelectionChanged += (_, _) => PersistOpenGameSettings(); GameScalingModeBox.SelectionChanged += (_, _) => PersistOpenGameSettings();
GameVSyncToggle.IsCheckedChanged += (_, _) => PersistOpenGameSettings(); GameVSyncToggle.IsCheckedChanged += (_, _) => PersistOpenGameSettings();
GameHdrModeBox.SelectionChanged += (_, _) => PersistOpenGameSettings(); GameHdrModeBox.SelectionChanged += (_, _) => PersistOpenGameSettings();
GameOverlayEnabledToggle.IsCheckedChanged += (_, _) => PersistOpenGameSettings();
GameOverlayModeBox.SelectionChanged += (_, _) => PersistOpenGameSettings();
GameOverlayCornerBox.SelectionChanged += (_, _) => PersistOpenGameSettings();
foreach (var (_, toggle) in GameEnvironmentToggles()) foreach (var (_, toggle) in GameEnvironmentToggles())
{ {
toggle.IsCheckedChanged += (_, _) => PersistOpenGameSettings(); toggle.IsCheckedChanged += (_, _) => PersistOpenGameSettings();
@ -141,6 +151,7 @@ public partial class MainWindow
!string.IsNullOrWhiteSpace(game.TitleId); !string.IsNullOrWhiteSpace(game.TitleId);
_isGameSettingsOpen = true; _isGameSettingsOpen = true;
UpdateEmbeddedConsoleVisibility();
SetGameOptionsPagesSpan(coversConsoleRow: true); SetGameOptionsPagesSpan(coversConsoleRow: true);
SetGameOptionsOpenClass(BackdropLayer, active: true); SetGameOptionsOpenClass(BackdropLayer, active: true);
SetGameOptionsOpenClass(CarouselHost, active: true); SetGameOptionsOpenClass(CarouselHost, active: true);
@ -160,6 +171,7 @@ public partial class MainWindow
} }
_isGameSettingsOpen = false; _isGameSettingsOpen = false;
UpdateEmbeddedConsoleVisibility();
SetGameOptionsPagesSpan(coversConsoleRow: false); SetGameOptionsPagesSpan(coversConsoleRow: false);
SetGameOptionsNavigationIndicator(_gameOptionsIndicatorIndex, animate: false); SetGameOptionsNavigationIndicator(_gameOptionsIndicatorIndex, animate: false);
_gameSettingsTitleId = null; _gameSettingsTitleId = null;
@ -205,6 +217,9 @@ public partial class MainWindow
effective.ScalingMode, effective.ScalingMode,
"Fit"); "Fit");
GameVSyncToggle.IsChecked = effective.VSync; GameVSyncToggle.IsChecked = effective.VSync;
GameOverlayEnabledToggle.IsChecked = effective.OverlayEnabled;
GameOverlayModeBox.SelectedItem = FindChoice(_overlayModeChoices, effective.OverlayMode, "TitleBar");
GameOverlayCornerBox.SelectedItem = FindChoice(_overlayCornerChoices, effective.OverlayCorner, "TopRight");
GameHdrModeBox.SelectedItem = FindChoice( GameHdrModeBox.SelectedItem = FindChoice(
_hdrModeChoices, _hdrModeChoices,
effective.HdrMode, effective.HdrMode,
@ -234,9 +249,7 @@ public partial class MainWindow
foreach (var (name, toggle) in GameEnvironmentToggles()) foreach (var (name, toggle) in GameEnvironmentToggles())
{ {
toggle.IsChecked = IsEnvironmentEnabled( toggle.IsChecked = IsEnvironmentEnabled(effective.EnvironmentToggles, name);
effective.EnvironmentToggles,
name);
} }
} }
finally finally
@ -271,7 +284,11 @@ public partial class MainWindow
ScalingMode = SelectedComboText(GameScalingModeBox, "Fit"), ScalingMode = SelectedComboText(GameScalingModeBox, "Fit"),
VSync = GameVSyncToggle.IsChecked == true, VSync = GameVSyncToggle.IsChecked == true,
HdrMode = SelectedComboText(GameHdrModeBox, "Auto"), HdrMode = SelectedComboText(GameHdrModeBox, "Auto"),
OverlayEnabled = GameOverlayEnabledToggle.IsChecked == true,
OverlayMode = SelectedComboText(GameOverlayModeBox, "TitleBar"),
OverlayCorner = SelectedComboText(GameOverlayCornerBox, "TopRight"),
EnvironmentToggles = BuildGameEnvironmentEntries(), EnvironmentToggles = BuildGameEnvironmentEntries(),
CustomEnvironmentVariables = PerGameSettings.Load(_gameSettingsTitleId)?.CustomEnvironmentVariables,
}; };
settings.RemoveInheritedValues(_settings); settings.RemoveInheritedValues(_settings);
settings.Save(_gameSettingsTitleId); settings.Save(_gameSettingsTitleId);
@ -368,7 +385,9 @@ public partial class MainWindow
var entries = new List<string>(_gameEnvironmentPassthrough); var entries = new List<string>(_gameEnvironmentPassthrough);
foreach (var (name, toggle) in GameEnvironmentToggles()) foreach (var (name, toggle) in GameEnvironmentToggles())
{ {
if (toggle.IsChecked == true) if (name == StrictComputeSettings.VariableName)
StrictComputeSettings.SetEnabled(entries, toggle.IsChecked == true);
else if (toggle.IsChecked == true)
{ {
entries.Add(name); entries.Add(name);
} }
@ -386,10 +405,9 @@ public partial class MainWindow
?? choices.First(choice => ?? choices.First(choice =>
string.Equals(choice.Value, fallback, StringComparison.OrdinalIgnoreCase)); string.Equals(choice.Value, fallback, StringComparison.OrdinalIgnoreCase));
private static bool IsEnvironmentEnabled( private static bool IsEnvironmentEnabled(IEnumerable<string> entries, string name)
IEnumerable<string> entries,
string name)
{ {
if (name == StrictComputeSettings.VariableName) return StrictComputeSettings.IsEnabled(entries);
foreach (var entry in entries) foreach (var entry in entries)
{ {
var parts = entry.Split('=', 2, StringSplitOptions.TrimEntries); var parts = entry.Split('=', 2, StringSplitOptions.TrimEntries);
@ -443,7 +461,7 @@ public partial class MainWindow
private void SetGameOptionsPagesSpan(bool coversConsoleRow) private void SetGameOptionsPagesSpan(bool coversConsoleRow)
{ {
Grid.SetRowSpan(PagesHost, coversConsoleRow ? 2 : 1); Grid.SetRowSpan(PagesHost, coversConsoleRow ? 3 : 1);
} }
private Button[] GameOptionsNavigationButtons() => private Button[] GameOptionsNavigationButtons() =>
@ -473,6 +491,9 @@ public partial class MainWindow
private (string Name, ToggleSwitch Toggle)[] GameEnvironmentToggles() => private (string Name, ToggleSwitch Toggle)[] GameEnvironmentToggles() =>
[ [
("SHARPEMU_PROFILE_PERFORMANCE", GamePerformanceProfileToggle),
("SHARPEMU_PROFILE_PERFORMANCE_FRAME_TRACE", GamePerformanceFrameTraceToggle),
(StrictComputeSettings.VariableName, GameStrictComputeToggle),
("SHARPEMU_BTHID_UNAVAILABLE", GameEnvBthidToggle), ("SHARPEMU_BTHID_UNAVAILABLE", GameEnvBthidToggle),
("SHARPEMU_DISABLE_IMPORT_LOOP_GUARD", GameEnvLoopGuardToggle), ("SHARPEMU_DISABLE_IMPORT_LOOP_GUARD", GameEnvLoopGuardToggle),
("SHARPEMU_WRITABLE_APP0", GameEnvWritableApp0Toggle), ("SHARPEMU_WRITABLE_APP0", GameEnvWritableApp0Toggle),
@ -481,7 +502,9 @@ public partial class MainWindow
("SHARPEMU_LOG_DIRECT_MEMORY", GameEnvLogDirectMemoryToggle), ("SHARPEMU_LOG_DIRECT_MEMORY", GameEnvLogDirectMemoryToggle),
("SHARPEMU_LOG_IO", GameEnvLogIoToggle), ("SHARPEMU_LOG_IO", GameEnvLogIoToggle),
("SHARPEMU_LOG_NP", GameEnvLogNpToggle), ("SHARPEMU_LOG_NP", GameEnvLogNpToggle),
("SHARPEMU_GUEST_IMAGE_CPU_SYNC", GameEnvGuestImageCpuSyncToggle), ("SHARPEMU_RENDERDOC", GameEnvRenderDocToggle),
("SHARPEMU_VK_DISABLE_IMPLICITS", GameEnvDisableVkImplicitLayersToggle),
("SHARPEMU_CRASH_CAPTURE", GameCrashDumpToggle),
]; ];
private static void SetGameOptionsOpenClass(Control control, bool active) => private static void SetGameOptionsOpenClass(Control control, bool active) =>

View File

@ -19,6 +19,10 @@ SPDX-License-Identifier: GPL-2.0-or-later
KeyDown="OnKeyDown"> KeyDown="OnKeyDown">
<Window.Resources> <Window.Resources>
<x:Double x:Key="LibraryCoverSize">148</x:Double>
<x:Double x:Key="LibraryTileWidth">160</x:Double>
<x:Double x:Key="LibraryRailItemHeight">172</x:Double>
<x:Double x:Key="LibraryGridItemHeight">200</x:Double>
<DataTemplate x:Key="LocalizedChoiceTemplate" x:DataType="local:LocalizedChoice"> <DataTemplate x:Key="LocalizedChoiceTemplate" x:DataType="local:LocalizedChoice">
<TextBlock Text="{Binding Label}" <TextBlock Text="{Binding Label}"
HorizontalAlignment="Left" HorizontalAlignment="Left"
@ -105,11 +109,17 @@ SPDX-License-Identifier: GPL-2.0-or-later
</Grid> </Grid>
<!-- Main content --> <!-- Main content -->
<Grid x:Name="MainContent" Grid.Row="1" Margin="32,24,32,20" RowDefinitions="Auto,*,Auto"> <Grid x:Name="MainContent" Grid.Row="1" Margin="32,24,32,20">
<Grid.RowDefinitions>
<RowDefinition Height="Auto" />
<RowDefinition Height="*" MinHeight="160" />
<RowDefinition Height="0" />
<RowDefinition Height="0" />
</Grid.RowDefinitions>
<!-- Settings use the same opaque neutral surface as contextual <!-- Settings use the same opaque neutral surface as contextual
per-game settings, keeping both views in one visual system --> per-game settings, keeping both views in one visual system -->
<Border x:Name="OptionsPageSurface" <Border x:Name="OptionsPageSurface"
Grid.RowSpan="3" Grid.RowSpan="4"
Margin="-32,-24,-32,-20" Margin="-32,-24,-32,-20"
Background="{StaticResource GameOptionsMenuBrush}" Background="{StaticResource GameOptionsMenuBrush}"
IsVisible="False" /> IsVisible="False" />
@ -156,11 +166,11 @@ SPDX-License-Identifier: GPL-2.0-or-later
<Panel Grid.Row="1" x:Name="PagesHost" ZIndex="1"> <Panel Grid.Row="1" x:Name="PagesHost" ZIndex="1">
<!-- Library page. Covers use a horizontal virtualized rail so the <!-- Library tiles use the available width and wrap before an item
number of realized images stays bounded for large libraries. --> reaches the window edge. -->
<Grid x:Name="LibraryPage" Margin="0,46,0,0" RowDefinitions="188,*"> <Grid x:Name="LibraryPage" Margin="0,6,0,0" RowDefinitions="Auto,*">
<Panel x:Name="CarouselHost" <Panel x:Name="CarouselHost"
Grid.Row="0" Grid.Row="1"
Classes="carouselHost" Classes="carouselHost"
RenderTransformOrigin="50%,50%"> RenderTransformOrigin="50%,50%">
<Panel.Transitions> <Panel.Transitions>
@ -229,8 +239,8 @@ SPDX-License-Identifier: GPL-2.0-or-later
<DataTemplate x:DataType="local:GameEntry" x:CompileBindings="True"> <DataTemplate x:DataType="local:GameEntry" x:CompileBindings="True">
<StackPanel Spacing="7"> <StackPanel Spacing="7">
<Border Classes="coverShadow libraryGameCard" <Border Classes="coverShadow libraryGameCard"
Width="148" Width="{DynamicResource LibraryCoverSize}"
Height="148" Height="{DynamicResource LibraryCoverSize}"
ToolTip.Tip="{Binding Name}" ToolTip.Tip="{Binding Name}"
AutomationProperties.Name="{Binding Name}"> AutomationProperties.Name="{Binding Name}">
<Border Classes="coverClip"> <Border Classes="coverClip">
@ -257,8 +267,8 @@ SPDX-License-Identifier: GPL-2.0-or-later
</DataTemplate> </DataTemplate>
<DataTemplate x:DataType="local:AddFolderTile"> <DataTemplate x:DataType="local:AddFolderTile">
<Border Classes="addFolderTile" <Border Classes="addFolderTile"
Width="148" Width="{DynamicResource LibraryCoverSize}"
Height="148" Height="{DynamicResource LibraryCoverSize}"
ToolTip.Tip="{Binding [Library.AddFolder], ToolTip.Tip="{Binding [Library.AddFolder],
Source={x:Static local:Localization.Instance}, Source={x:Static local:Localization.Instance},
x:CompileBindings=False}" x:CompileBindings=False}"
@ -293,52 +303,69 @@ SPDX-License-Identifier: GPL-2.0-or-later
<!-- Selected-game identity and actions share one detail surface so <!-- Selected-game identity and actions share one detail surface so
the selected title and metadata are never rendered twice. --> the selected title and metadata are never rendered twice. -->
<StackPanel x:Name="LibrarySelectedDetails" <Grid x:Name="LibrarySelectedDetails"
Grid.Row="1" Grid.Row="0"
Classes="selectedDetailsHost" Classes="selectedDetailsHost"
x:DataType="local:GameEntry" x:DataType="local:GameEntry"
x:CompileBindings="True" x:CompileBindings="True"
IsVisible="False" IsVisible="False"
MaxWidth="980" ColumnDefinitions="*,Auto"
HorizontalAlignment="Left" RowDefinitions="Auto,Auto"
VerticalAlignment="Top" ColumnSpacing="20"
Margin="4,8,0,0"> HorizontalAlignment="Stretch"
<StackPanel.Transitions> VerticalAlignment="Top"
Margin="4,0,4,10">
<Grid.Transitions>
<Transitions> <Transitions>
<DoubleTransition Property="Opacity" <DoubleTransition Property="Opacity"
Duration="0:0:0.16" /> Duration="0:0:0.16" />
<TransformOperationsTransition Property="RenderTransform" <TransformOperationsTransition Property="RenderTransform"
Duration="0:0:0.18" /> Duration="0:0:0.18" />
</Transitions> </Transitions>
</StackPanel.Transitions> </Grid.Transitions>
<Border Classes="selectedDetailsDivider" /> <StackPanel Grid.Column="0" Spacing="7" VerticalAlignment="Center">
<TextBlock Classes="selectedGameTitle" <TextBlock Classes="selectedGameTitle"
Text="{Binding Name}" Text="{Binding Name}"
FontWeight="SemiBold" FontWeight="SemiBold"
TextWrapping="Wrap" TextWrapping="Wrap"
TextTrimming="CharacterEllipsis" TextTrimming="CharacterEllipsis"
MaxLines="2" /> MaxLines="1" />
<StackPanel Orientation="Horizontal" Spacing="8"> <StackPanel Orientation="Horizontal" Spacing="8">
<Border Classes="pill" IsVisible="{Binding HasTitleId}"> <Border Classes="pill" IsVisible="{Binding HasTitleId}">
<TextBlock Text="{Binding TitleId}" FontSize="11" FontWeight="SemiBold" <TextBlock Text="{Binding TitleId}" FontSize="11" FontWeight="SemiBold"
Foreground="{StaticResource MutedBrush}" /> Foreground="{StaticResource MutedBrush}" />
</Border> </Border>
<Border Classes="pill" IsVisible="{Binding HasVersion}"> <Border Classes="pill" IsVisible="{Binding HasVersion}">
<TextBlock Text="{Binding VersionText}" FontSize="11" FontWeight="SemiBold" <TextBlock Text="{Binding VersionText}" FontSize="11" FontWeight="SemiBold"
Foreground="{StaticResource MutedBrush}" /> Foreground="{StaticResource MutedBrush}" />
</Border> </Border>
<Border Classes="pill"> <Border Classes="pill">
<TextBlock Text="{Binding SizeText}" FontSize="11" FontWeight="SemiBold" <TextBlock Text="{Binding SizeText}" FontSize="11" FontWeight="SemiBold"
Foreground="{StaticResource MutedBrush}" /> Foreground="{StaticResource MutedBrush}" />
</Border> </Border>
</StackPanel>
</StackPanel> </StackPanel>
<StackPanel Orientation="Horizontal" <StackPanel Grid.Column="1"
Orientation="Horizontal"
Spacing="12" Spacing="12"
HorizontalAlignment="Left"> HorizontalAlignment="Right"
VerticalAlignment="Center">
<Button x:Name="LaunchButton" <Button x:Name="LaunchButton"
Classes="playButton" Classes="playButton"
Content="Launch" Content="Launch"
IsEnabled="False" /> IsEnabled="False" />
<TextBlock Text="|"
Foreground="{StaticResource MutedBrush}"
FontSize="22"
VerticalAlignment="Center"
Margin="-4,0" />
<Button x:Name="LaunchCustomEnvButton"
Classes="optionsCircle"
ToolTip.Tip="{Binding [Launch.CustomEnv], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}"
AutomationProperties.Name="{Binding [Launch.CustomEnv], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}">
<TextBlock Classes="materialSymbol"
Text="keyboard_arrow_down" />
</Button>
<Button x:Name="GameSettingsButton" <Button x:Name="GameSettingsButton"
Classes="optionsCircle" Classes="optionsCircle"
ToolTip.Tip="{Binding [Library.Context.GameSettings], ToolTip.Tip="{Binding [Library.Context.GameSettings],
@ -362,7 +389,10 @@ SPDX-License-Identifier: GPL-2.0-or-later
Text="terminal" /> Text="terminal" />
</ToggleButton> </ToggleButton>
</StackPanel> </StackPanel>
</StackPanel> <Border Grid.Row="1"
Grid.ColumnSpan="2"
Classes="selectedDetailsDivider" />
</Grid>
<!-- Empty state --> <!-- Empty state -->
<StackPanel x:Name="EmptyState" Grid.RowSpan="2" <StackPanel x:Name="EmptyState" Grid.RowSpan="2"
@ -776,6 +806,18 @@ SPDX-License-Identifier: GPL-2.0-or-later
<ToggleSwitch x:Name="GameLogToFileToggle" <ToggleSwitch x:Name="GameLogToFileToggle"
Classes="optionToggle" /> Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow x:Name="GameCrashDumpRow"
Classes="optionRow"
Label="{Binding [Options.CrashDump.Label],
Source={x:Static local:Localization.Instance},
x:CompileBindings=False}"
Description="{Binding [Options.CrashDump.Desc],
Source={x:Static local:Localization.Instance},
x:CompileBindings=False}">
<ToggleSwitch x:Name="GameCrashDumpToggle"
Classes="optionToggle" />
</local:SettingRow>
</StackPanel> </StackPanel>
</Border> </Border>
</StackPanel> </StackPanel>
@ -882,6 +924,32 @@ SPDX-License-Identifier: GPL-2.0-or-later
HorizontalContentAlignment="Left" HorizontalContentAlignment="Left"
VerticalAlignment="Center" /> VerticalAlignment="Center" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow x:Name="GameOverlayEnabledRow"
Classes="optionRow"
Label="{Binding [Options.OverlayEnabled.Label], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}"
Description="{Binding [Options.OverlayEnabled.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}">
<ToggleSwitch x:Name="GameOverlayEnabledToggle"
Classes="optionToggle"
ToolTip.Tip="{Binding [Options.OverlayEnabled.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}" />
</local:SettingRow>
<local:SettingRow x:Name="GameOverlayModeRow"
Classes="optionRow"
Label="{Binding [Options.OverlayMode.Label], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}"
Description="{Binding [Options.OverlayMode.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}">
<ComboBox x:Name="GameOverlayModeBox"
Classes="optionValue"
ToolTip.Tip="{Binding [Options.OverlayMode.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}"
ItemTemplate="{StaticResource LocalizedChoiceTemplate}" />
</local:SettingRow>
<local:SettingRow x:Name="GameOverlayCornerRow"
Classes="optionRow"
Label="{Binding [Options.OverlayCorner.Label], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}"
Description="{Binding [Options.OverlayCorner.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}">
<ComboBox x:Name="GameOverlayCornerBox"
Classes="optionValue"
ToolTip.Tip="{Binding [Options.OverlayCorner.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}"
ItemTemplate="{StaticResource LocalizedChoiceTemplate}" />
</local:SettingRow>
</StackPanel> </StackPanel>
</Border> </Border>
</StackPanel> </StackPanel>
@ -892,28 +960,44 @@ SPDX-License-Identifier: GPL-2.0-or-later
<StackPanel> <StackPanel>
<Border Classes="optionsGroup"> <Border Classes="optionsGroup">
<StackPanel Spacing="8"> <StackPanel Spacing="8">
<TextBlock Classes="optionsGroupHeader" Text="{Binding [Options.Env.Group.Debug], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}" />
<local:SettingRow Classes="optionRow" <local:SettingRow Classes="optionRow"
Label="SHARPEMU_BTHID_UNAVAILABLE" Label="SHARPEMU_PROFILE_PERFORMANCE"
Description="{Binding [Options.Env.Bthid.Desc], Description="{Binding [Options.Env.PerformanceProfile.Desc],
Source={x:Static local:Localization.Instance}, Source={x:Static local:Localization.Instance},
x:CompileBindings=False}"> x:CompileBindings=False}">
<ToggleSwitch x:Name="GameEnvBthidToggle" <ToggleSwitch x:Name="GamePerformanceProfileToggle"
Classes="optionToggle" /> Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow Classes="optionRow" <local:SettingRow Classes="optionRow"
Label="SHARPEMU_DISABLE_IMPORT_LOOP_GUARD" Label="SHARPEMU_PROFILE_PERFORMANCE_FRAME_TRACE"
Description="{Binding [Options.Env.LoopGuard.Desc], Description="{Binding [Options.Env.PerformanceFrameTrace.Desc],
Source={x:Static local:Localization.Instance}, Source={x:Static local:Localization.Instance},
x:CompileBindings=False}"> x:CompileBindings=False}">
<ToggleSwitch x:Name="GameEnvLoopGuardToggle" <ToggleSwitch x:Name="GamePerformanceFrameTraceToggle"
Classes="optionToggle" /> Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow Classes="optionRow" <local:SettingRow Classes="optionRow"
Label="SHARPEMU_WRITABLE_APP0" Label="SHARPEMU_STRICT_COMPUTE"
Description="{Binding [Options.Env.WritableApp0.Desc], Description="{Binding [Options.Env.StrictCompute.Desc],
Source={x:Static local:Localization.Instance}, Source={x:Static local:Localization.Instance},
x:CompileBindings=False}"> x:CompileBindings=False}">
<ToggleSwitch x:Name="GameEnvWritableApp0Toggle" <ToggleSwitch x:Name="GameStrictComputeToggle" Classes="optionToggle" />
</local:SettingRow>
<local:SettingRow Classes="optionRow"
Label="SHARPEMU_RENDERDOC"
Description="{Binding [Options.Env.RenderDoc.Desc],
Source={x:Static local:Localization.Instance},
x:CompileBindings=False}">
<ToggleSwitch x:Name="GameEnvRenderDocToggle"
Classes="optionToggle" />
</local:SettingRow>
<local:SettingRow Classes="optionRow"
Label="SHARPEMU_VK_DISABLE_IMPLICITS"
Description="{Binding [Options.Env.DisableVkImplicitLayers.Desc],
Source={x:Static local:Localization.Instance},
x:CompileBindings=False}">
<ToggleSwitch x:Name="GameEnvDisableVkImplicitLayersToggle"
Classes="optionToggle" /> Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow Classes="optionRow" <local:SettingRow Classes="optionRow"
@ -956,12 +1040,32 @@ SPDX-License-Identifier: GPL-2.0-or-later
<ToggleSwitch x:Name="GameEnvLogNpToggle" <ToggleSwitch x:Name="GameEnvLogNpToggle"
Classes="optionToggle" /> Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
<Border Classes="optionsGroupDivider" />
<TextBlock Classes="optionsGroupHeader" Text="{Binding [Options.Env.Group.General], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}" />
<local:SettingRow Classes="optionRow" <local:SettingRow Classes="optionRow"
Label="SHARPEMU_GUEST_IMAGE_CPU_SYNC" Label="SHARPEMU_BTHID_UNAVAILABLE"
Description="{Binding [Options.Env.GuestImageCpuSync.Desc], Description="{Binding [Options.Env.Bthid.Desc],
Source={x:Static local:Localization.Instance}, Source={x:Static local:Localization.Instance},
x:CompileBindings=False}"> x:CompileBindings=False}">
<ToggleSwitch x:Name="GameEnvGuestImageCpuSyncToggle" <ToggleSwitch x:Name="GameEnvBthidToggle"
Classes="optionToggle" />
</local:SettingRow>
<local:SettingRow Classes="optionRow"
Label="SHARPEMU_DISABLE_IMPORT_LOOP_GUARD"
Description="{Binding [Options.Env.LoopGuard.Desc],
Source={x:Static local:Localization.Instance},
x:CompileBindings=False}">
<ToggleSwitch x:Name="GameEnvLoopGuardToggle"
Classes="optionToggle" />
</local:SettingRow>
<local:SettingRow Classes="optionRow"
Label="SHARPEMU_WRITABLE_APP0"
Description="{Binding [Options.Env.WritableApp0.Desc],
Source={x:Static local:Localization.Instance},
x:CompileBindings=False}">
<ToggleSwitch x:Name="GameEnvWritableApp0Toggle"
Classes="optionToggle" /> Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
</StackPanel> </StackPanel>
@ -1081,6 +1185,28 @@ SPDX-License-Identifier: GPL-2.0-or-later
VerticalAlignment="Center" /> VerticalAlignment="Center" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow x:Name="ConsoleTypeRow"
Classes="optionRow"
Label="{Binding [Options.Console.Type.Label], Source={x:Static local:Localization.Instance}}"
Description="{Binding [Options.Console.Type.Desc], Source={x:Static local:Localization.Instance}}">
<ComboBox x:Name="ConsoleTypeBox"
Classes="optionValue"
ItemTemplate="{StaticResource LocalizedChoiceTemplate}"
HorizontalContentAlignment="Left"
VerticalAlignment="Center" />
</local:SettingRow>
<local:SettingRow x:Name="ConsoleLanguageRow"
Classes="optionRow"
Label="{Binding [Options.Console.Language.Label], Source={x:Static local:Localization.Instance}}"
Description="{Binding [Options.Console.Language.Desc], Source={x:Static local:Localization.Instance}}">
<ComboBox x:Name="ConsoleLanguageBox"
Classes="optionValue"
ItemTemplate="{StaticResource LocalizedChoiceTemplate}"
HorizontalContentAlignment="Left"
VerticalAlignment="Center" />
</local:SettingRow>
<local:SettingRow x:Name="StrictRow" <local:SettingRow x:Name="StrictRow"
Classes="optionRow" Classes="optionRow"
Label="{Binding [Options.Strict.Label], Source={x:Static local:Localization.Instance}}" Label="{Binding [Options.Strict.Label], Source={x:Static local:Localization.Instance}}"
@ -1128,6 +1254,14 @@ SPDX-License-Identifier: GPL-2.0-or-later
Classes="optionToggle" /> Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow x:Name="CrashDumpRow"
Classes="optionRow"
Label="{Binding [Options.CrashDump.Label], Source={x:Static local:Localization.Instance}}"
Description="{Binding [Options.CrashDump.Desc], Source={x:Static local:Localization.Instance}}">
<ToggleSwitch x:Name="CrashDumpToggle"
Classes="optionToggle" />
</local:SettingRow>
<local:SettingRow x:Name="LogFilePathRow" <local:SettingRow x:Name="LogFilePathRow"
Classes="optionRow" Classes="optionRow"
Label="{Binding [Options.LogFilePath.Label], Source={x:Static local:Localization.Instance}}" Label="{Binding [Options.LogFilePath.Label], Source={x:Static local:Localization.Instance}}"
@ -1321,12 +1455,11 @@ SPDX-License-Identifier: GPL-2.0-or-later
Foreground="{StaticResource SettingsDescriptionBrush}" Foreground="{StaticResource SettingsDescriptionBrush}"
TextWrapping="Wrap" /> TextWrapping="Wrap" />
</StackPanel> </StackPanel>
<TextBlock Grid.Column="2" <Button Grid.Column="2"
x:Name="DiscordComingSoonText" x:Name="DiscordButton"
Text="{Binding [About.DiscordComingSoon], Source={x:Static local:Localization.Instance}}" Classes="ghost"
FontSize="12" Content="{Binding [About.DiscordButton], Source={x:Static local:Localization.Instance}}"
Foreground="{StaticResource MutedBrush}" VerticalAlignment="Center" />
VerticalAlignment="Center" />
</Grid> </Grid>
</Border> </Border>
</StackPanel> </StackPanel>
@ -1337,21 +1470,6 @@ SPDX-License-Identifier: GPL-2.0-or-later
<ScrollViewer x:Name="OptionsRenderingPanel" <ScrollViewer x:Name="OptionsRenderingPanel"
Classes="optionsSectionPanel"> Classes="optionsSectionPanel">
<StackPanel Spacing="16"> <StackPanel Spacing="16">
<Border Classes="optionsGroup">
<StackPanel Spacing="8">
<local:SettingRow x:Name="RenderResolutionRow"
Classes="optionRow"
Label="{Binding [Options.RenderResolution.Label], Source={x:Static local:Localization.Instance}}"
Description="{Binding [Options.RenderResolution.Desc], Source={x:Static local:Localization.Instance}}">
<ComboBox x:Name="RenderResolutionBox"
Classes="optionValue"
ItemTemplate="{StaticResource LocalizedChoiceTemplate}"
HorizontalContentAlignment="Left"
VerticalAlignment="Center" />
</local:SettingRow>
</StackPanel>
</Border>
<Border Classes="optionsGroup"> <Border Classes="optionsGroup">
<StackPanel Spacing="8"> <StackPanel Spacing="8">
<local:SettingRow x:Name="WindowModeRow" <local:SettingRow x:Name="WindowModeRow"
@ -1417,6 +1535,32 @@ SPDX-License-Identifier: GPL-2.0-or-later
HorizontalContentAlignment="Left" HorizontalContentAlignment="Left"
VerticalAlignment="Center" /> VerticalAlignment="Center" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow x:Name="OverlayEnabledRow"
Classes="optionRow"
Label="{Binding [Options.OverlayEnabled.Label], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}"
Description="{Binding [Options.OverlayEnabled.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}">
<ToggleSwitch x:Name="OverlayEnabledToggle"
Classes="optionToggle"
ToolTip.Tip="{Binding [Options.OverlayEnabled.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}" />
</local:SettingRow>
<local:SettingRow x:Name="OverlayModeRow"
Classes="optionRow"
Label="{Binding [Options.OverlayMode.Label], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}"
Description="{Binding [Options.OverlayMode.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}">
<ComboBox x:Name="OverlayModeBox"
Classes="optionValue"
ToolTip.Tip="{Binding [Options.OverlayMode.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}"
ItemTemplate="{StaticResource LocalizedChoiceTemplate}" />
</local:SettingRow>
<local:SettingRow x:Name="OverlayCornerRow"
Classes="optionRow"
Label="{Binding [Options.OverlayCorner.Label], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}"
Description="{Binding [Options.OverlayCorner.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}">
<ComboBox x:Name="OverlayCornerBox"
Classes="optionValue"
ToolTip.Tip="{Binding [Options.OverlayCorner.Desc], Source={x:Static local:Localization.Instance}, x:CompileBindings=False}"
ItemTemplate="{StaticResource LocalizedChoiceTemplate}" />
</local:SettingRow>
</StackPanel> </StackPanel>
</Border> </Border>
</StackPanel> </StackPanel>
@ -1427,19 +1571,32 @@ SPDX-License-Identifier: GPL-2.0-or-later
<StackPanel> <StackPanel>
<Border Classes="optionsGroup"> <Border Classes="optionsGroup">
<StackPanel Spacing="8"> <StackPanel Spacing="8">
<local:SettingRow x:Name="EnvBthidRow" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_BTHID_UNAVAILABLE" <TextBlock Classes="optionsGroupHeader" Text="{Binding [Options.Env.Group.Debug], Source={x:Static local:Localization.Instance}}" />
Description="{Binding [Options.Env.Bthid.Desc], Source={x:Static local:Localization.Instance}}"> <local:SettingRow x:Name="PerformanceProfileRow" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_PROFILE_PERFORMANCE"
<ToggleSwitch x:Name="EnvBthidToggle" Classes="optionToggle" /> Description="{Binding [Options.Env.PerformanceProfile.Desc], Source={x:Static local:Localization.Instance}}">
<ToggleSwitch x:Name="PerformanceProfileToggle" Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow x:Name="EnvLoopGuardRow" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_DISABLE_IMPORT_LOOP_GUARD" <local:SettingRow x:Name="PerformanceFrameTraceRow" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_PROFILE_PERFORMANCE_FRAME_TRACE"
Description="{Binding [Options.Env.LoopGuard.Desc], Source={x:Static local:Localization.Instance}}"> Description="{Binding [Options.Env.PerformanceFrameTrace.Desc], Source={x:Static local:Localization.Instance}}">
<ToggleSwitch x:Name="EnvLoopGuardToggle" Classes="optionToggle" /> <ToggleSwitch x:Name="PerformanceFrameTraceToggle" Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow x:Name="EnvWritableApp0Row" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_WRITABLE_APP0" <local:SettingRow Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_STRICT_COMPUTE"
Description="{Binding [Options.Env.WritableApp0.Desc], Source={x:Static local:Localization.Instance}}"> Description="{Binding [Options.Env.StrictCompute.Desc], Source={x:Static local:Localization.Instance}}">
<ToggleSwitch x:Name="EnvWritableApp0Toggle" Classes="optionToggle" /> <ToggleSwitch x:Name="StrictComputeToggle" Classes="optionToggle" />
</local:SettingRow>
<local:SettingRow x:Name="EnvRenderDocRow" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_RENDERDOC"
Description="{Binding [Options.Env.RenderDoc.Desc], Source={x:Static local:Localization.Instance}}">
<ToggleSwitch x:Name="EnvRenderDocToggle" Classes="optionToggle" />
</local:SettingRow>
<local:SettingRow Classes="optionRow"
LabelFontFamily="Consolas,monospace"
Label="SHARPEMU_VK_DISABLE_IMPLICITS"
Description="{Binding [Options.Env.DisableVkImplicitLayers.Desc], Source={x:Static local:Localization.Instance}}">
<ToggleSwitch x:Name="EnvDisableVkImplicitLayersToggle" Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow x:Name="EnvVkValidationRow" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_VK_VALIDATION" <local:SettingRow x:Name="EnvVkValidationRow" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_VK_VALIDATION"
@ -1467,9 +1624,32 @@ SPDX-License-Identifier: GPL-2.0-or-later
<ToggleSwitch x:Name="EnvLogNpToggle" Classes="optionToggle" /> <ToggleSwitch x:Name="EnvLogNpToggle" Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
<local:SettingRow x:Name="EnvGuestImageCpuSyncRow" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_GUEST_IMAGE_CPU_SYNC" <Border Classes="optionsGroupDivider" />
Description="{Binding [Options.Env.GuestImageCpuSync.Desc], Source={x:Static local:Localization.Instance}}">
<ToggleSwitch x:Name="EnvGuestImageCpuSyncToggle" Classes="optionToggle" /> <TextBlock Classes="optionsGroupHeader" Text="{Binding [Options.Env.Group.General], Source={x:Static local:Localization.Instance}}" />
<local:SettingRow x:Name="BinkPlaybackRow"
Classes="optionRow"
Label="{Binding [Options.Env.BinkPlayback.Label], Source={x:Static local:Localization.Instance}}"
Description="{Binding [Options.Env.BinkPlayback.Desc], Source={x:Static local:Localization.Instance}}">
<ComboBox x:Name="BinkPlaybackBox"
Classes="optionValue"
ToolTip.Tip="{Binding [Options.Env.BinkPlayback.Desc], Source={x:Static local:Localization.Instance}}"
ItemTemplate="{StaticResource LocalizedChoiceTemplate}" />
</local:SettingRow>
<local:SettingRow x:Name="EnvBthidRow" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_BTHID_UNAVAILABLE"
Description="{Binding [Options.Env.Bthid.Desc], Source={x:Static local:Localization.Instance}}">
<ToggleSwitch x:Name="EnvBthidToggle" Classes="optionToggle" />
</local:SettingRow>
<local:SettingRow x:Name="EnvLoopGuardRow" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_DISABLE_IMPORT_LOOP_GUARD"
Description="{Binding [Options.Env.LoopGuard.Desc], Source={x:Static local:Localization.Instance}}">
<ToggleSwitch x:Name="EnvLoopGuardToggle" Classes="optionToggle" />
</local:SettingRow>
<local:SettingRow x:Name="EnvWritableApp0Row" Classes="optionRow" LabelFontFamily="Consolas,monospace" Label="SHARPEMU_WRITABLE_APP0"
Description="{Binding [Options.Env.WritableApp0.Desc], Source={x:Static local:Localization.Instance}}">
<ToggleSwitch x:Name="EnvWritableApp0Toggle" Classes="optionToggle" />
</local:SettingRow> </local:SettingRow>
</StackPanel> </StackPanel>
@ -1482,9 +1662,18 @@ SPDX-License-Identifier: GPL-2.0-or-later
</Grid> </Grid>
</Panel> </Panel>
<GridSplitter x:Name="ConsoleSplitter"
Grid.Row="2"
Height="8"
ResizeDirection="Rows"
ResizeBehavior="PreviousAndNext"
Background="Transparent"
Cursor="SizeNorthSouth"
IsVisible="False" />
<!-- Console (collapsible) --> <!-- Console (collapsible) -->
<Border Grid.Row="2" x:Name="ConsolePanel" Classes="card" Padding="0" Height="240" <Border Grid.Row="3" x:Name="ConsolePanel" Classes="card" Padding="0"
Margin="0,12,0,0" IsVisible="False"> IsVisible="False">
<Grid RowDefinitions="Auto,*"> <Grid RowDefinitions="Auto,*">
<Grid Grid.Row="0" ColumnDefinitions="*,Auto,Auto,Auto,Auto,Auto,Auto" Margin="16,12,16,8"> <Grid Grid.Row="0" ColumnDefinitions="*,Auto,Auto,Auto,Auto,Auto,Auto" Margin="16,12,16,8">
<TextBlock x:Name="ConsoleSectionTitle" Classes="sectionTitle" <TextBlock x:Name="ConsoleSectionTitle" Classes="sectionTitle"

View File

@ -48,6 +48,44 @@ public partial class MainWindow : Window
[ [
LocalizedChoice.FromKey("Native", "Options.CpuEngine.Native"), LocalizedChoice.FromKey("Native", "Options.CpuEngine.Native"),
]; ];
private readonly LocalizedChoice[] _consoleTypeChoices =
[
LocalizedChoice.Literal("PS5", "PlayStation 5"),
];
private readonly LocalizedChoice[] _consoleLanguageChoices =
[
LocalizedChoice.Literal("Japanese", "日本語"),
LocalizedChoice.Literal("EnglishUS", "English (United States)"),
LocalizedChoice.Literal("French", "Français"),
LocalizedChoice.Literal("SpanishSpain", "Español (España)"),
LocalizedChoice.Literal("German", "Deutsch"),
LocalizedChoice.Literal("Italian", "Italiano"),
LocalizedChoice.Literal("Dutch", "Nederlands"),
LocalizedChoice.Literal("PortuguesePortugal", "Português (Portugal)"),
LocalizedChoice.Literal("Russian", "Русский"),
LocalizedChoice.Literal("Korean", "한국어"),
LocalizedChoice.Literal("ChineseTraditional", "繁體中文"),
LocalizedChoice.Literal("ChineseSimplified", "简体中文"),
LocalizedChoice.Literal("Finnish", "Suomi"),
LocalizedChoice.Literal("Swedish", "Svenska"),
LocalizedChoice.Literal("Danish", "Dansk"),
LocalizedChoice.Literal("Norwegian", "Norsk"),
LocalizedChoice.Literal("Polish", "Polski"),
LocalizedChoice.Literal("PortugueseBrazil", "Português (Brasil)"),
LocalizedChoice.Literal("EnglishUK", "English (United Kingdom)"),
LocalizedChoice.Literal("Turkish", "Türkçe"),
LocalizedChoice.Literal("SpanishLatinAmerica", "Español (Latinoamérica)"),
LocalizedChoice.Literal("Arabic", "العربية"),
LocalizedChoice.Literal("FrenchCanada", "Français (Canada)"),
LocalizedChoice.Literal("Czech", "Čeština"),
LocalizedChoice.Literal("Hungarian", "Magyar"),
LocalizedChoice.Literal("Greek", "Ελληνικά"),
LocalizedChoice.Literal("Romanian", "Română"),
LocalizedChoice.Literal("Thai", "ไทย"),
LocalizedChoice.Literal("Vietnamese", "Tiếng Việt"),
LocalizedChoice.Literal("Indonesian", "Bahasa Indonesia"),
LocalizedChoice.Literal("Ukrainian", "Українська"),
];
private readonly LocalizedChoice[] _logLevelChoices = private readonly LocalizedChoice[] _logLevelChoices =
[ [
LocalizedChoice.FromKey("Trace", "Options.LogLevel.Trace"), LocalizedChoice.FromKey("Trace", "Options.LogLevel.Trace"),
@ -57,13 +95,6 @@ public partial class MainWindow : Window
LocalizedChoice.FromKey("Error", "Options.LogLevel.Error"), LocalizedChoice.FromKey("Error", "Options.LogLevel.Error"),
LocalizedChoice.FromKey("Critical", "Options.LogLevel.Critical"), LocalizedChoice.FromKey("Critical", "Options.LogLevel.Critical"),
]; ];
private readonly LocalizedChoice[] _renderResolutionChoices =
[
LocalizedChoice.FromKey("1.0", "Options.RenderResolution.Native"),
LocalizedChoice.Literal("0.75", "75%"),
LocalizedChoice.Literal("0.5", "50%"),
LocalizedChoice.Literal("0.25", "25%"),
];
private readonly LocalizedChoice[] _windowModeChoices = private readonly LocalizedChoice[] _windowModeChoices =
[ [
LocalizedChoice.FromKey("Windowed", "Options.WindowMode.Windowed"), LocalizedChoice.FromKey("Windowed", "Options.WindowMode.Windowed"),
@ -77,12 +108,31 @@ public partial class MainWindow : Window
LocalizedChoice.FromKey("Stretch", "Options.Scaling.Stretch"), LocalizedChoice.FromKey("Stretch", "Options.Scaling.Stretch"),
LocalizedChoice.FromKey("Integer", "Options.Scaling.Integer"), LocalizedChoice.FromKey("Integer", "Options.Scaling.Integer"),
]; ];
private readonly LocalizedChoice[] _overlayModeChoices =
[
LocalizedChoice.FromKey("Full", "Options.OverlayMode.Full"),
LocalizedChoice.FromKey("Minimal", "Options.OverlayMode.Minimal"),
LocalizedChoice.FromKey("TitleBar", "Options.OverlayMode.TitleBar"),
];
private readonly LocalizedChoice[] _overlayCornerChoices =
[
LocalizedChoice.FromKey("TopLeft", "Options.OverlayCorner.TopLeft"),
LocalizedChoice.FromKey("TopRight", "Options.OverlayCorner.TopRight"),
LocalizedChoice.FromKey("BottomRight", "Options.OverlayCorner.BottomRight"),
LocalizedChoice.FromKey("BottomLeft", "Options.OverlayCorner.BottomLeft"),
];
private readonly LocalizedChoice[] _hdrModeChoices = private readonly LocalizedChoice[] _hdrModeChoices =
[ [
LocalizedChoice.FromKey("Auto", "Options.Hdr.Auto"), LocalizedChoice.FromKey("Auto", "Options.Hdr.Auto"),
LocalizedChoice.FromKey("On", "Common.On"), LocalizedChoice.FromKey("On", "Common.On"),
LocalizedChoice.FromKey("Off", "Common.Off"), LocalizedChoice.FromKey("Off", "Common.Off"),
]; ];
private readonly LocalizedChoice[] _binkPlaybackChoices =
[
LocalizedChoice.FromKey("Host", "Options.Env.BinkPlayback.Host"),
LocalizedChoice.FromKey("Guest", "Options.Env.BinkPlayback.Guest"),
LocalizedChoice.FromKey("Skip", "Options.Env.BinkPlayback.Skip"),
];
private readonly List<GameEntry> _allGames = new(); private readonly List<GameEntry> _allGames = new();
private readonly ObservableCollection<GameEntry> _visibleGames = new(); private readonly ObservableCollection<GameEntry> _visibleGames = new();
private readonly LibraryTileCollection _libraryTiles; private readonly LibraryTileCollection _libraryTiles;
@ -91,6 +141,7 @@ public partial class MainWindow : Window
private readonly List<LogLine> _allConsoleLines = new(); private readonly List<LogLine> _allConsoleLines = new();
private readonly ConcurrentQueue<(string Line, bool IsError)> _pendingLines = new(); private readonly ConcurrentQueue<(string Line, bool IsError)> _pendingLines = new();
private readonly DispatcherTimer _consoleFlushTimer; private readonly DispatcherTimer _consoleFlushTimer;
private readonly DispatcherTimer _libraryLayoutTimer;
private GuiSettings _settings = new(); private GuiSettings _settings = new();
private IReadOnlyList<HostDisplayOption> _hostDisplays = []; private IReadOnlyList<HostDisplayOption> _hostDisplays = [];
@ -125,6 +176,8 @@ public partial class MainWindow : Window
private bool _addFolderInProgress; private bool _addFolderInProgress;
private bool _isLibraryGridLayout; private bool _isLibraryGridLayout;
private GameEntry? _lastSelectedGame; private GameEntry? _lastSelectedGame;
private double _libraryRailRowHeight = 188;
private double _libraryGridRowHeight = 216;
// Bundled key art shown whenever no game-specific backdrop applies; the // Bundled key art shown whenever no game-specific backdrop applies; the
// plain window color remains the fallback when the asset fails to load. // plain window color remains the fallback when the asset fails to load.
@ -146,6 +199,8 @@ public partial class MainWindow : Window
string EbootPath, string EbootPath,
string DisplayName, string DisplayName,
string? TitleId, string? TitleId,
string ConsoleType,
string ConsoleLanguage,
EffectiveLaunchSettings Settings, EffectiveLaunchSettings Settings,
SharpEmuRuntimeOptions RuntimeOptions); SharpEmuRuntimeOptions RuntimeOptions);
@ -182,6 +237,15 @@ public partial class MainWindow : Window
MaybeAutoScroll(); MaybeAutoScroll();
}; };
_consoleFlushTimer.Start(); _consoleFlushTimer.Start();
_libraryLayoutTimer = new DispatcherTimer
{
Interval = TimeSpan.FromMilliseconds(120),
};
_libraryLayoutTimer.Tick += (_, _) =>
{
_libraryLayoutTimer.Stop();
UpdateLibraryLayoutMetrics();
};
TitleBar.PointerPressed += OnTitleBarPointerPressed; TitleBar.PointerPressed += OnTitleBarPointerPressed;
TitleBar.DoubleTapped += OnTitleBarDoubleTapped; TitleBar.DoubleTapped += OnTitleBarDoubleTapped;
@ -216,6 +280,7 @@ public partial class MainWindow : Window
LaunchSelected(); LaunchSelected();
} }
}; };
LaunchCustomEnvButton.Click += async (_, _) => await OpenCustomEnvironmentDialogAsync();
ClearLogButton.Click += (_, _) => { _consoleLines.Clear(); _allConsoleLines.Clear(); }; ClearLogButton.Click += (_, _) => { _consoleLines.Clear(); _allConsoleLines.Clear(); };
CopyLogButton.Click += async (_, _) => await CopyConsoleAsync(); CopyLogButton.Click += async (_, _) => await CopyConsoleAsync();
DetachConsoleButton.Click += (_, _) => ShowConsoleWindow(); DetachConsoleButton.Click += (_, _) => ShowConsoleWindow();
@ -223,9 +288,10 @@ public partial class MainWindow : Window
LibraryTabButton.Click += (_, _) => SetActivePage(0); LibraryTabButton.Click += (_, _) => SetActivePage(0);
OptionsTabButton.Click += (_, _) => SetActivePage(1); OptionsTabButton.Click += (_, _) => SetActivePage(1);
LibraryLayoutButton.Click += (_, _) => ToggleLibraryLayout(); LibraryLayoutButton.Click += (_, _) => ToggleLibraryLayout();
LibraryPage.SizeChanged += (_, _) => UpdateLibraryGridHeight(); LibraryPage.SizeChanged += (_, _) => ScheduleLibraryLayoutMetricsUpdate();
LibrarySelectedDetails.SizeChanged += (_, _) => UpdateLibraryGridHeight(); LibrarySelectedDetails.SizeChanged += (_, _) => UpdateLibraryMinimumHeight();
ConsoleToggle.IsCheckedChanged += (_, _) => ConsolePanel.IsVisible = ConsoleToggle.IsChecked == true && _consoleWindow is null; MainContent.SizeChanged += (_, _) => ClampEmbeddedConsoleHeight();
ConsoleToggle.IsCheckedChanged += (_, _) => UpdateEmbeddedConsoleVisibility();
WireOptionsNavigation(); WireOptionsNavigation();
WireGameOptions(); WireGameOptions();
@ -233,18 +299,6 @@ public partial class MainWindow : Window
// it is open already uses the new values. // it is open already uses the new values.
LogLevelBox.SelectionChanged += (_, _) => _settings.LogLevel = SelectedLogLevel(); LogLevelBox.SelectionChanged += (_, _) => _settings.LogLevel = SelectedLogLevel();
TraceImportsBox.ValueChanged += (_, _) => _settings.ImportTraceLimit = (int)(TraceImportsBox.Value ?? 0); TraceImportsBox.ValueChanged += (_, _) => _settings.ImportTraceLimit = (int)(TraceImportsBox.Value ?? 0);
RenderResolutionBox.SelectionChanged += (_, _) =>
{
if (RenderResolutionBox.SelectedItem is LocalizedChoice { Value: var value } &&
double.TryParse(
value,
System.Globalization.NumberStyles.Float,
System.Globalization.CultureInfo.InvariantCulture,
out var scale))
{
_settings.RenderResolutionScale = scale;
}
};
StrictToggle.IsCheckedChanged += (_, _) => _settings.StrictDynlibResolution = StrictToggle.IsChecked == true; StrictToggle.IsCheckedChanged += (_, _) => _settings.StrictDynlibResolution = StrictToggle.IsChecked == true;
LogToFileToggle.IsCheckedChanged += (_, _) => _settings.LogToFile = LogToFileToggle.IsChecked == true; LogToFileToggle.IsCheckedChanged += (_, _) => _settings.LogToFile = LogToFileToggle.IsChecked == true;
OverrideLogFileToggle.IsCheckedChanged += (_, _) => OverrideLogFileToggle.IsCheckedChanged += (_, _) =>
@ -261,6 +315,10 @@ public partial class MainWindow : Window
}; };
AutoUpdateToggle.IsCheckedChanged += (_, _) => AutoUpdateToggle.IsCheckedChanged += (_, _) =>
_settings.CheckForUpdatesOnStartup = AutoUpdateToggle.IsChecked == true; _settings.CheckForUpdatesOnStartup = AutoUpdateToggle.IsChecked == true;
ConsoleTypeBox.SelectionChanged += (_, _) =>
_settings.ConsoleType = SelectedComboText(ConsoleTypeBox, "PS5");
ConsoleLanguageBox.SelectionChanged += (_, _) =>
_settings.ConsoleLanguage = SelectedComboText(ConsoleLanguageBox, "EnglishUS");
WindowModeBox.SelectionChanged += (_, _) => _settings.WindowMode = SelectedComboText(WindowModeBox, "Windowed"); WindowModeBox.SelectionChanged += (_, _) => _settings.WindowMode = SelectedComboText(WindowModeBox, "Windowed");
DisplayBox.SelectionChanged += (_, _) => OnHostDisplayChanged(); DisplayBox.SelectionChanged += (_, _) => OnHostDisplayChanged();
ResolutionBox.SelectionChanged += (_, _) => OnHostResolutionChanged(); ResolutionBox.SelectionChanged += (_, _) => OnHostResolutionChanged();
@ -268,14 +326,25 @@ public partial class MainWindow : Window
ScalingModeBox.SelectionChanged += (_, _) => _settings.ScalingMode = SelectedComboText(ScalingModeBox, "Fit"); ScalingModeBox.SelectionChanged += (_, _) => _settings.ScalingMode = SelectedComboText(ScalingModeBox, "Fit");
VSyncToggle.IsCheckedChanged += (_, _) => _settings.VSync = VSyncToggle.IsChecked == true; VSyncToggle.IsCheckedChanged += (_, _) => _settings.VSync = VSyncToggle.IsChecked == true;
HdrModeBox.SelectionChanged += (_, _) => _settings.HdrMode = SelectedComboText(HdrModeBox, "Auto"); HdrModeBox.SelectionChanged += (_, _) => _settings.HdrMode = SelectedComboText(HdrModeBox, "Auto");
OverlayEnabledToggle.IsCheckedChanged += (_, _) => _settings.OverlayEnabled = OverlayEnabledToggle.IsChecked == true;
OverlayModeBox.SelectionChanged += (_, _) => _settings.OverlayMode = SelectedComboText(OverlayModeBox, "TitleBar");
OverlayCornerBox.SelectionChanged += (_, _) => _settings.OverlayCorner = SelectedComboText(OverlayCornerBox, "TopRight");
UpdateButton.Click += async (_, _) => await OnUpdateButtonAsync(); UpdateButton.Click += async (_, _) => await OnUpdateButtonAsync();
SelectLogFilePathButton.Click += async (_, _) => await SelectLogFilePathAsync(); SelectLogFilePathButton.Click += async (_, _) => await SelectLogFilePathAsync();
PerformanceProfileToggle.IsCheckedChanged += (_, _) =>
SetEnvironmentToggle("SHARPEMU_PROFILE_PERFORMANCE", PerformanceProfileToggle.IsChecked == true);
PerformanceFrameTraceToggle.IsCheckedChanged += (_, _) =>
SetEnvironmentToggle("SHARPEMU_PROFILE_PERFORMANCE_FRAME_TRACE", PerformanceFrameTraceToggle.IsChecked == true);
StrictComputeToggle.IsCheckedChanged += (_, _) =>
StrictComputeSettings.SetEnabled(_settings.EnvironmentToggles, StrictComputeToggle.IsChecked == true);
EnvBthidToggle.IsCheckedChanged += (_, _) => EnvBthidToggle.IsCheckedChanged += (_, _) =>
SetEnvironmentToggle("SHARPEMU_BTHID_UNAVAILABLE", EnvBthidToggle.IsChecked == true); SetEnvironmentToggle("SHARPEMU_BTHID_UNAVAILABLE", EnvBthidToggle.IsChecked == true);
EnvLoopGuardToggle.IsCheckedChanged += (_, _) => EnvLoopGuardToggle.IsCheckedChanged += (_, _) =>
SetEnvironmentToggle("SHARPEMU_DISABLE_IMPORT_LOOP_GUARD", EnvLoopGuardToggle.IsChecked == true); SetEnvironmentToggle("SHARPEMU_DISABLE_IMPORT_LOOP_GUARD", EnvLoopGuardToggle.IsChecked == true);
EnvWritableApp0Toggle.IsCheckedChanged += (_, _) => EnvWritableApp0Toggle.IsCheckedChanged += (_, _) =>
SetEnvironmentToggle("SHARPEMU_WRITABLE_APP0", EnvWritableApp0Toggle.IsChecked == true); SetEnvironmentToggle("SHARPEMU_WRITABLE_APP0", EnvWritableApp0Toggle.IsChecked == true);
BinkPlaybackBox.SelectionChanged += (_, _) =>
_settings.BinkPlaybackMode = SelectedComboText(BinkPlaybackBox, "Guest");
EnvVkValidationToggle.IsCheckedChanged += (_, _) => EnvVkValidationToggle.IsCheckedChanged += (_, _) =>
SetEnvironmentToggle("SHARPEMU_VK_VALIDATION", EnvVkValidationToggle.IsChecked == true); SetEnvironmentToggle("SHARPEMU_VK_VALIDATION", EnvVkValidationToggle.IsChecked == true);
EnvDumpSpirvToggle.IsCheckedChanged += (_, _) => EnvDumpSpirvToggle.IsCheckedChanged += (_, _) =>
@ -286,10 +355,41 @@ public partial class MainWindow : Window
SetEnvironmentToggle("SHARPEMU_LOG_IO", EnvLogIoToggle.IsChecked == true); SetEnvironmentToggle("SHARPEMU_LOG_IO", EnvLogIoToggle.IsChecked == true);
EnvLogNpToggle.IsCheckedChanged += (_, _) => EnvLogNpToggle.IsCheckedChanged += (_, _) =>
SetEnvironmentToggle("SHARPEMU_LOG_NP", EnvLogNpToggle.IsChecked == true); SetEnvironmentToggle("SHARPEMU_LOG_NP", EnvLogNpToggle.IsChecked == true);
EnvGuestImageCpuSyncToggle.IsCheckedChanged += (_, _) => CrashDumpToggle.IsCheckedChanged += (_, _) =>
SetEnvironmentToggle("SHARPEMU_CRASH_CAPTURE", CrashDumpToggle.IsChecked == true);
DefaultProfileBox.TextChanged += (_, _) =>
_settings.DefaultProfile = GuiSettings.NormalizeDefaultProfile(DefaultProfileBox.Text);
LanguageBox.SelectionChanged += (_, _) => OnLanguageChanged();
GameList.AddHandler(ContextRequestedEvent, OnGameContextRequested, RoutingStrategies.Tunnel);
AddHandler(KeyDownEvent, OnPreviewKeyDown, RoutingStrategies.Tunnel);
CtxLaunch.Click += (_, _) => LaunchSelected();
CtxOpenFolder.Click += (_, _) => OpenSelectedGameFolder();
CtxCopyPath.Click += async (_, _) =>
await CopyToClipboardAsync((GameList.SelectedItem as GameEntry)?.Path);
CtxCopyTitleId.Click += async (_, _) =>
await CopyToClipboardAsync((GameList.SelectedItem as GameEntry)?.TitleId);
CtxGameSettings.Click += (_, _) => OpenSelectedGameSettings();
CtxRemove.Click += (_, _) => RemoveSelectedFromLibrary();
Opened += async (_, _) => await OnOpenedAsync();
Closing += (_, _) => BeginWindowClosing();
Closed += (_, _) => CompleteWindowClosing();
SdlLauncherGamepad.EnsureStarted();
_gamepadTimer = new DispatcherTimer
{
Interval = TimeSpan.FromMilliseconds(50),
};
EnvRenderDocToggle.IsCheckedChanged += (_, _) =>
SetEnvironmentToggle( SetEnvironmentToggle(
"SHARPEMU_GUEST_IMAGE_CPU_SYNC", "SHARPEMU_RENDERDOC",
EnvGuestImageCpuSyncToggle.IsChecked == true); EnvRenderDocToggle.IsChecked == true);
EnvDisableVkImplicitLayersToggle.IsCheckedChanged += (_, _) =>
SetEnvironmentToggle(
"SHARPEMU_VK_DISABLE_IMPLICITS",
EnvDisableVkImplicitLayersToggle.IsChecked == true);
DefaultProfileBox.TextChanged += (_, _) => DefaultProfileBox.TextChanged += (_, _) =>
_settings.DefaultProfile = GuiSettings.NormalizeDefaultProfile(DefaultProfileBox.Text); _settings.DefaultProfile = GuiSettings.NormalizeDefaultProfile(DefaultProfileBox.Text);
LanguageBox.SelectionChanged += (_, _) => OnLanguageChanged(); LanguageBox.SelectionChanged += (_, _) => OnLanguageChanged();
@ -322,7 +422,16 @@ public partial class MainWindow : Window
{ {
Process.Start(new ProcessStartInfo Process.Start(new ProcessStartInfo
{ {
FileName = "https://github.com/sharpemu/sharpemu", FileName = ProjectLinks.RepositoryUrl,
UseShellExecute = true
});
};
DiscordButton.Click += (_, _) =>
{
Process.Start(new ProcessStartInfo
{
FileName = "https://discord.com/invite/zdTuUU9Uwn",
UseShellExecute = true UseShellExecute = true
}); });
}; };
@ -336,8 +445,7 @@ public partial class MainWindow : Window
Process.Start(new ProcessStartInfo Process.Start(new ProcessStartInfo
{ {
FileName = FileName = ProjectLinks.CommitUrl(_latestCommitSha),
$"https://github.com/sharpemu/sharpemu/commit/{_latestCommitSha}",
UseShellExecute = true UseShellExecute = true
}); });
}; };
@ -376,6 +484,7 @@ public partial class MainWindow : Window
LibraryToolbar.IsVisible = index == 0; LibraryToolbar.IsVisible = index == 0;
OptionsPageSurface.IsVisible = index == 1; OptionsPageSurface.IsVisible = index == 1;
OptionsPage.IsVisible = index == 1; OptionsPage.IsVisible = index == 1;
UpdateEmbeddedConsoleVisibility();
if (index == 1) if (index == 1)
{ {
@ -390,13 +499,8 @@ public partial class MainWindow : Window
_isLibraryGridLayout = grid; _isLibraryGridLayout = grid;
SetClass(GameList, "gridLayout", grid); SetClass(GameList, "gridLayout", grid);
SetClass(LibrarySelectedDetails, "gridLayout", grid); SetClass(LibrarySelectedDetails, "gridLayout", grid);
LibraryPage.RowDefinitions[0].Height = grid LibraryPage.Margin = new Thickness(0, 6, 0, 0);
? GridLength.Auto UpdateLibraryLayoutMetrics();
: new GridLength(188);
LibraryPage.Margin = grid
? new Thickness(0, 6, 0, 0)
: new Thickness(0, 46, 0, 0);
UpdateLibraryGridHeight();
UpdateLibraryLayoutButton(); UpdateLibraryLayoutButton();
if (GameList.SelectedItem is { } selected) if (GameList.SelectedItem is { } selected)
@ -407,18 +511,37 @@ public partial class MainWindow : Window
} }
} }
private void UpdateLibraryGridHeight() private void UpdateLibraryLayoutMetrics()
{ {
var pageHeight = LibraryPage.Bounds.Height; var metrics = LibraryLayoutMetrics.Calculate(LibraryPage.Bounds.Width);
if (!_isLibraryGridLayout || pageHeight <= 0) Resources["LibraryCoverSize"] = metrics.CoverSize;
{ Resources["LibraryTileWidth"] = metrics.ItemWidth;
GameList.MaxHeight = double.PositiveInfinity; Resources["LibraryRailItemHeight"] = metrics.RailItemHeight;
return; Resources["LibraryGridItemHeight"] = metrics.GridItemHeight;
} _libraryRailRowHeight = metrics.RailItemHeight + 16;
_libraryGridRowHeight = metrics.GridItemHeight + 16;
GameList.MaxHeight = Math.Max( GameList.MaxHeight = double.PositiveInfinity;
0, UpdateLibraryMinimumHeight();
pageHeight - LibrarySelectedDetails.DesiredSize.Height); }
private void ScheduleLibraryLayoutMetricsUpdate()
{
_libraryLayoutTimer.Stop();
_libraryLayoutTimer.Start();
}
private void UpdateLibraryMinimumHeight()
{
var detailsHeight = LibrarySelectedDetails.IsVisible
? LibrarySelectedDetails.DesiredSize.Height
: 0;
var cardRowHeight = _isLibraryGridLayout
? _libraryGridRowHeight
: _libraryRailRowHeight;
MainContent.RowDefinitions[1].MinHeight =
LibraryPage.Margin.Top + detailsHeight + cardRowHeight;
ClampEmbeddedConsoleHeight();
} }
private void ToggleLibraryLayout() private void ToggleLibraryLayout()
@ -616,16 +739,13 @@ public partial class MainWindow : Window
} }
private async Task LoadLatestCommitAsync() private async Task LoadLatestCommitAsync()
{ {
const string apiUrl =
"https://api.github.com/repos/sharpemu/sharpemu/commits/main";
_latestCommitSha = null; _latestCommitSha = null;
LatestCommitHashText.Content = "Loading…"; LatestCommitHashText.Content = "Loading…";
LatestCommitHashText.IsEnabled = false; LatestCommitHashText.IsEnabled = false;
try try
{ {
using var response = await GithubHttpClient.GetAsync(apiUrl); using var response = await GithubHttpClient.GetAsync(ProjectLinks.LatestCommitApiUrl);
var responseBody = var responseBody =
(await response.Content.ReadAsStringAsync()).Trim(); (await response.Content.ReadAsStringAsync()).Trim();
@ -1012,12 +1132,14 @@ public partial class MainWindow : Window
Interlocked.Increment(ref _libraryScanGeneration); Interlocked.Increment(ref _libraryScanGeneration);
Interlocked.Increment(ref _detailLoadGeneration); Interlocked.Increment(ref _detailLoadGeneration);
_consoleFlushTimer.Stop(); _consoleFlushTimer.Stop();
_libraryLayoutTimer.Stop();
_gamepadTimer.Stop(); _gamepadTimer.Stop();
} }
private void CompleteWindowClosing() private void CompleteWindowClosing()
{ {
RunShutdownStep("library watcher", _libraryWatcher.Dispose); RunShutdownStep("library watcher", _libraryWatcher.Dispose);
RememberEmbeddedConsoleHeight();
RunShutdownStep("settings", _settings.Save); RunShutdownStep("settings", _settings.Save);
RunShutdownStep("SDL gamepad", SdlLauncherGamepad.Shutdown); RunShutdownStep("SDL gamepad", SdlLauncherGamepad.Shutdown);
RunShutdownStep("title music", _sndPreview.Stop); RunShutdownStep("title music", _sndPreview.Stop);
@ -1025,6 +1147,7 @@ public partial class MainWindow : Window
RunShutdownStep("console window", () => _consoleWindow?.Close()); RunShutdownStep("console window", () => _consoleWindow?.Close());
RunShutdownStep("emulator process", () => _emulator?.Dispose()); RunShutdownStep("emulator process", () => _emulator?.Dispose());
RunShutdownStep("console mirror", () => _consoleMirror?.Dispose()); RunShutdownStep("console mirror", () => _consoleMirror?.Dispose());
RunShutdownStep("pending console output", FlushAllPendingConsoleLines);
RunShutdownStep("file log", DropFileLog); RunShutdownStep("file log", DropFileLog);
} }
@ -1121,21 +1244,29 @@ public partial class MainWindow : Window
private void InitializeLocalizedChoiceBoxes() private void InitializeLocalizedChoiceBoxes()
{ {
CpuEngineBox.ItemsSource = _cpuEngineChoices; CpuEngineBox.ItemsSource = _cpuEngineChoices;
ConsoleTypeBox.ItemsSource = _consoleTypeChoices;
ConsoleLanguageBox.ItemsSource = _consoleLanguageChoices;
LogLevelBox.ItemsSource = _logLevelChoices; LogLevelBox.ItemsSource = _logLevelChoices;
RenderResolutionBox.ItemsSource = _renderResolutionChoices;
WindowModeBox.ItemsSource = _windowModeChoices; WindowModeBox.ItemsSource = _windowModeChoices;
ScalingModeBox.ItemsSource = _scalingModeChoices; ScalingModeBox.ItemsSource = _scalingModeChoices;
HdrModeBox.ItemsSource = _hdrModeChoices; HdrModeBox.ItemsSource = _hdrModeChoices;
BinkPlaybackBox.ItemsSource = _binkPlaybackChoices;
OverlayModeBox.ItemsSource = _overlayModeChoices;
OverlayCornerBox.ItemsSource = _overlayCornerChoices;
} }
private void RefreshLocalizedChoices() private void RefreshLocalizedChoices()
{ {
RefreshChoices(_cpuEngineChoices); RefreshChoices(_cpuEngineChoices);
RefreshChoices(_consoleTypeChoices);
RefreshChoices(_consoleLanguageChoices);
RefreshChoices(_logLevelChoices); RefreshChoices(_logLevelChoices);
RefreshChoices(_renderResolutionChoices);
RefreshChoices(_windowModeChoices); RefreshChoices(_windowModeChoices);
RefreshChoices(_scalingModeChoices); RefreshChoices(_scalingModeChoices);
RefreshChoices(_hdrModeChoices); RefreshChoices(_hdrModeChoices);
RefreshChoices(_binkPlaybackChoices);
RefreshChoices(_overlayModeChoices);
RefreshChoices(_overlayCornerChoices);
} }
private static void RefreshChoices(IEnumerable<LocalizedChoice> choices) private static void RefreshChoices(IEnumerable<LocalizedChoice> choices)
@ -1149,6 +1280,10 @@ public partial class MainWindow : Window
private void ApplySettingsToControls() private void ApplySettingsToControls()
{ {
CpuEngineBox.SelectedIndex = 0; CpuEngineBox.SelectedIndex = 0;
ConsoleTypeBox.SelectedIndex = 0;
ConsoleLanguageBox.SelectedIndex = ChoiceIndex(
_settings.ConsoleLanguage,
_consoleLanguageChoices.Select(choice => choice.Value).ToArray());
LogLevelBox.SelectedIndex = _settings.LogLevel.ToLowerInvariant() switch LogLevelBox.SelectedIndex = _settings.LogLevel.ToLowerInvariant() switch
{ {
"trace" => 0, "trace" => 0,
@ -1160,36 +1295,39 @@ public partial class MainWindow : Window
_ => 2, _ => 2,
}; };
TraceImportsBox.Value = Math.Clamp(_settings.ImportTraceLimit, 0, 4096); TraceImportsBox.Value = Math.Clamp(_settings.ImportTraceLimit, 0, 4096);
RenderResolutionBox.SelectedIndex = _settings.RenderResolutionScale switch
{
>= 0.875 => 0,
>= 0.625 => 1,
>= 0.375 => 2,
_ => 3,
};
StrictToggle.IsChecked = _settings.StrictDynlibResolution; StrictToggle.IsChecked = _settings.StrictDynlibResolution;
LogToFileToggle.IsChecked = _settings.LogToFile; LogToFileToggle.IsChecked = _settings.LogToFile;
CrashDumpToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_CRASH_CAPTURE");
OverrideLogFileToggle.IsChecked = _settings.OverrideLogFile; OverrideLogFileToggle.IsChecked = _settings.OverrideLogFile;
TitleMusicToggle.IsChecked = _settings.PlayTitleMusic; TitleMusicToggle.IsChecked = _settings.PlayTitleMusic;
SetLibraryLayout(string.Equals(_settings.LibraryLayout, "Grid", StringComparison.OrdinalIgnoreCase)); SetLibraryLayout(string.Equals(_settings.LibraryLayout, "Grid", StringComparison.OrdinalIgnoreCase));
DiscordToggle.IsChecked = _settings.DiscordRichPresence; DiscordToggle.IsChecked = _settings.DiscordRichPresence;
AutoUpdateToggle.IsChecked = _settings.CheckForUpdatesOnStartup; AutoUpdateToggle.IsChecked = _settings.CheckForUpdatesOnStartup;
PerformanceProfileToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_PROFILE_PERFORMANCE");
PerformanceFrameTraceToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_PROFILE_PERFORMANCE_FRAME_TRACE");
StrictComputeToggle.IsChecked = StrictComputeSettings.IsEnabled(_settings.EnvironmentToggles);
EnvBthidToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_BTHID_UNAVAILABLE"); EnvBthidToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_BTHID_UNAVAILABLE");
EnvLoopGuardToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_DISABLE_IMPORT_LOOP_GUARD"); EnvLoopGuardToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_DISABLE_IMPORT_LOOP_GUARD");
EnvWritableApp0Toggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_WRITABLE_APP0"); EnvWritableApp0Toggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_WRITABLE_APP0");
BinkPlaybackBox.SelectedIndex = ChoiceIndex(_settings.BinkPlaybackMode, "Host", "Guest", "Skip");
EnvVkValidationToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_VK_VALIDATION"); EnvVkValidationToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_VK_VALIDATION");
EnvDumpSpirvToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_DUMP_SPIRV"); EnvDumpSpirvToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_DUMP_SPIRV");
EnvLogDirectMemoryToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_LOG_DIRECT_MEMORY"); EnvLogDirectMemoryToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_LOG_DIRECT_MEMORY");
EnvLogIoToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_LOG_IO"); EnvLogIoToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_LOG_IO");
EnvLogNpToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_LOG_NP"); EnvLogNpToggle.IsChecked = _settings.EnvironmentToggles.Contains("SHARPEMU_LOG_NP");
EnvGuestImageCpuSyncToggle.IsChecked = EnvRenderDocToggle.IsChecked =
_settings.EnvironmentToggles.Contains("SHARPEMU_GUEST_IMAGE_CPU_SYNC"); _settings.EnvironmentToggles.Contains("SHARPEMU_RENDERDOC");
EnvDisableVkImplicitLayersToggle.IsChecked =
_settings.EnvironmentToggles.Contains("SHARPEMU_VK_DISABLE_IMPLICITS");
DefaultProfileBox.Text = _settings.DefaultProfile; DefaultProfileBox.Text = _settings.DefaultProfile;
WindowModeBox.SelectedIndex = ChoiceIndex(_settings.WindowMode, "Windowed", "Borderless", "Exclusive"); WindowModeBox.SelectedIndex = ChoiceIndex(_settings.WindowMode, "Windowed", "Borderless", "Exclusive");
LoadHostDisplayOptions(); LoadHostDisplayOptions();
ScalingModeBox.SelectedIndex = ChoiceIndex(_settings.ScalingMode, "Fit", "Cover", "Stretch", "Integer"); ScalingModeBox.SelectedIndex = ChoiceIndex(_settings.ScalingMode, "Fit", "Cover", "Stretch", "Integer");
VSyncToggle.IsChecked = _settings.VSync; VSyncToggle.IsChecked = _settings.VSync;
HdrModeBox.SelectedIndex = ChoiceIndex(_settings.HdrMode, "Auto", "On", "Off"); HdrModeBox.SelectedIndex = ChoiceIndex(_settings.HdrMode, "Auto", "On", "Off");
OverlayEnabledToggle.IsChecked = _settings.OverlayEnabled;
OverlayModeBox.SelectedIndex = ChoiceIndex(_settings.OverlayMode, "Full", "Minimal", "TitleBar");
OverlayCornerBox.SelectedIndex = ChoiceIndex(_settings.OverlayCorner, "TopLeft", "TopRight", "BottomRight", "BottomLeft");
UpdateLogFilePathText(); UpdateLogFilePathText();
} }
@ -1412,6 +1550,7 @@ public partial class MainWindow : Window
} }
private const string DefaultProfileEnvironmentName = "SHARPEMU_DEFAULT_PROFILE"; private const string DefaultProfileEnvironmentName = "SHARPEMU_DEFAULT_PROFILE";
private const string BinkModeEnvironmentName = "SHARPEMU_BINK_MODE";
private string SelectedLogLevel() private string SelectedLogLevel()
{ {
@ -2085,10 +2224,7 @@ public partial class MainWindow : Window
GameLibraryReconciler.ReconcileVisibleGames(_visibleGames, desired); GameLibraryReconciler.ReconcileVisibleGames(_visibleGames, desired);
var selectedAfter = selectedPath is null var selectedAfter = ResolveLibrarySelection(_visibleGames, selectedPath);
? null
: _visibleGames.FirstOrDefault(game =>
game.Path.Equals(selectedPath, GameLibraryPath.Comparison));
if (!ReferenceEquals(GameList.SelectedItem, selectedAfter)) if (!ReferenceEquals(GameList.SelectedItem, selectedAfter))
{ {
GameList.SelectedItem = selectedAfter; GameList.SelectedItem = selectedAfter;
@ -2111,6 +2247,17 @@ public partial class MainWindow : Window
} }
} }
internal static GameEntry? ResolveLibrarySelection(
IReadOnlyList<GameEntry> visibleGames,
string? selectedPath)
{
var selected = selectedPath is null
? null
: visibleGames.FirstOrDefault(game =>
game.Path.Equals(selectedPath, GameLibraryPath.Comparison));
return selected ?? visibleGames.FirstOrDefault();
}
/// <summary> /// <summary>
/// Refreshes the empty-state title/hint from the current language and /// Refreshes the empty-state title/hint from the current language and
/// search text; a no-op while the empty state is not showing. /// search text; a no-op while the empty state is not showing.
@ -2149,6 +2296,7 @@ public partial class MainWindow : Window
_sndPreview.Stop(); _sndPreview.Stop();
} }
UpdateLibraryMinimumHeight();
UpdateRunButtons(); UpdateRunButtons();
} }
@ -2284,6 +2432,34 @@ public partial class MainWindow : Window
} }
} }
private async Task OpenCustomEnvironmentDialogAsync()
{
if (_isRunning || GameList.SelectedItem is not GameEntry game)
{
return;
}
var perGame = PerGameSettings.Load(game.TitleId);
var initialEntries = CustomEnvironmentVariables.Merge(
GlobalCustomEnvironmentSettings.Load(),
perGame?.CustomEnvironmentVariables);
var dialog = new CustomEnvironmentDialog(game.TitleId, initialEntries);
dialog.SaveGlobalRequested += entries => GlobalCustomEnvironmentSettings.Save(entries);
dialog.SaveGameRequested += (titleId, entries) =>
{
var settings = PerGameSettings.Load(titleId) ?? new PerGameSettings();
settings.CustomEnvironmentVariables = entries.Count == 0 ? null : entries.ToList();
settings.RemoveInheritedValues(_settings);
settings.Save(titleId);
};
var customEntries = await dialog.ShowDialog<IReadOnlyList<string>?>(this);
if (customEntries is not null && !_isRunning)
{
Launch(game.Path, game.Name, game.TitleId, customEntries);
}
}
private void LaunchSelected() private void LaunchSelected()
{ {
if (GameList.SelectedItem is GameEntry game) if (GameList.SelectedItem is GameEntry game)
@ -2292,7 +2468,11 @@ public partial class MainWindow : Window
} }
} }
private void Launch(string ebootPath, string displayName, string? titleId = null) private void Launch(
string ebootPath,
string displayName,
string? titleId = null,
IReadOnlyList<string>? oneShotCustomEnvironment = null)
{ {
if (_isRunning) if (_isRunning)
{ {
@ -2303,7 +2483,12 @@ public partial class MainWindow : Window
? _allGames.FirstOrDefault(game => ? _allGames.FirstOrDefault(game =>
game.Path.Equals(ebootPath, GameLibraryPath.Comparison))?.TitleId game.Path.Equals(ebootPath, GameLibraryPath.Comparison))?.TitleId
: titleId; : titleId;
var effective = EffectiveLaunchSettings.Resolve(_settings, PerGameSettings.Load(resolvedTitleId)); var perGame = PerGameSettings.Load(resolvedTitleId);
var effective = EffectiveLaunchSettings.Resolve(_settings, perGame);
var customEnvironment = CustomEnvironmentVariables.Merge(
GlobalCustomEnvironmentSettings.Load(),
perGame?.CustomEnvironmentVariables,
oneShotCustomEnvironment);
_sndPreview.Stop(); _sndPreview.Stop();
_consoleLines.Clear(); _consoleLines.Clear();
@ -2344,16 +2529,54 @@ public partial class MainWindow : Window
_appliedEnvironmentVariables.Add(name); _appliedEnvironmentVariables.Add(name);
} }
if (RenderDocCapture.ApplyVulkanLoaderEnvironment())
{
_appliedEnvironmentVariables.Add("VK_LOADER_DEBUG");
_appliedEnvironmentVariables.Add("VK_LOADER_LAYERS_DISABLE");
_appliedEnvironmentVariables.Add("VK_LOADER_LAYERS_ALLOW");
}
Environment.SetEnvironmentVariable( Environment.SetEnvironmentVariable(
DefaultProfileEnvironmentName, DefaultProfileEnvironmentName,
GuiSettings.NormalizeDefaultProfile(_settings.DefaultProfile)); GuiSettings.NormalizeDefaultProfile(_settings.DefaultProfile));
// Apply both values so an inherited skip setting cannot override the GUI choice.
Environment.SetEnvironmentVariable(StrictComputeSettings.VariableName,
StrictComputeSettings.GetLaunchValue(effective.EnvironmentToggles));
_appliedEnvironmentVariables.Add(StrictComputeSettings.VariableName);
_appliedEnvironmentVariables.Add(DefaultProfileEnvironmentName); _appliedEnvironmentVariables.Add(DefaultProfileEnvironmentName);
// An absent switch now enables the guard opt-out by default; send 0 for a disabled GUI toggle.
Environment.SetEnvironmentVariable("SHARPEMU_DISABLE_IMPORT_LOOP_GUARD",
effective.EnvironmentToggles.Contains("SHARPEMU_DISABLE_IMPORT_LOOP_GUARD") ? "1" : "0");
_appliedEnvironmentVariables.Add("SHARPEMU_DISABLE_IMPORT_LOOP_GUARD");
Environment.SetEnvironmentVariable(
BinkModeEnvironmentName,
_settings.BinkPlaybackMode switch
{
"Guest" => "guest",
"Skip" => "skip",
_ => "native",
});
_appliedEnvironmentVariables.Add(BinkModeEnvironmentName);
Environment.SetEnvironmentVariable( Environment.SetEnvironmentVariable(
"SHARPEMU_RENDER_SCALE", "SHARPEMU_RENDER_SCALE",
_settings.RenderResolutionScale.ToString( _settings.RenderResolutionScale.ToString(
"0.###", "0.###",
System.Globalization.CultureInfo.InvariantCulture)); System.Globalization.CultureInfo.InvariantCulture));
_appliedEnvironmentVariables.Add("SHARPEMU_RENDER_SCALE");
foreach (var entry in customEnvironment)
{
if (!CustomEnvironmentVariables.TryParseEntry(entry, out var name, out var value))
{
continue;
}
Environment.SetEnvironmentVariable(name, value);
_appliedEnvironmentVariables.Add(name);
}
if (SharpEmuLog.TryParseLevel(effective.LogLevel, out var logLevel)) if (SharpEmuLog.TryParseLevel(effective.LogLevel, out var logLevel))
{ {
@ -2379,6 +2602,8 @@ public partial class MainWindow : Window
Path.GetFullPath(ebootPath), Path.GetFullPath(ebootPath),
displayName, displayName,
_runningGameTitleId, _runningGameTitleId,
_settings.ConsoleType,
_settings.ConsoleLanguage,
effective, effective,
runtimeOptions); runtimeOptions);
@ -2425,7 +2650,7 @@ public partial class MainWindow : Window
_runningGameName = null; _runningGameName = null;
_runningGameTitleId = null; _runningGameTitleId = null;
UpdateDiscordPresence(); UpdateDiscordPresence();
ConsolePanel.IsVisible = ConsoleToggle.IsChecked == true && _consoleWindow is null; UpdateEmbeddedConsoleVisibility();
Console.Error.WriteLine("[GUI][INFO] Waiting for the SDL game process to exit."); Console.Error.WriteLine("[GUI][INFO] Waiting for the SDL game process to exit.");
} }
@ -2463,12 +2688,13 @@ public partial class MainWindow : Window
private void OnEmulatorExited(int exitCode) private void OnEmulatorExited(int exitCode)
{ {
FlushPendingConsoleLines(); FlushPendingConsoleLines();
FlushAllPendingConsoleLines();
_isRunning = false; _isRunning = false;
_isStopping = false; _isStopping = false;
_emulator?.Dispose(); _emulator?.Dispose();
_emulator = null; _emulator = null;
_pendingLaunch = null; _pendingLaunch = null;
ConsolePanel.IsVisible = ConsoleToggle.IsChecked == true && _consoleWindow is null; UpdateEmbeddedConsoleVisibility();
var meaningKey = exitCode switch var meaningKey = exitCode switch
{ {
@ -2544,6 +2770,8 @@ public partial class MainWindow : Window
{ {
"--cpu-engine=native", "--cpu-engine=native",
$"--log-level={launch.Settings.LogLevel}", $"--log-level={launch.Settings.LogLevel}",
$"--console={launch.ConsoleType.ToLowerInvariant()}",
$"--console-language={launch.ConsoleLanguage}",
}; };
if (launch.RuntimeOptions.StrictDynlibResolution) if (launch.RuntimeOptions.StrictDynlibResolution)
{ {
@ -2561,6 +2789,9 @@ public partial class MainWindow : Window
arguments.Add($"--scaling={launch.Settings.ScalingMode.ToLowerInvariant()}"); arguments.Add($"--scaling={launch.Settings.ScalingMode.ToLowerInvariant()}");
arguments.Add($"--vsync={(launch.Settings.VSync ? "on" : "off")}"); arguments.Add($"--vsync={(launch.Settings.VSync ? "on" : "off")}");
arguments.Add($"--hdr={launch.Settings.HdrMode.ToLowerInvariant()}"); arguments.Add($"--hdr={launch.Settings.HdrMode.ToLowerInvariant()}");
arguments.Add($"--overlay={(launch.Settings.OverlayEnabled ? "on" : "off")}");
arguments.Add($"--overlay-mode={launch.Settings.OverlayMode.ToLowerInvariant()}");
arguments.Add($"--overlay-corner={launch.Settings.OverlayCorner.ToLowerInvariant()}");
arguments.Add(launch.EbootPath); arguments.Add(launch.EbootPath);
return arguments; return arguments;
@ -2642,6 +2873,8 @@ public partial class MainWindow : Window
LaunchButton.IsEnabled = GameList.SelectedItem is GameEntry; LaunchButton.IsEnabled = GameList.SelectedItem is GameEntry;
} }
LaunchCustomEnvButton.IsEnabled = !_isRunning && GameList.SelectedItem is GameEntry;
GameSettingsButton.IsEnabled = GameSettingsButton.IsEnabled =
GameList.SelectedItem is GameEntry game && GameList.SelectedItem is GameEntry game &&
!string.IsNullOrWhiteSpace(game.TitleId); !string.IsNullOrWhiteSpace(game.TitleId);
@ -2658,12 +2891,8 @@ public partial class MainWindow : Window
} }
var incoming = new List<LogLine>(); var incoming = new List<LogLine>();
while (incoming.Count < MaxConsoleLinesPerFlush && DrainPendingLogLines(_pendingLines, WriteFileLog,
_pendingLines.TryDequeue(out var pending)) line => incoming.Add(new LogLine(line, BrushForLine(line))), MaxConsoleLinesPerFlush);
{
WriteFileLog(pending.Line);
incoming.Add(new LogLine(pending.Line, BrushForLine(pending.Line)));
}
FlushFileLog(); FlushFileLog();
@ -2744,6 +2973,27 @@ public partial class MainWindow : Window
// ---- Console-to-file mirroring ---- // ---- Console-to-file mirroring ----
private void FlushAllPendingConsoleLines()
{
while (!_pendingLines.IsEmpty)
{
FlushPendingConsoleLines();
}
}
internal static void DrainPendingLogLines(
ConcurrentQueue<(string Line, bool IsError)> pendingLines,
Action<string> writeLine,
Action<string> displayLine,
int maxLines = int.MaxValue)
{
for (var count = 0; count < maxLines && pendingLines.TryDequeue(out var pending); count++)
{
writeLine(pending.Line);
displayLine(pending.Line);
}
}
private void WriteFileLog(string text) private void WriteFileLog(string text)
{ {
if (_fileLog is not { } writer) if (_fileLog is not { } writer)
@ -2804,7 +3054,7 @@ public partial class MainWindow : Window
{ {
if (ReferenceEquals(_fileLog, writer)) if (ReferenceEquals(_fileLog, writer))
{ {
FlushPendingConsoleLines(); FlushAllPendingConsoleLines();
DropFileLog(); DropFileLog();
} }
}, TimeSpan.FromMilliseconds(400)); }, TimeSpan.FromMilliseconds(400));
@ -2864,6 +3114,68 @@ public partial class MainWindow : Window
await Clipboard.SetTextAsync(text); await Clipboard.SetTextAsync(text);
} }
private void UpdateEmbeddedConsoleVisibility()
{
var visible = ShouldShowEmbeddedConsole(
ConsoleToggle.IsChecked == true, _consoleWindow is not null, _activePageIndex, _isGameSettingsOpen);
if (visible == ConsolePanel.IsVisible)
{
return;
}
if (!visible)
RememberEmbeddedConsoleHeight();
ConsolePanel.IsVisible = visible;
ConsoleSplitter.IsVisible = visible;
MainContent.RowDefinitions[2].Height = visible
? new GridLength(8)
: new GridLength(0);
MainContent.RowDefinitions[3].MinHeight = visible ? 120 : 0;
MainContent.RowDefinitions[3].Height = visible
? new GridLength(Math.Min(_settings.EmbeddedConsoleHeight, MaximumEmbeddedConsoleHeight()))
: new GridLength(0);
}
internal static bool ShouldShowEmbeddedConsole(
bool requested, bool detached, int activePageIndex, bool gameOptionsOpen) =>
requested && !detached && activePageIndex == 0 && !gameOptionsOpen;
private void RememberEmbeddedConsoleHeight()
{
if (ConsolePanel.IsVisible && ConsolePanel.Bounds.Height >= 120)
_settings.EmbeddedConsoleHeight = ConsolePanel.Bounds.Height;
}
private void ClampEmbeddedConsoleHeight()
{
if (!ConsolePanel.IsVisible)
{
return;
}
var maximumHeight = MaximumEmbeddedConsoleHeight();
if (MainContent.RowDefinitions[3].ActualHeight > maximumHeight)
{
MainContent.RowDefinitions[3].Height = new GridLength(maximumHeight);
}
}
private double MaximumEmbeddedConsoleHeight()
{
const double minimumConsoleHeight = 120;
const double splitterHeight = 8;
var toolbarHeight = ContentToolbar.Bounds.Height +
ContentToolbar.Margin.Top +
ContentToolbar.Margin.Bottom;
return Math.Max(
minimumConsoleHeight,
MainContent.Bounds.Height -
toolbarHeight -
MainContent.RowDefinitions[1].MinHeight -
splitterHeight);
}
private void ShowConsoleWindow() private void ShowConsoleWindow()
{ {
if (_consoleWindow is { } window) if (_consoleWindow is { } window)
@ -2874,16 +3186,20 @@ public partial class MainWindow : Window
ConsoleSearchBox.Text = string.Empty; ConsoleSearchBox.Text = string.Empty;
ConsoleToggle.IsChecked = false; ConsoleToggle.IsChecked = false;
ConsolePanel.IsVisible = false; UpdateEmbeddedConsoleVisibility();
_consoleWindow = new ConsoleWindow( _consoleWindow = new ConsoleWindow(
_consoleLines, _consoleLines,
() => { _consoleLines.Clear(); _allConsoleLines.Clear(); }, () => { _consoleLines.Clear(); _allConsoleLines.Clear(); },
AutoScrollCheck.IsChecked == true); AutoScrollCheck.IsChecked == true,
_settings);
_consoleWindow.Closed += (_, _) => _consoleWindow.Closed += (_, _) =>
{ {
_consoleWindow = null; _consoleWindow = null;
ConsoleToggle.IsChecked = true; if (!_isClosing)
ConsolePanel.IsVisible = true; {
ConsoleToggle.IsChecked = true;
UpdateEmbeddedConsoleVisibility();
}
}; };
_consoleWindow.Show(this); _consoleWindow.Show(this);
} }

View File

@ -8,6 +8,7 @@ namespace SharpEmu.GUI;
public sealed class PerGameSettings public sealed class PerGameSettings
{ {
private static readonly JsonSerializerOptions SerializerOptions = new() private static readonly JsonSerializerOptions SerializerOptions = new()
{ {
WriteIndented = true, WriteIndented = true,
@ -35,8 +36,14 @@ public sealed class PerGameSettings
public string? HdrMode { get; set; } public string? HdrMode { get; set; }
public bool? OverlayEnabled { get; set; }
public string? OverlayCorner { get; set; }
public string? OverlayMode { get; set; }
public List<string>? EnvironmentToggles { get; set; } public List<string>? EnvironmentToggles { get; set; }
public List<string>? CustomEnvironmentVariables { get; set; }
[JsonIgnore] [JsonIgnore]
public bool IsEmpty => public bool IsEmpty =>
LogLevel is null && LogLevel is null &&
@ -50,7 +57,11 @@ public sealed class PerGameSettings
ScalingMode is null && ScalingMode is null &&
VSync is null && VSync is null &&
HdrMode is null && HdrMode is null &&
EnvironmentToggles is null; OverlayEnabled is null &&
OverlayCorner is null &&
OverlayMode is null &&
EnvironmentToggles is null &&
CustomEnvironmentVariables is null;
public static string DirectoryPath => public static string DirectoryPath =>
Path.Combine(AppContext.BaseDirectory, "user", "custom_configs"); Path.Combine(AppContext.BaseDirectory, "user", "custom_configs");
@ -88,6 +99,12 @@ public sealed class PerGameSettings
{ {
settings.EnvironmentToggles = toggles.Where(entry => !string.IsNullOrEmpty(entry)).ToList(); settings.EnvironmentToggles = toggles.Where(entry => !string.IsNullOrEmpty(entry)).ToList();
} }
if (settings?.CustomEnvironmentVariables is { } customEnvironmentVariables)
{
settings.CustomEnvironmentVariables = customEnvironmentVariables
.Where(entry => !string.IsNullOrWhiteSpace(entry))
.ToList();
}
return settings; return settings;
} }
@ -153,11 +170,27 @@ public sealed class PerGameSettings
HdrMode = null; HdrMode = null;
} }
if (OverlayEnabled == global.OverlayEnabled)
{
OverlayEnabled = null;
}
if (string.Equals(OverlayCorner, global.OverlayCorner, StringComparison.OrdinalIgnoreCase))
{
OverlayCorner = null;
}
if (string.Equals(OverlayMode, global.OverlayMode, StringComparison.OrdinalIgnoreCase))
{
OverlayMode = null;
}
if (EnvironmentToggles is { } environmentToggles && if (EnvironmentToggles is { } environmentToggles &&
EnvironmentEntriesEqual(environmentToggles, global.EnvironmentToggles)) EnvironmentEntriesEqual(environmentToggles, global.EnvironmentToggles))
{ {
EnvironmentToggles = null; EnvironmentToggles = null;
} }
} }
public void Save(string titleId) public void Save(string titleId)
@ -207,9 +240,12 @@ public sealed class PerGameSettings
private static HashSet<string> NormalizeEnvironmentEntries(IEnumerable<string> entries) private static HashSet<string> NormalizeEnvironmentEntries(IEnumerable<string> entries)
{ {
var normalized = new HashSet<string>(StringComparer.OrdinalIgnoreCase); var normalized = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
if (StrictComputeSettings.IsEnabled(entries)) normalized.Add(StrictComputeSettings.VariableName);
foreach (var entry in entries) foreach (var entry in entries)
{ {
var parts = entry.Split('=', 2, StringSplitOptions.TrimEntries); var parts = entry.Split('=', 2, StringSplitOptions.TrimEntries);
// An explicit zero differs from the enabled default for this switch.
if (string.Equals(parts[0], StrictComputeSettings.VariableName, StringComparison.OrdinalIgnoreCase)) continue;
if (parts.Length == 0 || string.IsNullOrWhiteSpace(parts[0])) if (parts.Length == 0 || string.IsNullOrWhiteSpace(parts[0]))
{ {
continue; continue;
@ -241,6 +277,9 @@ public sealed record EffectiveLaunchSettings(
string ScalingMode, string ScalingMode,
bool VSync, bool VSync,
string HdrMode, string HdrMode,
bool OverlayEnabled,
string OverlayCorner,
string OverlayMode,
IReadOnlyList<string> EnvironmentToggles) IReadOnlyList<string> EnvironmentToggles)
{ {
public static EffectiveLaunchSettings Resolve(GuiSettings global, PerGameSettings? perGame) => new( public static EffectiveLaunchSettings Resolve(GuiSettings global, PerGameSettings? perGame) => new(
@ -255,5 +294,8 @@ public sealed record EffectiveLaunchSettings(
perGame?.ScalingMode ?? global.ScalingMode, perGame?.ScalingMode ?? global.ScalingMode,
perGame?.VSync ?? global.VSync, perGame?.VSync ?? global.VSync,
perGame?.HdrMode ?? global.HdrMode, perGame?.HdrMode ?? global.HdrMode,
perGame?.OverlayEnabled ?? global.OverlayEnabled,
perGame?.OverlayCorner ?? global.OverlayCorner,
perGame?.OverlayMode ?? global.OverlayMode,
perGame?.EnvironmentToggles ?? global.EnvironmentToggles); perGame?.EnvironmentToggles ?? global.EnvironmentToggles);
} }

View File

@ -0,0 +1,19 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
namespace SharpEmu.GUI;
internal static class ProjectLinks
{
private const string RepositorySlug = "sharpemu/sharpemu";
public static string RepositoryUrl => $"https://github.com/{RepositorySlug}";
public static string LatestCommitApiUrl =>
$"https://api.github.com/repos/{RepositorySlug}/commits/main";
public static string CommitUrl(string sha) => $"{RepositoryUrl}/commit/{sha}";
public static string DocumentUrl(string path) =>
$"{RepositoryUrl}/blob/main/{path.TrimStart('/')}";
}

View File

@ -0,0 +1,30 @@
// Copyright (C) 2026 SharpEmu Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later
namespace SharpEmu.GUI;
internal static class StrictComputeSettings
{
internal const string VariableName = "SHARPEMU_STRICT_COMPUTE";
internal static bool IsEnabled(IEnumerable<string> entries)
{
var enabled = true;
foreach (var entry in entries)
{
var parts = entry.Split('=', 2, StringSplitOptions.TrimEntries);
if (string.Equals(parts[0], VariableName, StringComparison.OrdinalIgnoreCase))
enabled = parts.Length == 1 || parts[1] != "0";
}
return enabled;
}
internal static void SetEnabled(List<string> entries, bool enabled)
{
entries.RemoveAll(entry => string.Equals(entry.Split('=', 2, StringSplitOptions.TrimEntries)[0],
VariableName, StringComparison.OrdinalIgnoreCase));
entries.Add(enabled ? VariableName : VariableName + "=0");
}
internal static string GetLaunchValue(IEnumerable<string> entries) => IsEnabled(entries) ? "1" : "0";
}

View File

@ -28,7 +28,7 @@ Contextual per-game options reveal, actions, and selected-game motion.
<Setter Property="Opacity" Value="1" /> <Setter Property="Opacity" Value="1" />
</Style> </Style>
<Style Selector="StackPanel.selectedDetailsHost"> <Style Selector="Grid.selectedDetailsHost">
<Setter Property="RenderTransform" Value="translateY(0px)" /> <Setter Property="RenderTransform" Value="translateY(0px)" />
<Setter Property="Opacity" Value="1" /> <Setter Property="Opacity" Value="1" />
</Style> </Style>
@ -47,7 +47,7 @@ Contextual per-game options reveal, actions, and selected-game motion.
<Setter Property="Opacity" Value="0" /> <Setter Property="Opacity" Value="0" />
</Style> </Style>
<Style Selector="StackPanel.selectedDetailsHost.gameOptionsOpen"> <Style Selector="Grid.selectedDetailsHost.gameOptionsOpen">
<Setter Property="RenderTransform" Value="translateY(-28px)" /> <Setter Property="RenderTransform" Value="translateY(-28px)" />
<Setter Property="Opacity" Value="0" /> <Setter Property="Opacity" Value="0" />
</Style> </Style>
@ -109,26 +109,17 @@ Contextual per-game options reveal, actions, and selected-game motion.
<Setter Property="CornerRadius" Value="20" /> <Setter Property="CornerRadius" Value="20" />
</Style> </Style>
<Style Selector="StackPanel.selectedDetailsHost">
<Setter Property="Spacing" Value="18" />
</Style>
<Style Selector="TextBlock.selectedGameTitle"> <Style Selector="TextBlock.selectedGameTitle">
<Setter Property="FontSize" Value="42" /> <Setter Property="FontSize" Value="28" />
</Style> </Style>
<Style Selector="StackPanel.selectedDetailsHost.gridLayout"> <Style Selector="Grid.selectedDetailsHost.gridLayout TextBlock.selectedGameTitle">
<Setter Property="Spacing" Value="12" />
</Style>
<Style Selector="StackPanel.selectedDetailsHost.gridLayout TextBlock.selectedGameTitle">
<Setter Property="FontSize" Value="26" /> <Setter Property="FontSize" Value="26" />
</Style> </Style>
<Style Selector="Border.selectedDetailsDivider"> <Style Selector="Border.selectedDetailsDivider">
<Setter Property="Height" Value="1" /> <Setter Property="Height" Value="1" />
<Setter Property="MinWidth" Value="440" /> <Setter Property="Margin" Value="0,10,0,0" />
<Setter Property="Margin" Value="0,0,0,18" />
<Setter Property="HorizontalAlignment" Value="Stretch" /> <Setter Property="HorizontalAlignment" Value="Stretch" />
<Setter Property="Background"> <Setter Property="Background">
<LinearGradientBrush StartPoint="0%,0%" EndPoint="100%,0%"> <LinearGradientBrush StartPoint="0%,0%" EndPoint="100%,0%">
@ -140,15 +131,15 @@ Contextual per-game options reveal, actions, and selected-game motion.
</Setter> </Setter>
</Style> </Style>
<Style Selector="StackPanel.selectedDetailsHost.gridLayout Button.playButton"> <Style Selector="Grid.selectedDetailsHost Button.playButton">
<Setter Property="MinHeight" Value="44" /> <Setter Property="MinHeight" Value="44" />
<Setter Property="MinWidth" Value="168" /> <Setter Property="MinWidth" Value="168" />
<Setter Property="Padding" Value="28,10" /> <Setter Property="Padding" Value="28,10" />
<Setter Property="FontSize" Value="15" /> <Setter Property="FontSize" Value="15" />
</Style> </Style>
<Style Selector="StackPanel.selectedDetailsHost.gridLayout Button.optionsCircle, <Style Selector="Grid.selectedDetailsHost Button.optionsCircle,
StackPanel.selectedDetailsHost.gridLayout ToggleButton.optionsCircle"> Grid.selectedDetailsHost ToggleButton.optionsCircle">
<Setter Property="Width" Value="44" /> <Setter Property="Width" Value="44" />
<Setter Property="Height" Value="44" /> <Setter Property="Height" Value="44" />
<Setter Property="CornerRadius" Value="22" /> <Setter Property="CornerRadius" Value="22" />

Some files were not shown because too many files have changed in this diff Show More