Vue d’ensemble de l’API WIC

Le composant d’acquisition d’images (WIC) Windows fournit une API COM (Component Object Model) à utiliser en C et C++. L’API WIC expose une variété de fonctionnalités liées à l’image, notamment :

  • Codecs intégrés pour les formats d’image web standard.
  • Prise en charge intégrée des formats de métadonnées standard.
  • Large plage de prise en charge du format de pixel.
  • Prise en charge haute couleur ; y compris la plage étendue 30 bits, la haute précision 30 bits et les formats de pixels de haute précision 48 bits et larges.
  • Framework extensible pour les codecs d’image, les formats de pixels et les formats de métadonnées.

Cette rubrique contient les rubriques suivantes.

Fichiers d’en-tête WIC

Les API WIC sont définies dans les fichiers IDL (Interface Definition Language) suivants :

Fichier Description
wincodec.h Définit les versions C et C++ des API WIC principales.
wincodec.idl Définit les interfaces WIC principales.
wincodecsdk.h Définit les versions C et C++ des API WIC de métadonnées.
wincodecsdk.idl Définit les interfaces de métadonnées WIC.
wincodec_proxy.h Définit les exportations de proxy WIC.

 

Pour utiliser WIC, vos applications doivent inclure wincodec.h et/ou wincodecsdk.h, en fonction de l’API dont votre application a besoin.

Fichiers de bibliothèque

Fichiers de bibliothèque WIC :

Fichier Description
windowscodecs.lib Importer la bibliothèque fournie par le Kit de développement logiciel (SDK) Windows.
windowscodecs.dll Bibliothèque d’implémentation de stock fournie par le système d’exploitation.

 

Pour créer un lien vers des API WIC, votre application doit inclure windowscodec.lib comme dépendance supplémentaire de l’éditeur de liens.

Fabriques de classes

Le tableau suivant décrit les deux fabriques de classes COM que les API WIC fournissent pour créer des composants WIC.

Interface de fabrique Description
IWICImagingFactory Fabrique de classe principale pour le développement d’applications à l’aide de composants WIC. Cette fabrique crée des composants tels que les décodeurs d’images, les encodeurs et les flux.
IWICComponentFactory Fabrique de classes ciblée pour les développeurs de composants WIC. Les composants créés à partir de cette fabrique sont principalement utilisés dans le développement de codecs et de gestionnaires de métadonnées.

 

Pour créer l’une ou l’autre fabrique de classes, utilisez la fonction COM CoCreateInstance . L’exemple suivant illustre la création de la fabrique d’imagerie WIC.

// Initialize COM
CoInitialize(NULL);

// The factory pointer
IWICImagingFactory *pFactory = NULL;

// Create the COM imaging factory
HRESULT hr = CoCreateInstance(
    CLSID_WICImagingFactory,
    NULL,
    CLSCTX_INPROC_SERVER,
    IID_PPV_ARGS(&pFactory)
);

Composants d’acquisition d’images

Les API WIC fournissent plusieurs types de composants d’imagerie. Le tableau suivant décrit certains des composants WIC courants. Pour obtenir la liste complète des composants disponibles, consultez les interfaces WIC.

Type de composant Description
Bitmap Représente une représentation en mémoire accessible en écriture d’un IWICBitmapSource.
Décodeur Utilisé pour décoder les données d’image d’un flux dans un format utile pour le traitement d’images.
Encodeur Écrit des données d’image dans un flux.
Flux Utilisé pour lire et écrire des données à partir d’un fichier, d’une ressource réseau, d’un bloc de mémoire, et ainsi de suite.
Convertisseur de format Utilisé pour convertir d’un format de pixel en un autre.
Lecteur de requête de métadonnées Permet de lire les métadonnées d’une image ou d’un cadre d’image.
Enregistreur de requêtes de métadonnées Permet d’écrire des métadonnées dans une image ou un cadre d’image.

 

Voir aussi

Informations de référence

Exemples et exemples de code