Méthode IWICJpegFrameDecode ::SetIndexing (wincodec.h)

Active l’indexation du fichier JPEG pour un accès aléatoire efficace.

Syntaxe

HRESULT SetIndexing(
  WICJpegIndexingOptions options,
  UINT                   horizontalIntervalSize
);

Paramètres

options

Type : WICJpegIndexingOptions

Valeur spécifiant si les index doivent être générés immédiatement ou différés jusqu’à un appel ultérieur à IWICBitmapSource ::CopyPixels.

horizontalIntervalSize

Type : UINT

Granularité de l’indexation, en pixels.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite de l’exécution.

Remarques

Cette méthode permet un accès aléatoire efficace aux pixels d’image au détriment de l’utilisation de la mémoire. La quantité de mémoire requise pour l’indexation dépend de la granularité d’index demandée. Sauf si SetIndexing est appelé, il est beaucoup plus efficace d’accéder à un fichier JPEG en progressant dans ses pixels de haut en bas pendant les appels à IWICBitmapSource ::CopyPixels.

Cette méthode échoue si l’indexation n’est pas prise en charge sur le fichier. IWICJpegFrameDecode ::D oesSupportIndexing doit d’abord être appelé pour déterminer si l’indexation est prise en charge. Si cette méthode est appelée plusieurs fois, l’appel final remplace la granularité de l’index par la taille demandée.

La taille d’intervalle fournie contrôle l’espacement horizontal des entrées d’index. Cette valeur est arrondie en interne en fonction de la taille MCU (unité codée minimale) du JPEG, qui est généralement de 8 ou 16 pixels non mis à l’échelle. La taille verticale de l’intervalle d’index est toujours égale à une taille MCU.

Les index peuvent être générés immédiatement ou lors des appels futurs à IWICBitmapSource ::CopyPixels pour réduire le travail de décompression redondant.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	wincodec.h
Bibliothèque	Windowscodecs.lib
DLL	Windowscodecs.dll

Voir aussi

IWICBitmapSource ::CopyPixels

IWICJpegFrameDecode

IWICJpegFrameDecode ::ClearIndexing

IWICJpegFrameDecode ::D oesSupportIndexing