Metodo IDirect3DDevice9::SetGammaRamp (d3d9helper.h)

Articolo
08/23/2023

Imposta la rampa di correzione gamma per la catena di scambio implicita. Questo metodo influirà sull'intera schermata (non solo sulla finestra attiva se è in esecuzione in modalità finestra).

Sintassi

void SetGammaRamp(
  [in] UINT               iSwapChain,
  [in] DWORD              Flags,
  [in] const D3DGAMMARAMP *pRamp
);

Parametri

[in] iSwapChain

Tipo: UINT

Intero senza segno che specifica la catena di scambio.

[in] Flags

Tipo: DWORD

Indica se è necessario applicare la correzione. La correzione gamma genera una visualizzazione più coerente, ma può comportare un sovraccarico di elaborazione e non deve essere usata di frequente. Gli effetti di durata breve, ad esempio lampeggiando l'intero schermo rosso, non devono essere calibrati, ma le modifiche gamma a lunga durata devono essere calibrate. È possibile impostare uno dei valori seguenti:

Elemento	Descrizione
D3DSGR_CALIBRATE	Se è installato un calibratore gamma, la rampa verrà modificata prima di essere inviata al dispositivo per tenere conto delle curve di risposta del sistema e del monitoraggio. Se non è installato un calibratore, la rampa verrà passata direttamente al dispositivo.
D3DSGR_NO_CALIBRATION	Non viene applicata alcuna correzione gamma. La tabella gamma fornita viene trasferita direttamente al dispositivo.

[in] pRamp

Tipo: const D3DGAMMARAMP*

Puntatore a una struttura D3DGAMMARAMP , che rappresenta la rampa di correzione gamma da impostare per la catena di scambio implicita.

Valore restituito

nessuno

Osservazioni

Esiste sempre almeno una catena di scambio (la catena di scambio implicita) per ogni dispositivo, perché Direct3D 9 ha una catena di scambio come proprietà del dispositivo. La rampa gamma diventa effettiva immediatamente; non c'è attesa per una sincronizzazione verticale.

Se il dispositivo non supporta le rampe gamma nella modalità di presentazione corrente della catena di scambio (a schermo intero o finestra), non viene restituito alcun errore. Le applicazioni possono controllare i bit delle funzionalità D3DCAPS2_FULLSCREENGAMMA e D3DCAPS2_CANCALIBRATEGAMMA nel membro Caps2 della struttura D3DCAPS9 per determinare le funzionalità del dispositivo e se è installato un calibratore.

Per la presentazione di correzione gamma con finestra, usare IDirect3DSwapChain9::P resent se l'hardware supporta la funzionalità. In DirectX 8 SetGammaRamp imposterà la rampa gamma solo in un'applicazione in modalità schermo intero. Per altre informazioni sulla correzione gamma, vedere Gamma (Direct3D 9).For more information about gamma correction, see Gamma (Direct3D 9).

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	d3d9helper.h (include D3D9.h)
Libreria	D3D9.lib

Vedi anche

IDirect3DDevice9

IDirect3DDevice9::GetGammaRamp

IDirect3DSwapChain9

Condividi tramite