Funzione EngStrokePath (winddi.h)
La funzione EngStrokePath richiede che GDI tratti un percorso specificato.
Sintassi
ENGAPI BOOL EngStrokePath(
SURFOBJ *pso,
PATHOBJ *ppo,
CLIPOBJ *pco,
XFORMOBJ *pxo,
BRUSHOBJ *pbo,
POINTL *pptlBrushOrg,
[in] LINEATTRS *plineattrs,
[in] MIX mix
);
Parametri
pso
Puntatore a una struttura SURFOBJ che descrive la superficie su cui disegnare.
ppo
Puntatore a una struttura PATHOBJ . Le routine del servizio PATHOBJ_Xxx vengono fornite per enumerare le linee, le curve di Bezier e altri dati che costituiscono il percorso. Indica cosa deve essere disegnato.
pco
Puntatore a una struttura CLIPOBJ . Le routine del servizio CLIPOBJ_Xxx vengono fornite per enumerare l'area di ritaglio come set di rettangoli. Facoltativamente, tutte le righe nel percorso possono essere enumerate in modo preclip da questo CLIPOBJ. Ciò significa che i driver possono avere tutti i calcoli di ritaglio delle linee eseguiti per loro.
pxo
Puntatore a una struttura XFORMOBJ . Questa operazione è necessaria solo quando deve essere disegnata una linea geometrica larga. Specifica la trasformazione che converte le coordinate del mondo in coordinate del dispositivo. Ciò è necessario perché il percorso viene fornito nelle coordinate del dispositivo, ma una linea geometrica larga viene effettivamente ampliata nelle coordinate del mondo.
Il driver può usare le routine del servizio XFORMOBJ_Xxx per determinare la trasformazione.
pbo
Puntatore a una struttura BRUSHOBJ che specifica il pennello da utilizzare durante il disegno del percorso.
pptlBrushOrg
Puntatore a una struttura POINTL che contiene l'origine del pennello usata per allineare il motivo pennello nel dispositivo.
[in] plineattrs
Puntatore a una struttura LINEATTRS . Si noti che il membro elStyleState di questa struttura deve essere aggiornato come parte di questa funzione se la linea è in stile. Si noti anche che il membro ptlLastPel della stessa struttura deve essere aggiornato se viene disegnata una linea cosmetica a larghezza singola in pixel.
[in] mix
Specifica come combinare il pennello con la destinazione.
Valore restituito
Il valore restituito è TRUE se GDI traccia il percorso. Se il driver deve tracciare il percorso, il valore restituito è FALSE e non viene registrato alcun errore. Se GDI rileva un errore, il valore restituito viene DDI_ERROR e viene registrato un codice di errore.
Commenti
La modalità di combinazione 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 ROP2 compressi in un'unica ULONG. Il byte di ordine 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.
Requisiti
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |