IDirect3DDevice9::CreateVolumeTexture 메서드(d3d9helper.h)

아티클
02/28/2024

볼륨 텍스처 리소스를 만듭니다.

구문

HRESULT CreateVolumeTexture(
  [in]          UINT                    Width,
  [in]          UINT                    Height,
  [in]          UINT                    Depth,
  [in]          UINT                    Levels,
  [in]          DWORD                   Usage,
  [in]          D3DFORMAT               Format,
  [in]          D3DPOOL                 Pool,
  [out, retval] IDirect3DVolumeTexture9 **ppVolumeTexture,
  [in]          HANDLE                  *pSharedHandle
);

매개 변수

[in] Width

형식: UINT

볼륨 텍스처의 최상위 수준 너비(픽셀)입니다. D3DCAPS9 D3DPTEXTURECAPS_VOLUMEMAP_POW2 멤버가 설정된 경우 이 값은 2 의 힘이어야 합니다. 후속 수준의 픽셀 차원은 이전 수준의 픽셀 차원의 절반에 대한 잘린 값입니다(독립적으로). 각 차원은 1픽셀 크기로 고정됩니다. 따라서 2로 나누면 0이 되고 1이 대신 수행됩니다. 드라이버가 지원하는 최대 차원(너비, 높이 및 깊이)은 D3DCAPS9 MaxVolumeExtent에서 찾을 수 있습니다.

[in] Height

형식: UINT

볼륨 텍스처의 최상위 수준 높이(픽셀)입니다. D3DCAPS9 D3DPTEXTURECAPS_VOLUMEMAP_POW2 멤버가 설정된 경우 이 값은 2 의 힘이어야 합니다. 후속 수준의 픽셀 차원은 이전 수준의 픽셀 차원의 절반에 대한 잘린 값입니다(독립적으로). 각 차원은 1픽셀 크기로 고정됩니다. 따라서 2로 나누면 0이 되고 1이 대신 수행됩니다. 드라이버가 지원하는 최대 차원(너비, 높이 및 깊이)은 D3DCAPS9 MaxVolumeExtent에서 찾을 수 있습니다.

[in] Depth

형식: UINT

볼륨 텍스처의 최상위 수준 깊이(픽셀)입니다. D3DCAPS9 D3DPTEXTURECAPS_VOLUMEMAP_POW2 멤버가 설정된 경우 이 값은 2 의 힘이어야 합니다. 후속 수준의 픽셀 차원은 이전 수준의 픽셀 차원의 절반에 대한 잘린 값입니다(독립적으로). 각 차원은 1픽셀 크기로 고정됩니다. 따라서 2로 나누면 0이 되고 1이 대신 수행됩니다. 드라이버가 지원하는 최대 차원(너비, 높이 및 깊이)은 D3DCAPS9 MaxVolumeExtent에서 찾을 수 있습니다.

[in] Levels

형식: UINT

텍스처의 수준 수입니다. 이 값이 0이면 Direct3D는 mipmapped 볼륨 텍스처를 지원하는 하드웨어의 경우 모든 텍스처 하위 텍스처를 1x1 픽셀까지 생성합니다. IDirect3DBaseTexture9::GetLevelCount를 호출하여 생성된 수준 수를 확인합니다.

[in] Usage

형식: DWORD

사용량 값이 없음을 나타내는 0일 수 있습니다. 사용이 필요한 경우 D3DUSAGE_DYNAMIC 또는 D3DUSAGE_SOFTWAREPROCESSING 사용합니다. 자세한 내용은 D3DUSAGE.

[in] Format

형식: D3DFORMAT

볼륨 텍스처의 모든 수준 형식을 설명하는 D3DFORMAT 열거형 형식의 멤버입니다.

[in] Pool

형식: D3DPOOL

볼륨 텍스처를 배치해야 하는 메모리 클래스를 설명하는 D3DPOOL 열거형 형식의 멤버입니다.

[out, retval] ppVolumeTexture

형식: IDirect3DVolumeTexture9**

생성된 볼륨 텍스처 리소스를 나타내는 IDirect3DVolumeTexture9 인터페이스에 대한 포인터의 주소입니다.