ネイティブ イメージ形式のメタデータ クエリ

このトピックでは、GIF、PNG、TIFF、JPEG 画像でサポートされるメタデータの読み取りと書き込みに関するメタデータ クエリ言語 クエリの概要について説明します。これには、各イメージ形式に固有のメタデータと、複数の形式でサポートされているメタデータが含まれます。

このトピックは、次のセクションで構成されています。

• 必要条件
• 写真メタデータ ポリシー式
• ファイル形式固有のメタデータ
  • GIF メタデータ
  • PNG メタデータ
  • TIFF メタデータ
  • JPEG メタデータ
• ファイル形式に依存しないメタデータ
  • IFD メタデータ
  • EXIF メタデータ
  • GPS メタデータ
  • XMP メタデータ
• 関連トピック

必須コンポーネント

このトピックを理解するには、「 WIC メタデータの概要」の説明に従って、Windows イメージング コンポーネント (WIC) メタデータ システムについて理解している必要があります。 また、「メタデータ クエリ言語の概要」で説明されているように、メタデータの読み取りと書き込みに使用される クエリ言語についても理解している必要があります。

写真メタデータ ポリシー式

WIC は、メタデータ クエリ言語のサポートに加えて、Windows プロパティ システムからの正規のプロパティ名も受け入れます。 WIC では、「 写真メタデータ ポリシー」で説明されているように、画像形式に関連する Windows プロパティ名前空間のサブセットがサポートされています。 WIC メタデータ クエリとして使用される Windows プロパティは、写真メタデータ ポリシー式と呼ばれます。

たとえば、EXIF オリエンテーション フラグの写真メタデータ ポリシー式は次のとおりです。

• System.Photo.Orientation

一般に、ポリシー式は、Windows プロパティ名前空間の対象となる一般的なイメージ メタデータ項目のネイティブ メタデータ クエリよりも推奨されます。 メタデータ クエリ言語は、特定のイメージ メタデータ項目への低レベルのアクセスが必要な場合や、Windows プロパティ システムでサポートされていないカスタムまたは高度なメタデータ項目に最適です。 詳細については、「 Photo Metadata Policy Expressions」を参照してください。

ファイル形式固有のメタデータ

次のセクションには、イメージ ファイルの種類ごとに使用可能なメタデータ クエリの一覧を示すテーブルが含まれています。 各テーブルには、次の列があります。

• Path - メタデータ 項目の取得に使用されるクエリ パス。
• Name - メタデータ 項目の名前。
• 型 - クエリ パスから取得したメタデータ項目の型。 WIC によって取得されたメタデータは PROPVARIANT の形式で返されます。この形式では、VARTYPE 列挙を使用してデータ型が報告されます。

クエリ パスは、イメージの埋め込みメタデータにアクセスするために WIC メタデータ API によって使用されます。 次のコード例は、 IWICMetadataQueryReader を使用して JPEG の IFD メタデータ ブロックを照会する方法を示しています。

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

GIF メタデータ

グラフィックス交換形式 (GIF) イメージ形式では、グローバル レベルとフレーム レベルのメタデータの両方がサポートされています。 次の 2 つのセクションでは、GIF のグローバル およびフレーム レベルのメタデータに使用できるメタデータ クエリ パスを提供します。

グローバル メタデータ

次の表に、グローバル GIF メタデータへのアクセスに使用できるメタデータ クエリ パスを示します。

フレーム メタデータ

次の表に、フレーム レベルの GIF メタデータにアクセスするために使用できるメタデータ クエリ パスを示します。

PNG メタデータ

ポータブル ネットワーク グラフィックス (PNG) イメージ形式では、フレーム レベルのメタデータがサポートされています。

フレーム メタデータ

次の表に、フレーム レベルの PNG メタデータにアクセスするために使用できるメタデータ クエリ パスを示します。

TIFF メタデータ

タグ付きイメージ ファイル形式 (TIFF) イメージ形式では、フレーム レベルのメタデータがサポートされます。

フレーム メタデータ

次の表に、フレーム レベルの TIFF メタデータにアクセスするために使用できるメタデータ クエリ パスを示します。

JPEG メタデータ

JPEG イメージ形式では、フレーム レベルのメタデータがサポートされます。

フレーム メタデータ

次の表に、フレーム レベルの JPEG メタデータにアクセスするために使用できるメタデータ クエリ パスを示します。

ファイル形式に依存しないメタデータ

次のセクションでは、複数の画像形式でサポートされているメタデータ形式に関する情報を示します。 各テーブルには、次の列があります。

• 相対パス - メタデータ ブロックに対する相対メタデータ 項目の取得に使用されるクエリ パス。
• Name - メタデータ 項目の名前。
• 型 - クエリ パスから取得したメタデータ項目の型。 WIC によって取得されたメタデータは PROPVARIANT の形式で返されます。この形式では、VARTYPE 列挙を使用してデータ型が報告されます。

たとえば、JPEG ファイルの Orientation フラグにアクセスするには、次の式を使用します。

• /app1/ifd/{ushort=274}

