画像メタデータの読み取りと書き込みの概要

[アーティクル]
06/12/2023

このトピックでは、Windows Imaging Component (WIC) API を使用して、イメージファイルに埋め込まれたメタデータの読み取りと書き込みを行う方法の概要について説明します。

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

前提条件
はじめに
クエリリーダーを使用したメタダデータの読み取り
クエリライターを使用したメタデータの書き込み
高速メタデータエンコード
関連トピック

前提条件

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

はじめに

WIC は、アプリケーション開発者にコンポーネントオブジェクトモデル (COM) コンポーネントを提供し、イメージファイルに埋め込まれたメタデータの読み取りと書き込みを行います。メタデータの読み取りと書き込みには、次の 2 つの方法があります。

クエリリーダー/ライターとクエリ式を使用して、入れ子になったブロックまたはブロック内の特定のメタデータのメタデータブロックに対してクエリを実行します。
メタデータハンドラー (メタデータリーダーまたはメタデータライター) を使用して、入れ子になったメタデータブロックまたはメタデータブロック内の特定のメタデータにアクセスします。

最も簡単なのは、クエリリーダー/ライターとクエリ式を使用してメタデータにアクセスすることです。クエリリーダー (IWICMetadataQueryReader) を使用してメタデータを読み取り、クエリライター (IWICMetadataQueryWriter) を使用してメタデータを書き込みます。どちらもクエリ式を使用して、目的のメタデータの読み取りまたは書き込みを行います。バックグラウンドでは、クエリリーダー (およびライター) はメタデータハンドラーを使用して、クエリ式によって記述されたメタデータにアクセスします。

より高度なメソッドは、メタデータハンドラーに直接アクセスすることです。メタデータハンドラーは、ブロックリーダー (IWICMetadataBlockReader) またはブロックライター (IWICMetadataBlockWriter) を使用して、個々のフレームから取得されます。使用できるメタデータハンドラーの 2 種類は、メタデータリーダー (IWICMetadataReader) とメタデータライター (IWICMetadataWriter) です。

このトピックの例では、JPEG イメージファイルの内容を次の図に示します。この図で表される画像は、Microsoft ペイントを使用して作成されました。評価メタデータは、Windows Vista のフォトギャラリー機能を使用して追加されました。

評価メタデータを含む jpeg 画像の図

クエリリーダーを使用したメタダデータの読み取り

メタデータを読み取る最も簡単な方法は、クエリリーダーインターフェイス IWICMetadataQueryReader を使用することです。クエリリーダーを使用すると、クエリ式を使用してメタデータブロックとメタデータブロック内の項目を読み取ることができます。

クエリリーダーを取得するには、ビットマップデコーダー (IWICBitmapDecoder)、個々のフレーム (IWICBitmapFrameDecode)、またはクエリライター (IWICMetadataQueryWriter) の 3 つの方法があります。

クエリリーダーの取得

次のコード例は、イメージングファクトリからビットマップデコーダーを取得し、個々のビットマップフレームを取得する方法を示しています。このコードでは、デコードされたフレームからクエリリーダーを取得するために必要なセットアップ作業も実行します。

IWICImagingFactory *pFactory = NULL;
IWICBitmapDecoder *pDecoder = NULL;
IWICBitmapFrameDecode *pFrameDecode = NULL;
IWICMetadataQueryReader *pQueryReader = NULL;
IWICMetadataQueryReader *pEmbedReader = NULL;
PROPVARIANT value;

// Initialize COM
CoInitialize(NULL);

// Initialize PROPVARIANT
PropVariantInit(&value);

//Create the COM imaging factory
HRESULT hr = CoCreateInstance(
    CLSID_WICImagingFactory,
    NULL,
    CLSCTX_INPROC_SERVER,
    IID_IWICImagingFactory,
    (LPVOID*)&pFactory);

// Create the decoder
if (SUCCEEDED(hr))
{
    hr = pFactory->CreateDecoderFromFilename(
        L"test.jpg",
        NULL,
        GENERIC_READ,
        WICDecodeMetadataCacheOnDemand,
        &pDecoder);
}

// Get a single frame from the image
if (SUCCEEDED(hr))
{
    hr = pDecoder->GetFrame(
         0,  //JPEG has only one frame.
         &pFrameDecode); 
}

