Query di metadati per formati di immagine nativi

Questo argomento offre una panoramica delle query del linguaggio di query dei metadati per la lettura e la scrittura di metadati supportati da immagini GIF, PNG, TIFF e JPEG. Include metadati specifici di ogni formato di immagine, nonché metadati supportati da più formati.

In questo argomento sono contenute le sezioni seguenti.

• Prerequisiti
• Espressione criteri metadati foto
• Metadati specifici del formato di file
  • Metadati GIF
  • Metadati PNG
  • Metadati TIFF
  • Metadati JPEG
• Metadati indipendenti formato file
  • Metadati IFD
  • Metadati EXIF
  • Metadati GPS
  • Metadati XMP
• Argomenti correlati

Prerequisiti

Per comprendere questo argomento, è necessario avere familiarità con il sistema di metadati Windows Imaging Component (WIC), come descritto in Panoramica dei metadati wic. È anche necessario avere familiarità con il linguaggio di query usato per leggere e scrivere metadati, come descritto in Panoramica del linguaggio di query sui metadati.

Espressione criteri metadati foto

Oltre a supportare il linguaggio di query dei metadati, WIC accetta anche nomi di proprietà canonici dal sistema di proprietà Windows. WIC supporta un subset dello spazio dei nomi delle proprietà Windows rilevante per i formati di immagine, come descritto in Criteri metadati foto. Una proprietà Di Windows utilizzata come query di metadati WIC viene definita espressione di criteri di metadati delle foto.

Ad esempio, l'espressione dei criteri dei metadati delle foto per il flag di orientamento EXIF è:

• System.Photo.Orientation

In generale, le espressioni di criteri sono consigliate sulle query di metadati native per gli elementi di metadati di immagine comuni coperti dallo spazio dei nomi delle proprietà di Windows. Il linguaggio di query dei metadati è ideale per i casi in cui è necessario l'accesso di basso livello a elementi di metadati di immagine specifici o per elementi di metadati personalizzati o avanzati non supportati dal sistema di proprietà Windows. Per altre informazioni, vedere Photo Metadata Policy Expressions.For more information, see Photo Metadata Policy Expressions.

Metadati specifici del formato di file

Le sezioni seguenti contengono tabelle che elencano le query di metadati disponibili per ogni tipo di file di immagine. Ogni tabella include le colonne seguenti:

• Path : percorso della query usato per recuperare l'elemento di metadati.
• Name : nome dell'elemento di metadati.
• Type : tipo dell'elemento di metadati recuperato dal percorso della query. I metadati recuperati da WIC vengono restituiti sotto forma di PROPVARIANT, che segnala il tipo di dati usando l'enumerazione VARTYPE.on.

I percorsi di query vengono usati dall'API dei metadati WIC per accedere ai metadati incorporati di un'immagine. Il codice di esempio seguente illustra l'uso di un oggetto IWICMetadataQueryReader per eseguire una query per il blocco di metadati IFD di jpeg.

// Not shown: image decoding 
IWICMetadataQueryReader *pQueryReader = NULL;
IWICMetadataQueryReader *pIFDReader = NULL;

// Get the query reader.
if (SUCCEEDED(hr))
{
    hr = pFrameDecode->GetMetadataQueryReader(&pQueryReader);
}

if (SUCCEEDED(hr))
{
    // Get the nested IFD reader.
    hr = pQueryReader->GetMetadataByName(L"/app1/ifd", &value);
    if (value.vt == VT_UNKNOWN)
    {
        hr = value.punkVal->QueryInterface(IID_IWICMetadataQueryReader, (void **)&pIFDReader);
    }
    PropVariantClear(&value); // Clear value for new query.
}

Metadati GIF

Il formato immagine GIF (Graphics Interchange Format) supporta sia i metadati a livello globale che a livello di fotogramma. Le due sezioni seguenti forniscono i percorsi di query dei metadati disponibili per i metadati a livello di frame e globale di GIF.

Metadati globali

Nella tabella seguente vengono forniti i percorsi di query dei metadati disponibili che possono essere usati per accedere ai metadati GIF globali.

Metadati dei frame

Nella tabella seguente vengono forniti i percorsi di query dei metadati disponibili che possono essere usati per accedere ai metadati GIF a livello di frame.

Metadati PNG

Il formato di immagine PNG (Portable Network Graphics) supporta i metadati a livello di frame.

Metadati dei frame

Nella tabella seguente vengono forniti i percorsi di query dei metadati disponibili che possono essere usati per accedere ai metadati PNG a livello di frame.

Metadati TIFF

Il formato di immagine TIFF (Tag Image Format) supporta i metadati a livello di frame.

Metadati dei frame

La tabella seguente fornisce i percorsi di query dei metadati disponibili che possono essere usati per accedere ai metadati TIFF a livello di frame.

Metadati JPEG

Il formato di immagine JPEG supporta i metadati a livello di cornice.

Metadati dei frame

La tabella seguente fornisce i percorsi di query dei metadati disponibili che possono essere usati per accedere ai metadati JPEG a livello di frame.

Metadati indipendenti formato file

Le sezioni seguenti contengono informazioni sui formati di metadati supportati da più formati di immagine. Ogni tabella include le colonne seguenti:

• Percorso relativo : percorso della query usato per recuperare l'elemento di metadati, relativo al blocco di metadati.
• Name : nome dell'elemento di metadati.
• Type : tipo dell'elemento di metadati recuperato dal percorso della query. I metadati recuperati da WIC vengono restituiti sotto forma di PROPVARIANT, che segnala il tipo di dati usando l'enumerazione VARTYPE.

