IWICJpegFrameDecode::SetIndexing 메서드(wincodec.h)

  • 아티클

효율적인 임의 액세스를 위해 JPEG의 인덱싱을 사용하도록 설정합니다.

구문

HRESULT SetIndexing(
  WICJpegIndexingOptions options,
  UINT                   horizontalIntervalSize
);

매개 변수

options

형식: WICJpegIndexingOptions

나중에 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

추가 정보

IWICBitmapSource::CopyPixels

IWICJpegFrameDecode

IWICJpegFrameDecode::ClearIndexing

IWICJpegFrameDecode::D oesSupportIndexing