test.jpg ファイルのビットマップデコーダーは、イメージングファクトリの CreateDecoderFromFilename メソッドを使用して取得されます。このメソッドでは、4 番目のパラメーターは WICDecodeOptions 列挙の値 WICDecodeMetadataCacheOnDemand に設定されます。これにより、メタデータが必要になったときにメタデータをキャッシュするようにデコーダーに指示されます。クエリリーダーまたは基になるメタデータリーダーを取得します。このオプションを使用すると、高速メタデータエンコードに必要なメタデータへのストリームを保持でき、JPEG イメージのロスレスデコードが可能になります。または、他の WICDecodeOptions 値 WICDecodeMetadataCacheOnLoad を使用して、イメージが読み込まれるとすぐに埋め込みイメージメタデータをキャッシュすることもできます。

フレームのクエリリーダーを取得するには、フレームの GetMetadataQueryReader メソッドを簡単に呼び出します。次のコードは、この呼び出しを示しています。

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

同様に、クエリリーダーもデコーダーレベルで取得できます。デコーダーの GetMetadataQueryReader メソッドを簡単に呼び出すと、デコーダーのクエリリーダーが取得されます。デコーダーのクエリリーダーは、フレームのクエリリーダーとは異なり、個々のフレームの外部にあるイメージのメタデータを読み取ります。ただし、このシナリオは一般的ではなく、ネイティブイメージ形式ではこの機能はサポートされていません。 WIC によって提供されるネイティブイメージコーデックは、JPEG などの単一フレーム形式の場合でも、フレームレベルでメタデータを読み取りおよび書き込みます。

メタデータの読み取り

実際にメタデータを読み取る前に、埋め込みメタデータブロックと取得する実際のデータを含む JPEG ファイルの次の図を参照してください。この図では、画像内の特定のメタデータブロックとアイテムへの吹き出しを提供し、メタデータクエリ式を各ブロックまたは項目に提供します。

メタデータ吹き出しを含む jpeg 画像の図

埋め込まれたメタデータブロックまたは特定のアイテムを名前で照会するには、 GetMetadataByName メソッドを呼び出します。このメソッドは、クエリ式と、メタデータ項目が返される PROPVARIANT を受け取ります。次のコードは、入れ子になったメタデータブロックを照会し、PROPVARIANT 値によって提供される IUnknown コンポーネントが見つかった場合にクエリリーダーに変換します。

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 **)&pEmbedReader);
    }
    PropVariantClear(&value); // Clear value for new query
}

クエリ式 "/app1/ifd" は、App1 ブロックに入れ子になった IFD ブロックに対してクエリを実行しています。 JPEG イメージファイルには IFD 入れ子になったメタデータブロックが含まれているため、PROPVARIANT はの変数型 (vt) と IUnknown インターフェイス (punkVal) VT_UNKNOWN へのポインターを使用して返されます。次に、クエリリーダーの IUnknown インターフェイスに対してクエリを実行します。

次のコードは、入れ子になった IFD ブロックに対する新しいクエリリーダーに基づく新しいクエリを示しています。

if (SUCCEEDED(hr))
{
    hr = pEmbedReader->GetMetadataByName(L"/{ushort=18249}", &value);
    PropVariantClear(&value); // Clear value for new query
}

クエリ式 "/{ushort=18249}" は、タグ 18249 に埋め込まれた MicrosoftPhoto 評価の IFD ブロックに対してクエリを実行します。 PROPVARIANT 値には、の値型VT_UI2と 50 のデータ値が含まれるようになりました。

ただし、特定のデータ値に対してクエリを実行する前に、入れ子になったブロックを取得する必要はありません。たとえば、入れ子になった IFD に対してクエリを実行してから MicrosoftPhoto 評価を照会する代わりに、ルートメタデータブロックと次のコードに示すクエリを使用して、同じ情報を取得できます。

if (SUCCEEDED(hr))
{
    hr = pQueryReader->GetMetadataByName(L"/app1/ifd/{ushort=18249}", &value);
    PropVariantClear(&value);
}

