跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

swapchain-resource-analysis

RenoDX DevKit workflow for tracing swapchain/output passes, SwapChainPass, RGBA8U/UNORM limits, RGBA16F proxy resources, gamma-space float pipelines, HDR10-preferred SDR/HDR output toggles, rare scRGB output encoding, render resources, backbuffer formats, resource upgrades, neutral HDR source preservation, UI/HUD separation, and rejecting inverse-tonemap postprocess approaches. Use when investigating swapchain output, resource formats, final backbuffer shaders, swapchain proxies, AutoHDR/RTX HDR/ReShade FX style inverse tonemap ideas, resource upgrades, or proving where scene HDR data exists before shader-side ToneMapPass work.

clshortfuse · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add clshortfuse/renodx --skill swapchain-resource-analysis

技能说明


name: swapchain-resource-analysis description: "RenoDX DevKit workflow for tracing swapchain/output passes, SwapChainPass, RGBA8U/UNORM limits, RGBA16F proxy resources, gamma-space float pipelines, HDR10-preferred SDR/HDR output toggles, rare scRGB output encoding, render resources, backbuffer formats, resource upgrades, neutral HDR source preservation, UI/HUD separation, and rejecting inverse-tonemap postprocess approaches. Use when investigating swapchain output, resource formats, final backbuffer shaders, swapchain proxies, AutoHDR/RTX HDR/ReShade FX style inverse tonemap ideas, resource upgrades, or proving where scene HDR data exists before shader-side ToneMapPass work." argument-hint: "game/frame target, graphics API, suspected final pass/resource, and whether the issue is HDR source proof, proxy/resource upgrade, or inverse-tonemap rejection"

Swapchain and Resource Analysis

Use this skill when the target pass/resource is not proven yet, especially when work starts at final presentation, swapchain output, backbuffer format, or a suspected resource bottleneck. The goal is to trace the render pipeline far enough backward to find real scene/HDR data, prove where destructive SDR mapping happens, and decide whether the fix is shader replacement, resource upgrade, SwapChainPass/output-format work, UI separation, or rejection of a postprocess-only approach.

Related skills and scope

NeedUse
Game folder setup, builds, DevKit launch/linking, metadata, initial scaffoldsetup-game-mod-dev
Proving swapchain/resource formats, final output path, proxy resources, or HDR source locationThis skill
Editing a proven tonemap/LUT shader target after untonemapped/neutral_sdr/graded_sdr signals are knownhandle-sdr-tonemap-lut
Plotting curves, resource stats, or validation graphs discovered during analysisanalysis-graphing

Do not duplicate setup or shader-math workflow here. Capture only the facts those workflows need.

Core principle: RenoDX is not inverse tonemapping

RenoDX mods should not be framed as "take the finished SDR frame and inverse-tonemap it." That is the postprocess class of tools such as Microsoft AutoHDR, RTX HDR, and generic ReShade FX filters. Those methods guess missing HDR after the game has already compressed/clipped/graded the image.

RenoDX should instead preserve or recover a real upstream signal:

scene HDR / pre-tonemap composite
-> game exposure, bloom, fades, presentation effects
-> SDR tonemap or hard clip
-> optional LUT/color grade
-> UI/video/composite
-> final output encode / swapchain

The preferred RenoDX target is before the destructive SDR step, or at a shader that still receives the upstream signal plus an SDR reference. A final swapchain pass is only a valid target when it still has access to the HDR/pre-SDR resource, handles final color-space/output encode, or is used for verification/UI separation. It is not valid when it only reads the completed SDR backbuffer.

HDR upgrade model

Treat HDR upgrade work as preservation of range and gamut through the game's real pipeline, followed by an intentional output conversion.

Neutral output is the baseline. Resource upgrades, proxy paths, and swapchain color-space changes should preserve the original SDR art direction while removing proven range/precision limits. Default settings should match the original look as closely as practical. They should not create a default "HDR look" by increasing contrast, saturation, or colorfulness; visual augmentation belongs in explicit sliders or named presets such as HDR Look. Rare exceptions need explicit user intent and validation evidence.

ConceptRenoDX meaning
RGBA8U / UNORM limitValues are confined to [0, 1], cannot carry negative channels for wider-gamut representation, and cap highlights at SDR reference white.
Floating-point resourceRGBA16F or similar resources can preserve values above 1.0, negative channels, smoother gradients, and intermediate post-process precision.
Proxy resourceA high-precision intermediate can carry HDR data even when the practical swapchain format is RGB10A2/PQ HDR10 or linear scRGB. A full floating-point swapchain is not always required.
Native pipeline compatibilityMany game passes may continue operating in the game's original BT.709/gamma-style domain if the upgraded resources preserve range until the final proxy/output shader.
Final output conversionThe final proxy/output shader maps the preserved floating representation to the display path, such as linear scRGB or PQ HDR10. This is forward encoding, not inverse tonemapping.
SwapChainPassThe shared shader helper renodx::draw::SwapChainPass(...) is the standard final proxy/output conversion path when a proven float/intermediate signal reaches presentation.
Output preset cbufferA per-frame injected preset such as RENODX_SWAP_CHAIN_OUTPUT_PRESET / swap_chain_output_preset can cheaply select SDR, HDR10, or scRGB behavior without recompiling output shaders. Use named constants in code when available; numeric values are documentation only.

Use this model to decide whether the mod needs a shader replacement, a resource format upgrade, a swapchain proxy path, or all three.

Boundaries

  • Focus on DevKit draw/resource/swapchain analysis, render-target format decisions, and resource-upgrade planning.
  • Use this before handle-sdr-tonemap-lut when the shader capture point is unknown or when a final-output hack is being proposed.
  • After a shader-side tonemap/LUT target is proven, switch to handle-sdr-tonemap-lut for HLSL/Slang math.
  • Keep setup/build/link details in setup-game-mod-dev unless they are directly needed to prove resource behavior.
  • Do not create a RenoDX strategy that only inverse-tonemaps the final SDR swapchain image.
  • Do not treat a fullscreen pass as "the tonemap" until draw inputs prove whether it receives HDR
阅读完整来源 ↗