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 |