Método IDirectDrawGammaControl::SetGammaRamp (ddraw.h)
Define as rampas gama vermelhas, verdes e azuis para a superfície primária.
Sintaxe
HRESULT SetGammaRamp(
[in] DWORD unnamedParam1,
[in] LPDDGAMMARAMP unnamedParam2
);
Parâmetros
[in] unnamedParam1
Sinalizador que indica se a calibragem gama é necessária. Defina esse parâmetro como DDSGR_CALIBRATE para solicitar que o calibrador ajuste a rampa gama de acordo com as propriedades físicas da tela, o que torna o resultado idêntico em todos os computadores. Se a calibragem não for necessária, defina esse parâmetro como 0.
[in] unnamedParam2
Um ponteiro para uma estrutura DDGAMMARAMP que contém as novas entradas de rampa gama vermelha, verde e azul. Cada matriz mapeia valores de cor no buffer de quadros para os valores de cor a serem passados para o DAC (conversor digital para analógico).
Retornar valor
Se o método for bem-sucedido, o valor retornado será DD_OK.
Se falhar, o método poderá retornar um dos seguintes valores de erro:
- DDERR_EXCEPTION
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
Comentários
Nem todos os sistemas dão suporte à calibragem gama. Para determinar se há suporte para calibragem gama, chame IDirectDraw7::GetCaps e examine o membro dwCaps2 da estrutura DDCAPS associada após o retorno do método. Se o sinalizador de funcionalidade DDCAPS2_CANCALIBRATEGAMMA estiver presente, a calibragem gama terá suporte.
A calibragem de rampas gama incorre em alguma sobrecarga de processamento e não deve ser usada com frequência.
Incluir o sinalizador DDSGR_CALIBRATE no parâmetro dwFlags durante a execução em computadores que não dão suporte à calibragem gama não faz com que esse método falhe. O método é bem-sucedido e define novos valores de rampa gama sem calibragem.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | ddraw.h |
| Biblioteca | Ddraw.lib |
| DLL | Ddraw.dll |