Funzione DrvLineTo (winddi.h)

Articolo
08/27/2023

La funzione DrvLineTo disegna una linea cosmetica singola, solida e sola intero.

Sintassi

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

Parametri

pso

Puntatore a una struttura SURFOBJ che descrive la superficie su cui disegnare.

pco

Puntatore a una struttura CLIPOBJ che definisce l'area clip in cui è necessario eseguire il rendering. Nessun pixel può essere interessato all'esterno di questa area clip.

pbo

Puntatore a una struttura BRUSHOBJ che specifica il pennello da usare quando si disegna la linea.

x1

Specificare le coordinate x intere del punto iniziale della riga.

y1

Specificare le coordinate intere del punto iniziale della riga.

x2

Specificare le coordinate x intere del punto finale della riga.

y2

Specificare le coordinate intere del punto finale della riga.

prclBounds

Puntatore alla struttura RECTL che definisce il rettangolo intero che delimita la linea non ritagliata. I driver che supportano il disegno della linea hardware possono usare questo rettangolo per determinare rapidamente se la linea si adatta a uno spazio di coordinate abbastanza piccolo da eseguire il rendering dall'hardware.

mix

Modalità di combinazione che definisce le operazioni raster in primo piano e in background da usare per il pennello. Nella chiamata a DrvLineTo, i valori dell'operazione raster in primo piano e in background sono uguali. Per altre informazioni sulla modalità di combinazione, vedere Osservazioni.

Valore restituito

DrvLineTo restituisce TRUE se ha esito positivo; in caso contrario, restituisce FALSE.

Commenti

DrvLineTo è un punto di ingresso facoltativo che un driver può fornire come ottimizzazione per le chiamate dell'applicazione alla funzione Win32 LineTo . Se il driver non si aggancia DrvLineTo o se il driver restituisce FALSE da una chiamata a questa funzione, GDI chiamerà automaticamente DrvStrokePath . Un driver che ha collegato DrvLineTo può chiamare EngLineTo quando la superficie di rendering è un DIB.

Questa funzione è più semplice di DrvStrokePath perché supporta solo punti finali interi e linee cosmetiche solide. GDI ha meno sovraccarico quando si chiama DrvLineTo anziché DrvStrokePath; di conseguenza, DrvLineTo è destinato a essere usato come semplice ottimizzazione da parte dei driver che possono accelerare le linee di larghezza nominale nell'hardware.

La modalità mix definisce il modo in cui il modello in ingresso deve essere misto con i dati già presenti nell'area del dispositivo. Il tipo di dati MIX è costituito da due valori di operazione raster binaria (ROP2) compressi in una singola ULONG. Il byte più basso definisce l'operazione raster in primo piano; il byte successivo definisce l'operazione raster in background. Per altre informazioni sui codici di operazione raster, vedere la documentazione di Microsoft Windows SDK.