QPix Command Reference
![]() |
![]() ![]() |
QPx_GetImporterMetaData(importerRef; metaTypes; metaDataItems):error | |||
![]() |
importerRef | Longint | Graphics importer reference |
![]() |
metaTypes | Array string | Metadata types |
![]() |
metaDataItems | Array text | Metadata items (optional) |
![]() |
error | Longint | Error result |
Some file formats may contain non-image data called "metadata". This command extracts the metadata from the image container associated with a graphics importer.
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.
The metadata are returned in two arrays, metaTypes and metaDataItems.
The metaTypes array receives the metadata types; 4-character strings, identifying the kind of the metadata. The metaDataItems text array parameter is optional. If present, it will receive the data items as text array elements.
Receiving the metadata items as text is convenient, but has an obvious limitation: text elements cannot hold more than 32000 bytes. To overcome this limitation, you can use the QPx_GetImporterMetaDataItem command that returns metadata items in BLOBs.
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 image metadata C_LONGINT($error) ARRAY STRING(4;$metaTypes;0) ARRAY TEXT($metaData;0) C_LONGINT(gQPixImporter) $error:=QPx_GetImporterMetaData (gQPixImporter;$metaTypes;$metaData) If ($error#qpx_noErr) `Handle the error End if |
Related commands
QPx_GetImporterMetaDataItem | Extracts individual metadata items as BLOBs |