IWICJpegFrameDecode::SetIndexing 메서드(wincodec.h)
효율적인 임의 액세스를 위해 JPEG의 인덱싱을 사용하도록 설정합니다.
구문
HRESULT SetIndexing(
WICJpegIndexingOptions options,
UINT horizontalIntervalSize
);
매개 변수
options
나중에 IWICBitmapSource::CopyPixels를 호출할 때까지 인덱스를 즉시 생성할지 또는 연기할지를 지정하는 값입니다.
horizontalIntervalSize
형식: UINT
인덱싱의 세분성(픽셀)입니다.
반환 값
형식: HRESULT
성공적으로 완료되면 S_OK 반환합니다.
설명
이 방법을 사용하면 메모리 사용량을 희생하여 이미지 픽셀에 효율적으로 임의로 액세스할 수 있습니다. 인덱싱에 필요한 메모리 양은 요청된 인덱스 세분성에 따라 달라집니다. SetIndexing이 호출되지 않는 한 IWICBitmapSource::CopyPixels를 호출하는 동안 픽셀을 하향식으로 진행하여 JPEG에 액세스하는 것이 훨씬 더 효율적입니다.
인덱싱이 파일에서 지원되지 않는 경우 이 메서드는 실패합니다. 먼저 인덱싱이 지원되는지 여부를 확인하려면 IWICJpegFrameDecode::D oesSupportIndexing을 호출해야 합니다. 이 메서드를 여러 번 호출하는 경우 최종 호출은 인덱스 세분성을 요청된 크기로 변경합니다.
제공된 간격 크기는 인덱스 항목의 가로 간격을 제어합니다. 이 값은 JPEG의 MCU(최소 코딩된 단위) 크기에 따라 내부적으로 반올림되며, 일반적으로 크기가 조정되지 않은 픽셀은 8개 또는 16개입니다. 인덱스 간격의 세로 크기는 항상 하나의 MCU 크기와 같습니다.
인덱스를 즉시 생성하거나 나중에 IWICBitmapSource::CopyPixels 를 호출하여 중복 압축 해제 작업을 줄일 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | wincodec.h |
| 라이브러리 | Windowscodecs.lib |
| DLL | Windowscodecs.dll |