Partager via


Lecture et écriture de métadonnées

Certains fichiers image contiennent des métadonnées que vous pouvez lire pour déterminer les caractéristiques de l’image. Par exemple, une photo numérique peut contenir des métadonnées que vous pouvez lire pour déterminer la fabrique et le modèle de l’appareil photo utilisé pour capturer l’image. Avec Windows GDI+, vous pouvez lire les métadonnées existantes et écrire de nouvelles métadonnées dans des fichiers image.

GDI+ offre un moyen uniforme de stocker et de récupérer des métadonnées à partir de fichiers image dans différents formats. Dans GDI+, un élément de métadonnées est appelé élément de propriété. Vous pouvez stocker et récupérer des métadonnées en appelant les méthodes SetPropertyItem et GetPropertyItem de la classe Image , et vous n’avez pas à vous soucier des détails de la façon dont un format de fichier particulier stocke ces métadonnées.

GDI+ prend actuellement en charge les métadonnées pour les formats de fichiers TIFF, JPEG, Exif et PNG. Le format Exif, qui spécifie comment stocker des images capturées par des appareils photo fixes numériques, s’appuie sur les formats TIFF et JPEG. Exif utilise le format TIFF pour les données de pixels non compressées et le format JPEG pour les données de pixels compressées.

GDI+ définit un ensemble de balises de propriété qui identifient les éléments de propriété. Certaines balises sont à usage général ; autrement dit, ils sont pris en charge par tous les formats de fichier mentionnés dans le paragraphe précédent. Les autres balises sont à usage spécial et s’appliquent uniquement à certains formats. Si vous essayez d’enregistrer un élément de propriété dans un fichier qui ne prend pas en charge cet élément de propriété, GDI+ ignore la demande. Plus précisément, la méthode Image::SetPropertyItem retourne PropertyNotSupported.

Vous pouvez déterminer les éléments de propriété stockés dans un fichier image en appelant Image::GetPropertyIdList. Si vous essayez de récupérer un élément de propriété qui n’est pas dans le fichier, GDI+ ignore la demande. Plus précisément, la méthode Image::GetPropertyItem retourne PropertyNotFound.

Lecture des métadonnées à partir d’un fichier

L’application console suivante appelle la méthode GetPropertySize d’un objet Image pour déterminer le nombre d’éléments de métadonnées dans le fichier FakePhoto.jpg.

#include <windows.h>
#include <gdiplus.h>
#include <stdio.h>
using namespace Gdiplus;
INT main()
{
   // Initialize <tla rid="tla_gdiplus"/>.
   GdiplusStartupInput gdiplusStartupInput;
   ULONG_PTR gdiplusToken;
   GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, NULL);
   UINT    size = 0;
   UINT    count = 0;
   Bitmap* bitmap = new Bitmap(L"FakePhoto.jpg");
   bitmap->GetPropertySize(&size, &count);
   printf("There are %d pieces of metadata in the file.\n", count);
   printf("The total size of the metadata is %d bytes.\n", size);
 
   delete bitmap;
   GdiplusShutdown(gdiplusToken);
   return 0;
}

Le code précédent, ainsi qu’un fichier particulier, FakePhoto.jpg, ont produit la sortie suivante :

There are 7 pieces of metadata in the file.
The total size of the metadata is 436 bytes.

GDI+ stocke un élément de métadonnées individuel dans un objet PropertyItem . Vous pouvez appeler la méthode GetAllPropertyItems de la classe Image pour récupérer toutes les métadonnées d’un fichier. La méthode GetAllPropertyItems retourne un tableau d’objets PropertyItem . Avant d’appeler GetAllPropertyItems, vous devez allouer une mémoire tampon suffisamment grande pour recevoir ce tableau. Vous pouvez appeler la méthode GetPropertySize de la classe Image pour obtenir la taille (en octets) de la mémoire tampon requise.

Un objet PropertyItem a les quatre membres publics suivants :

