DXGK_GDIARG_TRANSPARENTBLT 구조체(d3dkmddi.h)
DXGK_GDIARG_TRANSPARENTBLT 구조는 투명도를 사용하여 GDI 하드웨어 가속 비트 블록 전송(비트블릿) 작업의 특징을 설명합니다.
통사론
typedef struct _DXGK_GDIARG_TRANSPARENTBLT {
[in] RECT SrcRect;
[in] RECT DstRect;
UINT SrcAllocationIndex;
UINT DstAllocationIndex;
UINT Color;
UINT NumSubRects;
RECT *pSubRects;
D3DKM_TRANSPARENTBLTFLAGS Flags;
UINT SrcPitch;
} DXGK_GDIARG_TRANSPARENTBLT;
회원
[in] SrcRect
복사할 사각형 영역을 정의하는 RECT 구조체입니다. 이 사각형은 원본 표면의 좌표계에 지정되며 왼쪽 위와 오른쪽 아래의 두 점으로 정의됩니다. 사각형을 정의하는 두 지점은 항상 순서가 잘 정렬됩니다.
자세한 내용은 설명 섹션을 참조하세요.
[in] DstRect
수정할 사각형 영역을 정의하는 RECT 구조체입니다. 이 사각형은 대상 표면의 좌표계에 지정되며 왼쪽 위와 오른쪽 아래의 두 점으로 정의됩니다. 사각형은 오른쪽 아래에만 있습니다. 즉, 아래쪽 및 오른쪽 가장자리는 비트 블록 전송의 일부가 아닙니다. 사각형을 정의하는 두 지점은 항상 순서가 잘 정렬됩니다.
DstRect 정의된 대상 사각형은 대상 표면의 범위를 초과할 수 있지만 하위 사각형은 사용할 수 없습니다. 또한 모든 하위 사각형은 대상 표면 내부에 맞도록 보장됩니다. 하위 사각형은 대상 사각형보다 작은 경계 사각형에 의해 추가로 제한될 수 있습니다.
자세한 내용은 설명 섹션을 참조하세요.
SrcAllocationIndex
[in] SrcRect 원본 사각형에서 참조하는 할당을 지정하는 할당 목록의 요소 인덱스입니다.
DstAllocationIndex
[in] DstRect 대상 사각형에서 참조하는 할당을 지정하는 할당 목록의 요소 인덱스입니다.
Color
[in] 소스 표면의 실제 투명 색을 32비트 ARGB 부호 없는 픽셀 형식으로 지정합니다(D3DDDIFORMAT 열거형의 D3DDDIFMT_A8R8G8B8 값으로 정의됨). Color 지정된 투명한 색과 일치하는 원본 표면의 픽셀은 복사되지 않습니다.
NumSubRects
[in] DstRect 대상 사각형으로 경계가 지정된 대상 표면 공간의 하위 사각형 수입니다.
pSubRects
[in] 대상 표면 공간의 하위 사각형에 대한 포인터입니다.
Flags
[in] 디스플레이 어댑터의 하드웨어 가속 투명 비트 블록 전송 기능을 지정하는 D3DKM_TRANSPARENTBLTFLAGS 구조체입니다.
SrcPitch
[in] 소스 표면의 피치(바이트)입니다.
발언
SrcRect 및 DstRect 멤버에 의해 지정된 사각형은 원본 및 대상 표면 공간의 모든 하위 사각형을 각각 바인딩합니다. 원본 및 대상 사각형이 동일한 화면에서 겹치는 경우 Microsoft DirectX 그래픽 커널 하위 시스템은 투명한 비트 블록 전송을 요청하지 않습니다.
투명한 비트 블록 전송 작업을 완료하려면 다음 수식을 사용하여 DstRect 각 픽셀의 색을 계산해야 합니다.
typedef DXGK_GDIARG_TRANSPARENTBLT tblt;
if (tblt.Flags.HonorAlpha)
{
if (SourceColor != tblt.Color)
{
DestinationColor = SourceColor;
}
}
else
{
if ((SourceColor & 0x00FFFFFF) != tblt.Color)
{
DestinationColor = SourceColor;
}
}
이 경우 ARGB 형식의 0x00FFFFFF 값은 alpha = 0을 나타내므로 알파 혼합이 구현되지 않습니다.
스트레치 비트 블록 전송 작업이 필요한 경우 x 및 y 스트레치 비율은 각각 DstRect 및 SrcRectx 및 y 크기의 비율로 계산됩니다. 또한 stretch 연산은 Wingdi.h COLORONCOLOR 값이 설정된 것처럼 진행됩니다. 축소된 비트 블록 전송에서는 픽셀을 결합할 필요가 없도록 충분한 픽셀을 무시해야 합니다. 확장 비트 블록 전송에서 픽셀을 복제해야 합니다.
투명한 비트 블록 전송에 대한 자세한 내용은 비트맵 복사참조하세요.
하위 사각형을 원본 표면 공간으로 변환하면 결과가 원본 표면 내에 있도록 보장됩니다. 대상 표면의 하위 사각형 좌표를 원본 표면의 좌표로 변환하는 방법은 다음 수식에 의해 정의됩니다.
- (Xd, Yd)는 하위 사각형 내의 점입니다.
- (Xs, Ys)는 원본 사각형 내의 지점입니다.
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)
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 |
| 헤더 | d3dkmddi.h(D3dkmddi.h 포함) |