Funzione EngTransparentBlt (winddi.h)

Articolo
03/04/2024

La funzione EngTransparentBlt offre funzionalità di trasferimento a blocchi di bit con trasparenza.

Sintassi

ENGAPI BOOL EngTransparentBlt(
  [in]           SURFOBJ  *psoDst,
  [in]           SURFOBJ  *psoSrc,
  [in, optional] CLIPOBJ  *pco,
  [in, optional] XLATEOBJ *pxlo,
  [in]           RECTL    *prclDst,
  [in]           RECTL    *prclSrc,
  [in]           ULONG    TransColor,
  [in]           ULONG    bCalledFromBitBlt
);

Parametri

[in] psoDst

Puntatore alla struttura SURFOBJ che identifica la superficie di destinazione su cui disegnare.

[in] psoSrc

Puntatore alla struttura SURFOBJ che identifica la superficie di origine del trasferimento a blocchi di bit.

[in, optional] pco

Puntatore a una struttura CLIPOBJ . Le routine del servizio CLIPOBJ_Xxx vengono fornite per enumerare l'area di ritaglio come set di rettangoli. Questa enumerazione limita l'area della destinazione modificata. Quando possibile, GDI semplifica il ritaglio.

[in, optional] pxlo

Puntatore a una struttura XLATEOBJ che indica come devono essere convertiti gli indici del colore di origine per la scrittura nella superficie di destinazione.

[in] prclDst

Puntatore a una struttura RECTL che definisce l'area rettangolare da modificare. Questo rettangolo viene specificato nel sistema di coordinate della superficie di destinazione ed è definito da due punti: in alto a sinistra e in basso a destra. Il rettangolo è esclusivo in basso a destra; ovvero i bordi inferiori e destro non fanno parte del trasferimento del blocco di bit. I due punti che definiscono il rettangolo sono sempre ordinati correttamente.

Il driver non deve mai chiamare EngTransparentBlt con un rettangolo di destinazione vuoto.

[in] prclSrc

Puntatore a una struttura RECTL che definisce l'area rettangolare da copiare. Questo rettangolo viene specificato nel sistema di coordinate della superficie di origine ed è definito da due punti: superiore sinistro e inferiore destro. I due punti che definiscono il rettangolo sono sempre ordinati correttamente.

Il rettangolo di origine non supererà mai i limiti della superficie di origine e quindi non sovrasporrà mai la superficie di origine.

Questo rettangolo viene mappato al rettangolo di destinazione definito da prclDst. Il driver non deve mai chiamare EngTransparentBlt con un rettangolo di origine vuoto.

[in] TransColor

Specifica il colore trasparente fisico, nel formato della superficie di origine. Si tratta di un valore di indice colore convertito nella tavolozza della superficie di origine. Per altre informazioni, vedere la sezione Osservazioni .

[in] bCalledFromBitBlt

Riservato. Questo parametro deve essere impostato su zero.

Valore restituito

EngTransparentBlt restituisce TRUE in caso di esito positivo. In caso contrario, restituisce FALSE.

Commenti

Il driver deve chiamare EngTransparentBlt se ha collegato DrvTransparentBlt e viene chiamato per eseguire un'operazione che non supporta.

Il trasferimento a blocchi di bit con trasparenza è supportato tra due superfici gestite dal dispositivo o tra una superficie gestita dal dispositivo e una bitmap in formato standard gestito da GDI. Attualmente GDI supporta solo BMF_4BPP e BMF_8BPP superfici di origine.

I pixel sulla superficie di origine che corrispondono al colore trasparente specificato da iTransparentColor non vengono copiati. Per una spiegazione dettagliata dei blts trasparenti, vedere Copia di bitmap.

Requisiti

Requisito	Valore
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