TIFF ファイルで、次の式を使用します。

• /ifd/{ushort=274}

この例では、異なる画像形式で特定のメタデータ ブロックが異なる方法で格納される場合があるため、特定のメタデータ 項目にアクセスするための完全修飾メタデータ クエリは画像形式固有である可能性があることに注意してください。 各形式のテーブルを参照して、特定のメタデータ ブロックにアクセスするための適切なメタデータ クエリを見つけます。

IFD メタデータ

IFD (イメージ ファイル ディレクトリ) は、イメージ メタデータを含めることができる TIFF 標準で定義されているデータ構造です。 ushort 型のタグを使用して、各メタデータ項目を識別します。 JPEG、TIFF、JPEG-XR では、IFD メタデータがサポートされます。 一部のカメラ生形式のようなサード パーティの形式でも、IFD メタデータがサポートされる場合があります。

次の表は、一般的に使用される IFD メタデータ項目にアクセスするための相対メタデータ クエリ パスを示しています。 IFD データ構造を使用すると、サードパーティの機能拡張が可能になり、このテーブルは完全な一覧ではありません。 詳細については、TIFF 標準を参照してください。

EXIF メタデータ

EXIF メタデータは、EXIF JPEG 仕様の一部として定義されています。 EXIF メタデータは、TIFF 標準で定義されている IFD データ構造に基づいており、画像の作成に使用されるデバイスや写真属性に関する情報などの追加の属性を提供します。 ushort 型のタグを使用して、各メタデータ項目を識別します。 JPEG、TIFF、JPEG-XR は EXIF メタデータをサポートします。 一部のカメラ生形式など、サードパーティの形式でも EXIF メタデータがサポートされる場合があります。

次の表は、一般的に使用される EXIF メタデータ項目にアクセスするための相対メタデータ クエリ パスを示しています。 EXIF データ構造はサードパーティの拡張性を可能にしており、このテーブルは完全なリストではありません。詳細については、EXIF 標準を参照してください。

GPS メタデータ

GPS メタデータには位置情報が含まれており、EXIF JPEG 仕様の一部として定義されています。 ushort 型のタグを使用して、各メタデータ項目を識別します。 JPEG、TIFF、JPEG-XR は GPS メタデータをサポートします。一部のカメラ生形式のようなサードパーティの形式でも、GPS メタデータがサポートされる場合があります。

次の表は、一般的に使用される GPS メタデータ項目にアクセスするための相対メタデータ クエリ パスを示しています。 この表は完全なリストではありません。詳細については、EXIF 標準を参照してください。

XMP メタデータ

XMP は、XML ベースの拡張可能なメタデータ標準です。 メタデータ項目は階層型で、複雑なデータ構造を含めることができます。 JPEG、TIFF、JPEG-XR では、XMP メタデータがサポートされています。 一部のカメラ生形式のようなサードパーティの形式でも、XMP メタデータがサポートされている場合があります。

XMP 標準は、 から https://www.adobe.com/devnet/xmp.html取得できます。

XMP と を使用すると、サードパーティエンティティは独自のスキーマまたは名前空間を公開できます。これにより、XMP 標準を変更しなくても新しいメタデータ項目を定義できます。 XMP スキーマは URL によって一意に識別されますが、 WIC は既知のスキーマのフレンドリ識別子のセットを提供します。

XMP メタデータ項目は、文字列名とスキーマ識別子によって識別されます。 ベスト プラクティスとして、すべての XMP メタデータ クエリでスキーマと名前の両方を指定する必要があります。 スキーマ識別子がない場合、JPEG は XMP メタデータ パケット内に存在するすべての名前空間のメタデータ名の照合を試みます。

たとえば、JPEG イメージの XMP スキーマで定義されている Rating プロパティを取得するには、次のクエリを使用します。

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

最初の部分 "/xmp" は、イメージの XMP メタデータ リーダー/ライターを取得します。 "https://ns.adobe.com/xap/1.0/"は、XMP 標準で定義されている XMP スキーマの URL です。 URL はデータ式で囲まれており、スラッシュ (/) などの文字を使用できます。 最後に、"Rating" は XMP スキーマで定義された実際のメタデータ項目名であり、スキーマ識別子からコロン (:)で区切られます。

この例では、WIC は、完全な URL の代わりに使用できる XMP スキーマのフレンドリ識別子を提供します。 そのため、前のクエリは次のように書き換えることができます。

• /xmp/xmp:Rating

WIC では、次の一般的に使用されるスキーマのわかりやすいスキーマ プレフィックスが提供されます。

特定のスキーマに対するフレンドリ スキーマ プレフィックスがない場合 (たとえば、イメージにカスタムサード パーティ スキーマを使用する XMP メタデータが含まれている場合)、メタデータ クエリでは完全なスキーマ URL を使用する必要があります。

関連トピック

概念

Windows イメージング コンポーネントの概要

WIC メタデータの概要

メタデータ クエリ言語の概要

メタデータ機能拡張の概要

方法: メタデータを使用して JPEG イメージを再エンコードする