> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Windows Imaging Component (WIC) sur XBOX

> Fonctionnalités de Windows Imaging Component (WIC) disponibles dans le GDK XBOX pour encoder, décoder et manipuler les formats BMP, JPG, PNG, GIF, TIFF, ICO et DDS.

Cette rubrique décrit les fonctionnalités de Windows Imaging Component (WIC) disponibles dans le Microsoft Game Development Kit (GDK).

La majorité des fonctionnalités de WIC sont disponibles pour encoder, décoder et manipuler les formats d'image courants. Ces fonctionnalités sont similaires à celles de la version ERA de WIC, avec certaines améliorations en matière de signalement des erreurs et de stabilité. Les fonctionnalités de WIC sur ERA et sur le Microsoft Game Development Kit (GDK) sont toutes deux des sous-ensembles des fonctionnalités de WIC sur Windows.

Pour les développeurs qui connaissent WIC sur Windows, cette rubrique fournit une courte liste des exceptions de fonctionnalités sur le Microsoft Game Development Kit (GDK). Les autres développeurs peuvent se reporter à l'ensemble complet des fonctionnalités de WIC décrites dans les sections suivantes.

## Différences par rapport à WIC pour Windows

* Prise en charge intégrée des codecs BMP, JPG, PNG, GIF, TIFF, ICO et DDS. JPEG-XR/HD Photo n'est pas pris en charge.
* Si vous utilisez le format BMP avec la compression BI\_BITFIELDS, seuls les formats 16bppBGR555, 16bppBGR565 et 32bppBGRA sont pris en charge.
* Les formats cyan-magenta-jaune-noir (CMJN), à plage dynamique élevée, les formats de pixels à virgule flottante demi-précision, les formats de pixels à virgule fixe et les images de plus de quatre canaux ne sont pas pris en charge.
* Les formats de pixels 32bppRGBE, 16bppYQuantizedDctCoefficients, 16bppCbQuantizedDctCoefficients et 16bppCrQuantizedDctCoefficients ne sont pas pris en charge.
* La lecture et l'écriture des métadonnées XMP ou des [stratégies de métadonnées de photos](https://learn.microsoft.com/windows/win32/wic/photo-metadata-policies) ne sont pas prises en charge. Lors du transcodage, l'API tente de conserver les métadonnées XMP si possible.
* La manipulation et la conversion d'espaces colorimétriques (c'est-à-dire IWICColorTransform) ne sont pas prises en charge.
* Les points d'entrée Windows Runtime vers WIC (c'est-à-dire les méthodes de Windows::Graphics::Imaging) ne sont pas pris en charge.
* Les méthodes d'interopérabilité GDI, GDI+ et D2D ne sont pas prises en charge : **CreateBitmapFromHBITMAP**, **CreateBitmapFromHIcon** et **IWICImagingFactory2::CreateImageEncoder**.
* **IWICPixelFormatInfo::GetColorContext** n'est pas pris en charge. Notez que **IWICBitmapFrameDecode::GetColorContexts** et **IWICBitmapDecoder::GetColorContexts** sont toujours pris en charge.
* Il existe certaines différences entre Direct3D sur XBOX One et sur Windows concernant WIC. Vous trouverez plus de détails dans la rubrique [Création et utilisation de Direct3D sur XBOX One](/fr/build/core-features/graphics/directx/creation-flags).

## Fonctionnalités de WIC pour le Microsoft Game Development Kit (GDK)

Les principales fonctionnalités de WIC sont les suivantes.

* Permet aux développeurs d'applications d'effectuer des opérations de traitement d'image sur n'importe quel format d'image au moyen d'un ensemble unique et cohérent d'interfaces communes, sans nécessiter de connaissance préalable des formats d'image spécifiques
* Fournit une architecture extensible « plug and play » pour les codecs d'image, les formats de pixels et les métadonnées, avec découverte automatique des nouveaux formats à l'exécution
* Prend en charge la lecture et l'écriture de métadonnées arbitraires dans les fichiers image, avec la possibilité de conserver les métadonnées non reconnues lors de la modification
* Préserve les données d'image à profondeur de bits élevée, jusqu'à 32 bits par canal, tout au long du pipeline de traitement d'image
* Fournit une prise en charge intégrée des formats d'image, formats de pixels et schémas de métadonnées les plus courants

## Codecs natifs pour le Microsoft Game Development Kit (GDK)

WIC inclut plusieurs codecs intégrés. Le tableau suivant présente les codecs standard fournis avec la plateforme.