Ad esempio, per accedere al flag Orientation in un file JPEG, usare l'espressione seguente:

• /app1/ifd/{ushort=274}

In un file TIFF usare l'espressione seguente:

• /ifd/{ushort=274}

In questo esempio, si noti che diversi formati di immagine possono archiviare un blocco di metadati specifico in modo diverso e quindi la query di metadati completi per accedere a un determinato elemento di metadati può essere specifica del formato di immagine. Vedere la tabella di ogni formato per trovare la query di metadati appropriata per accedere a un blocco di metadati specifico.

Metadati IFD

Un IFD o Image File Directory è una struttura di dati definita nello standard TIFF che può contenere metadati di immagine. Identifica ogni elemento di metadati usando un tag di tipo ushort. JPEG, TIFF e JPEG-XR supportano i metadati IFD. I formati di terze parti, ad esempio alcuni formati non elaborati della fotocamera, possono supportare anche i metadati IFD.

La tabella seguente fornisce percorsi di query sui metadati relativi per accedere ad alcuni elementi di metadati IFD usati comunemente. La struttura dei dati IFD consente l'estendibilità di terze parti e questa tabella non è un elenco completo. Per altre informazioni, vedere lo standard TIFF.

Metadati EXIF

I metadati EXIF vengono definiti come parte della specifica JPEG EXIF. I metadati EXIF si basano sulla struttura dei dati IFD come definito nello standard TIFF e forniscono attributi aggiuntivi, ad esempio informazioni sui dispositivi e sugli attributi fotografici usati per creare l'immagine. Identifica ogni elemento di metadati usando un tag di tipo ushort. JPEG, TIFF e JPEG-XR supportano i metadati EXIF. I formati di terze parti, ad esempio alcuni formati non elaborati della fotocamera, possono supportare anche i metadati EXIF.

Nella tabella seguente vengono forniti i percorsi di query dei metadati relativi per accedere ad alcuni elementi di metadati EXIF usati comunemente. La struttura dei dati EXIF consente l'estendibilità di terze parti e questa tabella non è un elenco esaustivo; per altre informazioni, vedere lo standard EXIF.

Metadati GPS

I metadati GPS contengono informazioni sulla georilevazione ed è definito come parte della specifica JPEG EXIF. Identifica ogni elemento di metadati usando un tag di tipo ushort. JPEG, TIFF e JPEG-XR supportano i metadati GPS; anche formati di terze parti, come alcuni formati non elaborati della fotocamera, possono supportare i metadati GPS.

Nella tabella seguente vengono forniti i percorsi di query dei metadati relativi per accedere ad alcuni elementi di metadati GPS di uso comune. Questa tabella non è un elenco esaustivo; per altre informazioni, vedere lo standard EXIF.

Metadati XMP

XMP è uno standard di metadati estendibile basato su XML. Gli elementi dei metadati possono essere gerarchici e contengono strutture di dati complesse. JPEG, TIFF e JPEG-XR supportano i metadati XMP. I formati di terze parti, come alcuni formati non elaborati della fotocamera, possono supportare anche i metadati XMP.

Lo standard XMP può essere ottenuto da: https://www.adobe.com/devnet/xmp.html.

XMP e consente alle entità di terze parti di pubblicare i propri schemi o spazi dei nomi, che consentono loro di definire nuovi elementi di metadati senza dover modificare lo standard XMP. Uno schema XMP è identificato in modo univoco da un URL, ma WIC fornisce un set di identificatori descrittivi per schemi noti.

Gli elementi dei metadati XMP vengono identificati da un nome stringa e da un identificatore dello schema. Come procedura consigliata, ogni query di metadati XMP deve specificare sia lo schema che il nome. Se l'identificatore dello schema manca, JPEG tenterà di corrispondere al nome dei metadati in tutti gli spazi dei nomi presenti all'interno del pacchetto di metadati XMP.

Ad esempio, per ottenere la proprietà Rating come definito dallo schema XMP in un'immagine JPEG, usare la query seguente:

• /xmp/{wstr=https://ns.adobe.com/xap/1.0/}:Rating

La prima parte, "/xmp", recupera il lettore/writer di metadati XMP per l'immagine. "https://ns.adobe.com/xap/1.0/" è l'URL dello schema XMP, come definito nello standard XMP. L'URL è racchiuso in un'espressione di dati per consentire l'uso di caratteri come una barra in avanti (/). Infine, "Rating" è il nome effettivo dell'elemento di metadati definito dallo schema XMP ed è separato dall'identificatore dello schema in base a due punti (:).

In questo esempio WIC fornisce un identificatore descrittivo per lo schema XMP che può essere usato al posto dell'URL completo. Quindi, la query precedente può essere riscritta come:

• /xmp/xmp:Rating

WIC offre prefissi di schema descrittivi per gli schemi comunemente usati:

Se non esiste un prefisso di schema descrittivo per uno schema specifico, ad esempio se un'immagine contiene metadati XMP usando uno schema di terze parti personalizzato, la query di metadati deve usare l'URL completo dello schema.

Argomenti correlati

Informazioni concettuali

Panoramica del componente Di creazione immagini di Windows

Panoramica dei metadati WIC

Panoramica del linguaggio di query dei metadati

Panoramica dell'estendibilità dei metadati

Procedura: Codificare nuovamente un'immagine JPEG con metadati