seedds
f8642c480f
Below MSL 3.1, SPIRV-Cross emulates an image atomic with a raw device pointer beside the texture, laid out like a linear image. A block-linear image's Metal texture is a deswizzled copy, so its atomics went to a scratch buffer nothing read (Pokemon Legends: Z-A's atomic max into texture 302), and a 3D image's pointer was indexed with the int3 coordinate itself, which does not compile (16 shaders of Octopath Traveler 0, 5 of Ghost Trick, 8 of FINAL FANTASY RESONANCE). - dmsh_atomic.py: shaders with image atomics (OpImageTexelPointer) are written at MSL 3.1, so the atomics run on the image's own texture; every other shader keeps its MSL 2.3 source byte for byte. MSL that still holds the pointer form fails the build. - Translator (TranslationFlags.MetalImageAtomics, renamed from Msl23ImageAtomics): admits 3D images and SUATOM.CAS (Metal's texture compare-exchange); the IGN coordinate guard is unchanged. - Host: the IMGA pointer binding, the scratch buffer and the layout admission are gone. NVN images of R32Uint / R32Sint take MTLTextureUsageShaderAtomic (img_usage, kept by tex_upgrade: Metal leaves that bit out of the usage property); any other texture in an atomic slot is replaced by an atomic-capable write sink with a red line. - Chain a4e2088c2e69 (with main's vertex-output padding). Tested on chain 0ce4b5e8aefb, this change before that rebase: Octopath Traveler 0 builds all 10,324 shaders, Z-A all 28,603, Ghost Trick's five 3D-atomic shaders build. Mac runs of both games under the Metal API validation layer showed no validation error (Octopath Traveler 0 to frame 14,400, its particle atomics on buffer texture 2049; Z-A to frame 12,000 through the atomic max on texture 302). Synthetic atomics and CAS run on buffer, 2D, 2D-array and 3D textures of a Mac GPU (test_image_atomic_bounds.py, t_atomic_return.m). GitHub issue #290: at40b643bOctopath Traveler 0 already built 10,308 of 10,324 shaders (2e655b7fixed the returning atomics); the 16 left were the 3D ones, which build now. Not checked: an iPhone, FINAL FANTASY RESONANCE's library, the picture of Z-A's atomic scene.
dm/third_party: third-party code
This is code written by others, shipped with the repository so there is nothing to download. Each component keeps its original license, and the license file sits in its own directory.
| Directory | What it is | Version and changes | Where it is used | License file |
|---|---|---|---|---|
flip/ |
NVIDIA FLIP, an image difference metric that models human viewing. FLIP.h plus the source of the command-line tool in tool/ |
Not recorded in the directory | Verification: the image quality measurements in dm/verify/gfxq/; build flip first with make -C dm/third_party/flip |
flip/LICENSE (BSD 3-Clause) |
libvpx/ |
The VP9 decoder from libvpx: the 71 source files a VP9-decoder-only build compiles, their headers, and the generated configuration in config/ |
v1.17.0 (upstream commit 6df3ec3), unmodified |
Host: decodes the games' VP9 movies (dm/host/hle_movie.c). dm/host/Makefile builds it into gen/vpx/libvpx.a; the iOS build compiles the same files |
libvpx/LICENSE (BSD 3-Clause), with the patent grant in libvpx/PATENTS |
stb_vorbis/ |
Ogg Vorbis decoder, a single file stb_vorbis.c |
1.22 (upstream commit 1ee679c), unmodified |
Host: decodes the Vorbis sound tracks of the games' WebM movies (dm/host/hle_movie.c, which includes the file with its push-data API only) |
stb_vorbis/LICENSE (MIT or public domain, your choice; the same text ends stb_vorbis.c) |
ryujinx/ |
The shader translation library from Ryujinx, three projects: Ryujinx.Graphics.Shader, Ryujinx.Common, Spv.Generator |
Ryujinx 1.3.2, with the local changes listed in ryujinx/README.md |
Referenced by the shader translation tool dm/gfx/tools/dmsh_xlate, which translates the original Switch shaders to SPIR-V |
ryujinx/LICENSE.txt (MIT); ryujinx/src/Spv.Generator/LICENSE is that subproject's own license text |
vulkan-headers/ |
The Vulkan C headers: vulkan_core.h, vk_platform.h, vulkan_vi.h and the vk_video/ headers they include |
Vulkan-Headers 1.4.363, unmodified | Host: the Vulkan layer on Metal (dm/gfx/vk/hle_vk.m) that runs Hades |
vulkan-headers/LICENSE.md (Apache-2.0 or MIT, your choice) |
A few more notes:
flip/tool/also carries three single-header libraries used by the FLIP command-line tool:stb_image.h(2.23),stb_image_write.h(1.13) andtinyexr.h. Their license notices are in the files themselves.libvpx/README.md,stb_vorbis/README.md,ryujinx/README.mdandvulkan-headers/README.mdrecord where each came from and what it is used for.- Four pieces of third-party code live outside this directory:
dm/gfx/nvn/include/nvn.h(MIT, author named in the file header), the layout size algorithm indm/gfx/nvn/nvn_tex.c, ported from deko3d (zlib license), and two adapted from MacNativeGames (MIT, license text inmacnativegames/LICENSE): indm/gfx/nvn/nvn_mtl.mthe GPU widening of 8-bit indices (wide_*) and the in-pass clear triangles (clear_color_tri/clear_ds_tri), from itswiden_u8_gpuandclear_quad/clear_ds_quad, and the Tears of the Kingdom visibility-counter lowering indm/gfx/tools/dmsh_xlate/Program.cs(VertexCounterLowering).