Repository navigation
MetalSharp Wine 8.0 adds two switches for other graphics drivers, Mesa's Zink for OpenGL and KosmicKrisp for Vulkan, ships MetalVR in both apps, and moves to Mullion alpha 4, WineMetalGL 4.0.0, VKD3D-Proton-MacOS 6.0 and DXVK-MacOS 3.1.1-macos.4. Windowed mode's desktop can be moved, the function keys can act as Windows', and Assetto Corsa with Custom Shaders Patch runs on the x86_64 build.
Graphics drivers
SharpGL_Switch=1: OpenGL through Zink. Mesa's Zink (OpenGL on Vulkan) in WineMetalGL's place:opengl32.dllandlibgallium_wgl.dllcome fromlib/zink(Wine 0175, 0180, 0181, x86_64 0072, 0076). 64-bit and 32-bit programs both get it. It runs on MoltenVK, or on KosmicKrisp with the switch below. Built from Mesa main3c253c7f.SharpVK_Switch=1: Vulkan through KosmicKrisp. Mesa's Vulkan driver on Metal in MoltenVK's place. On the arm64 build Wine points the Vulkan loader at it (Wine 0180); the x86_64 build carries the Khronos Vulkan loader for it, whichwin32uopens in MoltenVK's place (x86_64 0074). KosmicKrisp needs macOS 26 or later.- Both are off unless set to
1, and change nothing in a prefix: turning a switch off goes back to WineMetalGL and MoltenVK at the program's next start.
Direct3D (Mullion alpha 4)
Mullion is aaf2tbz/mullion metalsharp-2.1-main at f62d816: alpha 4 (dttdrv/mullion#297, Mullion's PRs merged in order) on top of 7.0's Mullion, with nothing of 7.0's left out.
- Performance improvements:
- Loading: the shader cache's lookups no longer wait on each other and its writes are queued; a pipeline whose shaders are stored is made without parsing them; root signatures and a library's bitcode are hashed once; helper functions are linked from their bitcode in place, lazily.
- Ray tracing: a ray tracing shader is converted once and kept in the shader cache, its pipeline is compiled when the state object is created, its dispatchers are made as Metal IR instead of compiled from source, and builds of acceleration structures recorded in a row share their passes.
- Pipelines off the draw path: tessellation pipelines compile beside each other, tessellation and mesh pipelines leave Metal's compile to the compile threads, a geometry pipeline's strip variants are made at the first draw that needs them, and a MetalFX scaler is made without waiting for its pipelines.
- Per frame: a command allocator keeps the memory it recorded into across
Reset, samplers, clear and resolve pipelines are made once per device, textures find their views under a shared lock, a Metal 4 command buffer takes over the residency set of one that is done, and work an application reads only timing from is left out by default. - Correctness: DXIL comparison samples, float to integer conversions,
IsInf/IsFinite/IsNormaland NaN handling give Direct3D's results; ExecuteIndirect, bundles, root constants, buffer views and descriptor copies follow D3D12.
- Tessellation through Metal's tessellator on Metal 3, and in compute on Metal 4 (#173).
- Faster loads: pipelines keep one copy of each shader between them (#281), a pipeline the archive holds is made at its first draw (#288), the pipeline archive keeps one converter version's files (#282) and adds pipelines on its own thread, one at a time (#257), and a shader's parse keeps no copy of its bytecode (#279).
- Faster frames: signed
dot4addat almost twice the rate (#283), pixel shaders specialized for bound reduction samplers (#292), a pass after barriers for pixel shading alone starts its vertices early (#275), and an ExecuteIndirect resolver no longer ends its command list's pass (#276). - Correctness: an anisotropic sample with a bias takes the gradients only past the anisotropy's limit (#291), AIR that Apple's verifier accepts on Metal 4 (#295), depth bias, root signature ranges, geometry shader input topology, mesh pipeline stages, render pass bindings, binary occlusion resolves, indirect offsets, depth output without a depth buffer, D3D11 resolves, sRGB unordered access textures and constant buffer ranges (#227-#271), and a statistics heap that is not zeroed twice (#274).
- NVAPI reports driver 999.99 for a GPU that is not NVIDIA's again (#290).
- SteamVR games show in a headset (aaf2tbz/mullion#3): with
MULLION_METALVRset, which MetalVR's setup does for the Steam prefix, Mullion shares Direct3D 11 buffers and Direct3D 12 textures between processes, so SteamVR's compositor finds a game's current eye image. Without the variable nothing changes. - Custom Shaders Patch: the D3D11 context's
ResolveSubresourcecan be detoured (aaf2tbz/mullion#2). - MetalFX:
metalfx.jitteredMotionVectorsreads a game's motion vectors as jittered. - Its NGX cores (DLSS on MetalFX) are signed by the fork's CI.
Direct3D (VKD3D-Proton-MacOS 6.0, DXVK-MacOS 3.1.1-macos.4)
- VKD3D-Proton-MacOS 5.4 → 6.0, mostly speed:
- Pipelines compile without blocking, and shaders converted by Metal Shader Converter are kept on disk.
- Tessellation of DXIL shaders runs in Metal Shader Converter's emulation.
- ExecuteIndirect keeps converted pipelines with root arguments, runs only the counted draws and dispatches, and no longer ends a render pass.
- A fence wait waits on the timeline semaphore's Metal shared event directly.
- SyncInterval 2 to 4 holds frames.
- DLSS Super Resolution passes its bias mask, jittered motion vectors and subrect bases to MetalFX.
- DXVK's
ResolveSubresourcecan be detoured, for Custom Shaders Patch.
- DXVK-MacOS 3.1.1-macos.4: the DXVK lane on the MoltenVK of VKD3D-Proton-MacOS 6.0, so both lanes share one MoltenVK.
OpenGL (WineMetalGL 4.0.0)
- Foundry Mari's viewport compiles: sampler arrays indexed by a variable before GLSL 4.00, and locals named after Metal functions (
dfdx). - Per-game settings:
winemetalgl.confbeside a game's.exeholds its ownWINEMETALGL_*settings, asdxvk.confdoes for DXVK. - Frame rate limits of 100 and 120 fps and any custom value, in WineMetalGL Settings.
- SteamVR finds OpenGL:
opengl32.dllhas the version resource SteamVR checks for.
VR (MetalVR 0.2.1)
- MetalVR ships in both apps (
lib/metalvr,bin/metalvrd): an OpenXR runtime for VR games on Mullion, and the server that composes their frames and streams them to a headset. It supports the Oculus Rift CV1 and Rift S, Meta Quest 1, 2, 3, 3S and Pro, Valve Steam Frame and Index, HTC Vive, Vive Pro and Vive Pro 2, and PlayStation VR2, with a guide for each (docs/headsets). The Rift CV1 /PSVR2 are the only ones tested on real hardware. - 0.2.1 fixes a crash that ended
metalvrdas soon as it found a PlayStation VR2. - Steam no longer stops responding when SteamVR starts. gdi32 exports
D3DKMTGetProcessSchedulingPriorityClassandD3DKMTSetProcessSchedulingPriorityClass; without them the 32-bitsteamservice.execrashed raising SteamVR's compositor's GPU priority, and Steam waited up to three minutes for it (Wine 0179, x86_64 0075).
Windows and input
- Windowed mode's desktop moves (metalsharp/MetalSharp#805). A Wine virtual desktop is a titled frame the desktop's size, and the program's windows move with it; a fullscreen-only game in Windowed mode was a box fixed to the screen's top-left.
WINEMAC_DESKTOP_FRAME=0keeps the old behavior (Wine 0177, x86_64 0073). - Windows function keys (metalsharp/MetalSharp#802).
WINEMAC_FKEYS=windowshas the top row send F1-F12 while the program is the active app, with the brightness, media and volume keys on fn as on a Windows keyboard. The keyboard's own setting is put back when the program stops being active and when it exits (Wine 0177, x86_64 0073). - Dialogs over fullscreen (x86_64): a window a program opens while its fullscreen window is on screen shows in front of it (x86_64 0068).
Launchers and games
- Programs a launcher starts are set up as the game is (Wine 0172, x86_64 0071). A launcher's game in another folder than the launcher (No Hesi Launcher's
acs.exe, Minecraft'sjavaw.exe) is shown the display divided by the MetalFX factor, gets DLSS and the GPU it should see, instead of rendering at the display's size. A Sharp Library launcher's own window is not scaled, and Steam and WebView2 are left as they are. - Battle.net loads again (#50): it gets
--in-process-gpualone, as before 7.0 (Wine 0174). - x86_64 programs that ship their own x64 C runtime no longer crash in Wine's DLLs (arm64, #57: EXOCAD's .NET WinForms in
ImageList_Duplicate). The compiler gave ARM64EC calls tomemcpy,memmoveandmemsetit makes itself no exit thunk, so such a call that reached x64 code ran the module's first byte; 542 of 7.0's ARM64X modules had them. Wine's modules now have them (Wine 0176).
Assetto Corsa with Custom Shaders Patch (x86_64)
Assetto Corsa with CSP runs and joins servers (Wine 11 regressions from Wine 10):
- CSP initializes: dbghelp's PDB reader returns public symbols again and names folded functions by their own name (x86_64 0065).
- Assetto Corsa starts: d3dx11 creates shader resource views from files, memory and resources, and saves textures to memory and files (0064).
- Shaders: vkd3d-shader reads SM4
call,callcand label registers,D3DReflectkeeps a shader's resources when it can't scan its code (0066), andD3DCompile's standard includes are found with either path separator (0069). - Online: winevulkan gives DXVK-MacOS failing functions for Win32 handles of extensions MoltenVK lacks, instead of NULL (0067).
- D3DMetal: WFDXCompat's D3D11 frontend loads in front of D3DMetal's
d3d11(0070) and refuses block-compressed render targets as the D3D11 runtime does, which fixes black squares in CSP's track textures, and shares resources within the process (WFDXCompat32e5e73).
32-bit programs (arm64)
- Clocks and
cpuidwork again (#32) when a program keeps the data it writes on a page with its code:- A system call writing to such a page now writes it, where it failed with an access violation, so
QueryPerformanceCounter,GetSystemTimeAsFileTime,GetSystemTime,GetLocalTimeandtime()returned 0 (Wine 0173). - A fault on
movto or from an absolute address resumes at the right instruction, socpuidno longer runs again with EAX overwritten (FEX 0036).
- A system call writing to such a page now writes it, where it failed with an access violation, so
Downloads
MetalSharp-Wine-8.0-arm64.zip: the Developer ID signed and notarizedMetalSharp-Wine.app. Use this one for the arm64 build: i386 and 4K pages need it.metalsharp-wine-8.0-arm64.tar.xz: the same Wine as a relocatable folder (bin/wine). It's ad-hoc signed, so x86_64 and ARM64 programs only, with 16K pages.MetalSharp-Wine-8.0-x86_64.zip: the Developer ID signed and notarizedMetalSharp-Wine-x86_64.app, the x86_64 build (Wine 11.17 under Rosetta 2).SHA256SUMS: checksums of all three.
Contributors
- @aaf2tbz: MetalSharp Wine.
- @dttdrv (Mullion): Mullion alpha 4, and @cyyever for its D3D11 reduction-sampler specialization, ReaderIO ownership fix and ICB test.
- @multision: Mullion's patchable
ResolveSubresourcefor Custom Shaders Patch. - Mesa: Zink and KosmicKrisp.
- Wine Mono: the .NET runtime both builds carry.
- @Alien4042x (WineForge): the x86_64 build's Wine. (With Proton / MetalSharp Specific Patches)
Sources: MetalSharp Wine main (tag v8.0) pins:
source/wine07dcccb (Wine 11.20, patches 0001–0181)source/fex4589993 (patches 0001–0036)source/wine-x86_64ff042ef (patches 0001–0076)source/linuxhostb1ceb88- Mullion f62d816a
- VKD3D-Proton-MacOS v6.0 (2178b90)
- DXVK-MacOS v3.1.1-macos.4 (e847475)
- WineMetalGL 4.0.0 (
source/winemetalgl44eeb30) - WFDXCompat 32e5e73
- MetalVR 0.2.1 (2745afd)
- Mesa 3c253c7f (Zink, KosmicKrisp) with MetalSharp's patch 0001
- Wine Mono 11.3.99 (c019b64ba8)