| Codec | Types MIME | Décodeurs | Encodeurs |
| - | - | - | - |
| BMP (Windows Bitmap Format), spécification BMP v5. | image/bmp | Oui | Oui |
| GIF (Graphics Interchange Format 89a), spécification GIF 89a/89m | image/gif | Oui | Oui |
| ICO (Icon Format) | image/ico | Oui | Non |
| JPEG (Joint Photographic Experts Group), spécification JFIF 1.02 | image/jpeg, image/jpe, image/jpg | Oui | Oui |
| PNG (Portable Network Graphics), spécification PNG 1.2 | image/png | Oui | Oui |
| TIFF (Tagged Image File Format), spécification TIFF 6.0 | image/tiff, image/tif | Oui | Oui |
| DDS (DirectDraw Surface) | image/vnd.ms-dds | Oui | Oui |

## Interfaces WIC pour le Microsoft Game Development Kit (GDK)

| Rubrique | Description |
| - | - |
| [IWICBitmap](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmap)<br /> | Définit des méthodes qui ajoutent à [IWICBitmapSource](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapsource) la notion d'accès en écriture et de représentations statiques en mémoire des bitmaps. <br /> |
| [IWICBitmapClipper](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapclipper)<br /> | Expose des méthodes qui produisent une version découpée de la bitmap d'entrée pour une région d'intérêt rectangulaire spécifiée.<br /> |
| [IWICBitmapCodecInfo](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapcodecinfo)<br /> | Expose des méthodes qui fournissent des informations sur un codec particulier.<br /> |
| [IWICBitmapDecoder](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapdecoder)<br /> | Expose des méthodes qui représentent un décodeur.<br /> |
| [IWICBitmapDecoderInfo](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapdecoderinfo)<br /> | Expose des méthodes qui fournissent des informations sur un décodeur.<br /> |
| [IWICBitmapEncoder](https://learn.microsoft.com/windows/win32/api/wincodec/nn-wincodec-iwicbitmapencoder)<br /> | Définit des méthodes permettant de définir les propriétés d'un encodeur, telles que les miniatures, les images et les palettes.<br /> |
| [IWICBitmapEncoderInfo](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapencoderinfo)<br /> | Expose des méthodes qui fournissent des informations sur un encodeur.<br /> |
| [IWICBitmapFlipRotator](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapfliprotator)<br /> | Expose des méthodes qui produisent une source bitmap retournée (horizontalement ou verticalement) et/ou pivotée (par incréments de 90 degrés). Les rotations sont effectuées avant le retournement.<br /> |
| [IWICBitmapFrameDecode](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapframedecode)<br /> | Définit des méthodes permettant de décoder les images individuelles d'un fichier encodé.<br /> |
| [IWICBitmapFrameEncode](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapframeencode)<br /> | Représente les images individuelles d'un encodeur.<br /> |
| [IWICBitmapLock](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmaplock)<br /> | Expose des méthodes qui prennent en charge la méthode [**Lock**](https://learn.microsoft.com/windows/win32/api/Wincodec/nf-wincodec-iwicbitmap-lock).<br /> |
| [IWICBitmapScaler](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapscaler)<br /> | Représente une version redimensionnée de la bitmap d'entrée à l'aide d'un algorithme de rééchantillonnage ou de filtrage.<br /> |
| [IWICBitmapSource](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapsource)<br /> | Expose des méthodes qui font référence à une source à partir de laquelle les pixels sont récupérés, mais dans laquelle ils ne peuvent pas être réécrits.<br /> |
| [IWICBitmapSourceTransform](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapsourcetransform)<br /> | Expose des méthodes permettant de déléguer certaines opérations à l'implémentation [IWICBitmapSource](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapsource) sous-jacente.<br /> |
| [IWICColorContext](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwiccolorcontext)<br /> | Expose des méthodes de gestion des couleurs.<br /> |
| [IWICComponentFactory](https://learn.microsoft.com/windows/win32/api/Wincodecsdk/nn-wincodecsdk-iwiccomponentfactory)<br /> | Expose des méthodes qui créent des composants utilisés par les développeurs de composants. Cela inclut les lecteurs et rédacteurs de métadonnées, ainsi que d'autres services destinés aux développeurs de codecs et de gestionnaires de métadonnées.<br /> |
| [IWICComponentInfo](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwiccomponentinfo)<br /> | Expose des méthodes qui fournissent des informations sur les composants.<br /> |
| [IWICDdsDecoder](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicddsdecoder)<br /> | Fournit des informations et des fonctionnalités propres au format d'image DDS.<br /> |
| [IWICDdsEncoder](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicddsencoder)<br /> | Permet d'écrire des informations propres au format DDS dans un encodeur.<br /> |
| [IWICDdsFrameDecode](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicddsframedecode)<br /> | Fournit l'accès à une seule image de données DDS dans sa forme [DXGI\_FORMAT](https://learn.microsoft.com/windows/win32/api/dxgiformat/ne-dxgiformat-dxgi_format) native, ainsi qu'à des informations sur les données d'image.<br /> |
| [IWICEnumMetadataItem](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicenummetadataitem)<br /> | Expose des méthodes qui fournissent des services d'énumération pour les éléments de métadonnées individuels.<br /> |
| [IWICFastMetadataEncoder](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicfastmetadataencoder)<br /> | Expose des méthodes utilisées pour la modification des métadonnées sur place. Un encodeur de métadonnées rapide vous permet d'ajouter et de supprimer des métadonnées d'une image sans avoir à réencoder entièrement l'image.<br /> |
| [IWICFormatConverter](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicformatconverter)<br /> | Représente un [IWICBitmapSource](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicbitmapsource) qui convertit les données d'image d'un format de pixels à un autre, en gérant le tramage et la mise en demi-teintes vers les formats indexés, la traduction de palette et le seuillage alpha. <br /> |
| [IWICFormatConverterInfo](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicformatconverterinfo)<br /> | Expose des méthodes qui fournissent des informations sur un convertisseur de format de pixels.<br /> |
| [IWICImageEncoder](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicimageencoder)<br /> | Encode des interfaces [ID2D1Image](https://learn.microsoft.com/windows/win32/api/d2d1/nn-d2d1-id2d1image) vers une interface [IWICBitmapEncoder](https://learn.microsoft.com/windows/win32/api/wincodec/nn-wincodec-iwicbitmapencoder). <br /> |
| [IWICImagingFactory](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicimagingfactory)<br /> | Expose des méthodes utilisées pour créer des composants pour WIC, tels que des décodeurs, des encodeurs et des convertisseurs de format de pixels.<br /> |
| [IWICImagingFactory2](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicimagingfactory2)<br /> | Extension de l'interface de fabrique WIC qui inclut la possibilité de créer une interface [IWICImageEncoder](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicimageencoder). <br /> |
| [IWICJpegFrameDecode](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicjpegframedecode)<br /> | Expose des méthodes permettant de décoder des images JPEG. Fournit l'accès à l'en-tête Start Of Frame (SOF), à l'en-tête Start of Scan (SOS), aux tables de Huffman et de quantification, ainsi qu'aux données JPEG compressées. Permet également l'indexation pour un accès aléatoire efficace. <br /> |
| [IWICJpegFrameEncode](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicjpegframeencode)<br /> | Expose des méthodes permettant d'écrire des données de balayage JPEG compressées directement dans le flux de sortie de l'encodeur WIC. Fournit également l'accès aux tables de Huffman et de quantification.<br /> |
| [IWICMetadataBlockReader](https://learn.microsoft.com/windows/win32/api/Wincodecsdk/nn-wincodecsdk-iwicmetadatablockreader)<br /> | Expose des méthodes qui donnent accès à tous les blocs de métadonnées de niveau supérieur du codec.<br /> |
| [IWICMetadataBlockWriter](https://learn.microsoft.com/windows/win32/api/Wincodecsdk/nn-wincodecsdk-iwicmetadatablockwriter)<br /> | Expose des méthodes qui permettent l'encodage des métadonnées. Cette interface est implémentée par le décodeur et ses images.<br /> |
| [IWICMetadataHandlerInfo](https://learn.microsoft.com/windows/win32/api/Wincodecsdk/nn-wincodecsdk-iwicmetadatahandlerinfo)<br /> | Expose des méthodes qui fournissent des informations de base sur le gestionnaire de métadonnées inscrit.<br /> |
| [IWICMetadataQueryReader](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicmetadataqueryreader)<br /> | Expose des méthodes permettant de récupérer des blocs et des éléments de métadonnées à partir d'un décodeur ou de ses images à l'aide d'une expression de requête de métadonnées.<br /> |
| [IWICMetadataQueryWriter](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicmetadataquerywriter)<br /> | Expose des méthodes permettant de définir ou de supprimer des blocs et des éléments de métadonnées dans un encodeur ou ses images à l'aide d'une expression de requête de métadonnées.<br /> |
| [IWICMetadataReader](https://learn.microsoft.com/windows/win32/api/Wincodecsdk/nn-wincodecsdk-iwicmetadatareader)<br /> | Expose des méthodes qui donnent accès au contenu des métadonnées sous-jacentes. Cette interface est implémentée par des éditeurs de logiciels indépendants (ISV) pour créer de nouveaux lecteurs de métadonnées.<br /> |
| [IWICMetadataReaderInfo](https://learn.microsoft.com/windows/win32/api/Wincodecsdk/nn-wincodecsdk-iwicmetadatareaderinfo)<br /> | Expose des méthodes qui fournissent des informations de base sur le lecteur de métadonnées inscrit.<br /> |
| [IWICMetadataWriter](https://learn.microsoft.com/windows/win32/api/Wincodecsdk/nn-wincodecsdk-iwicmetadatawriter)<br /> | Expose des méthodes qui donnent accès à l'écriture du contenu des métadonnées. Cette interface est implémentée par des ISV pour créer de nouveaux rédacteurs de métadonnées.<br /> |
| [IWICMetadataWriterInfo](https://learn.microsoft.com/windows/win32/api/Wincodecsdk/nn-wincodecsdk-iwicmetadatawriterinfo)<br /> | Expose des méthodes qui fournissent des informations de base sur le rédacteur de métadonnées inscrit.<br /> |
| [IWICPalette](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicpalette)<br /> | Expose des méthodes permettant d'accéder à une table de couleurs et de la construire, principalement pour les formats de pixels indexés.<br /> |
| [IWICPersistStream](https://learn.microsoft.com/windows/win32/api/Wincodecsdk/nn-wincodecsdk-iwicpersiststream)<br /> | Expose des méthodes qui fournissent des méthodes de chargement et d'enregistrement supplémentaires acceptant [WICPersistOptions](https://learn.microsoft.com/windows/win32/api/Wincodecsdk/ne-wincodecsdk-wicpersistoptions).<br /> |
| [IWICPixelFormatInfo](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicpixelformatinfo)<br /> | Expose des méthodes qui fournissent des informations sur un format de pixels.<br /> |
| [IWICPixelFormatInfo2](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicpixelformatinfo2)<br /> | Étend [IWICPixelFormatInfo](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicpixelformatinfo) en fournissant des informations supplémentaires sur un format de pixels.<br /> |
| [IWICPlanarBitmapFrameEncode](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicplanarbitmapframeencode)<br /> | Permet d'écrire dans un encodeur les pixels d'une image à composants planaires.<br /> |
| [IWICPlanarBitmapSourceTransform](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicplanarbitmapsourcetransform)<br /> | Fournit l'accès aux formats de pixels Y'CbCr planaires dans lesquels les composants des pixels sont stockés dans des plans de composants distincts.<br /> |
| [IWICPlanarFormatConverter](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicplanarformatconverter)<br /> | Permet d'initialiser un convertisseur de format avec une source planaire.<br /> |
| [IWICProgressiveLevelControl](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicprogressivelevelcontrol)<br /> | Expose des méthodes permettant d'obtenir des informations sur le décodage progressif et de le contrôler.<br /> |
| [IWICStream](https://learn.microsoft.com/windows/win32/api/Wincodec/nn-wincodec-iwicstream)<br /> | Représente un flux WIC permettant de référencer du contenu d'image et de métadonnées.<br /> |
| [IWICStreamProvider](https://learn.microsoft.com/windows/win32/api/Wincodecsdk/nn-wincodecsdk-iwicstreamprovider)<br /> | Expose des méthodes pour un fournisseur de flux.<br /> |

## Exemples

Pour obtenir des exemples d'utilisation de WIC pour le Microsoft Game Development Kit (GDK), consultez les exemples [SimpleTexture](https://github.com/microsoft/Xbox-ATG-Samples/tree/master/XDKSamples/IntroGraphics/SimpleTexture) et [xtexconv](https://github.com/microsoft/Xbox-ATG-Samples/tree/master/XDKSamples/Tools/xtexconv).

## Voir aussi

[Graphiques](/fr/build/core-features/graphics/gc-graphics-toc)


## Related topics

- [Graphiques sur XBOX et PC avec le GDK](/fr/build/core-features/graphics/index.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [XUserGamertagComponent](/fr/reference/system/xuser/enums/xusergamertagcomponent.md)
- [Fiddler sur PC Windows](/fr/build/console-features/networking/tools/fiddler-pc.md)
- [XBOX Device Portal (Windows Device Portal sur XBOX)](/fr/tools/tools-console/wdp/wdp.md)