Fonction DrvLineTo (winddi.h)

Article
08/27/2023

La fonction DrvLineTo dessine une ligne cosmétique unique, solide et entière uniquement.

Syntaxe

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

Paramètres

pso

Pointeur vers une structure SURFOBJ qui décrit la surface sur laquelle dessiner.

pco

Pointeur vers une structure CLIPOBJ qui définit la région de clip dans laquelle le rendu doit être effectué. Aucun pixel ne peut être affecté en dehors de cette région de clip.

pbo

Pointeur vers une structure BRUSHOBJ qui spécifie le pinceau à utiliser lors du dessin de la ligne.

x1

Spécifiez les coordonnées x entières du point de départ de la ligne.

y1

Spécifiez les coordonnées y entières du point de départ de la ligne.

x2

Spécifiez les coordonnées x entières du point de terminaison de la ligne.

y2

Spécifiez les coordonnées y entières du point de terminaison de la ligne.

prclBounds

Pointeur vers la structure RECTL qui définit le rectangle entier qui limite la ligne sans saut. Les pilotes qui prennent en charge le dessin de lignes matérielles peuvent utiliser ce rectangle pour déterminer rapidement si la ligne se trouve dans un espace de coordonnées suffisamment petit pour être rendue par le matériel.

mix

Mode mix qui définit les opérations de trame de premier plan et d’arrière-plan à utiliser pour le pinceau. Dans l’appel à DrvLineTo, les valeurs d’opération raster au premier plan et en arrière-plan sont les mêmes. Pour plus d’informations sur le mode mix, consultez Remarques.

Valeur retournée

DrvLineTo retourne TRUE s’il réussit ; sinon, il retourne FALSE.

Remarques

DrvLineTo est un point d’entrée facultatif qu’un pilote peut fournir en tant qu’optimisation pour les appels d’applications à la fonction Win32 LineTo . Si le pilote n’accroche pas DrvLineTo ou si le pilote retourne FALSE à partir d’un appel à cette fonction, GDI appelle automatiquement DrvStrokePath à la place. Un pilote qui a crocheté DrvLineTo peut appeler EngLineTo lorsque la surface de rendu est une DIB.

Cette fonction est plus simple que DrvStrokePath , car elle prend uniquement en charge les points de terminaison entiers et les lignes cosmétiques solides. GDI a moins de surcharge lors de l’appel de DrvLineTo au lieu de DrvStrokePath ; par conséquent, DrvLineTo est destiné à être utilisé comme une simple optimisation par les pilotes qui peuvent accélérer les lignes de largeur nominale dans le matériel.

Le mode mix définit la façon dont le modèle entrant doit être mélangé avec les données qui se trouvent déjà sur l’surface de l’appareil. Le type de données MIX se compose de deux valeurs d’opération raster binaire (ROP2) regroupées dans un seul ULONG. L’octet d’ordre le plus bas définit l’opération raster de premier plan ; l’octet suivant définit l’opération raster en arrière-plan. Pour plus d’informations sur les codes d’opération raster, consultez la documentation Microsoft Windows SDK.