mstlvc/Radiance

选用指南

AI 根据 README 整理 · 2026/10/30 02:22:21

使用方式

通过图形界面操作，也提供命令行参数用于生成诊断报告、测试 Discord 等。

查看 README 依据

## Requirements - Windows 10 or 11, x64 - .NET 8 (or use the self-contained publish below) - An NVIDIA GPU for digital vibrance; the rest works on any GPU ## Build ```bash dotnet build Radiance.slnx -c Release ``` ### Self-contained single file ```bash dotnet publish src/Radiance/Radiance.csproj -c Release -r win-x64 --self-contained true \ -p:PublishSingleFile=true -p:EnableCompressionInSingleFile=false -p:DebugType=none ``` ## Command line ``` Radiance.exe --report write a diagnostics zip to the Desktop and exit Radiance.exe --shared list shared presets

Radiance.exe --screenshot save a colour-baked screenshot and exit Radiance.exe --discord test the Discord pipe and print the result Radiance.exe --gpu report NVIDIA availability, display count and current vibrance Radiance.exe --monitors list physical monitors, DDC/CI support and HDR state Radiance.exe --audio print the current master volume ``` ## Configuration Everything is local, in `%APPDATA%\Radiance\`: - `settings.json` – colour state, theme, hotkeys, crosshair, customizations - `profiles.json` – saved looks - `games.json` – game-to-profile bindings

部署要求

需要 Windows 10 或 11 x64，.NET 8（或使用自包含发布版），数字振动功能需要 NVIDIA GPU，其他功能支持任意 GPU。

查看 README 依据

## Requirements - Windows 10 or 11, x64 - .NET 8 (or use the self-contained publish below) - An NVIDIA GPU for digital vibrance; the rest works on any GPU ## Build ```bash dotnet build Radiance.slnx -c Release ``` ### Self-contained single file ```bash dotnet publish src/Radiance/Radiance.csproj -c Release -r win-x64 --self-contained true \ -p:PublishSingleFile=true -p:EnableCompressionInSingleFile=false -p:DebugType=none ``` ## Command line ``` Radiance.exe --report write a diagnostics zip to the Desktop and exit Radiance.exe --shared list shared presets

已知限制

数字振动仅适用于 NVIDIA GPU；某些 HDR 显示器可能忽略 gamma 设置；D3D11 覆盖层有崩溃导致屏幕颜色偏移的风险，但提供了安全防护。

查看 README 依据

OnboardingForm.cs first-run welcome Pages/ one file per screen ``` ## Notes on the colour pipeline Digital vibrance is written per display with `SetDVCLevelEx`; 50 is the driver default and 100 is maximum, so saturation scales the driver value (saturation 150 at vibrance 60 writes 90). The tone controls build a 256-entry ramp and push it with `SetDeviceGammaRamp`, which some HDR displays ignore. ## Safety around the per-pixel overlay The D3D11 overlay replaces what you see, so a crash while it is running could leave the screen colour-shifted. Three guards exist:

- a marker file is written while it runs; an unclean exit disables it on next start - a test hook (`RADIANCE_SHADER_TEST=1`) is capped at 120 seconds - the tray menu has **Turn off per-pixel colour** ## Licence MIT – see [LICENSE](LICENSE). `libs/NvAPIWrapper.dll` is the [NvAPIWrapper](https://github.com/falahati/NvAPIWrapper) managed wrapper for NVIDIA's NVAPI (MIT).