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

Vedi anche

IDirectDrawGammaControl