Função EngGradientFill (winddi.h)

A função EngGradientFill sombreia os primitivos especificados.

Sintaxe

ENGAPI BOOL EngGradientFill(
       SURFOBJ   *psoDest,
       CLIPOBJ   *pco,
       XLATEOBJ  *pxlo,
       TRIVERTEX *pVertex,
       ULONG     nVertex,
       PVOID     pMesh,
       ULONG     nMesh,
       RECTL     *prclExtents,
       POINTL    *pptlDitherOrg,
  [in] ULONG     ulMode
);

Parâmetros

psoDest

Ponteiro para a estrutura SURFOBJ que identifica a superfície na qual desenhar.

pco

Ponteiro para uma estrutura CLIPOBJ . As rotinas de serviço CLIPOBJ_Xxx são fornecidas para enumerar a região de clipe como um conjunto de retângulos. Essa enumeração limita a área do destino que é modificado. Sempre que possível, a GDI simplifica o recorte envolvido.

pxlo

Ponteiro para uma estrutura XLATEOBJ . Essa estrutura indica como os índices de cores devem ser convertidos entre o formato RGB de 32 bpp e o destino. O driver é responsável por converter os valores de cor de COLOR16 de entrada em RGB.

pVertex

Ponteiro para uma matriz de estruturas TRIVERTEX, com cada entrada contendo informações de posição e cor. A estrutura TRIVERTEX é descrita na documentação do SDK do Microsoft Windows.

nVertex

Especifica o número de estruturas TRIVERTEX na matriz para a qual pVertex aponta.

pMesh

Ponteiro para uma matriz de estruturas que definem a conectividade dos elementos TRIVERTEX aos quais pVertex aponta.

Quando retângulos estão sendo desenhados, pMesh aponta para uma matriz de estruturas GRADIENT_RECT, cada uma especificando dois elementos TRIVERTEX que definem um retângulo. Os elementos TRIVERTEX podem representar qualquer par diagonalmente oposto de vértices de retângulo. O desenho do retângulo é exclusivo no canto inferior direito. TRIVERTEX e GRADIENT_RECT são definidos na documentação do SDK do Windows.

Quando triângulos estão sendo desenhados, pMesh aponta para uma matriz de estruturas GRADIENT_TRIANGLE, cada uma especificando os três elementos TRIVERTEX que definem um triângulo. O desenho do triângulo é exclusivo no canto inferior direito. A estrutura GRADIENT_TRIANGLE é definida na documentação do SDK do Windows.

nMesh

Especifica o número de elementos na matriz para a qual pMesh aponta.

prclExtents

Ponteiro para uma estrutura RECTL que define a área na qual o desenho de gradiente deve ocorrer. Os pontos são especificados no sistema de coordenadas da superfície de destino. Esse parâmetro é útil para estimar o tamanho das operações de desenho.

pptlDitherOrg

Ponteiro para uma estrutura POINTL que define a origem na superfície para dithering. O pixel superior esquerdo do padrão dither está alinhado com esse ponto.

[in] ulMode

Especifica o modo de desenho atual e como interpretar a matriz à qual pMesh aponta. Esse parâmetro pode usar um dos valores a seguir:

GRADIENT_FILL_RECT_H

O parâmetro pMesh aponta para uma matriz de estruturas GRADIENT_RECT. Cada retângulo deve ser sombreado da esquerda para a direita.

GRADIENT_FILL_RECT_V

O parâmetro pMesh aponta para uma matriz de estruturas GRADIENT_RECT. Cada retângulo deve ser sombreado de cima para baixo.

GRADIENT_FILL_TRIANGLE

O parâmetro pMesh aponta para uma matriz de estruturas GRADIENT_TRIANGLE.

Valor retornado

EngGradientFill retorna TRUE após o sucesso. Caso contrário, ele relatará um erro e retornará FALSE.

Comentários

O driver deve chamar EngGradientFill se ele tiver fisgado DrvGradientFill e for chamado para fazer algo que ele não dá suporte.

As fórmulas usadas para calcular o valor de cor em cada pixel dependem do valor de ulMode da seguinte maneira:

A GDI ignora o valor alfa dos vértices, deixando o canal alfa inalterado para superfícies que dão suporte a alfa.

Requisitos

Confira também

DrvGradientFill