Windows Imaging Component (WIC) sur XBOX

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. Les fonctionnalités sont semblables à 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 dans 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 dans 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), à grande plage dynamique, les formats de pixels à virgule flottante en 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 photo ne sont pas prises en charge. Lors du transcodage, l’API tentera 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 sous 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 prise en charge. Notez que IWICBitmapFrameDecode::GetColorContexts et IWICBitmapDecoder::GetColorContexts sont toujours prises en charge.
Il existe certaines différences entre Direct3D sur XBOX One et sur Windows en ce qui concerne WIC. Vous trouverez des détails dans la rubrique Création et utilisation de Direct3D sur XBOX One.

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 connaissances préalables des formats d’image particuliers
Fournit une architecture « plug-and-play » extensible 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 d’image, avec la capacité de conserver les métadonnées non reconnues pendant la modification
Conserve les données d’image à grande profondeur de bits, 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, des formats de pixels et des schémas de métadonnées les plus populaires

Codecs natifs pour le Microsoft Game Development Kit (GDK)

WIC comprend 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 (format d’icône)	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	Définit des méthodes qui ajoutent à IWICBitmapSource le concept d’accessibilité en écriture et de représentations statiques en mémoire des bitmaps.
IWICBitmapClipper	Expose des méthodes qui produisent une version découpée du bitmap d’entrée pour une région d’intérêt rectangulaire spécifiée.
IWICBitmapCodecInfo	Expose des méthodes qui fournissent des informations sur un codec particulier.
IWICBitmapDecoder	Expose des méthodes qui représentent un décodeur.
IWICBitmapDecoderInfo	Expose des méthodes qui fournissent des informations sur un décodeur.
IWICBitmapEncoder	Définit des méthodes permettant de définir les propriétés d’un encodeur, comme les miniatures, les trames et les palettes.
IWICBitmapEncoderInfo	Expose des méthodes qui fournissent des informations sur un encodeur.
IWICBitmapFlipRotator	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.
IWICBitmapFrameDecode	Définit des méthodes permettant de décoder les trames d’image individuelles d’un fichier encodé.
IWICBitmapFrameEncode	Représente les trames d’image individuelles d’un encodeur.
IWICBitmapLock	Expose des méthodes qui prennent en charge la méthode Lock.
IWICBitmapScaler	Représente une version redimensionnée du bitmap d’entrée obtenue au moyen d’un algorithme de rééchantillonnage ou de filtrage.
IWICBitmapSource	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.
IWICBitmapSourceTransform	Expose des méthodes permettant de déléguer certaines opérations à l’implémentation sous-jacente de IWICBitmapSource.
IWICColorContext	Expose des méthodes de gestion des couleurs.
IWICComponentFactory	Expose des méthodes qui créent des composants utilisés par les développeurs de composants. Cela comprend les lecteurs et les 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.
IWICComponentInfo	Expose des méthodes qui fournissent des informations sur les composants.
IWICDdsDecoder	Fournit des informations et des fonctionnalités propres au format d’image DDS.
IWICDdsEncoder	Permet d’écrire dans un encodeur des informations propres au format DDS.
IWICDdsFrameDecode	Fournit l’accès à une seule trame de données d’image DDS dans sa forme DXGI_FORMAT native, ainsi qu’à des informations sur les données d’image.
IWICEnumMetadataItem	Expose des méthodes qui fournissent des services d’énumération pour les éléments de métadonnées individuels.
IWICFastMetadataEncoder	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 des métadonnées à une image et d’en supprimer sans avoir à réencoder entièrement l’image.
IWICFormatConverter	Représente une IWICBitmapSource qui convertit les données d’image d’un format de pixels à un autre, en gérant le tramage et la similigravure vers les formats indexés, la traduction de palette et le seuillage alpha.
IWICFormatConverterInfo	Expose des méthodes qui fournissent des informations sur un convertisseur de format de pixels.
IWICImageEncoder	Encode des interfaces ID2D1Image dans une interface IWICBitmapEncoder.
IWICImagingFactory	Expose des méthodes utilisées pour créer des composants pour WIC, comme des décodeurs, des encodeurs et des convertisseurs de format de pixels.
IWICImagingFactory2	Une extension de l’interface de fabrique WIC qui inclut la capacité de créer une interface IWICImageEncoder.
IWICJpegFrameDecode	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.
IWICJpegFrameEncode	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.
IWICMetadataBlockReader	Expose des méthodes qui fournissent l’accès à tous les blocs de métadonnées de niveau supérieur du codec.
IWICMetadataBlockWriter	Expose des méthodes qui permettent l’encodage des métadonnées. Cette interface est implémentée par le décodeur et ses trames d’image.
IWICMetadataHandlerInfo	Expose des méthodes qui fournissent des informations de base sur le gestionnaire de métadonnées inscrit.
IWICMetadataQueryReader	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 trames d’image au moyen d’une expression de requête de métadonnées.
IWICMetadataQueryWriter	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 trames d’image au moyen d’une expression de requête de métadonnées.
IWICMetadataReader	Expose des méthodes qui fournissent l’accès au contenu des métadonnées sous-jacentes. Cette interface est implémentée par les éditeurs de logiciels indépendants (ISV) pour créer de nouveaux lecteurs de métadonnées.
IWICMetadataReaderInfo	Expose des méthodes qui fournissent des informations de base sur le lecteur de métadonnées inscrit.
IWICMetadataWriter	Expose des méthodes qui permettent l’écriture du contenu des métadonnées. Cette interface est implémentée par les ISV pour créer de nouveaux rédacteurs de métadonnées.
IWICMetadataWriterInfo	Expose des méthodes qui fournissent des informations de base sur le rédacteur de métadonnées inscrit.
IWICPalette	Expose des méthodes permettant d’accéder à une table de couleurs et de la construire, principalement pour les formats de pixels indexés.
IWICPersistStream	Expose des méthodes qui fournissent des méthodes supplémentaires de chargement et d’enregistrement acceptant WICPersistOptions.
IWICPixelFormatInfo	Expose des méthodes qui fournissent des informations sur un format de pixels.
IWICPixelFormatInfo2	Étend IWICPixelFormatInfo en fournissant des informations supplémentaires sur un format de pixels.
IWICPlanarBitmapFrameEncode	Permet d’écrire des pixels d’image à composants planaires dans un encodeur.
IWICPlanarBitmapSourceTransform	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.
IWICPlanarFormatConverter	Permet d’initialiser un convertisseur de format avec une source planaire.
IWICProgressiveLevelControl	Expose des méthodes permettant d’obtenir des informations sur le décodage progressif et de le contrôler.
IWICStream	Représente un flux WIC permettant de référencer du contenu d’imagerie et de métadonnées.
IWICStreamProvider	Expose des méthodes pour un fournisseur de flux.

Exemples

Pour des exemples d’utilisation de WIC pour le Microsoft Game Development Kit (GDK), consultez les exemples SimpleTexture et xtexconv.

Voir aussi

Graphiques

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Différences par rapport à WIC pour Windows

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

Codecs natifs pour le Microsoft Game Development Kit (GDK)

Interfaces WIC pour le Microsoft Game Development Kit (GDK)

Exemples

Voir aussi

​Différences par rapport à WIC pour Windows

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

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

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

​Exemples

​Voir aussi

Différences par rapport à WIC pour Windows

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

Codecs natifs pour le Microsoft Game Development Kit (GDK)

Interfaces WIC pour le Microsoft Game Development Kit (GDK)

Exemples

Voir aussi