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
- Fichiers de bibliothèque
- Fabriques de classes
- Composants d’acquisition d’images
- Voir aussi
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