Optional DLSS Ray Reconstruction

August 8, 2026 · View on GitHub

English documentation: Optional DLSS Ray Reconstruction

D3D12LookDevPT には optional の Streamline / DLSS Ray Reconstruction backend があります。Streamline の dynamic load、adapter/driver 検証、render/output 解像度の分離、guide resource の生成と frame tag、renderer の D3D12 command list 内での slEvaluateFeature まで実装しています。

DLSS-RR は RTX 4070 / 1080p60 の ReSTIR GI+DI gate とは独立です。binary 不足、非対応 adapter/driver、application identity 不足、runtime evaluation failure の場合は、Streamline を process-load dependency にせず native reconstruction を使用します。

依存関係と application identity

固定 submodule:

  • ThirdParty/Streamline: NVIDIA Streamline SDK v2.12.0
  • ThirdParty/DLSS: NVIDIA DLSS SDK v310.7.0

初期化:

git submodule update --init --recursive ThirdParty/Streamline ThirdParty/DLSS

DLSS SDK は nvngx_dlss.dll と nvngx_dlssd.dll を提供します。source-only の Streamline checkout には prebuilt runtime / feature DLL がすべて含まれない場合があります。存在する file は Bin/x64/<Config>/Streamline/ へ copy します。

sl.interposer.dll
sl.common.dll
sl.dlss.dll
sl.dlss_d.dll
nvngx_dlss.dll
nvngx_dlssd.dll

production NGX component には NVIDIA が発行した application identity も必要です。10進数 ID は source control の外で管理し、起動前に設定します。

$env:D3D12LOOKDEVPT_NGX_APPLICATION_ID = "<NVIDIA 発行の10進数 ID>"

renderer は temporary ID や架空の ID を代用しません。変数がない場合は applicationIdentityConfigured=false、failure stage applicationIdentity を報告し、native reconstruction を使用します。

strict setup check は runtime DLL 不足を failure にします。

.\Scripts\CheckSetup.ps1 -CheckDLSS

Build switch と matrix

DLSS header support は default で有効です。

msbuild .\D3D12LookDevPT.sln /m /p:Configuration=Release /p:Platform=x64

dependency-free path を検証する場合は無効化します。

msbuild .\D3D12LookDevPT.sln /m /p:Configuration=Release /p:Platform=x64 /p:EnableDLSS=false

EnableDLSS=false では Streamline/DLSS include path と optional runtime copy を使わず、status は compiled=false を返し、dlss_rr は native internal reconstruction へ fallback します。

backend matrix は all-enabled、no-NRD、no-RTXDI、no-DLSS、all-disabled、repository target を含みます。

.\Scripts\BuildBackendMatrix.ps1 -Configuration Release

Frame evaluation

初期化時は次を行います。

  1. sl.interposer.dll を load し、必須 core function を解決
  2. frame-based resource tagging を有効にして D3D12 用 Streamline を initialize
  3. D3D12 device を登録
  4. NVIDIA 発行 application identity を検証
  5. 選択 adapter/driver の kFeatureDLSS_RR support を確認
  6. 推奨 render size を取得し、選択 DLSS mode を設定

eligible な各 frame で PathTracingDlss.hlsl は次を準備します。

  • HDR scaling-input color
  • 正の linear depth
  • 2D motion vector
  • packed world normal / roughness
  • diffuse albedo / specular albedo
  • 1x1 exposure resource

backend は camera matrix、jitter、reset、render/output extent、8個の resource tag を設定し、active command list 内で kFeatureDLSS_RR を evaluate します。成功すると display-resolution HDR を生成し、NRD、internal denoiser、Final TAA を迂回して tone map します。

evaluation が失敗した場合、部分出力は表示しません。同じ frame は native reconstruction し、以後の evaluation を無効化して次 frame の native resource rebuild を要求します。resize、camera cut、明示 reset は DLSS history reset へ伝播します。

解像度と runtime status

quality schema は render/output 解像度を分離します。

{
  "resolutionMode": "dynamic",
  "fixedRenderScale": 0.75,
  "minRenderScale": 0.5,
  "maxRenderScale": 1.0
}

resolutionMode は native、fixed、dynamic を受理し、旧 project は native になります。Dynamic は既存 GPU budget と settle hysteresis を使い、1/16 刻みで調整します。非 DLSS 経路で render/output size が異なる場合は TAAU を使い、NRD は render 解像度で動作します。

Denoise panel または MCP から選択できます。

{
  "method": "set_denoise",
  "params": {
    "backend": "dlss_rr",
    "dlssMode": "quality",
    "resetDlss": true
  }
}

lookdevpt.get_state / lookdevpt.get_stats の denoise.dlss / denoiser.dlss は compile/load/init/device/application-identity/support/evaluation 状態、推奨・active 解像度、成功/失敗回数、last result code/failure stage、runtime path、error、fallback reason を公開します。benchmark にも同じ activation/failure evidence を出力します。

この checkout の local 環境には NVIDIA 発行 NGX application ID がないため、DLSS-RR active evaluation の認証は未完了です。identity 不足時の fallback は確認済みですが、feature-active 検証には発行済み ID、対応 GPU/driver、production runtime DLL が必要です。