Introducción al lenguaje de consulta de metadatos

En este tema se presenta el lenguaje de consulta de metadatos para el componente de creación de imágenes de Windows (WIC). Use el lenguaje de consulta de metadatos para crear expresiones que encuentren datos específicos (elementos de metadatos) y ubicaciones (bloques de metadatos) dentro de los metadatos de una imagen.

En este tema se incluyen las siguientes secciones.

• Requisitos previos
• Introducción
• Anatomía de una expresión de ruta de acceso
  • Selección de bloques
  • Selección de elementos
  • Carácter de escape
  • Ejemplos de expresiones
• Expresiones de directiva de metadatos de fotos
• Resumen del lenguaje de consulta de metadatos
• Temas relacionados

Prerrequisitos

Para comprender este tema, debe estar familiarizado con el sistema de metadatos WIC, tal y como se describe en introducción a los metadatos de WIC y acceso a los metadatos, como se describe en Introducción a la lectura y escritura de metadatos de imagen.

Introducción

Interactúe con la plataforma de metadatos principalmente a través de dos componentes del Modelo de objetos componentes (COM): un lector de consultas, representado por la interfaz IWICMetadataQueryReader y un escritor de consultas, representado por la interfaz IWICMetadataQueryWriter . Estos componentes permiten leer o escribir metadatos mediante el lenguaje de consulta de metadatos. El lenguaje de consulta describe la sintaxis de una expresión de ruta de acceso y los componentes de consulta usan esta expresión de ruta de acceso para acceder a los metadatos deseados. Esta expresión de ruta de acceso describe la ubicación de un bloque o elemento de metadatos.

Un bloque de metadatos es un grupo con nombre de metadatos en un formato específico. Un bloque de metadatos puede contener elementos de metadatos individuales, como un tiempo de creación o creación y bloques de metadatos adicionales. El nombre de un bloque de metadatos viene determinado por su formato. Por ejemplo, un bloque de metadatos que contenga metadatos de App1 se denominaría "app1". Los formatos de metadatos comunes incluyen App1, Exif, IFD y XMP.

Un elemento de metadatos es un par nombre-valor que describe características como autor, título y clasificación.

Una expresión de ruta de acceso contiene uno o varios nombres de bloque de metadatos. También puede especificar un elemento de metadatos dentro de un bloque de metadatos. La siguiente expresión de ruta de acceso representa un bloque App1 que contiene un bloque IFD que contiene el elemento de metadatos:

• /app1/ifd/{ushort=18249}

En el diagrama siguiente se muestra la composición de una imagen JPEG de ejemplo con cuatro bloques de metadatos raíz: App0, App1, XMP y un bloque desconocido. Cada elemento resaltado anota el tipo de metadatos (bloque o elemento) y la expresión de consulta usada para recuperar los datos.

Anatomía de una expresión de ruta de acceso

Para acceder a los metadatos mediante las API de WIC, se debe usar una expresión de consulta completa en la mayoría de los casos. En este tema se describen expresiones completas para acceder a los metadatos. Si necesita información sobre los casos en los que se usan expresiones no completas, consulte la sección Expresión de directiva de metadatos de fotos más adelante en este documento.

¿Qué es una expresión de consulta completa? En WIC, una expresión completa es una cadena que comienza con la barra diagonal de caracteres de ruta de acceso (/), seguida de una ruta de navegación a un bloque de metadatos o a un elemento de metadatos específico. Cada paso dentro de la ruta de navegación está separado por una barra diagonal, formando una expresión para acceder a un bloque de metadatos o a un elemento de metadatos. Por ejemplo, lo siguiente es una expresión de consulta completa que accede a la clasificación fotográfica de Microsoft en un bloque IFD anidado en un bloque App1:

• /app1/ifd/{ushort=18249}

Cuando WIC analiza esta expresión, primero busca el bloque de metadatos app1 dentro de los metadatos de la imagen. Si se encuentra el bloque App1, continúa su búsqueda buscando el bloque de metadatos IFD anidado. Si se encuentra el bloque IFD, busca el elemento de metadatos específico, en este caso, la clasificación MicrosoftPhoto bajo la etiqueta 18249, dentro del bloque de metadatos IFD. Si en cualquier momento WIC no encuentra un bloque de metadatos o un elemento, anula la consulta.

Selección de bloques

La expresión de consulta de metadatos WIC más sencilla es una expresión para obtener un lector o escritor de consultas para un bloque de metadatos específico. Obtener un lector o escritor de consultas le permite dirigir las consultas posteriores directamente a un bloque de metadatos anidado sin tratar con su bloque primario. Una expresión de consulta de selección de bloques es una ruta de navegación al bloque de metadatos deseado. Por ejemplo, en la ilustración anterior hay cinco bloques de metadatos, dos de los cuales están anidados en otros bloques de metadatos. A continuación se muestran las expresiones de ruta de acceso a cada bloque de metadatos del ejemplo JPEG:

