ci: pin standalone ARM64 WARP for offscreen shader tests

Author: Fryingpan-Jason

.github/workflows/build.yml

@@ -30,6 +30,18 @@ jobs:
       - name: Build application
         shell: pwsh
         run: .\build.ps1 -Architecture '${{ matrix.arch }}' -OutputDirectory 'out\${{ matrix.arch }}'
+      - name: Pin ARM64 offscreen test rasterizer
+        if: matrix.arch == 'arm64'
+        shell: pwsh
+        run: |
+          $version = '1.0.20'
+          New-Item -ItemType Directory -Force out/test-warp | Out-Null
+          Invoke-WebRequest "https://api.nuget.org/v3-flatcontainer/microsoft.direct3d.warp/$version/microsoft.direct3d.warp.$version.nupkg" -OutFile out/test-warp/package.zip
+          Expand-Archive out/test-warp/package.zip out/test-warp/package
+          $dll = Get-ChildItem out/test-warp/package -Recurse -Filter d3d10warp.dll | Where-Object { $_.Directory.Name -eq 'arm64' }
+          if (@($dll).Count -ne 1) { throw 'Expected one ARM64 test WARP binary.' }
+          "FLOATNOTE_TEST_WARP=$($dll.FullName)" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
+          $dll.VersionInfo | Select-Object FileName,FileVersion
       - name: Run native and glass regression
         shell: pwsh
         run: |

docs/DEVELOPMENT.md

@@ -65,3 +65,5 @@ Package staging uses a fixed file allowlist: EXE, bilingual README, quick start,
 - Apply transparency only to the background; text must remain legible.
 - Treat glass as optional. Editing must work when composition, transparency effects, or the backdrop API is unavailable.
 - Avoid polling and animation loops while the note is idle.
+
+ARM64 CI pins Microsoft.Direct3D.WARP 1.0.20 for offscreen HLSL tests because the runner's system WARP crashes during this fixture. FLOATNOTE_TEST_WARP selects that test-only DLL. Application builds and release archives continue to use Windows system components only; the pinned test DLL is never packaged.

tests/glass_adaptation.cpp

@@ -19,6 +19,8 @@ struct GlassAdaptationTest {
     static void Check(HRESULT hr) {if(FAILED(hr))throw std::runtime_error("D3D operation failed");}
     ~GlassAdaptationTest(){g.Close();}
     static LONG WINAPI Crash(EXCEPTION_POINTERS* error) {
+        static volatile LONG reports=0;
+        if(InterlockedIncrement(&reports)>4)return EXCEPTION_CONTINUE_SEARCH;
         if(error->ExceptionRecord->ExceptionCode!=EXCEPTION_ACCESS_VIOLATION && error->ExceptionRecord->ExceptionCode!=EXCEPTION_ILLEGAL_INSTRUCTION && error->ExceptionRecord->ExceptionCode!=EXCEPTION_STACK_OVERFLOW)return EXCEPTION_CONTINUE_SEARCH;
         MEMORY_BASIC_INFORMATION region{};
         char module[MAX_PATH]{};
@@ -36,6 +38,15 @@ struct GlassAdaptationTest {
         (void)handler;
         Trace("compile shaders");
         Check(GlassLabBackdrop::WarmShaderBytecode());
+        // CI can pin Microsoft's standalone WARP for offscreen shader tests.
+        // The production renderer never loads this test-only dependency.
+        wchar_t warpPath[MAX_PATH]{};
+        const DWORD pathLength=GetEnvironmentVariableW(L"FLOATNOTE_TEST_WARP",warpPath,MAX_PATH);
+        if(pathLength) {
+            if(pathLength>=MAX_PATH || !LoadLibraryExW(warpPath,nullptr,LOAD_WITH_ALTERED_SEARCH_PATH))
+                throw std::runtime_error("Could not load pinned test WARP");
+            std::fwprintf(stderr,L"Test WARP: %ls\n",warpPath);
+        }
         Trace("create device");
         Check(D3D11CreateDevice(nullptr,hardware?D3D_DRIVER_TYPE_HARDWARE:D3D_DRIVER_TYPE_WARP,nullptr,0,nullptr,0,D3D11_SDK_VERSION,&g.device,nullptr,&g.context));
         Trace("create shaders");