Description
id Balise qui identifie l’élément de métadonnées. Les valeurs qui peuvent être attribuées à id (PropertyTagImageTitle, PropertyTagEquipMake, PropertyTagExifExposureTime, etc.) sont définies dans Gdiplusimaging.h.
length Longueur, en octets, du tableau de valeurs pointées par le membre de données de valeur . Notez que si le membre de données de type est défini sur PropertyTagTypeASCII, le membre de données de longueur correspond à la longueur d’une chaîne de caractères terminée par null, y compris la terminaison NULL.
type Type de données des valeurs du tableau pointé vers le membre de données value. Les constantes (PropertyTagTypeByte, PropertyTagTypeASCII, etc.) qui représentent différents types de données sont décrites dans Constantes de type de balise de propriété image.
value Pointeur vers un tableau de valeurs.

 

L’application console suivante lit et affiche les sept éléments de métadonnées dans le fichier FakePhoto.jpg. La fonction main s’appuie sur la fonction d’assistance PropertyTypeFromWORD, qui s’affiche après la fonction main.

#include <windows.h>
#include <gdiplus.h>
#include <strsafe.h>
using namespace Gdiplus;

INT main()
{
   // Initialize GDI+
   GdiplusStartupInput gdiplusStartupInput;
   ULONG_PTR gdiplusToken;
   GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, NULL);

   UINT  size = 0;
   UINT  count = 0;

   #define MAX_PROPTYPE_SIZE 30
   WCHAR strPropertyType[MAX_PROPTYPE_SIZE] = L"";

   Bitmap* bitmap = new Bitmap(L"FakePhoto.jpg");

   bitmap->GetPropertySize(&size, &count);
   printf("There are %d pieces of metadata in the file.\n\n", count);

   // GetAllPropertyItems returns an array of PropertyItem objects.
   // Allocate a buffer large enough to receive that array.
   PropertyItem* pPropBuffer =(PropertyItem*)malloc(size);

   // Get the array of PropertyItem objects.
   bitmap->GetAllPropertyItems(size, count, pPropBuffer);

   // For each PropertyItem in the array, display the id, type, and length.
   for(UINT j = 0; j < count; ++j)
   {
      // Convert the property type from a WORD to a string.
      PropertyTypeFromWORD(
         pPropBuffer[j].type, strPropertyType, MAX_PROPTYPE_SIZE);

      printf("Property Item %d\n", j);
      printf("  id: 0x%x\n", pPropBuffer[j].id);
      wprintf(L"  type: %s\n", strPropertyType);
      printf("  length: %d bytes\n\n", pPropBuffer[j].length);
   }

   free(pPropBuffer);
   delete bitmap;
   GdiplusShutdown(gdiplusToken);
   return 0;
} // main

// Helper function
HRESULT PropertyTypeFromWORD(WORD index, WCHAR* string, UINT maxChars)
{
   HRESULT hr = E_FAIL;

   WCHAR* propertyTypes[] = {
      L"Nothing",                   // 0
      L"PropertyTagTypeByte",       // 1
      L"PropertyTagTypeASCII",      // 2
      L"PropertyTagTypeShort",      // 3
      L"PropertyTagTypeLong",       // 4
      L"PropertyTagTypeRational",   // 5
      L"Nothing",                   // 6
      L"PropertyTagTypeUndefined",  // 7
      L"Nothing",                   // 8
      L"PropertyTagTypeSLONG",      // 9
      L"PropertyTagTypeSRational"}; // 10

   hr = StringCchCopyW(string, maxChars, propertyTypes[index]);
   return hr;
}

L’application console précédente produit la sortie suivante :

Property Item 0
  id: 0x320
  type: PropertyTagTypeASCII
  length: 16 bytes
Property Item 1
  id: 0x10f
  type: PropertyTagTypeASCII
  length: 17 bytes
Property Item 2
  id: 0x110
  type: PropertyTagTypeASCII
  length: 7 bytes
