D3DXLoadVolumeFromResource 함수

리소스에서 볼륨을 로드합니다.

구문

HRESULT D3DXLoadVolumeFromResource(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       HMODULE           hSrcModule,
  _In_       LPCSTR            pSrcResource,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey,
  _In_       D3DXIMAGE_INFO    *pSrcInfo
);

매개 변수

pDestVolume [in]

형식: LPDIRECT3DVOLUME9

IDirect3DVolume9 인터페이스에 대한 포인터입니다. 대상 볼륨을 지정합니다.

pDestPalette [in]

형식: const PALETTEENTRY*

PALETTEENTRY 구조체, 256색 또는 NULL의 대상 팔레트에 대한 포인터입니다.

pDestBox [in]

형식: const D3DBOX*

D3DBOX 구조체에 대한 포인터입니다. 대상 상자를 지정합니다. 이 매개 변수를 NULL 로 설정하여 전체 볼륨을 지정합니다.

hSrcModule [in]

형식: HMODULE

리소스가 있는 모듈 또는 현재 프로세스를 만드는 데 사용되는 운영 체제 이미지와 연결된 모듈의 경우 NULL 을 처리합니다.

pSrcResource [in]

형식: LCSTTR

원본 이미지의 파일 이름을 지정하는 문자열에 대한 포인터입니다. UNICODE 또는 _UNICODE 정의된 경우 이 매개 변수 형식은 LPCWSTR이고, 그렇지 않으면 형식은 LPCSTR입니다.

pSrcBox [in]

형식: const D3DBOX*

D3DBOX 구조체에 대한 포인터입니다. 원본 상자를 지정합니다. 이 매개 변수를 NULL 로 설정하여 전체 볼륨을 지정합니다.

필터 [in]

형식: DWORD

하나 이상의 D3DX_FILTER 조합하여 이미지를 필터링하는 방법을 제어합니다. 이 매개 변수에 대한 D3DX_DEFAULT 지정하는 것은 D3DX_FILTER_TRIANGLE 지정하는 것과 같습니다. | D3DX_FILTER_DITHER.

ColorKey [in]

형식: D3DCOLOR

투명 검정으로 바꿀 D3DCOLOR 값 또는 colorkey를 사용하지 않도록 설정하는 0입니다. 원본 이미지 형식과 관계없이 항상 32비트 ARGB 색입니다. 알파는 중요하며 일반적으로 불투명 색 키의 경우 FF로 설정해야 합니다. 따라서 불투명 검정의 경우 값은 0xFF000000 같습니다.

pSrcInfo [in]

형식: D3DXIMAGE_INFO*

원본 이미지 파일 또는 NULL의 데이터에 대한 설명으로 채워질 D3DXIMAGE_INFO 구조체에 대한 포인터입니다.

반환 값

형식: HRESULT

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

설명

로드되는 리소스는 비트맵 리소스(RT_BITMAP)여야 합니다.

이 함수는 압축된 텍스처 형식으로의 변환을 처리합니다.

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

이 함수는 유니코드 및 ANSI 문자열을 모두 지원합니다.

요구 사항

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

추가 정보

D3DXLoadVolumeFromFile

D3DXLoadVolumeFromFileInMemory

D3DXLoadVolumeFromMemory

D3DXLoadVolumeFromVolume

D3DX 9의 텍스처 함수