• /app0
• /app1
• /app1/ifd
• /app1/ifd/exif
• /Xmp

Cuando se usa un lector o escritor de consultas para ejecutar una consulta, devuelve un nuevo lector o escritor de consultas que atiende las consultas dentro del ámbito del bloque de metadatos especificado. Por ejemplo, si ejecuta la consulta "/app1", se obtiene un nuevo lector de consultas y las consultas al nuevo lector son relativas al bloque App1. Esto significa que la consulta "/ifd" es válida para el nuevo lector porque el bloque App1 contiene un bloque IFD. Sin embargo, "/xmp" no funcionaría porque este bloque App1 no contiene un bloque de metadatos XMP.

El lenguaje de consulta también admite una notación de índice. La notación de índice proporciona acceso a un bloque de metadatos específico cuando existen varios bloques del mismo tipo. Para el ejemplo JPEG, se puede usar la siguiente expresión de ruta de acceso indizada:

• /[0]app1/[0]ifd

En el lenguaje de consulta, todos los índices comienzan en cero. En la expresión anterior, el primer cero consulta el primer bloque App1 y el segundo cero consulta el primer bloque IFD anidado. La notación de índice todavía se puede usar incluso cuando no existen varios bloques del mismo tipo. Si el archivo JPEG de ejemplo incluía un segundo bloque App1 con un bloque IFD incrustado, la expresión "/[1]app1/ifd" se usaría para acceder al segundo bloque App1.

La notación de índice se vuelve más común al tratar con fragmentos tEXt PNG, ya que es probable que la imagen PNG tenga más de un fragmento tEXt.

Selección de elementos

Puede acceder a los elementos de metadatos de un bloque de metadatos mediante la creación de expresiones de selección de bloques. Tenga en cuenta las propiedades de clasificación XMP y Microsoft Photo en el ejemplo JPEG. Estos metadatos existen en dos bloques de metadatos: los bloques App1/IFD y XMP. Por lo tanto, se puede usar más de una expresión para tener acceso a los mismos datos. La siguiente expresión tiene acceso a la clasificación MicrosoftPhoto en el bloque XMP:

• /xmp/xmp:Rating

La parte "xmp:" de la expresión es un identificador descriptivo del esquema. XMP es un estándar extensible y permite a las entidades de terceros publicar sus propios esquemas que definen cómo almacenar determinados elementos de metadatos. Un esquema XMP se identifica por completo mediante una dirección URL, pero WIC proporciona un conjunto de identificadores descriptivos para esquemas conocidos. Para obtener más información, consulte el tema Consultas de metadatos de formato de imagen nativa .

En el caso de las imágenes JPEG, la información de clasificación también se puede almacenar en el bloque IFD anidado App1. Sin embargo, a diferencia del ejemplo de clasificación XMP, el bloque IFD no usa un nombre de esquema para acceder a la información de clasificación. En su lugar, se usa una expresión de datos. La siguiente expresión se usa para acceder a la clasificación MicrosoftPhoto en el bloque IFD anidado App1:

• /app1/ifd/{ushort=18249}

En esta expresión, la parte "/app1/ifd" de la expresión es la ruta de acceso de navegación al bloque IFD (como se explicó anteriormente en la sección Selección de bloques). La segunda parte de la expresión "/{ushort=18249}" accede a los datos. Esta parte de la expresión indica al analizador de consultas que busque los datos incrustados en la etiqueta corta sin firmar que tiene el identificador de etiqueta 18249.

{ushort=18249} es una expresión de datos y puede tener varias formas. Una expresión de datos es una expresión de dos partes que contiene la etiqueta o clave de metadatos solicitadas, en este caso "18249" y el tipo de datos de la clave, en este caso "ushort". Las dos partes están separadas por un signo igual (=). WIC admite la mayoría de los tipos de datos comunes de C/C++. El lenguaje de consulta acepta los siguientes tipos de datos:

• char
• uchar
• short
• ushort
• long
• ulong
• int
• uint
• longlong
• FLOAT
• double
• str
• wstr
• guid
• bool

"18249" en el ejemplo es la etiqueta de datos. Microsoft define este número determinado para que contenga la clasificación de MicrosoftPhoto. La etiqueta de datos puede ser cualquier número, cadena o GUID en función del elemento de datos que busque.

A diferencia del ejemplo de clasificación XMP, no hay ninguna colisión de nombres para el valor de clasificación en el bloque App1/IFD. Esto se debe a que el valor de clasificación XMP se almacena realmente en una etiqueta ushort diferente, 18246. Por lo tanto, la expresión para acceder a la clasificación XMP en el bloque App1/IFD es:

• /app1/ifd/{ushort=18246}

Carácter de escape

