### QPxObs_GetImporterMetaDataItem

QPxObs_GetImporterMetaDataItem(importerRef; metaType; metaDataItem):error
| importerRef | Longint | Graphics importer reference
| metaType | String4 | Metadata type
| metaDataItem | BLOB | Metadata item
| error | Longint | Error result

### Do not use this command in QPix v3 or later

This command is preserved in QPix v3 for backward compatibility reasons. Image meta-data support is now provided by the image tag commands.

Some file formats may contain non-image data called "metadata". This command extracts a metadata item from the image container associated with a graphics importer, and returns the item data in a BLOB.

The graphics importer instance is specified by importerRef. If importerRef is not a reference to a valid graphics importer instance, error qpx_paramErr is returned.

Parameter metaType is the metadata type; a 4-character string identifying the metadata item.

Parameter metaDataItem receives the item data.

Different image file formats support different kinds of metadata, and have different ways of identifying them. QPix defines the following constants for metadata types:

qpx_MetaArtist | "©ART" | Artist name meta data
qpx_MetaAuthor | "©aut" | Author name meta data
qpx_MetaComment | "©cmt" | Comment meta data
qpx_MetaCopyright | "©cpy" | Copyright meta data
qpx_MetaCreationDate | "©day" | Creation date meta data
qpx_MetaDescription | "©des" | Description meta data
qpx_MetaFullName | "©nam" | Name meta data
qpx_MetaHostComputer | "©hst" | Host computer meta data
qpx_MetaInformation | "©inf" | Information meta data
qpx_MetaOriginalFormat | "©fmt" | Original format meta data
qpx_MetaOriginalSource | "©src" | Original source meta data
qpx_MetaProducer | "©prd" | Producer meta data
qpx_MetaProduct | "©PRD" | Product meta data
qpx_MetaSoftware | "©swr" | Software meta data
qpx_MetaWriter | "©wrt" | Writer meta data
qpx_MetaEditDate1 | "©ed1" | Edit date 1 meta data
qpx_MetaEditDate2 | "©ed2" | Edit date 2 meta data
qpx_MetaEditDate3 | "©ed3" | Edit date 3 meta data
qpx_MetaEditDate4 | "©ed4" | Edit date 4 meta data
qpx_MetaEditDate5 | "©ed5" | Edit date 5 meta data
qpx_MetaEditDate6 | "©ed6" | Edit date 6 meta data
qpx_MetaEditDate7 | "©ed7" | Edit date 7 meta data
qpx_MetaEditDate8 | "©ed8" | Edit date 8 meta data
qpx_MetaEditDate9 | "©ed9" | Edit date 9 meta data
qpx_MetaIPTCRecord | "iptc" | IPTC record meta data

Example

``Get the IPTC block from the image metadata` `` `C_LONGINT($error)` `C_LONGINT(gQPixImporter)` `C_BLOB($iptcBlock)` `` `$error:=QPx_GetImporterMetaDataItem (gQPixImporter;qpx_MetaIPTCRecord;$iptcBlock)` `` `If ($error#qpx_noErr)` ``Handle the error` `End if`

Related commands

QPxObs_GetImporterMetaData | Extracts metadata (substituted)

QPix © Escape
Generated by QDoc 2.8 on Wed, Feb 17, 2010 17:46:58