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

  • Artigo

Define a rampa de correção gama para a cadeia de troca implícita. Esse método afetará toda a tela (não apenas a janela ativa se você estiver executando no modo de janela).

Sintaxe

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

Parâmetros

[in] iSwapChain

Tipo: UINT

Inteiro sem sinal que especifica a cadeia de troca.

[in] Flags

Tipo: DWORD

Indica se a correção deve ser aplicada. A correção gama resulta em uma exibição mais consistente, mas pode incorrer em sobrecarga de processamento e não deve ser usada com frequência. Efeitos de curta duração, como piscar a tela inteira vermelha, não devem ser calibrados, mas as alterações gama de longa duração devem ser calibradas. Um dos seguintes valores pode ser definido:

Item Descrição
D3DSGR_CALIBRATE Se um calibrador gama estiver instalado, a rampa será modificada antes de ser enviada ao dispositivo para levar em conta o sistema e monitorar as curvas de resposta. Se um calibrador não estiver instalado, a rampa será passada diretamente para o dispositivo.
D3DSGR_NO_CALIBRATION Nenhuma correção gama é aplicada. A tabela gama fornecida é transferida diretamente para o dispositivo.

[in] pRamp

Tipo: const D3DGAMMARAMP*

Ponteiro para uma estrutura D3DGAMMARAMP , representando a rampa de correção gama a ser definida para a cadeia de troca implícita.

Retornar valor

Nenhum

Comentários

Há sempre pelo menos uma cadeia de troca (a cadeia de troca implícita) para cada dispositivo, pois o Direct3D 9 tem uma cadeia de troca como uma propriedade do dispositivo. A rampa gama entra em vigor imediatamente; não há espera por uma sincronização vertical.

Se o dispositivo não oferecer suporte a rampas gama no modo de apresentação atual da cadeia de troca (tela inteira ou janela), nenhum retorno de erro será dado. Os aplicativos podem marcar os bits de funcionalidade D3DCAPS2_FULLSCREENGAMMA e D3DCAPS2_CANCALIBRATEGAMMA no membro Caps2 da estrutura de D3DCAPS9 para determinar os recursos do dispositivo e se um calibrador está instalado.

Para a apresentação de correção gama em janelas, use IDirect3DSwapChain9::P resent se o hardware der suporte ao recurso. No DirectX 8, SetGammaRamp definirá a rampa gama somente em um aplicativo de modo de tela inteira. Para obter mais informações sobre a correção gama, consulte Gama (Direct3D 9).

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d9helper.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

IDirect3DDevice9

IDirect3DDevice9::GetGammaRamp

IDirect3DSwapChain9