El lenguaje de consulta no distingue mayúsculas de minúsculas y trata todos los caracteres como minúsculas. Sin embargo, algunos formatos de metadatos (como XMP) distinguen mayúsculas de minúsculas. Al trabajar con un formato de metadatos que distingue mayúsculas de minúsculas, use el carácter de barra diagonal inversa (\) cuando desee especificar un carácter en mayúsculas.

El analizador de lenguaje consume el carácter de escape y el siguiente carácter que sigue se interpreta directamente. Por ejemplo, la expresión {char=\\} se resuelve como "\" y {char=\C} se resuelve como una C mayúscula. Sin el carácter de escape, {char=\} sería una expresión no válida y {char=C} se interpretaría como una c minúscula. Asegúrese de usar el carácter de escape de barra diagonal inversa antes de todas las letras mayúsculas en formatos de metadatos que distinguen mayúsculas de minúsculas.

Ejemplos de expresiones

En la tabla siguiente se proporcionan algunas expresiones de ejemplo y descripciones de sus interpretaciones por parte del analizador del lenguaje de consulta.

Cada bloque de metadatos también se identifica de forma única por el GUID de metadatos que se puede usar en lugar del nombre de bloque descriptivo. La sintaxis siguiente se puede usar en lugar de proporcionar nombres de bloque: "/{guid=GUID}/[n]{guid=GUID}/schema:tagidentifier"

En la tabla siguiente se proporcionan algunos ejemplos no válidos y los motivos por los que se rechazarían.

Expresiones de directiva de metadatos de fotos

Como se indicó anteriormente, una expresión de consulta completa comienza con una barra diagonal (/). Las expresiones que no comienzan con la barra diagonal se evalúan como expresiones de directiva. Una expresión de directiva permite consultar los metadatos de fotos para las propiedades de Shell de Windows relacionadas con imágenes. En la sección Selección de datos anterior de este documento, la expresión "/xmp/xmp:Rating" se usó para tener acceso a la propiedad de clasificación XMP. Esta propiedad también se puede consultar mediante la siguiente expresión de directiva:

• System.SimpleRating

Para tener acceso a la propiedad rating desde el esquema MicrosoftPhoto, se puede usar la siguiente expresión de consulta:

• System.Rating

Las expresiones de directiva de metadatos de fotos se comportan de forma diferente a las consultas de metadatos completas de varias maneras notables.

En primer lugar, al acceder a los metadatos mediante una expresión de directiva, WIC realiza el arbitraje y la resolución de conflictos en caso de que la misma propiedad esté disponible en varios bloques de metadatos. Por ejemplo, tanto MicrosoftPhoto como los valores de clasificación XMP se almacenan tanto en el bloque App1/IFD como en el bloque XMP. La directiva de metadatos de fotos determina la prioridad para la que se devuelve el valor de bloque al leer los metadatos. Al escribir metadatos, la directiva de metadatos de fotos garantiza que las mismas propiedades de distintos bloques sean coherentes. Si usa una consulta de metadatos como "/xmp/xmp:Rating", es responsable de arbitrar entre las distintas ubicaciones de metadatos.

En segundo lugar, las expresiones de directiva de metadatos de fotos son independientes del formato de imagen, mientras que las consultas de metadatos completos no son válidas. Por ejemplo, la consulta "/xmp/xmp:Rating" es específica del formato JPEG. Las imágenes TIFF también admiten metadatos XMP, pero se almacenan de forma diferente en comparación con JPEG, por lo que la consulta TIFF sería "/ifd/xmp/xmp:Rating". Sin embargo, en ambos casos, la expresión de directiva sería "System.SimpleRating".

Las expresiones de directiva de metadatos de fotos proporcionan un mayor nivel de abstracción y simplicidad en comparación con las consultas de metadatos completos, por lo que deben preferirse en los casos en los que no se necesita acceso a metadatos de bajo nivel. Sin embargo, las expresiones de directiva solo proporcionan acceso a un conjunto limitado de metadatos de imagen, mientras que el lenguaje de consulta de metadatos proporciona acceso a casi todos los metadatos almacenados en un archivo de imagen.

Resumen del lenguaje de consulta de metadatos

La tabla siguiente es una definición formal del lenguaje de consulta de metadatos de WIC. Cada símbolo gramatical representa una expresión formada por otros símbolos. La expresión puede ser otro símbolo o una secuencia de otros símbolos separados por la barra vertical (|), que indica una opción "o". Toda la expresión de la derecha es una posible sustitución del símbolo especificado a la izquierda.

Temas relacionados

Conceptual

Información general sobre el componente de creación de imágenes de Windows

Introducción a los metadatos de WIC

Información general sobre la lectura y escritura de metadatos de imagen

Introducción a la extensibilidad de metadatos

Procedimiento para volver a codificar una imagen JPEG con metadatos