IDirectDrawSurface7::UpdateOverlay 메서드(ddraw.h)
오버레이 표면의 시각적 특성을 변경하거나 수정합니다. 이러한 표면에는 DDSCAPS_OVERLAY 플래그가 설정되어 있어야 합니다.
구문
HRESULT UpdateOverlay(
[in] LPRECT unnamedParam1,
[in] LPDIRECTDRAWSURFACE7 unnamedParam2,
[in] LPRECT unnamedParam3,
[in] DWORD unnamedParam4,
[in] LPDDOVERLAYFX unnamedParam5
);
매개 변수
[in] unnamedParam1
오버레이로 사용되는 원본 표면에서 영역의 x, y, 너비 및 높이를 정의하는 RECT 구조체에 대한 포인터입니다. 이 매개 변수는 오버레이를 숨기거나 전체 오버레이 표면을 사용하고 오버레이 표면이 디바이스 드라이버에 의해 적용되는 경계 및 크기 맞춤 제한을 준수함을 나타내는 NULL일 수 있습니다.
[in] unnamedParam2
오버레이되는 DirectDrawSurface 개체의 IDirectDrawSurface7 인터페이스에 대한 포인터입니다.
[in] unnamedParam3
오버레이를 이동해야 하는 대상 표면의 영역 너비, x 및 높이 y를 정의하는 RECT 구조체에 대한 포인터입니다. 이 매개 변수는 오버레이를 숨기는 NULL일 수 있습니다.
[in] unnamedParam4
오버레이 업데이트를 결정하는 다음 플래그의 조합입니다.
DDOVER_ADDDIRTYRECT
에뮬레이된 오버레이 표면에 더티 사각형을 추가합니다.
DDOVER_ALPHADEST
사용되지 않습니다.
DDOVER_ALPHADESTCONSTOVERRIDE
DDOVERLAYFX 구조체의 dwAlphaDestConst 멤버를 이 오버레이의 대상 알파 채널로 사용합니다.
DDOVER_ALPHADESTNEG
알파 값이 증가함에 따라 대상 표면이 더 투명해지게 됨을 나타냅니다(0은 불투명).
DDOVER_ALPHADESTSURFACEOVERRIDE
DDOVERLAYFX 구조체의 lpDDSAlphaDest 멤버를 이 오버레이의 알파 채널 대상으로 사용합니다.
DDOVER_ALPHAEDGEBLEND
DDOVERLAYFX 구조체의 dwAlphaEdgeBlend 멤버를 색 키 색과 경계를 지정하는 이미지 가장자리의 알파 채널로 사용합니다.
DDOVER_ALPHASRC
픽셀 형식의 알파 정보 또는 원본 표면에 연결된 알파 채널 표면을 이 오버레이의 원본 알파 채널로 사용합니다.
DDOVER_ALPHASRCCONSTOVERRIDE
DDOVERLAYFX 구조체의 dwAlphaSrcConst 멤버를 이 오버레이의 원본 알파 채널로 사용합니다.
DDOVER_ALPHASRCNEG
알파 값이 증가함에 따라 원본 표면이 더 투명해지게 됨을 나타냅니다(0은 불투명).
DDOVER_ALPHASRCSURFACEOVERRIDE
DDOVERLAYFX 구조체의 lpDDSAlphaSrc 멤버를 이 오버레이의 알파 채널 원본으로 사용합니다.
DDOVER_ARGBSCALEFACTORS
DirectX 7.0의 새로운 기능입니다. DDOVERLAYFX 구조에 유효한 ARGB 배율 인수가 포함되어 있음을 나타냅니다.
DDOVER_AUTOFLIP
비디오 포트 VSYNC가 발생할 때마다 대칭 이동 체인의 다음 화면으로 자동으로 대칭 이동합니다.
DDOVER_BOB
아티팩트가 표시되지 않고 인터레이스된 비디오 스트림의 각 필드를 개별적으로 표시합니다.
DDOVER_BOBHARDWARE
Bob 작업은 소프트웨어를 사용하거나 에뮬레이트하는 대신 하드웨어를 사용하여 수행됩니다. 이 플래그는 DDOVER_BOB 플래그와 함께 사용해야 합니다.
DDOVER_DDFX
lpDDOverlayFx 매개 변수의 오버레이 FX 플래그를 사용하여 특수 오버레이 효과를 정의합니다.
DDOVER_DEGRADEARGBSCALING
DirectX 7.0의 새로운 기능입니다. ARGB 배율 인수는 드라이버 기능에 맞게 저하될 수 있습니다.
DDOVER_HIDE
이 오버레이를 끕니다.
DDOVER_INTERLEAVED
표면 메모리는 인터리브 필드로 구성됩니다.
DDOVER_KEYDEST
대상 표면과 연결된 색 키를 사용합니다.
DDOVER_KEYDESTOVERRIDE
DDOVERLAYFX 구조체의 dckDestColorkey 멤버를 대상 표면의 색 키로 사용합니다.
DDOVER_KEYSRC
원본 표면과 연결된 색 키를 사용합니다.
DDOVER_KEYSRCOVERRIDE
DDOVERLAYFX 구조체의 dckSrcColorkey 멤버를 원본 표면의 색 키로 사용합니다.
DDOVER_OVERRIDEBOBWEAVE
Bob 및 직조 결정은 다른 인터페이스에 의해 재정의되어서는 안됩니다.
DDOVER_REFRESHALL
에뮬레이된 오버레이된 표면에서 전체 표면을 다시 그립니다.
DDOVER_REFRESHDIRTYRECTS
에뮬레이된 표면에서 모든 더티 사각형을 다시 그립니다.
DDOVER_SHOW
이 오버레이를 켭니다.
[in] unnamedParam5
사용할 효과를 설명하는 DDOVERLAYFX 구조체에 대한 포인터입니다. DDOVER_DDFX 플래그가 지정되지 않은 경우 NULL일 수 있습니다.
반환 값
메서드가 성공하면 반환 값이 DD_OK.
실패하면 메서드는 다음 오류 값 중 하나를 반환할 수 있습니다.
- DDERR_DEVICEDOESNTOWNSURFACE
- DDERR_GENERIC
- DDERR_HEIGHTALIGN
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDRECT
- DDERR_INVALIDSURFACETYPE
- DDERR_NOSTRETCHHW
- DDERR_NOTAOVERLAYSURFACE
- DDERR_OUTOFCAPS
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_XALIGN
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | ddraw.h |
| 라이브러리 | Ddraw.lib |
| DLL | Ddraw.dll |