Funzione DrvRealizeBrush (winddi.h)

Articolo
03/04/2024

La funzione DrvRealizeBrush richiede al driver di realizzare un pennello specificato per una superficie specificata.

Sintassi

BOOL DrvRealizeBrush(
  [in]           BRUSHOBJ *pbo,
  [in, out]      SURFOBJ  *psoTarget,
  [in]           SURFOBJ  *psoPattern,
  [in, optional] SURFOBJ  *psoMask,
  [in]           XLATEOBJ *pxlo,
  [in]           ULONG    iHatch
);

Parametri

[in] pbo

Puntatore alla struttura BRUSHOBJ da realizzare. Tutti gli altri parametri, ad eccezione di psoTarget, possono essere sottoposti a query da questo oggetto. Le specifiche dei parametri vengono fornite come ottimizzazione. Questo parametro viene usato solo come parametro per BRUSHOBJ_pvAllocRbrush, che alloca la memoria per il pennello realizzato.

[in, out] psoTarget

Puntatore alla struttura SURFOBJ per cui il pennello deve essere realizzato. Questa superficie può essere la superficie fisica per il dispositivo, una bitmap di formato dispositivo o una bitmap di formato standard.

[in] psoPattern

Puntatore alla struttura SURFOBJ che descrive il modello per il pennello. Per un dispositivo raster, si tratta di una bitmap. Per un dispositivo vettore, questa è una delle superfici del modello fornite da DrvEnablePDEV.

[in, optional] psoMask

Puntatore a una struttura SURFOBJ che descrive una maschera di trasparenza per il pennello. Si tratta di un bit per bitmap a 1 bit che ha lo stesso extent del modello. Una maschera di zero indica che il pixel è considerato un pixel di sfondo per il pennello. In modalità sfondo trasparente, i pixel di sfondo non sono interessati da un riempimento. I plotter possono ignorare questo parametro perché non disegnano mai informazioni in background.

[in] pxlo

Puntatore a una struttura XLATEOBJ che definisce l'interpretazione dei colori nel modello. Se pxlo è NULL, non è necessaria alcuna traduzione. Una routine di servizio XLATEOBJ_Xxx può essere chiamata per tradurre i colori in indici di colore del dispositivo. I dispositivi vettoriali devono tradurre il colore zero tramite XLATEOBJ per ottenere il colore di primo piano per il pennello.

[in] iHatch

Specifica se psoPattern è uno dei pennelli di tratteggio restituiti da DrvEnablePDEV. Questo valore è true se il valore di questo parametro è minore di HS_DDI_MAX, definito in winddi.h.

Valore restituito

Il valore restituito è TRUE se il pennello è stato realizzato correttamente. In caso contrario, è FALSE e viene registrato un codice di errore.

Commenti

Per realizzare un pennello, il driver converte un pennello GDI in un modulo che può essere usato internamente. Un pennello realizzato contiene informazioni specifiche del dispositivo necessarie per accelerare il disegno usando il pennello.

La realizzazione del driver di un pennello viene scritta nel buffer allocato da una chiamata a BRUSHOBJ_pvAllocRbrush.

DrvRealizeBrush è necessario per un driver che esegue qualsiasi disegno in qualsiasi superficie.