D3DXLoadVolumeFromMemory 함수

  • 아티클

메모리에서 볼륨을 로드합니다.

구문

HRESULT D3DXLoadVolumeFromMemory(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPCVOID           pSrcMemory,
  _In_       D3DFORMAT         SrcFormat,
  _In_       UINT              SrcRowPitch,
  _In_       UINT              SrcSlicePitch,
  _In_ const PALETTEENTRY      *pSrcPalette,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey
);

매개 변수

pDestVolume [in]

형식: LPDIRECT3DVOLUME9

IDirect3DVolume9 인터페이스에 대한 포인터입니다. 이미지를 수신하는 대상 볼륨을 지정합니다.

pDestPalette [in]

형식: const PALETTEENTRY*

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

pDestBox [in]

형식: const D3DBOX*

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

pSrcMemory [in]

형식: LPCVOID

메모리에서 원본 볼륨의 왼쪽 위 모서리에 대한 포인터입니다.

SrcFormat [in]

형식: D3DFORMAT

원본 볼륨의 픽셀 형식인 D3DFORMAT 열거형 형식의 멤버입니다.

SrcRowPitch [in]

형식: UINT

원본 이미지의 피치(바이트)입니다. DXT 형식(압축된 텍스처 형식)의 경우 이 숫자는 한 행의 셀 크기를 바이트 단위로 나타내야 합니다.

SrcSlicePitch [in]

형식: UINT

원본 이미지의 피치(바이트)입니다. DXT 형식(압축된 텍스처 형식)의 경우 이 숫자는 셀 한 조각의 크기를 바이트 단위로 나타내야 합니다.

pSrcPalette [in]

형식: const PALETTEENTRY*

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

pSrcBox [in]

형식: const D3DBOX*

D3DBOX 구조체에 대한 포인터입니다. 원본 상자를 지정합니다. NULL 이 이 매개 변수에 유효한 값이 아닙니다.

필터 [in]

형식: DWORD

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

ColorKey [in]

형식: D3DCOLOR

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

반환 값

형식: HRESULT

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

설명

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

요구 사항

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

추가 정보

D3DXLoadVolumeFromFile

D3DXLoadVolumeFromResource

D3DXLoadVolumeFromVolume

D3DX 9의 텍스처 함수