Property Item 3
  id: 0x9003
  type: PropertyTagTypeASCII
  length: 20 bytes
Property Item 4
  id: 0x829a
  type: PropertyTagTypeRational
  length: 8 bytes
Property Item 5
  id: 0x5090
  type: PropertyTagTypeShort
  length: 128 bytes
Property Item 6
  id: 0x5091
  type: PropertyTagTypeShort
  length: 128 bytes

La sortie précédente affiche un numéro d’ID hexadécimal pour chaque élément de propriété. Vous pouvez rechercher ces numéros d’ID dans Constantes d’étiquette de propriété d’image et découvrir qu’ils représentent les balises de propriété suivantes.

Valeur hexadécimale Balise de propriété
0x0320 0x010f
  0x0110
  0x9003
  0x829a
  0x5090
  0x5091
PropertyTagImageTitle PropertyTagEquipMake
  PropertyTagEquipModel
  PropertyTagExifDTOriginal
  PropertyTagExifExposureTime
  PropertyTagLuminanceTable
  PropertyTagChrominanceTable

 

Le deuxième élément de propriété (index 1) de la liste a l’id PropertyTagEquipMake et le type PropertyTagTypeASCII. L’exemple suivant, qui est une continuation de l’application console précédente, affiche la valeur de cet élément de propriété :

printf("The equipment make is %s.\n", pPropBuffer[1].value);

La ligne de code précédente produit la sortie suivante :

The equipment make is Northwind Traders.

Le cinquième élément de propriété (index 4) de la liste a l’id PropertyTagExifExposureTime et le type PropertyTagTypeRational. Ce type de données (PropertyTagTypeRational) est une paire de longs. L’exemple suivant, qui est une continuation de l’application console précédente, affiche ces deux valeurs LONG sous forme de fraction. Cette fraction, 1/125, correspond au temps d’exposition mesuré en secondes.

long* ptrLong = (long*)(pPropBuffer[4].value);
printf("The exposure time is %d/%d.\n", ptrLong[0], ptrLong[1]);

Le code ci-dessus génère la sortie suivante :

The exposure time is 1/125.

Écriture de métadonnées dans un fichier

Pour écrire un élément de métadonnées dans un objet Image , initialisez un objet PropertyItem , puis transmettez l’adresse de cet objet PropertyItem à la méthode SetPropertyItem de l’objet Image .

L’application console suivante écrit un élément (le titre de l’image) des métadonnées dans un objet Image , puis enregistre l’image dans le fichier disque FakePhoto2.jpg. La fonction main s’appuie sur la fonction d’assistance GetEncoderClsid, qui est présentée dans la rubrique Récupération de l’identificateur de classe pour un encodeur.

#include <windows.h>
#include <gdiplus.h>
#include <stdio.h>
using namespace Gdiplus;
INT main()
{
   // Initialize <tla rid="tla_gdiplus"/>.
   GdiplusStartupInput gdiplusStartupInput;
   ULONG_PTR gdiplusToken;
   GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, NULL);
   Status stat;
   CLSID  clsid;
   char   propertyValue[] = "Fake Photograph";
   Bitmap* bitmap = new Bitmap(L"FakePhoto.jpg");
   PropertyItem* propertyItem = new PropertyItem;
   // Get the CLSID of the JPEG encoder.
   GetEncoderClsid(L"image/jpeg", &clsid);
   propertyItem->id = PropertyTagImageTitle;
   propertyItem->length = 16;  // string length including NULL terminator
   propertyItem->type = PropertyTagTypeASCII; 
   propertyItem->value = propertyValue;
   bitmap->SetPropertyItem(propertyItem);
   stat = bitmap->Save(L"FakePhoto2.jpg", &clsid, NULL);
   if(stat == Ok)
      printf("FakePhoto2.jpg saved successfully.\n");
   
   delete propertyItem;
   delete bitmap;
   GdiplusShutdown(gdiplusToken);
   return 0;
}