D3DXFilterTexture 함수

텍스처의 Mipmap 수준을 필터링합니다.

구문

HRESULT D3DXFilterTexture(
  _In_        LPDIRECT3DBASETEXTURE9 pBaseTexture,
  _Out_ const PALETTEENTRY           *pPalette,
  _In_        UINT                   SrcLevel,
  _In_        DWORD                  MipFilter
);

매개 변수

pBaseTexture [in]

형식: LPDIRECT3DBASETEXTURE9

필터링할 텍스처 개체를 나타내는 IDirect3DBaseTexture9 인터페이스에 대한 포인터입니다.

pPalette [out]

형식: const PALETTEENTRY*

채울 256색 팔레트를 나타내는 PALETTEENTRY 구조체에 대한 포인터이거나, 색이 지정되지 않은 형식의 경우 NULL 입니다. 색상표를 지정하지 않으면 기본 Direct3D 색상표(모든 불투명 흰색 색상표)가 제공됩니다. 설명 부분을 참조하세요.

SrcLevel [in]

형식: UINT

이미지를 사용하여 후속 수준을 생성하는 수준입니다. 이 매개 변수에 D3DX_DEFAULT 지정하는 것은 0을 지정하는 것과 같습니다.

MipFilter [in]

형식: DWORD

mipmap이 필터링되는 방법을 제어하는 하나 이상의 D3DX_FILTER 조합입니다. 이 매개 변수에 D3DX_DEFAULT 지정하는 것은 텍스처 크기가 2인 경우 D3DX_FILTER_BOX 지정하고 | D3DX_FILTER_BOX 것과 같습니다. 그렇지 않으면 D3DX_FILTER_DITHER.

반환 값

형식: HRESULT

함수가 성공하면 반환 값이 D3D_OK. 함수가 실패하면 반환 값은 D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA 중 하나일 수 있습니다.

설명

필터는 각 텍스처 수준에 재귀적으로 적용되어 다음 텍스처 수준을 생성합니다.

텍스처의 0이 아닌 표면에 쓰면 더티 사각형이 업데이트되지 않습니다. D3DXFilterTexture가 호출되고 표면이 아직 더티 않은 경우(일반적인 사용 시나리오에서는 불가능함) 애플리케이션은 텍스처에서 AddDirtyRect를 명시적으로 호출해야 합니다.

기본 풀(D3DPOOL_DEFAULT)에서 만든 텍스처는 개체에 잠금 작업이 필요하기 때문에 D3DXFilterTexture (D3DUSAGE_DYNAMIC 사용하여 만들지 않는 한)와 함께 사용할 수 없습니다. 잠금은 기본 풀의 텍스처에서 금지됩니다(동적이 아닌 경우).

PALETTEENTRY에 대한 자세한 내용은 플랫폼 SDK를 참조하세요. DirectX 8.0을 기준으로 PALETTEENTRY 구조체의 peFlags 멤버는 플랫폼 SDK에 설명된 대로 작동하지 않습니다. peFlags 멤버는 이제 8비트 팔레트 형식의 알파 채널입니다.

텍스처 필터링 함수는 하나뿐이지만 이 메서드를 호출하는 매크로는 두 개뿐입니다.

#define D3DXFilterCubeTexture D3DXFilterTexture
#define D3DXFilterVolumeTexture D3DXFilterTexture

요구 사항

요구 사항	값
헤더	D3dx9tex.h
라이브러리	D3dx9.lib

추가 정보

D3DX 9의 텍스처 함수