Vue d’ensemble de l’API WIC

Le composant WIC (Windows Imaging Component) fournit une API COM (Component Object Model) pour une utilisation en C et C++. L’API WIC expose une variété de fonctionnalités liées aux images, 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 éventail de formats de pixels pris en charge.
  • Prise en charge des couleurs élevées ; y compris les formats de plage étendue 30 bits, haute précision 30 bits et 48 bits haute précision et pixels larges.
  • Infrastructure 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 d’en-tête et d’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 Bibliothèque d’importation 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 établir un lien vers des API WIC, votre application doit inclure windowscodec.lib en tant que 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 des décodeurs d’images, des encodeurs et des 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’images 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 Interfaces WIC.

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