メタデータブロック内の特定のメタデータ項目に対するクエリに加えて、メタデータブロック内のすべてのメタデータ項目を列挙することもできます (入れ子になったメタデータブロック内のメタデータ項目は含まれません)。現在のブロック内のメタデータ項目を列挙するために、クエリリーダーの GetEnumeration メソッドが使用されます。このメソッドは、現在のブロック内のメタデータ項目が設定された IEnumString インターフェイスを取得します。たとえば、次のコードは、前に取得した入れ子になった IFD ブロックの XMP 評価と MicrosoftPhoto 評価を列挙します。

IEnumString *metadataItems = NULL;

if (SUCCEEDED(hr))
{
    hr = pEmbedReader->GetEnumerator(&metadataItems);
}

さまざまなイメージ形式とメタデータ形式に適したタグを識別する方法の詳細については、「ネイティブイメージ形式メタデータクエリ」を参照してください。

その他のクエリリーダーメソッド

メタデータの読み取りに加えて、クエリリーダーに関する追加情報を取得し、他の方法でメタデータを取得することもできます。クエリリーダーには、クエリリーダー GetContainerFormat と GetLocation に関する情報を提供する 2 つのメソッド が用意されています。

埋め込みクエリリーダーを使用すると、 GetContainerFormat を 使用してメタデータブロックの種類を決定できます。 また、GetLocation を呼び出して、ルートメタデータブロックに対する相対パスを取得できます。次のコードは、埋め込みクエリリーダーにその場所を照会します。

// Determine the metadata block format

if (SUCCEEDED(hr))
{
    hr = pEmbedReader->GetContainerFormat(&containerGUID);
}

// Determine the query reader's location
if (SUCCEEDED(hr))
{
    UINT length;
    WCHAR readerNamespace[100];
    hr = pEmbedReader->GetLocation(100, readerNamespace, &length);
}

埋め込みクエリリーダーの GetContainerFormat を呼び出すと、IFD メタデータ形式 GUID が返されます。 GetLocation の呼び出しは、"/app1/ifd" の名前空間を返します。新しいクエリリーダーへの後続のクエリの実行元となる相対パスを指定します。もちろん、上記のコードはあまり役に立ちませんが、入れ子になったメタデータブロックを検索するために GetLocation メソッドを使用する方法を示しています。

クエリライターを使用したメタデータの書き込み

注意

このセクションで提供されるコード例の一部は、メタデータの書き込みに必要な実際の手順のコンテキストでは示されていません。作業サンプルのコンテキストでコード例を表示するには、「方法: メタデータを使用してイメージを再エンコードする」チュートリアルを参照してください。

メタデータを書き込むメインコンポーネントは、クエリライター (IWICMetadataQueryWriter) です。クエリライターを使用すると、メタデータブロック内のメタデータブロックと項目を設定および削除できます。

クエリリーダーと同様に、クエリライターを取得するには、ビットマップエンコーダー (IWICBitmapEncoder)、個々のフレーム (IWICBitmapFrameEncode)、高速メタデータエンコーダー (IWICFastMetadataEncoder) の 3 つの方法があります。

クエリライターの取得

最も一般的なクエリライターは、ビットマップの個々のフレームです。このクエリライターは、イメージフレームのメタデータブロックと項目を設定および削除します。イメージフレームのクエリライターを取得するには、フレームの GetMetadataQueryWriter メソッドを呼び出します。次のコードは、フレームのクエリライターを取得するための単純なメソッド呼び出しを示しています。

IWICMetadataQueryWriter &pFrameQWriter = NULL;

//Obtain a query writer from the frame.
hr = pFrameEncode->GetMetadataQueryWriter(&pFrameQWriter);

同様に、エンコーダーレベルに対してクエリライターを取得することもできます。エンコーダーの GetMetadataQueryWriter メソッドを簡単に呼び出すと、エンコーダーのクエリライターが取得されます。エンコーダーのクエリライターは、フレームのクエリライターとは異なり、個々のフレームの外部にあるイメージのメタデータを書き込みます。ただし、このシナリオは一般的ではなく、ネイティブイメージ形式ではこの機能はサポートされていません。 WIC によって提供されるネイティブイメージコーデックは、JPEG などの単一フレーム形式の場合でも、フレームレベルでメタデータを読み取りおよび書き込みます。

また、イメージングファクトリ (IWICImagingFactory) から直接クエリライターを取得することもできます。クエリライターを返すイメージングファクトリメソッドには、CreateQueryWriter と CreateQueryWriterFromReader の 2 つがあります。

