eglantine-cirakg/src/video_core/shader_environment.cpp, branch nx2

video_core: flush GPU-written code when capturing native shaders

2026-11-02T19:53:47+00:00

10e7063905 moved native program capture from one ReadBlock per instruction to ReadBlockUnsafe per 4 KiB page. ReadBlockUnsafe skips the rasterizer flush, so code that a GPU copy had written and not yet flushed to guest memory was captured stale. The speed-up comes from reading a page at a time, not from skipping the flush: read each page (and the odd single instruction outside a fully mapped page) with ReadBlock, which flushes once per page instead of once per instruction. Follow-up to 10e7063905. Assisted-by: Claude Sonnet 5.5 (implementation and commit message)

video_core: read texture handles as header offsets only on Switch 2

2026-11-02T19:53:47+00:00

049c9633ed made TextureHeaderIndex take index / 32 for any texture index past the pool that is a multiple of 32, in VisitImageView and in the shader environment. That was written for Switch 2 handles that hold a header byte offset, but it ran for Switch 1 games too, where such an out-of-range index used to give a null view (and fail the shader environment's range check) and now binds an unrelated header. Pass whether the memory manager uses native tiling, which is how Switch 2 titles are set up, and keep the previous behaviour otherwise. Follow-up to 049c9633ed. Assisted-by: Claude Sonnet 5.5 (implementation and commit message)

nx2: capture and lower native shader programs once

2026-11-01T23:11:25+00:00

Native programs were captured and lowered when their ShaderInfo was made and again for every environment built for their pipelines. The ShaderInfo now keeps the lowered code and the environments adopt it. Capture also reads a 4 KiB page at a time instead of flushing caches per instruction, and cached native programs fold bank 1 reads like live ones. Ported from Wael3rd/Eglantine-MKW (0ae093058e, 65a6aa877a, df076133c4). Assisted-by: Claude Sonnet 5.5 (porting the fixes) (cherry picked from commit 3af11ac401ad3061c183281d8c98c16c1d6da456)

Merge remote-tracking branch 'origin/fix/nx2-texture-header-offset-handles' into test/linux-all-prs

2026-11-01T18:26:13+00:00

video_core: draw Switch 2 task/mesh pipelines with VK_EXT_mesh_shader

2026-11-01T16:29:30+00:00

While SET_MESH_CONTROL is on, a native draw binds a task program in the vertex slot, its mesh program in the tessellation slot and a header-only pass-through geometry program naming the per-primitive outputs. Translate the first two as task and mesh programs with the mesh registers (SET_MESH_SHADER_A/B, SET_MESH_INIT_SHADER) and that header, key their pipelines by them, and build pipelines with task/mesh stages and no vertex input, input assembly or tessellation state. The draw's vertex count is the number of task workgroups: record vkCmdDrawMeshTasksEXT. Enable VK_EXT_mesh_shader (task and mesh only) when the host has it; draws are skipped without it, as they were before.

nx2: read texture handles that hold a header byte offset

2026-10-31T14:31:41+00:00

Switch Sports' scenery shaders take their 64-bit texture handles from a uniform register, and the texture part of those handles is the header's byte offset in the pool (index * 32), not its index: 0x96e46000 names header 8960 (a 640x152 2D texture), while the plain reading, 286720, runs far past the 33067-entry pool. Eden skipped them at draw time (null view) and built the shaders for a garbage header, so the island's ground, cliffs and buildings drew black. When a handle's index falls past the pool but index / 32 lands inside it, take that header, both when building the shader and when binding the view. Handles that already resolve keep their meaning.

nx2: log per-call GPU memory, syncpoint and shader lowering lines at debug level

2026-10-30T03:33:03+00:00

GPU memory registration (gpu sub 101) and mapping (211) alone wrote two info lines per allocation, about 80% of every Switch 2 log (27,000 lines in five minutes of Mario Kart World), with slot jobs, semaphore pages, GPU-only region words, syncpoint waits and each lowered shader on top. They are still there at debug level; one-time messages, the GPU-only region backing and every warning about unexpected requests stay as they were.

IMAD.SHL as a shift; EDEN_NX2_REJECT; log where rejected programs are bound

2026-10-28T18:44:18+00:00

- IMAD by a power of two lowers to SHL imm, the form Eden's jump-table tracking expects (a title 1 compute program failed "track indirect branch"). - EDEN_NX2_REJECT=: treat those native programs as rejected, to bisect a behaviour change without rebuilding. - A rejected graphics program logs its stage slot, header and slot registers once (for the task/mesh pipeline setup). - Notes: rows 87-92, title 1 status.

nx2: title 4's intro cutscene renders correctly

2026-10-28T06:57:31+00:00

Native shader capture counted CALL.REL.NOINC as a function call, so a program using it waited for a RET after its EXIT and read on into the following shaders until a garbage branch target made it fail. NOINC calls push no return address (the compiler uses them as jumps; the lowering already treats them so): count them as forward branches. That shader builds title 4's 3D colour-grading LUT once per scene; with it rejected the LUT stayed empty and the tonemap turned every frame black. The intro cutscene now renders lit and graded, with subtitles, through the bilinear stand-in for the tensor-core upscaler. Also: rejected captures dump to EDEN_NX2_SHADER_DUMP as rejected-.bin and report the offending instruction.

Switch 2: Turing macros, native compute, Ampere shader lowering, native tiling

2026-10-28T02:26:16+00:00

From changes.patch: the TU104/GA10x MME interpreter (shared macro context for the process's channels, also on the compute class), native compute with QMD 3.0 dependency scheduling, the Ampere-to-Maxwell shader lowering, native vertex stream sizes, and the console's GOB swizzle for textures, DMA copies and the host unswizzle shaders. Switch 2 channels turn all of it on at init. The lowering is widened for title 4 (all 32 of its programs lower): general TEX (any dimension/LOD/mask, operand split 1+1/2+1/2+2/4+n, any but consistent descriptor buffer), cube/array, SULD channel masks, 128-bit STG, indexed IPA, VOTE, SHFL with any immediate or predicate output, R2P/P2R byte select, uniform ULOP3/ULEA/UBREV/UFLO.SH/UISETP signed/UMOV URZ, IMNMX cbuf, IADD3 and FFMA uniform operands, FMUL /4 /8 x8, and BSSY/BSYNC/BREAK/WARPSYNC as no-ops. The capture stops at unmapped memory. EDEN_NX2_SHADER_DUMP dumps every native program; tools in C:\dev\nx2work test the lowering offline.