Compartilhar via

Estrutura DDCOLORCONTROL (ddraw.h)

  • Artigo

A estrutura DDCOLORCONTROL define os controles de cor associados a um objeto VPE (extensões de porta de vídeo) do Microsoft DirectDraw.

Sintaxe

typedef struct _DDCOLORCONTROL {
  DWORD dwSize;
  DWORD dwFlags;
  LONG  lBrightness;
  LONG  lContrast;
  LONG  lHue;
  LONG  lSaturation;
  LONG  lSharpness;
  LONG  lGamma;
  LONG  lColorEnable;
  DWORD dwReserved1;
} *LPDDCOLORCONTROL, DDCOLORCONTROL;

Membros

dwSize

Especifica o tamanho em bytes dessa estrutura DDCOLORCONTROL.

dwFlags

Indica um conjunto de sinalizadores que especificam quais membros da estrutura contêm dados válidos. Quando a estrutura é retornada por DdVideoPortColorControl, ela também indica quais opções são compatíveis com o objeto VPE. Esse membro pode ser um OR bit a bit dos valores listados na tabela a seguir.

Sinalizador Significado

DDCOLOR_BRIGHTNESS

O membro lBrightness contém dados válidos.

DDCOLOR_CONTRAST

O membro lContrast contém dados válidos.

DDCOLOR_COLORENABLE

O membro lColorEnable contém dados válidos.

DDCOLOR_GAMMA

O membro lGamma contém dados válidos.

DDCOLOR_HUE

O membro lHue contém dados válidos.

DDCOLOR_SATURATION

O membro lSaturation contém dados válidos.

DDCOLOR_SHARPNESS

O membro lSharpness contém dados válidos.

lBrightness

Especifica a intensidade de luminância (Nível Preto), em unidades IRE*100. Esse membro pode variar de 0 a 10.000, com um valor padrão de 750 (7,5 IRE).

lContrast

Especifica a diferença relativa entre valores de luminância de intensidade maior e menor, em unidades de IRE*100. Esse membro pode variar de 0 a 20.000, com um valor padrão de 10.000 (100 IRE). Valores mais altos de contraste fazem com que os valores de luminância mais escuros tendem a ser pretos e fazem com que valores de luminância mais leves tendem a ser brancos. Valores mais baixos de contraste fazem com que todos os valores de luminância se movam em direção aos valores de luminância média.

lHue

Especifica a relação de fase dos componentes chrominance. Hue é especificado em graus, com um intervalo válido de -180 a 180. O padrão é 0 graus.

lSaturation

Especifica a intensidade de cor, em unidades de IRE*100. Esse membro pode variar de 0 a 20.000, com um valor padrão de 10.000 (100 IRE).

lSharpness

Especifica a nitidez em unidades arbitrárias. O intervalo válido é de 0 a 10, com um valor padrão de 5.

lGamma

Controla a quantidade de correção gama aplicada aos valores de luminância. O intervalo válido é de 1 a 500 unidades gama, com um padrão de 1.

lColorEnable

Especifica um sinalizador que indica se a cor é usada. Se esse membro for zero, a cor não será usada; se for 1, a cor será usada. O valor padrão é 1.

dwReserved1

Reservado para uso do sistema e deve ser ignorado.

Requisitos

Requisito Valor
Cabeçalho ddraw.h

Confira também