Função DrvGradientFill (winddi.h)

A função DrvGradientFill sombreia os primitivos especificados.

Sintaxe

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

Parâmetros

[in, out] psoDest

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

[in] 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.

[in, optional] pxlo

Ponteiro para uma estrutura XLATEOBJ . Esse parâmetro deve ser ignorado pelo driver.

[in] 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.

[in] nVertex

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

[in] 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. GRADIENT_TRIANGLE é definido na documentação do SDK do Windows.

[in] nMesh

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

[in] 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.

[in] 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. Especificamente, os pixels superior esquerdo e inferior esquerdo são da mesma cor, assim como os pixels superior direito e inferior direito.

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. Especificamente, os pixels superior esquerdo e superior direito são da mesma cor, assim como os pixels inferior esquerdo e inferior direito.

GRADIENT_FILL_TRIANGLE

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

Os cálculos de preenchimento de gradiente para cada modo são documentados na seção Comentários.

Retornar valor

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

Comentários

DrvGradientFill pode ser implementado opcionalmente em drivers gráficos. A GDI nunca chama essa função para superfícies palletizadas.

O driver conecta DrvGradientFill definindo o sinalizador HOOK_GRADIENTFILL quando chama EngAssociateSurface ou EngModifySurface. Se o driver tiver fisgado o DrvGradientFill e for chamado para executar uma operação à qual não dá suporte, o driver deverá ter o GDI para manipular a operação pontuando os dados em uma chamada para EngGradientFill.

A GDI não chamará DrvGradientFill para superfícies de destino de 8bpp.

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

O erro total acumulado em todos os três canais de cores não deve ser superior a oito (8). Para obter mais informações sobre o erro permitido, consulte Efeitos especiais em Drivers de exibição.

O driver deve ignorar o valor alfa dos vértices, deixando o canal alfa inalterado para superfícies que dão suporte à mistura alfa.

Requisitos

Confira também

EngAssociateSurface

EngGradientFill