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 "呸RT" Artist name meta data
qpx_MetaAuthor "奄ut" Author name meta data
qpx_MetaComment "妾mt" Comment meta data
qpx_MetaCopyright "妾py" Copyright meta data
qpx_MetaCreationDate "妻ay" Creation date meta data
qpx_MetaDescription "妻es" Description meta data
qpx_MetaFullName "姊am" Name meta data
qpx_MetaHostComputer "姑st" Host computer meta data
qpx_MetaInformation "姆nf" Information meta data
qpx_MetaOriginalFormat "妹mt" Original format meta data
qpx_MetaOriginalSource "孟rc" Original source meta data
qpx_MetaProducer "妳rd" Producer meta data
qpx_MetaProduct "周RD" Product meta data
qpx_MetaSoftware "孟wr" Software meta data
qpx_MetaWriter "定rt" Writer meta data
qpx_MetaEditDate1 "委d1" Edit date 1 meta data
qpx_MetaEditDate2 "委d2" Edit date 2 meta data
qpx_MetaEditDate3 "委d3" Edit date 3 meta data
qpx_MetaEditDate4 "委d4" Edit date 4 meta data
qpx_MetaEditDate5 "委d5" Edit date 5 meta data
qpx_MetaEditDate6 "委d6" Edit date 6 meta data
qpx_MetaEditDate7 "委d7" Edit date 7 meta data
qpx_MetaEditDate8 "委d8" Edit date 8 meta data
qpx_MetaEditDate9 "委d9" 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