struttura DXGK_GDIARG_ALPHABLEND (d3dkmddi.h)

Articolo
02/06/2025

La struttura DXGK_GDIARG_ALPHABLEND descrive le caratteristiche di un'operazione di fusione alfa accelerata dall'hardware GDI.

Sintassi

typedef struct _DXGK_GDIARG_ALPHABLEND {
  [in] RECT    SrcRect;
  [in] RECT    DstRect;
  [in] UINT    SrcAllocationIndex;
  [in] UINT    DstAllocationIndex;
  [in] UINT    NumSubRects;
  [in] RECT    *pSubRects;
  [in] BYTE    SourceConstantAlpha;
  [in] BOOLEAN SourceHasAlpha;
  [in] UINT    SrcPitch;
} DXGK_GDIARG_ALPHABLEND;

Membri

[in] SrcRect

StrutturaRECTche definisce l'area rettangolare da copiare. Questo rettangolo di origine 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 ben ordinati. Questo rettangolo non supererà mai i limiti della superficie di origine, quindi non sovrasporrà mai la superficie di origine. Questo rettangolo viene mappato al rettangolo di destinazione definito da DstRect. Per altre informazioni, vedere La sezione Osservazioni.

[in] DstRect

Struttura RECT che definisce l'area rettangolare da modificare. Questo rettangolo viene specificato nel sistema di coordinate della superficie di destinazione ed è definito da due punti: superiore sinistro e inferiore destro. 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 ben ordinati.

Il rettangolo di destinazione definito da DstRect può superare i limiti della superficie di destinazione, ma i sotto rettangoli non possono. Inoltre, tutti i rettangoli secondari sono garantiti per adattarsi all'interno della superficie di destinazione. I rettangoli secondari possono essere vincolati ulteriormente da un rettangolo di delimitazione inferiore al rettangolo di destinazione.

[in] SrcAllocationIndex

Indice dell'elemento nell'elenco di allocazione che specifica l'allocazione a cui fa riferimento il rettangolo di origine SrcRect.

[in] DstAllocationIndex

Indice dell'elemento nell'elenco di allocazione che specifica l'allocazione a cui fa riferimento il rettangolo di destinazione DstRect.

[in] NumSubRects

Numero di sotto rettangoli nello spazio della superficie di destinazione delimitato dal rettangolo di destinazione DstRect.

[in] pSubRects

Puntatore ai sotto rettangoli nello spazio della superficie di destinazione.

[in] SourceConstantAlpha

Fattore di fusione costante da applicare all'intera superficie di origine. Questo valore è compreso nell'intervallo di [0,255], dove 0 è completamente trasparente e 255 è completamente opaco.

[in] SourceHasAlpha

Definisce se si presuppone che la superficie abbia un canale alfa. Se TRUE, si presuppone che la superficie abbia un canale alfa; in caso contrario, il valore è FALSE.

[in] SrcPitch

Passo della superficie di origine, in byte.

Osservazioni

Se è necessaria un'operazione di trasferimento bitblt (bitblt), i rapporti di estensione x e y vengono calcolati rispettivamente come proporzioni delle dimensioni x e y del DstRect e membri di SrcRect e l'operazione di estensione procederà come se il valore COLORONCOLOR in *Wingdi.h sia impostato. In caso di trasferimento di blocchi di bit di compattazione, è necessario ignorare sufficienti pixel in modo che i pixel non debbano essere combinati. In un trasferimento di blocco di bit esteso, i pixel devono essere replicati.

Quando i rettangoli secondari vengono trasformati nello spazio della superficie di origine, il risultato è garantito che si trovi all'interno della superficie di origine. La trasformazione delle coordinate di un sotto rettangolo nella superficie di destinazione per le coordinate nella superficie di origine è definita dalle formule seguenti, dove:

(Xd, Yd) è un punto all'interno del rettangolo secondario
(Xs, Ys) è un punto all'interno del rettangolo di origine

float Ws = SrcRect.right - SrcRect.left;
float Wd = DstRect.right - DstRect.left;
int Xs = round((Xd - DstRect.left + 0.5) * Ws/Wd + SrcRect.left - 0.5)

// OR

int Xs = truncate((Xd - DstRect.left + 0.5) * Ws/Wd + SrcRect.left)

float Hs = SrcRect.bottom - SrcRect.top;
float Hd = DstRect.bottom - DstRect.top;
int Ys = round((Yd - DstRect.top + 0.5) * Hs/Hd + SrcRect.top - 0.5)

//OR

int Ys = truncate((Yd - DstRect.top + 0.5) * Hs/Hd + SrcRect.top)</code></pre>

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7
intestazione	d3dkmddi.h (include D3dkmddi.h)

Vedere anche

RECT

Condividi tramite