4D v12.4
GET PICTURE METADATA
- 4D Language Reference
-
- Pictures
-
- Pictures
- BLOB TO PICTURE
- COMBINE PICTURES
- CONVERT PICTUREUpd
- CREATE THUMBNAIL
- GET PICTURE FROM LIBRARY
- GET PICTURE METADATANew
- Is picture fileNew
- PICTURE CODEC LIST
- PICTURE LIBRARY LIST
- PICTURE PROPERTIES
- Picture size
- PICTURE TO BLOB
- PICTURE TO GIF
- PICTURE TYPE LIST
- QT COMPRESS PICTURE
- QT COMPRESS PICTURE FILE
- QT LOAD COMPRESS PICTURE FROM FILE
- READ PICTURE FILE
- REMOVE PICTURE FROM LIBRARY
- SAVE PICTURE TO FILE
- SET PICTURE METADATANew
- SET PICTURE TO LIBRARY
- TRANSFORM PICTURE
- WRITE PICTURE FILE
GET PICTURE METADATA
| GET PICTURE METADATA ( picture ; metaName ; metaContents {; metaName2 ; metaContents2 ; ... ; metaNameN ; metaContentsN} ) | ||||||||
| Parameter | Type | Description | ||||||
| picture | Picture |
|
Picture whose metadata you want to get | |||||
| metaName | Text |
|
Name or path of block to get | |||||
| metaContents | Variable |
|
Metadata contents | |||||
The GET PICTURE METADATA command can be used to read the contents of the metadata (or meta-tags) found in picture (4D picture field or variable). For more information about metadata, please refer to the description of the SET PICTURE METADATA command.
In the metaName parameter, pass a string specifying the type of metadata to retrieve. You can pass:
- a constant from the theme containing a tag path,
- the name of a complete block of metadata ("TIFF", "EXIF", "GPS" or "IPTC"),
- an empty string ("").
Pass the variable intended to receive the metadata in the metaContents parameter.
- If you passed a tag path in metaName, the metaContents parameter will directly contain the value to get. The value will be converted to the type of the variable. Variables of the Text type will be formatted in XML (XMP standard). You can pass an array when the metadata contains more than one value (this is the case, more particularly, for the IPTC Keywords tags).
- If you passed a block name or an empty string in metaName, the metaContents parameter must be a valid XML DOM element reference. In this case, the contents of the designated block (or all the blocks if you passed an empty string in metaName) is recopied into the element referenced.
Use of DOM tree structures
$xml:=DOM Create XML Ref("Root") //Creation of an XML DOM tree
//Reception of TIFF metadata
$_Xml_TIFF:=DOM Create XML element($xml;"/Root/TIFF")
GET PICTURE METADATA(vPicture;"TIFF";$_Xml_TIFF)
//Reception of GPS metadata
$_Xml_GPS:=DOM Create XML element($xml;"/Root/GPS")
GET PICTURE METADATA(vPicture;"GPS";$_Xml_GPS)Use of variables
C_DATE($dateAsDate)
GET PICTURE METADATA("TIFF/DateTime";$dateAsDate)
//only returns the date since $dateAsDate is of the Date type
C_TEXT($dateAsText)
GET PICTURE METADATA("TIFF/DateTime";$dateAsText)
//only returns the date but in XML format
C_INTEGER($urgency)
GET PICTURE METADATA(vPicture;"IPTC/Urgency";$urgency)Reception of tags with multiple values in arrays
ARRAY TEXT($tTkeywords;0)
GET PICTURE METADATA(vPicture;"IPTC/Keywords";$tTkeywords)After execution of the command, arrTkeywords contains for example:
$arrTkeywords{1}="France"
$arrTkeywords{2}="Europe"Reception of tags with multiple values in a Text variable
C_TEXT($vTwords;0)
GET PICTURE METADATA(vPicture;"IPTC/Keywords";$vTwords)After execution of the command, vTwords contains for example "France;Europe".
The OK system variable returns 1 if the retrieval of the metadata has proceeded correctly and 0 if an error occurs or if at least one of the tags is not found. In all cases, the any values that can be read are returned.
Product: 4D
Theme: Pictures
Number:
1122
Created: 4D v12
Picture metadata names
Picture metadata values
SET PICTURE METADATA
