You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 4f0f48c
Browse filesBrowse the repository at this point in the historyBrowse files
Upscalers record the vendor runtimes they were built against; beta.2 notes
build-native.ps1 writes upscaler-runtimes.json beside each Upscalers payload: each upscaler SDK at
NRI's pin (FidelityFX 2.4.0, XeSS 3.0.2, NIS 1.0.3, NGX 310.9.16 at v191) and each runtime NRI's
build fetched, by file version and SHA-256. The package carries it as
runtimes/<rid>/upscaler-runtimes.json, release.yml lists it under the notes' NRI line
(tools/ci/upscaler-runtimes.ps1), and the pack step requires it and the XML docs.
NativePayloadTests holds the manifest to the pins and to GetRuntimeFiles.
The beta.2 notes cover everything since beta.1.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01NvXTk6Roe4sQLHFx9Zykv8
$body = @($notes[0]) + $runtimes + $notes[1..($notes.Count - 1)] + @("", "The macOS (osx-arm64) library is not in the packages: it is attached here as a zip once a macOS runner has built it.")
Copy file name to clipboardExpand all lines: docs/releases/v1.0.0-beta.2.md
+19-2Lines changed: 19 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,13 +3,30 @@
3
3
## Changes
4
4
5
5
### Added
6
-
- Published on NuGet.org: `dotnet add package SharpNRI --prerelease`. The packages carry a readme.
6
+
- Published on NuGet.org: `dotnet add package SharpNRI --prerelease`. The packages carry a readme and XML documentation (IntelliSense).
7
+
-`SharpNRI.Native.Upscalers` records the vendor runtimes it was built against (listed above) in `runtimes/<rid>/upscaler-runtimes.json`, with each file's version and SHA-256: the versions an application ships beside it.
8
+
- A failed vendor upscaler call reports why through the message callback, in release builds too: a missing or incomplete FSR loader, `ffxCreateContext`, the XeSS calls, NGX initialization and feature creation, and a failed dispatch (`ffxDispatch`, `xessD3D12Execute`, NGX evaluation), which used to leave the output unchanged without a word.
9
+
- Zero allocation covers every per-frame call of the binding, not only a representative frame: every command and overload, submission, queue, fence, query and descriptor call, the static helpers, and every extension's per-frame calls (guide: Zero allocation). A test fails for any public call added later until it is measured.
7
10
8
11
### Fixed
12
+
- Vulkan applications presenting while RivaTuner Statistics Server runs (the overlay of MSI Afterburner, CapFrameX and HWiNFO) ended at the first present with 0xC0000409. NRI now lists physical devices with `vkEnumeratePhysicalDevices`, as the layer expects, without the extra call beta.1 made after device creation.
13
+
- D3D12 micromaps: the debug layer refused every micromap creation (`[1162] ... InputBuffer and PerOmmDescs can't be null`); the size query now passes the dummy addresses the DXR specification asks for.
14
+
- Vulkan AV1 encode: session parameters from a sequence without a colour description were refused (`VK_ERROR_INVALID_VIDEO_STD_PARAMETERS_KHR`); the colours are now passed as "unspecified", as AV1 defines them.
15
+
-`CreateStreamer` with the default (zero) constant buffer size was refused by NRI validation for its constant buffer location, which is not used then.
16
+
- Lavapipe on Windows: every pipeline without a logic op crashed the driver; NRI now passes a valid value for the disabled logic op (a driver workaround, harmless everywhere).
9
17
-`WriteShaderGroupIdentifiers` with a group range past the pipeline's groups ended the process on D3D12 and Vulkan, also with NRI validation on; validation now refuses the range with `INVALID_ARGUMENT`.
10
18
- Vulkan pipeline-statistics query pools on a device with mesh shaders but without mesh-shader queries drew a validation error at creation and reported a query size two counters too large.
11
19
-`ENABLE_DRAW_PARAMETERS_EMULATION` on Vulkan: indirect draws with the plain `DrawDesc` / `DrawIndexedDesc` records were refused. The flag is D3D12 and Metal only and now has no effect on Vulkan, so it can be set on every backend.
20
+
-`NriAccelerationStructure.Buffer` and `NriMicromap.Buffer` made a new wrapper on every read (a barrier per frame allocated); the wrapper is now made once per object.
21
+
- Command-buffer, queue and thread annotations allocated native memory for their name on every call; names up to 255 UTF-8 bytes are now encoded on the stack.
12
22
- Documentation: `SwapChainBits.LATEST_READY` with `VSYNC` does not cap rendering at the refresh rate; the display shows the newest ready image at each vblank.
13
23
24
+
### Notes
25
+
- NVIDIA's Vulkan driver (617.14 and 621.14 measured) fails an AV1 encode into a bitstream buffer without `HOST_VISIBLE` memory, silently: put the AV1 bitstream in `HOST_READBACK` memory there (guide: Video).
26
+
27
+
## Breaking changes
28
+
-`NriDeviceOptions.VkEnumeratePhysicalDevicesAfterCreation` is gone: NRI enumerates physical devices itself, so the option has nothing left to do. Remove it from device options.
29
+
-`NriApi.HAS_BUFFER` is `static readonly`; it could be assigned, process-wide. Use `NriBuffer.HasBuffer`.
30
+
-`NriCopyImguiDataDesc`, `NriStreamBufferDataDesc` and `NriStreamTextureDataDesc` are `readonly ref struct`s; their properties were already init-only.
31
+
14
32
## Verified
15
-
NVIDIA GeForce RTX 4070 SUPER (Vulkan, D3D12) at c213de0 ([coverage](https://github.com/Nullpoint56/SharpNRI/blob/v1.0.0-beta.2/docs/coverage.md)); Microsoft Basic Render Driver (WARP, D3D12) and Mesa llvmpipe (lavapipe, Vulkan) at 42797cb, whose library code c213de0 changes only in a documentation comment.
$nisVersion=if ((Get-Content (Join-Path$nri"Shaders""NIS.hlsl") -Raw) -match'NVIDIA Image Scaling SDK\s+-\s+v([\d.]+)') { $Matches[1] } else { throw"the NIS SDK version was not found in nri/Shaders/NIS.hlsl" }
455
+
$sdks.Add([ordered]@{ name="NVIDIA Image Scaling"; version=$nisVersion; runtimes=@(); note="compiled into NRI; no runtime" })
456
+
}
457
+
if (&$on NRI_ENABLE_FFX_SDK) {
458
+
$sdks.Add([ordered]@{ name="AMD FidelityFX SDK"; version= (PinOf 'FidelityFX-SDK/archive/refs/tags/v([\d.]+)\.zip'"FidelityFX SDK"); runtimes= [object[]](RuntimesOf '^amd_fidelityfx_(loader|upscaler)_(dx12|vk)\.dll$'); note="loaded by name at upscaler creation" })
0 commit comments