kBufferTypeUIAlpha changed from 68 to 69 in Streamline SDK 2.12.0
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 32/100
Direzione di ricerca
Inizia ispezionando il commit e8aaa6eaac968711fb62473d4ae8256dde20919b e la dichiarazione di BufferType, quindi traccia il percorso con cui i valori di ResourceTag raggiungono slSetTag e slSetTagForFrame. Confronta le versioni dell’SDK coinvolte e determina se i valori numerici sono stabili a livello ABI. Il lavoro è completo quando sono documentati la decisione di compatibilità, ogni modifica di valore necessaria e le indicazioni per la migrazione delle integrazioni meno recenti.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Streamline commit e8aaa6eaac968711fb62473d4ae8256dde20919b appears to introduce a public BufferType numeric compatibility break.
Observed change
Before the change:
constexpr BufferType kBufferTypeUIAlpha = 68;
After the change:
constexpr BufferType kBufferTypeResponsivityMask = 68;
constexpr BufferType kBufferTypeUIAlpha = 69;
This means an existing public constant changed numeric value.
Why this matters
BufferType values are passed as runtime data in Streamline resource tags, such as slSetTag / slSetTagForFrame ResourceTag arrays.
Applications, middleware, or compatibility layers compiled against older Streamline headers may have kBufferTypeUIAlpha baked into their binaries as raw value 68.
Newer Streamline headers now interpret raw value 68 as kBufferTypeResponsivityMask instead.
| Component | Meaning of raw BufferType 68 |
|---|---|
| App built with older headers | kBufferTypeUIAlpha |
| Streamline 2.12.0 headers | kBufferTypeResponsivityMask |
Compatibility risk
Possible impact:
- Older games or integrations tagging alpha-only UI as
68may be interpreted by newer Streamline components or tools as providing a responsivity mask. - DLSS Frame Generation may fail to receive the intended alpha-only UI tag from older integrations.
- DLSS-D may receive a UI alpha texture where it expects a responsivity mask.
- Middleware, debugging tools, overlays, DLSS fix layers, and compatibility shims that inspect, filter, or rewrite
ResourceTagarrays cannot safely decode rawBufferType68without knowing the exact SDK/runtime/plugin version contract. - Newer integrations using raw
69forUIAlphamay not be understood by older Streamline components.
Questions / request
- Are
BufferTypenumeric values intended to be ABI-stable across Streamline SDK versions? - If they are intended to be stable, can
kBufferTypeUIAlpharetain value68andkBufferTypeResponsivityMaskbe assigned a new unused value instead? - If
BufferTypevalues are not intended to be stable, can this be explicitly documented as a breaking change? - Is there a recommended runtime way to disambiguate raw
BufferType68from older binaries: legacyUIAlphavs newResponsivityMask? - Should tools/interposers assume Streamline headers, interposer DLL, plugins, and app integration must all come from the same SDK package?
Suggested compatibility-safe fix
Prefer preserving the old value:
constexpr BufferType kBufferTypeUIAlpha = 68;
constexpr BufferType kBufferTypeResponsivityMask = <new unused value>;
If preserving the old value is not possible, the changelog should call this out as an API/ABI compatibility break and provide migration guidance for interposers and middleware that handle ResourceTag arrays from existing game binaries.
- Lingua principale
- C
- Stelle
- 1.4k
- Fork
- 174
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Nessun modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di NVIDIA-RTX/Streamline
-
Title: Vulkan: VK_FORMAT_R8_UNORM missing in Vulkan::getFormatForse già presa Una pull request collegata a questa issue è aperta o già unita. Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100
NVIDIA-RTX/Streamline#133 ·
-
sl.log folder makes it hard to integrate, as many developer has *.log in the exclude filter for git/p4.Forse già presa @Dragon31337 l’ha presa 72 giorni fa. Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 64/100
NVIDIA-RTX/Streamline#121 ·
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 86/100
NVIDIA-RTX/Streamline#120 ·
-
C++23 issueApertabug triaged
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
NVIDIA-RTX/Streamline#111 · 1 commento ·
-
Difficoltà 4/5 3-5 giorni Idoneità per principianti 35/100
NVIDIA-RTX/Streamline#136 · 1 commento · 1 reazione ·
Tutte le issue di NVIDIA-RTX/Streamline
Issue simili
-
ecs_ptr_from_json does not free the buffer of a string longer than 256 bytes on two error pathsAperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
SanderMertens/flecs#2444 ·
I maintainer di solito rispondono entro 1 giorno
-
Status: Opened
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
espressif/esp-eth-drivers#201 ·
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 74/100
libsdl-org/SDL#16788 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100
cisco/ChezScheme#1110 ·
I maintainer di solito rispondono entro 1 giorno