Função DrvLineTo (winddi.h)

Artigo
08/27/2023

A função DrvLineTo desenha uma linha cosmética única, sólida e somente inteiro.

Sintaxe

BOOL DrvLineTo(
  SURFOBJ  *pso,
  CLIPOBJ  *pco,
  BRUSHOBJ *pbo,
  LONG     x1,
  LONG     y1,
  LONG     x2,
  LONG     y2,
  RECTL    *prclBounds,
  MIX      mix
);

Parâmetros

pso

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

pco

Ponteiro para uma estrutura CLIPOBJ que define a região de clipe na qual a renderização deve ser feita. Nenhum pixel pode ser afetado fora dessa região de clipe.

pbo

Ponteiro para uma estrutura BRUSHOBJ que especifica o pincel a ser usado ao desenhar a linha.

x1

Especifique as coordenadas x inteiros do ponto inicial da linha.

y1

Especifique as coordenadas y inteiras do ponto inicial da linha.

x2

Especifique as coordenadas x inteiras do ponto de extremidade da linha.

y2

Especifique as coordenadas y inteiras do ponto de extremidade da linha.

prclBounds

Ponteiro para a estrutura RECTL que define o retângulo inteiro que vincula a linha descompactada. Os drivers que dão suporte ao desenho de linha de hardware podem usar esse retângulo para determinar rapidamente se a linha se encaixa em um espaço de coordenadas pequeno o suficiente para ser renderizada pelo hardware.

mix

O modo de combinação que define as operações de raster em primeiro plano e segundo plano a serem usadas para o pincel. Na chamada para DrvLineTo, os valores de operação de raster em primeiro e segundo plano são os mesmos. Para obter mais informações sobre o modo de combinação, consulte Comentários.

Valor retornado

DrvLineTo retornará TRUE se for bem-sucedido; caso contrário, retornará FALSE.

Comentários

DrvLineTo é um ponto de entrada opcional que um driver pode fornecer como uma otimização para chamadas de aplicativo para a função LineTo do Win32. Se o driver não ligar para DrvLineTo ou se o driver retornar FALSE de uma chamada para essa função, o GDI chamará automaticamente DrvStrokePath . Um driver que fisgou o DrvLineTo pode chamar EngLineTo quando a superfície de renderização é um DIB.

Essa função é mais simples que DrvStrokePath porque dá suporte apenas a pontos de extremidade inteiros e linhas cosméticas sólidas. A GDI tem menos sobrecarga ao chamar DrvLineTo em vez de DrvStrokePath; consequentemente, o DrvLineTo destina-se a ser usado como uma otimização simples por drivers que podem acelerar linhas de largura nominal no hardware.

O modo de combinação define como o padrão de entrada deve ser misturado com os dados que já estão na superfície do dispositivo. O tipo de dados MIX consiste em dois valores roP2 (operação de varredura binária) empacotados em um único ULONG. O byte de ordem mais baixa define a operação de varredura em primeiro plano; o próximo byte define a operação de varredura em segundo plano. Para obter mais informações sobre códigos de operação de varredura, consulte a documentação do SDK do Microsoft Windows.