4D Doc Center : GET PICTURE METADATA

Home

4D v14.3

GET PICTURE METADATA


GET PICTURE METADATA ( Bild ; metaName ; metaInhalt {; metaName2 ; metaInhalt2 ; ... ; metaNameN ; metaInhaltN} )

Parameter	Typ	Beschreibung
Bild	Bild	Bild, dessen Metadaten Sie erhalten wollen
metaName	Text	Name oder Pfad des zu lesenden Blocks
metaInhalt	Variable	Metadaten Inhalt

Beschreibung

Der Befehl GET PICTURE METADATA liest den Inhalt der Metadaten oder Meta-Tags von Bild (4D Feld vom Typ Bild oder Variable). Weitere Informationen zu Metadaten finden Sie unter dem Befehl SET PICTURE METADATA.

Im Parameter metaName übergeben Sie einen String, der den Typ der zu findenden Metadaten angibt. Sie können folgendes übergeben:

Eine Konstante unter dem Thema Bild Metadaten Namen mit einem Tag Pfad,
Den Namen eines kompletten Blocks mit Metadaten ("TIFF", "EXIF", "GPS" oder "IPTC"),
Einen leeren String ("").

Im Parameter metaInhalt übergeben Sie die Variable, welche die Metadaten empfangen soll

Haben Sie in metaName einen Tag Pfad übergeben, enthält der Parameter metaInhalt direkt den zu lesenden Wert. Der Wert wird in den Typ der Variablen konvertiert. Variablen vom Typ Text werden in XML (XMP Standard) formatiert. Sie können ein Array verwenden, wenn Metadata mehr als einen Wert enthält. Das ist insbesondere für die Tags IPTC Keywords der Fall.
Haben Sie in metaName einen Blocknamen oder einen leeren String übergeben, muss der Parameter metaInhalt eine gültige Referenz auf ein XML DOM Element sein. In diesem Fall wird der Inhalt des angegebenen Blocks (oder alle Blöcke, wenn Sie in metaName einen leeren String übergeben haben) in das referenzierte Element kopiert.

Beispiel 1

DOM Baum Strukturen verwenden:

 $xml:=DOM Create XML Ref("Root")\Einen XML DOM Baum erstellen

 

  // Empfangen von TIFF metadata

 $_Xml_TIFF:=DOM Create XML element($xml;"/Root/TIFF")

 GET PICTURE METADATA(vPicture;"TIFF";$_Xml_TIFF)

 

  // Empfangen von GPS metadata

 $_Xml_GPS:=DOM Create XML element($xml;"/Root/GPS")

 GET PICTURE METADATA(vPicture;"GPS";$_Xml_GPS)

Beispiel 2

Variablen verwenden

 C_DATE($dateAsDate)

 GET PICTURE METADATA(vPicture;TIFF date time;$dateAsDate)

  //gibt nur das Datum zurück, da $dateAsDate vom Typ Datum ist

 

 C_TEXT($dateAsText)

 GET PICTURE METADATA(vPicture;TIFF date time;$dateAsText)

  //gibt nur das Datum zurück, jedoch in XML Format

 

 C_INTEGER($urgency)

 GET PICTURE METADATA(vPicture;IPTC urgency;$urgency)

Beispiel 3

Tags mit mehrfachen Werten in einer Textvariablen empfangen:

 ARRAY TEXT($tTkeywords;0)

 GET PICTURE METADATA(vPicture;"IPTC/Keywords";$tTkeywords)

Nach Ausführen des Befehls enthält arrTkeywords zum Beispiel:

 $arrTkeywords{1}="Frankreich"

 $arrTkeywords{2}="Europa"

Beispiel 4

Tags mit mehrfachen Werten in einer Textvariablen empfangen

 C_TEXT($vTwords;0)

 GET PICTURE METADATA(vPicture;IPTC/Keywords;$vTwords)

Nach Ausführen des Befehls enthält vTwords z.B. "Frankreich;Europa".

Systemvariablen und Mengen

Die Systemvariable OK gibt 1 zurück, wenn das Auffinden der Metadaten korrekt abgelaufen ist. 0, wenn ein Fehler auftritt oder mindestens einer der Tags nicht gefunden wird. In allen Fällen werden alle Werte, die gelesen werden können, zurückgegeben.