Función DrvLineTo (winddi.h)

Artículo
08/27/2023

La función DrvLineTo dibuja una sola línea cosmética de solo entero y sólida.

Sintaxis

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

Parámetros

pso

Puntero a una estructura SURFOBJ que describe la superficie en la que se va a dibujar.

pco

Puntero a una estructura CLIPOBJ que define la región de recorte en la que se debe realizar la representación. No se puede ver afectado ningún píxel fuera de esta región de clip.

pbo

Puntero a una estructura BRUSHOBJ que especifica el pincel que se va a usar al dibujar la línea.

x1

Especifique las coordenadas x del entero del punto inicial de la línea.

y1

Especifique las coordenadas y de entero del punto inicial de la línea.

x2

Especifique las coordenadas x del entero del punto final de la línea.

y2

Especifique las coordenadas y de entero del punto final de la línea.

prclBounds

Puntero a la estructura RECTL que define el rectángulo entero que enlaza la línea no recortada. Los controladores que admiten el dibujo de líneas de hardware pueden usar este rectángulo para determinar rápidamente si la línea cabe en un espacio de coordenadas lo suficientemente pequeño como para representarlo el hardware.

mix

Modo de combinación que define las operaciones de trama en primer plano y en segundo plano que se van a usar para el pincel. En la llamada a DrvLineTo, los valores de operación de trama en primer plano y en segundo plano son los mismos. Para obtener más información sobre el modo de combinación, vea Comentarios.

Valor devuelto

DrvLineTo devuelve TRUE si se realiza correctamente; de lo contrario, devuelve FALSE.

Comentarios

DrvLineTo es un punto de entrada opcional que un controlador puede proporcionar como optimización para las llamadas de aplicación a la función LineTo de Win32. Si el controlador no enlaza DrvLineTo o si el controlador devuelve FALSE desde una llamada a esta función, GDI llamará automáticamente a DrvStrokePath en su lugar. Un controlador que ha conectado DrvLineTo puede llamar a EngLineTo cuando la superficie de representación es una DIB.

Esta función es más sencilla que DrvStrokePath porque solo admite puntos finales enteros y líneas cosméticas sólidas. GDI tiene menos sobrecarga al llamar a DrvLineTo en lugar de DrvStrokePath; por lo tanto, DrvLineTo está diseñado para ser utilizado como una optimización simple por los controladores que pueden acelerar las líneas de ancho nominal en hardware.

El modo de combinación define cómo se debe mezclar el patrón entrante con los datos que ya están en la superficie del dispositivo. El tipo de datos MIX consta de dos valores de operación de ráster binario (ROP2) empaquetados en un único ULONG. El byte de orden más bajo define la operación de trama en primer plano; el byte siguiente define la operación de trama en segundo plano. Para obtener más información sobre los códigos de operación de trama, consulte la documentación de Microsoft Windows SDK.