Método IDirect3DDevice9::SetGammaRamp (d3d9.h)

Artículo
02/26/2024

Establece la rampa de corrección gamma para la cadena de intercambio implícita. Este método afectará a toda la pantalla (no solo la ventana activa si se ejecuta en modo de ventana).

Sintaxis

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

Parámetros

[in] iSwapChain

Tipo: UINT

Entero sin signo que especifica la cadena de intercambio.

[in] Flags

Tipo: DWORD

Indica si se debe aplicar la corrección. La corrección gamma da como resultado una pantalla más coherente, pero puede incurrir en sobrecarga de procesamiento y no debe usarse con frecuencia. Los efectos de corta duración, como parpadear todo el rojo de la pantalla, no deben calibrarse, pero los cambios gamma de larga duración deben calibrarse. Se puede establecer uno de los siguientes valores:

Elemento	Descripción
D3DSGR_CALIBRATE	Si se instala un calibrador gamma, la rampa se modificará antes de enviarse al dispositivo para tener en cuenta las curvas de respuesta del sistema y de supervisión. Si no se instala un calibrador, la rampa se pasará directamente al dispositivo.
D3DSGR_NO_CALIBRATION	No se aplica ninguna corrección gamma. La tabla gamma suministrada se transfiere directamente al dispositivo.

[in] pRamp

Tipo: const D3DGAMMARAMP*

Puntero a una estructura de D3DGAMMARAMP , que representa la rampa de corrección gamma que se va a establecer para la cadena de intercambio implícita.

Valor devuelto

None

Observaciones

Siempre hay al menos una cadena de intercambio (la cadena de intercambio implícita) para cada dispositivo, ya que Direct3D 9 tiene una cadena de intercambio como propiedad del dispositivo. La rampa gamma surte efecto inmediatamente; no hay ninguna espera para una sincronización vertical.

Si el dispositivo no admite rampas gamma en el modo de presentación actual de la cadena de intercambio (pantalla completa o ventana), no se proporciona ninguna devolución de error. Las aplicaciones pueden comprobar los bits de funcionalidad D3DCAPS2_FULLSCREENGAMMA y D3DCAPS2_CANCALIBRATEGAMMA en el miembro Caps2 de la estructura de D3DCAPS9 para determinar las funcionalidades del dispositivo y si se instala un calibrador.

Para la presentación de corrección gamma con ventana, use IDirect3DSwapChain9::P resent si el hardware admite la característica. En DirectX 8, SetGammaRamp establecerá la rampa gamma solo en una aplicación en modo de pantalla completa. Para obtener más información sobre la corrección gamma, vea Gamma (Direct3D 9) .