QPix Command Reference
![]() |
![]() ![]() |
QPxObs_GetImporterMetaDataItem(importerRef; metaType; metaDataItem):error | |||
![]() |
importerRef | Longint | Graphics importer reference |
![]() |
metaType | String4 | Metadata type |
![]() |
metaDataItem | BLOB | Metadata item |
![]() |
error | Longint | Error result |
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) |