Método IWICDevelopRaw::SetWhitePointKelvin (wincodec.h)

Define o valor kelvin do ponto branco.

Sintaxe

HRESULT SetWhitePointKelvin(
  [in] UINT WhitePointKelvin
);

Parâmetros

[in] WhitePointKelvin

Tipo: UINT

O valor kelvin do ponto branco. Os valores kelvin aceitáveis são de 1.500 a 30.000.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os implementadores de codec devem ajustar fielmente a temperatura da cor dentro do intervalo com suporte nativo pela imagem bruta. Para valores fora do intervalo de suporte nativo, o implementador de codec deve fornecer uma melhor representação de esforço da imagem nessa temperatura de cor.

Os implementadores de codec devem retornar WINCODEC_ERR_VALUEOUTOFRANGE se o valor estiver fora do intervalo aceitável definido.

Os implementadores de codec devem garantir a interoperabilidade adequada com outros métodos de configuração de ponto em branco, como SetWhitePointRGB. Por exemplo, se o chamador definir o ponto em branco por meio de SetNamedWhitePoint , talvez o implementador de codec queira desabilitar a leitura da temperatura kelvin correspondente. Em casos específicos em que o implementador de codec deseja negar uma determinada ação devido a chamadas anteriores, WINCODEC_ERR_WRONGSTATE deve ser retornado.

Requisitos