CreateQueryWriter は 、指定されたメタデータ形式とベンダーのクエリライターを作成します。このクエリライターを使用すると、特定のメタデータ形式のメタデータを書き込み、それをイメージに追加できます。次のコードは、XMP クエリライターを作成するための CreateQueryWriter 呼び出しを示しています。

IWICMetadataQueryWriter *pXMPWriter = NULL;

// Create XMP block
GUID vendor = GUID_VendorMicrosoft;
hr = pFactory->CreateQueryWriter(
        GUID_MetadataFormatXMP,
        &vendor,
        &pXMPWriter);

この例では、フレンドリ名 GUID_MetadataFormatXMP が guidMetadataFormat パラメーターとして使用されます。これは XMP メタデータ形式 GUID を表し、ベンダーは Microsoft によって作成されたハンドラーを表します。または、他の XMP ハンドラーが存在しない場合は、同じ結果を持つ pguidVendor パラメーターとして NULL を渡すことができます。ネイティブ XMP ハンドラーと共にカスタム XMP ハンドラーがインストールされている場合、ベンダーに NULL を 渡すと、返される GUID が最も低いクエリライターになります。

CreateQueryWriterFromReader は CreateQueryWriter メソッドに似ていますが、新しいクエリライターにクエリリーダーによって提供されるデータが事前に設定される点が除きます。これは、既存のメタデータを維持しながらイメージを再エンコードする場合や、不要なメタデータを削除する場合に便利です。次のコードは、 CreateQueryWriterFromReader 呼び出しを示しています。

hr = pFrameDecode->GetMetadataQueryReader(&pFrameQReader);

// Copy metadata using query readers
if(SUCCEEDED(hr) && pFrameQReader)
{
    IWICMetadataQueryWriter *pNewWriter = NULL;

    GUID vendor = GUID_VendorMicrosoft;
    hr = pFactory->CreateQueryWriterFromReader(
        pFrameQReader,
        &vendor,
        &pNewWriter);

メタデータの追加

クエリライターを取得したら、それを使用してメタデータブロックと項目を追加できます。メタデータを書き込むには、クエリライターの SetMetadataByName メソッドを 使用します。 SetMetadataByName は、クエリ式 (wzName) と PROPVARIANT (pvarValue) へのポインターという 2 つのパラメーターを受け取ります。クエリ式は設定するブロックまたは項目を定義しますが、PROPVARIANT は設定する実際のデータ値を提供します。

次の例では、 CreateQueryWriter メソッドを使用して以前に取得した XMP クエリライターを使用してタイトルを追加する方法を示します。

// Write metadata to the XMP writer
if (SUCCEEDED(hr))
{
    PROPVARIANT value;
    PropVariantInit(&value);

    value.vt = VT_LPWSTR;
    value.pwszVal = L"Metadata Test Image.";
   
    hr = pXMPWriter->SetMetadataByName(L"/dc:title", &value);

    PropVariantClear(&value);
}

この例では、値の型 (vt) がに VT_LPWSTR設定され、文字列がデータ値として使用されることを示します。値の型は文字列であるため、pwszVal を使用して、使用するタイトルを設定します。 SetMetadataByName は、クエリ式 "/dc:title" と新しく設定された PROPVARIANT を使用して呼び出されます。使用されるクエリ式は、デジタルカメラ (dc) スキーマの title プロパティを設定する必要があることを示します。式が "/xmp/dc:title" ではないことに注意してください。これは、クエリライターが XMP に既に固有であり、埋め込み XMP ブロックが含まれていないためです。これは、"/xmp/dc:title" が推奨します。

ここまでは、実際に画像フレームにメタデータを追加していません。クエリライターにデータを設定するだけです。クエリライターによって表されるメタデータブロックをフレームに追加するには、再び PROPVARIANT の値としてクエリライターを使用して SetMetadataByName を呼び出します。これにより、クエリライター内のメタデータがイメージフレームに効果的にコピーされます。次のコードは、以前に取得した XMP クエリライターのメタデータをフレームのルートメタデータブロックに追加する方法を示しています。

// Get the frame's query writer and write the XMP query writer to it
if (SUCCEEDED(hr))
{
    hr = pFrameEncode->GetMetadataQueryWriter(&pFrameQWriter);

    // Copy the metadata in the XMP query writer to the frame
    if (SUCCEEDED(hr))
    {
        PROPVARIANT value;

        PropVariantInit(&value);
        value.vt = VT_UNKNOWN;
        value.punkVal = pXMPWriter;
        value.punkVal->AddRef();

        hr = pFrameQWriter->SetMetadataByName(L"/", &value);

        PropVariantClear(&value);
    }
}

この例では、の値型 (vt) VT_UNKOWN が使用されます。COM インターフェイスの値の型を示します。その後、XMP クエリライター (piXMPWriter) が PROPVARIANT の値として使用され、AddRef メソッドを使用して参照が追加されます。最後に、XMP クエリライターを設定するには、フレームの SetMetadataByName メソッドを呼び出し、ルートブロックと新しく設定された PROPVARIANT を示すクエリ式 "/" を渡します。

注意

追加しようとしているメタデータブロックがフレームに既に含まれている場合は、追加するメタデータが追加され、既存のメタデータが上書きされます。

メタデータの削除

クエリライターを使用すると、 RemoveMetadataByName メソッドを呼び出してメタデータを削除することもできます。 RemoveMetadataByName はクエリ式を受け取り、メタデータブロックまたはアイテムが存在する場合は削除します。次のコードは、以前に追加されたタイトルを削除する方法を示しています。

if (SUCCEEDED(hr))
{
    hr = pFrameQWriter->RemoveMetadataByName(L"/xmp/dc:title");
}

次のコードは、XMP メタデータブロック全体を削除する方法を示しています。

if (SUCCEEDED(hr))
{
    hr = pFrameQWriter->RemoveMetadataByName(L"/xmp");
}

再エンコード用のメタデータのコピー

注意

このセクションのコードは、ソースとコピー先のイメージの形式が同じ場合にのみ有効です。別のイメージ形式にエンコードする場合、1 回の操作ですべてのイメージのメタデータをコピーすることはできません。

イメージを同じイメージ形式に再エンコードするときにメタデータを保持するために、すべてのメタデータを 1 回の操作でコピーできるメソッドがあります。これらの各操作は、同様のパターンに従います。では、デコードされたフレームのメタデータがエンコードされる新しいフレームに直接設定されます。

メタデータをコピーする方法として推奨される方法は、デコードされたフレームのブロックリーダーを使用して、新しいフレームのブロックライターを初期化することです。次のコードは、このメソッドを示しています。

if (SUCCEEDED(hr) && formatsEqual)
{
    // Copy metadata using metadata block reader/writer
    if (SUCCEEDED(hr))
    {
        pFrameDecode->QueryInterface(
            IID_IWICMetadataBlockReader,
            (void**)&pBlockReader);
    }
    if (SUCCEEDED(hr))
    {
        pFrameEncode->QueryInterface(
            IID_IWICMetadataBlockWriter,
            (void**)&pBlockWriter);
    }
    if (SUCCEEDED(hr))
    {
        pBlockWriter->InitializeFromBlockReader(pBlockReader);
    }
}

この例では、ブロックリーダーとブロックライターは、それぞれソースフレームとターゲットフレームから取得されます。その後、ブロックライターはブロックリーダーから初期化されます。これにより、ブロックリーダーの事前設定されたメタデータを使用してブロックリーダーが初期化されます。

メタデータをコピーするもう 1 つの方法は、エンコーダーのクエリライターを使用してクエリリーダーによって参照されるメタデータブロックを書き込む方法です。次のコードは、このメソッドを示しています。

if (SUCCEEDED(hr) && formatsEqual)
{
    hr = pFrameDecode->GetMetadataQueryReader(&pFrameQReader);

    // Copy metadata using query readers
    if(SUCCEEDED(hr))
    {
        hr = pFrameEncode->GetMetadataQueryWriter(&pFrameQWriter);
        if (SUCCEEDED(hr))
        {
            PropVariantClear(&value);
            value.vt=VT_UNKNOWN;
            value.punkVal=pFrameQReader;
            value.punkVal->AddRef();
            hr = pFrameQWriter->SetMetadataByName(L"/", &value);
            PropVariantClear(&value);
        }
    }
}

ここで、クエリリーダーはデコードされたフレームから取得され、値型が VT_UNKNOWN に設定された PROPVARIANT のプロパティ値として使用されます。エンコーダーのクエリライターが取得され、クエリ式 "/" を使用して、ルートナビゲーションパスにメタデータが設定されます。クエリ式を目的の場所に調整することで、入れ子になったメタデータブロックを設定するときにも、このメソッドを使用できます。

同様に、イメージングファクトリの CreateQueryWriterFromReader メソッドを使用して、デコードされたフレームのクエリリーダーに基づいてクエリライターを作成できます。この操作で作成されたクエリライターには、クエリリーダーからのメタデータが事前設定され、フレームで設定できます。次のコードは、 CreateQueryWriterFromReader コピー操作を示しています。

IWICMetadataQueryWriter *pNewWriter = NULL;

GUID vendor = GUID_VendorMicrosoft;
hr = pFactory->CreateQueryWriterFromReader(
    pFrameQReader,
    &vendor,
    &pNewWriter);

if (SUCCEEDED(hr))
{
    // Get the frame's query writer
    hr = pFrameEncode->GetMetadataQueryWriter(&pFrameQWriter);
}

// Set the query writer to the frame.
if (SUCCEEDED(hr))
{
    PROPVARIANT value;

    PropVariantInit(&value);
    value.vt = VT_UNKNOWN;
    value.punkVal = pNewWriter;
    value.punkVal->AddRef();
    hr = pFrameQWriter->SetMetadataByName(L"/",&value);
}

このメソッドは、クエリリーダーのデータに基づいて作成される個別のクエリライターを使用します。この新しいクエリライターは、フレームに設定されます。

ここでも、メタデータをコピーするこれらの操作は、ソースイメージとコピー先イメージの形式が同じ場合にのみ機能します。これは、異なるイメージ形式でメタデータブロックが異なる場所に格納されるためです。たとえば、JPEG と TIFF の両方で XMP メタデータブロックがサポートされます。 JPEG 画像では、「 WIC メタデータの概要」に示すように、XMP ブロックはルートメタデータブロックにあります。ただし、TIFF イメージでは、XMP ブロックはルート IFD ブロックに入れ子になっています。次の図は、JPEG 画像と同じ評価メタデータを持つ TIFF イメージの違いを示しています。

jpeg と tiff の比較。

高速メタデータエンコード

新しいメタデータを書き込むには、必ずしもイメージを再エンコードする必要はありません。メタデータは、高速メタデータエンコーダーを使用して書き込むこともできます。高速メタデータエンコーダーでは、イメージを再エンコードすることなく、限られた量のメタデータをイメージに書き込むことができます。これは、一部のメタデータ形式によって提供される空のパディング内に新しいメタデータを書き込むことで実現されます。メタデータの埋め込みをサポートするネイティブメタデータ形式は、Exif、IFD、GPS、XMP です。

メタデータブロックへのパディングの追加

高速メタデータエンコードを実行するには、メタデータブロック内に、より多くのメタデータを書き込むスペースが必要です。既存のパディング内に新しいメタデータを書き込むのに十分なスペースがない場合、高速メタデータエンコードは失敗します。画像にメタデータパディングを追加するには、イメージを再エンコードする必要があります。埋め込み中のメタデータブロックでサポートされている場合は、クエリ式を使用して、他のメタデータ項目を追加するのと同じ方法でパディングを追加できます。次の例では、App1 ブロックに埋め込まれた IFD ブロックにパディングを追加する方法を示します。

if (SUCCEEDED(hr))
{
    // Add metadata padding
    PROPVARIANT padding;

    PropVariantInit(&padding);
    padding.vt = VT_UI4;
    padding.uiVal = 4096; // 4KB

    hr = pFrameQWriter->SetMetadataByName(L"/app1/ifd/PaddingSchema:padding", &padding);

    PropVariantClear(&padding);
}

パディングを追加するには、VT_UI4型の PROPVARIANT と、追加するパディングのバイト数に対応する値を作成します。一般的な値は 4096 バイトです。 JPEG、TIFF、JPEG-XR のメタデータクエリを次の表に示します。

メタデータ形式	JPEG メタデータクエリ	TIFF、JPEG-XR メタデータクエリ
IFD	/app1/ifd/PaddingSchema:Padding	/ifd/PaddingSchema:Padding
Exif	/app1/ifd/exif/PaddingSchema:Padding	/ifd/exif/PaddingSchema:Padding
Xmp	/xmp/PaddingSchema:Padding	/ifd/xmp/PaddingSchema:Padding
GPS	/app1/ifd/gps/PaddingSchema:Padding	/ifd/gps/PaddingSchema:Padding

高速メタデータエンコーダーの取得

メタデータパディングを含むイメージがある場合は、イメージングファクトリメソッド CreateFastMetadataEncoderFromDecoder と CreateFastMetadataEncoderFromFrameDecode を使用して高速メタデータエンコーダーを取得できます。

名前が示すように、 CreateFastMetadataEncoderFromDecoder はデコーダーレベルのメタデータ用の高速メタデータエンコーダーを作成します。 WIC によって提供されるネイティブイメージ形式はデコーダーレベルのメタデータをサポートしていませんが、このようなイメージ形式が将来開発される場合に備えて、このメソッドが提供されます。

より一般的なシナリオは、 CreateFastMetadataEncoderFromFrameDecode を使用して、イメージフレームから高速メタデータエンコーダーを取得することです。次のコードは、デコードされたフレームの高速メタデータエンコーダーを取得し、App1 ブロックの評価値を変更します。

if (SUCCEEDED(hr))
{
    IWICFastMetadataEncoder *pFME = NULL;
    IWICMetadataQueryWriter *pFMEQW = NULL;

    hr = pFactory->CreateFastMetadataEncoderFromFrameDecode(
        pFrameDecode, 
        &pFME);
}

高速メタデータエンコーダーの使用

高速メタデータエンコーダーから、クエリライターを取得できます。これにより、前に示したようにクエリ式を使用してメタデータを記述できます。クエリライターでメタデータが設定されたら、高速メタデータエンコーダーをコミットしてメタデータの更新を完了します。次のコードは、メタデータの変更の設定とコミットを示しています

    if (SUCCEEDED(hr))
    {
        hr = pFME->GetMetadataQueryWriter(&pFMEQW);
    }

    if (SUCCEEDED(hr))
    {
        // Add additional metadata
        PROPVARIANT value;

        PropVariantInit(&value);

        value.vt = VT_UI4;
        value.uiVal = 99;
        hr = pFMEQW->SetMetadataByName(L"/app1/ifd/{ushort=18249}", &value);

        PropVariantClear(&value);
    }

    if (SUCCEEDED(hr))
    {
        hr = pFME->Commit();
    }
}

何らかの理由 でコミット が失敗した場合は、イメージを再エンコードして、新しいメタデータがイメージに追加されるようにする必要があります。

概念
Windows イメージングコンポーネントの概要
WIC メタデータの概要
メタデータクエリ言語の概要
メタデータ機能拡張の概要
方法: メタデータを使用して JPEG イメージを再エンコードする

次の方法で共有

画像メタデータの読み取りと書き込みの概要

前提条件

はじめに

クエリリーダーを使用したメタダデータの読み取り

クエリリーダーの取得

メタデータの読み取り

その他のクエリリーダーメソッド

クエリライターを使用したメタデータの書き込み

クエリライターの取得

メタデータの追加

メタデータの削除

再エンコード用のメタデータのコピー

高速メタデータエンコード

メタデータブロックへのパディングの追加

高速メタデータエンコーダーの取得

高速メタデータエンコーダーの使用

フィードバック

その他のリソース

次の方法で共有

画像メタデータの読み取りと書き込みの概要

前提条件

はじめに

クエリ リーダーを使用したメタダデータの読み取り

クエリ リーダーの取得

メタデータの読み取り

その他のクエリ リーダー メソッド

クエリ ライターを使用したメタデータの書き込み

クエリ ライターの取得

メタデータの追加

メタデータの削除

再エンコード用のメタデータのコピー

高速メタデータ エンコード

メタデータ ブロックへのパディングの追加

高速メタデータ エンコーダーの取得

高速メタデータ エンコーダーの使用

関連トピック

フィードバック

その他のリソース

クエリリーダーを使用したメタダデータの読み取り

クエリリーダーの取得

その他のクエリリーダーメソッド

クエリライターを使用したメタデータの書き込み

クエリライターの取得

高速メタデータエンコード

メタデータブロックへのパディングの追加

高速メタデータエンコーダーの取得

高速メタデータエンコーダーの使用