IDirect3DCubeTexture9::AddDirtyRect 메서드(d3d9.h)

아티클
08/23/2023

큐브 텍스처 리소스에 더티 영역을 추가합니다.

구문

HRESULT AddDirtyRect(
  [in] D3DCUBEMAP_FACES FaceType,
  [in] const RECT       *pDirtyRect
);

매개 변수

[in] FaceType

형식: D3DCUBEMAP_FACES

큐브 맵 얼굴을 식별하는 D3DCUBEMAP_FACES 열거형 형식의 멤버입니다.

[in] pDirtyRect

형식: const RECT*

더티 영역을 지정하는 RECT 구조체에 대한 포인터입니다. NULL을 지정하면 전체 큐브 텍스처를 포함하도록 더티 영역이 확장됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값은 D3DERR_INVALIDCALL 일 수 있습니다.

설명

성능상의 이유로 더티 영역은 텍스처의 수준 0에 대해서만 기록됩니다. sublevels의 경우 해당(크기 조정된) 사각형 또는 상자도 더티 가정합니다. 더티 지역은 IDirect3DCubeTexture9::LockRect가 D3DLOCK_NO_DIRTY_UPDATE 또는 D3DLOCK_READONLY 없이 호출될 때 자동으로 기록됩니다. IDirect3DDevice9::UpdateSurface의 대상 화면도 자동으로 더티 표시됩니다.

D3DLOCK_NO_DIRTY_UPDATE 사용하고 더티 지역을 명시적으로 지정하면 IDirect3DDevice9::UpdateTexture의 효율성을 높일 수 있습니다. 애플리케이션은 이 메서드를 사용하여 리소스에 더티 지역을 지정하여 복사되는 리소스의 하위 집합을 최적화할 수 있습니다. 그러나 맞춤을 최적화하기 위해 더티 영역을 확장할 수 있습니다.