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. 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 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.

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	Définit des méthodes qui ajoutent à IWICBitmapSource la notion d’accès en écriture et de représentations statiques en mémoire des bitmaps.
IWICBitmapClipper	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.
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, telles que les miniatures, les images 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 images individuelles d’un fichier encodé.
IWICBitmapFrameEncode	Représente les images individuelles d’un encodeur.
IWICBitmapLock	Expose des méthodes qui prennent en charge la méthode Lock.
IWICBitmapScaler	Représente une version redimensionnée de la bitmap d’entrée à l’aide 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 IWICBitmapSource sous-jacente.
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 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.
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 des informations propres au format DDS dans un encodeur.
IWICDdsFrameDecode	Fournit l’accès à une seule image de données 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 et de supprimer des métadonnées d’une image sans avoir à réencoder entièrement l’image.
IWICFormatConverter	Représente un 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.
IWICFormatConverterInfo	Expose des méthodes qui fournissent des informations sur un convertisseur de format de pixels.
IWICImageEncoder	Encode des interfaces ID2D1Image vers une interface IWICBitmapEncoder.
IWICImagingFactory	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.
IWICImagingFactory2	Extension de l’interface de fabrique WIC qui inclut la possibilité 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 donnent 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 images.
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 images à l’aide 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 images à l’aide d’une expression de requête de métadonnées.
IWICMetadataReader	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.
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 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.
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 de chargement et d’enregistrement supplémentaires 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 dans un encodeur les pixels d’une image à composants planaires.
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’image et de métadonnées.
IWICStreamProvider	Expose des méthodes pour un fournisseur de flux.

Exemples

Pour obtenir 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