IWICDdsDecoder::GetFrame 메서드(wincodec.h)
DDS 이미지의 지정된 프레임을 검색합니다.
구문
HRESULT GetFrame(
[in] UINT arrayIndex,
[in] UINT mipLevel,
[in] UINT sliceIndex,
[out] IWICBitmapFrameDecode **ppIBitmapFrame
);
매개 변수
[in] arrayIndex
형식: UINT
텍스처 배열 내에서 요청된 인덱스입니다.
[in] mipLevel
형식: UINT
요청된 밉 수준입니다.
[in] sliceIndex
형식: UINT
3D 텍스처 내에서 요청된 조각입니다.
[out] ppIBitmapFrame
형식: IWICBitmapFrameDecode**
IWICBitmapFrameDecode 개체에 대한 포인터입니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
DDS 파일에는 3단계 계층 구조로 구성된 여러 이미지가 포함될 수 있습니다. 먼저 DDS 파일에는 텍스처 배열에 여러 텍스처가 포함될 수 있습니다. 둘째, 각 텍스처에는 여러 밉 수준이 있을 수 있습니다. 마지막으로 텍스처는 3D(볼륨) 텍스처일 수 있으며 여러 조각이 있으며, 각 조각은 2D 텍스처입니다. 자세한 내용은 DDS 설명서를 참조하세요.
WIC는 이 세 수준 계층을 IWICBitmapDecoder::GetFrame을 통해 액세스할 수 있는 IWICBitmapFrameDecode의 선형 배열 에 매핑합니다. 그러나 3D 텍스처의 각 밉 수준에는 깊이(조각 수)가 다르기 때문에 arrayIndex, mipLevel 및 sliceIndex 값의 triad에 해당하는 프레임을 결정하는 것은 간단하지 않습니다. 이 메서드는 세 개의 인덱스가 지정된 올바른 프레임을 계산하여 DDS 이미지에 대한 IWICBitmapDecoder::GetFrame 을 통해 추가 편의성을 제공합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8.1 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2012 R2 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | wincodec.h |
| 라이브러리 | Windowscodecs.lib |
| DLL | Windowscodecs.dll |