feat(host): HDR Vulkan layer so Vulkan games get HDR on the virtual display

NVIDIA/AMD Vulkan ICDs refuse to *advertise* an HDR color space for a surface on an IddCx indirect/virtual display, so Vulkan games (Doom: The Dark Ages, id Tech, Indiana Jones, …) report "device does not support HDR" — even though Windows HDR, DWM compose, and the client PQ stream all work, and the ICD happily *accepts + presents* a forced HDR swapchain there. The whole gap is enumeration; the community (Apollo/Sunshine/VDD) wrote this off as kernel-side / unfixable. Add VK_LAYER_PUNKTFUNK_hdr_inject (packaging/windows/pf-vkhdr-layer/): a standalone cdylib Vulkan implicit layer that appends {A2B10G10R10, HDR10_ST2084} + {RGBA16F, scRGB} to vkGetPhysicalDeviceSurfaceFormats[2]KHR (no need to hook vkCreateSwapchainKHR — the ICD doesn't validate the color space there). Self-gated on the surface monitor's actual advanced-color state (DisplayConfig GET_ADVANCED_COLOR_INFO), so it is a complete no-op on SDR sessions and real monitors (dedup). Always-on (registry-discovered) so it works regardless of how a game is launched — env-scoping silently fails for already-running Steam. Escape hatches: DISABLE_PF_VKHDR, PF_VKHDR_EXCLUDE, and a built-in kernel-anti- cheat denylist. The installer builds/signs/stages it and registers it under HKLM64\SOFTWARE\Khronos\Vulkan\ImplicitLayers (opt-out "Install the HDR Vulkan layer" task); windows-host CI fmt+clippy-gates it (msvc-only FFI). Live-validated on the RTX box: Doom: The Dark Ages enables HDR over the pf-vdisplay virtual display. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 11:33:20 +00:00
parent 3e7c9bd059
commit d01a8fd17a
31 changed files with 1021 additions and 0 deletions
@@ -211,6 +211,38 @@ if ($WebDir -and (Test-Path $WebDir) -and $BunExe -and (Test-Path $BunExe)) {
 }
 else { Write-Host "no -WebDir/-BunExe -> installer built WITHOUT the web console" }

+# --- build + stage the HDR Vulkan layer (pf-vkhdr-layer) --------------------------------------
+# A tiny always-on Vulkan implicit layer (cdylib) that advertises HDR10/scRGB surface formats on the
+# virtual display so Vulkan games (Doom: The Dark Ages, etc.) can enable HDR while streaming — the
+# NVIDIA/AMD ICDs hide HDR formats on an indirect display even though they accept+present a forced HDR
+# swapchain there. Self-gated on the display's actual advanced-color state, so it's a no-op on SDR.
+# Standalone crate (own [workspace]); built here and registered by the installer. Skipped if cargo
+# is unavailable or the build fails -> installer is produced WITHOUT the layer (non-fatal).
+$layerSrc = Join-Path $here 'pf-vkhdr-layer'
+if (Test-Path (Join-Path $layerSrc 'Cargo.toml')) {
+    $layerTarget = Join-Path $OutDir 'vklayer-target'
+    Write-Host "==> building pf-vkhdr-layer (cdylib)"
+    $prevTarget = $env:CARGO_TARGET_DIR
+    $env:CARGO_TARGET_DIR = $layerTarget
+    Push-Location $layerSrc
+    & cargo build --release
+    $layerExit = $LASTEXITCODE
+    Pop-Location
+    if ($prevTarget) { $env:CARGO_TARGET_DIR = $prevTarget } else { Remove-Item Env:\CARGO_TARGET_DIR -ErrorAction SilentlyContinue }
+    $layerDll = Join-Path $layerTarget 'release\pf_vkhdr_layer.dll'
+    if ($layerExit -eq 0 -and (Test-Path $layerDll)) {
+        $layerStage = Join-Path $OutDir 'vklayer'
+        New-Item -ItemType Directory -Force -Path $layerStage | Out-Null
+        Copy-Item $layerDll (Join-Path $layerStage 'pf_vkhdr_layer.dll') -Force
+        Copy-Item (Join-Path $layerSrc 'pf_vkhdr_layer.json') (Join-Path $layerStage 'pf_vkhdr_layer.json') -Force
+        Sign-File (Join-Path $layerStage 'pf_vkhdr_layer.dll')
+        $defines += "/DVkLayerDir=$layerStage"
+        Write-Host "==> staged pf-vkhdr-layer -> $layerStage"
+    }
+    else { Write-Warning "pf-vkhdr-layer build failed ($layerExit) — installer built WITHOUT the HDR Vulkan layer" }
+}
+else { Write-Host "no pf-vkhdr-layer crate -> installer built WITHOUT the HDR Vulkan layer" }
+
 # --- build the installer (from the non-redirected copy under C:\t) -----------------------------
 Write-Host "==> ISCC $($defines -join ' ') $issLocal"
 & $iscc @defines $issLocal