Metodo IDirectDrawGammaControl::SetGammaRamp (ddraw.h)
Imposta le rampe gamma rosse, verdi e blu per la superficie primaria.
Sintassi
HRESULT SetGammaRamp(
[in] DWORD unnamedParam1,
[in] LPDDGAMMARAMP unnamedParam2
);
Parametri
[in] unnamedParam1
Flag che indica se è necessaria la calibrazione gamma. Impostare questo parametro su DDSGR_CALIBRATE per richiedere che il calibratore regola la rampa gamma in base alle proprietà fisiche dello schermo, il che rende il risultato identico in tutti i computer. Se la calibrazione non è necessaria, impostare questo parametro su 0.
[in] unnamedParam2
Puntatore a una struttura DDGAMMARAMP che contiene le nuove voci di rampa gamma rossa, verde e blu. Ogni matrice esegue il mapping dei valori di colore nel buffer dei fotogrammi ai valori di colore da passare al convertitore digitale-analogico (DAC).
Valore restituito
Se il metodo ha esito positivo, il valore restituito viene DD_OK.
Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:
- DDERR_EXCEPTION
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
Commenti
Non tutti i sistemi supportano la calibrazione gamma. Per determinare se la calibrazione gamma è supportata, chiamare IDirectDraw7::GetCaps ed esaminare il membro dwCaps2 della struttura DDCAPS associata dopo la restituzione del metodo. Se è presente il flag di funzionalità DDCAPS2_CANCALIBRATEGAMMA, la calibrazione gamma è supportata.
La calibrazione delle rampe gamma comporta un sovraccarico di elaborazione e non deve essere usata di frequente.
L'inclusione del flag DDSGR_CALIBRATE nel parametro dwFlags durante l'esecuzione nei computer che non supportano la calibrazione gamma non causa l'esito negativo di questo metodo. Il metodo ha esito positivo e imposta nuovi valori di rampa gamma senza calibrazione.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |