Consultas de metadados de formato de imagem nativa

Este tópico fornece uma visão geral das consultas de linguagem de consulta de metadados para ler e gravar metadados compatíveis com imagens GIF, PNG, TIFF e JPEG. Ele inclui metadados específicos para cada formato de imagem, bem como metadados compatíveis com vários formatos.

Este tópico inclui as seções a seguir.

• Pré-requisitos
• Expressão de política de metadados de foto
• Metadados específicos do formato de arquivo
  • Metadados GIF
  • Metadados PNG
  • Metadados TIFF
  • Metadados JPEG
• Metadados independentes de formato de arquivo
  • Metadados IFD
  • Metadados EXIF
  • Metadados de GPS
  • Metadados XMP
• Tópicos relacionados

Pré-requisitos

Para entender este tópico, você deve estar familiarizado com o sistema de metadados do Componente de Imagem do Windows (WIC), conforme descrito na Visão geral dos metadados do WIC. Você também deve estar familiarizado com a linguagem de consulta usada para ler e gravar metadados, conforme descrito em Visão geral da linguagem de consulta de metadados.

Expressão de política de metadados de foto

Além de dar suporte à linguagem de consulta de metadados, o WIC também aceita nomes de propriedades canônicas do Sistema de Propriedades do Windows. O WIC dá suporte a um subconjunto do namespace de propriedade do Windows relevante para formatos de imagem, conforme descrito em Políticas de Metadados de Fotos. Uma propriedade do Windows usada como uma consulta de metadados wic é conhecida como uma expressão de política de metadados de foto.

Por exemplo, a expressão de política de metadados de foto para o sinalizador de orientação EXIF é:

• System.Photo.Orientation

Em geral, as expressões de política são recomendadas em consultas de metadados nativos para itens comuns de metadados de imagem cobertos pelo namespace da propriedade do Windows. A linguagem de consulta de metadados é mais adequada para casos em que o acesso de baixo nível a itens de metadados de imagem específicos é necessário ou para itens de metadados personalizados ou avançados que não são compatíveis com o sistema de propriedades do Windows. Para obter mais informações, consulte Expressões de política de metadados de fotos.

Metadados específicos do formato de arquivo

As seções a seguir contêm tabelas que listam as consultas de metadados disponíveis para cada tipo de arquivo de imagem. Cada tabela tem as seguintes colunas:

• Caminho – o caminho de consulta usado para recuperar o item de metadados.
• Nome – o nome do item de metadados.
• Tipo – o tipo do item de metadados recuperado do caminho da consulta. Os metadados recuperados pelo WIC são retornados na forma de PROPVARIANT, que relata o tipo de dados usando a enumeração VARTYPE.on.

Os caminhos de consulta são usados pela API de metadados do WIC para acessar os metadados inseridos de uma imagem. O código de exemplo a seguir demonstra o uso de um IWICMetadataQueryReader para consultar o bloco de metadados IFD de um 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.
}

Metadados GIF

O formato de imagem GIF (Graphics Interchange Format) dá suporte a metadados globais e de nível de quadro. As duas seções a seguir fornecem os caminhos de consulta de metadados disponíveis para metadados globais e de nível de quadro do GIF.

Metadados globais

A tabela a seguir fornece os caminhos de consulta de metadados disponíveis que podem ser usados para acessar metadados GIF globais.

Metadados de quadro

A tabela a seguir fornece os caminhos de consulta de metadados disponíveis que podem ser usados para acessar metadados GIF no nível do quadro.

Metadados PNG

O formato de imagem PNG (Portable Network Graphics) dá suporte a metadados no nível do quadro.

Metadados de quadro

A tabela a seguir fornece os caminhos de consulta de metadados disponíveis que podem ser usados para acessar metadados PNG no nível do quadro.

Metadados TIFF

O formato de imagem TIFF (Formato de Arquivo de Imagem Marcado) dá suporte a metadados no nível do quadro.

Metadados de quadro

A tabela a seguir fornece os caminhos de consulta de metadados disponíveis que podem ser usados para acessar metadados TIFF no nível do quadro.

Metadados JPEG

O formato de imagem JPEG dá suporte a metadados no nível do quadro.

Metadados de quadro

A tabela a seguir fornece os caminhos de consulta de metadados disponíveis que podem ser usados para acessar metadados JPEG no nível do quadro.

Metadados independentes de formato de arquivo

As seções a seguir contêm informações sobre formatos de metadados compatíveis com vários formatos de imagem. Cada tabela tem as seguintes colunas:

• Caminho Relativo – o caminho de consulta usado para recuperar o item de metadados, em relação ao bloco de metadados.
• Nome – o nome do item de metadados.
• Tipo – o tipo do item de metadados recuperado do caminho da consulta. Os metadados recuperados pelo WIC são retornados na forma de PROPVARIANT, que relata o tipo de dados usando a enumeração VARTYPE.

Por exemplo, para acessar o sinalizador de orientação em um arquivo JPEG, use a seguinte expressão:

• /app1/ifd/{ushort=274}

Em um arquivo TIFF, use a seguinte expressão:

• /ifd/{ushort=274}

Neste exemplo, observe que diferentes formatos de imagem podem armazenar um bloco de metadados específico de forma diferente e, portanto, a consulta de metadados totalmente qualificada para acessar um item de metadados específico pode ser específica do formato de imagem. Consulte a tabela de cada formato para encontrar a consulta de metadados apropriada para acessar um bloco de metadados específico.

Metadados IFD

Um IFD ou Diretório de Arquivos de Imagem é uma estrutura de dados definida no padrão TIFF que pode conter metadados de imagem. Ele identifica cada item de metadados usando uma marca do tipo ushort. JPEG, TIFF e JPEG-XR dão suporte a metadados IFD. Formatos de terceiros, como alguns formatos brutos de câmera, também podem dar suporte a metadados IFD.

A tabela aqui fornece caminhos de consulta de metadados relativos para acessar alguns itens de metadados IFD comumente usados. A estrutura de dados IFD permite extensibilidade de terceiros e essa tabela não é uma lista exaustiva. Consulte o padrão TIFF para obter mais informações.

Metadados EXIF

Os metadados EXIF são definidos como parte da especificação EXIF JPEG. Os metadados EXIF baseiam-se na estrutura de dados IFD, conforme definido no padrão TIFF, e fornecem atributos adicionais, como informações sobre os dispositivos e atributos fotográficos usados para criar a imagem. Ele identifica cada item de metadados usando uma marca do tipo ushort. JPEG, TIFF e JPEG-XR dão suporte a metadados EXIF. Formatos de terceiros, como alguns formatos brutos de câmera, também podem dar suporte a metadados EXIF.

A tabela a seguir fornece caminhos de consulta de metadados relativos para acessar alguns itens de metadados EXIF comumente usados. A estrutura de dados EXIF permite extensibilidade de terceiros e essa tabela não é uma lista exaustiva; consulte o padrão EXIF para obter mais informações.

Metadados de GPS

Os metadados gps contêm informações de geolocalização e são definidos como parte da especificação EXIF JPEG. Ele identifica cada item de metadados usando uma marca do tipo ushort. JPEG, TIFF e JPEG-XR dão suporte a metadados GPS; Formatos de terceiros, como alguns formatos brutos de câmera, também podem dar suporte a metadados gps.

A tabela a seguir fornece caminhos de consulta de metadados relativos para acessar alguns itens de metadados GPS comumente usados. Esta tabela não é uma lista exaustiva; consulte o padrão EXIF para obter mais informações.

Metadados XMP

O XMP é um padrão de metadados extensível baseado em XML. Os itens de metadados podem ser hierárquicos e conter estruturas de dados complexas. JPEG, TIFF e JPEG-XR dão suporte a metadados XMP. Formatos de terceiros, como alguns formatos brutos de câmera, também podem dar suporte a metadados XMP.

O padrão XMP pode ser obtido de: https://www.adobe.com/devnet/xmp.html.

XMP e permite que entidades de terceiros publiquem seus próprios esquemas ou namespaces, o que lhes permite definir novos itens de metadados sem precisar modificar o padrão XMP. Um esquema XMP é identificado exclusivamente por uma URL, mas o WIC fornece um conjunto de identificadores amigáveis para esquemas conhecidos.

Os itens de metadados XMP são identificados por um nome de cadeia de caracteres, bem como por um identificador de esquema. Como prática recomendada, cada consulta de metadados XMP deve especificar o esquema e o nome. Se o identificador de esquema estiver ausente, o JPEG tentará corresponder ao nome dos metadados em todos os namespaces presentes no pacote de metadados XMP.

Por exemplo, para obter a propriedade Rating conforme definido pelo esquema XMP em uma imagem JPEG, use a seguinte consulta:

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

A primeira parte, "/xmp", recupera o leitor/gravador de metadados XMP para a imagem. "https://ns.adobe.com/xap/1.0/" é a URL do esquema XMP, conforme definido no padrão XMP. A URL é colocada em uma expressão de dados para permitir o uso de caracteres, como uma barra (/). Por fim, "Rating" é o nome real do item de metadados, conforme definido pelo esquema XMP e é separado do identificador de esquema por dois-pontos (:).

Neste exemplo, o WIC fornece um identificador amigável para o esquema XMP que pode ser usado no lugar da URL completa. Portanto, a consulta anterior pode ser reescrita como:

• /xmp/xmp:Rating

O WIC fornece prefixos de esquema amigáveis para os seguintes esquemas comumente usados:

Se não houver nenhum prefixo de esquema amigável para um esquema específico, por exemplo, se uma imagem contiver metadados XMP usando um esquema de terceiros personalizado, a consulta de metadados deverá usar a URL de esquema completa.

Tópicos relacionados

Conceitual

Visão geral do componente de imagem do Windows

Visão geral dos metadados do WIC

Visão geral da linguagem de consulta de metadados

Visão geral da extensibilidade de metadados

Instruções: recodificar uma imagem JPEG com metadados