Metodo IWICJpegFrameDecode::SetIndexing (wincodec.h)

Consente l'indicizzazione del JPEG per un accesso casuale efficiente.

Sintassi

HRESULT SetIndexing(
  WICJpegIndexingOptions options,
  UINT                   horizontalIntervalSize
);

Parametri

options

Tipo: WICJpegIndexingOptions

Valore che specifica se gli indici devono essere generati immediatamente o posticipati fino a una chiamata futura a IWICBitmapSource::CopyPixels.

horizontalIntervalSize

Tipo: UINT

Granularità dell'indicizzazione, in pixel.

Valore restituito

Tipo: HRESULT

Restituisce S_OK al completamento corretto.

Commenti

Questo metodo consente l'accesso casuale efficiente ai pixel dell'immagine a spese dell'utilizzo della memoria. La quantità di memoria necessaria per l'indicizzazione dipende dalla granularità dell'indice richiesta. A meno che setIndexing non venga chiamato, è molto più efficiente accedere a un JPEG eseguendo lo stato superiore dei pixel durante le chiamate a IWICBitmapSource::CopyPixels.

Questo metodo avrà esito negativo se l'indicizzazione non è supportata nel file. IWICJpegFrameDecode::D oesSupportIndexing deve essere chiamato per determinare prima se l'indicizzazione è supportata. Se questo metodo viene chiamato più volte, la chiamata finale modifica la granularità dell'indice alle dimensioni richieste.

La dimensione dell'intervallo specificata controlla la spaziatura orizzontale delle voci di indice. Questo valore viene arrotondato internamente in base alla dimensione MCU (unità minima codificata) di JPEG, che in genere è 8 o 16 pixel non ridimensionati. Le dimensioni verticali dell'intervallo di indice sono sempre uguali a una dimensione MCU.

Gli indici possono essere generati immediatamente o durante le chiamate future a IWICBitmapSource::CopyPixels per ridurre il lavoro di decompressione ridondante.

Requisiti

Vedi anche

IWICBitmapSource::CopyPixels

IWICJpegFrameDecode

IWICJpegFrameDecode::ClearIndexing

IWICJpegFrameDecode::D oesSupportIndexing