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

Define o ponto branco nomeado do arquivo bruto.

Sintaxe

HRESULT SetNamedWhitePoint(
  [in] WICNamedWhitePoint WhitePoint
);

Parâmetros

[in] WhitePoint

Tipo: WICNamedWhitePoint

Um combinação bit a bit dos valores de enumeração.

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

Se os pontos em branco nomeados não forem compatíveis com a imagem bruta ou o arquivo bruto contiver pontos em branco nomeados que não são compatíveis com essa API, o implementador de codec ainda deverá marcar essa funcionalidade como compatível.

Se os pontos brancos nomeados não forem suportados pela imagem bruta, um melhor esforço deverá ser feito para ajustar a imagem ao ponto branco nomeado, mesmo quando não for um ponto branco predefinido do arquivo bruto.

Se o arquivo bruto contiver pontos brancos nomeados sem suporte por essa API, o implementador de codec deverá dar suporte aos pontos brancos nomeados na API.

Devido a outros métodos de configuração de ponto em branco (por exemplo, SetWhitePointKelvin), o cuidado deve ser tomado pelos implementadores de codec para garantir a interoperabilidade adequada. Por exemplo, se o chamador definir por meio de um ponto branco nomeado, o implementador de codec poderá querer 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