4D Doc Center : SET PICTURE METADATA

4D v12.4

SET PICTURE METADATA


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

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

Beschreibung

Der Befehl SET PICTURE METADATA schreibt oder ändert den Inhalt der Metadaten bzw. Meta-Tags, die in Bild (4D Feld vom Typ Bild oder Variable) gefunden werden.

Metadaten sind zusätzliche Information, die in Bilder eingefügt ist. 4D ermöglicht vier Arten von standardmäßigen Metadaten zu verwalten: EXIF, GPS, IPTC und TIFF.

Hinweis: Eine ausführliche Beschreibung der Metadaten Typen finden Sie unter http://www.iptc.org/std/IIM/4.1/specification/IIMV4.1.pdf (IPTC) und http://exif.org/Exif2-2.PDF (TIFF, EXIF und GPS).

Im Parameter metaName übergeben Sie einen String, der den Typ der Metadaten, die zu schreiben oder zu ändern sind, angibt. Sie können folgendes übergeben:

Eine Konstante aus dem Thema Bild Metadaten Namen. Es enthält alle Tags, die 4D unterstützt. Jede Konstante enthält ein Tag Pfad, z.B."TIFF/DateTime"),
Den Namen des kompletten Blocks von Metadaten ("TIFF", "EXIF", "GPS" oder "IPTC"),
Einen leeren String ("").

Im Parameter metaInhalt übergeben Sie die neuen Werte der Metadaten:

Haben Sie in metaName eine Konstante mit Tag Pfad übergeben, können Sie im Parameter metaInhalt den zu schreibenden Wert direkt übergeben oder eine passende Konstante aus dem Thema Bild Metadaten Werte. Der Wert kann je nach den festgelegten Metadaten vom Typ Text, Lange Ganzzahl, Zahl, Datum oder Zeit sein. Sie können ein Array verwenden, wenn Metadata mehr als einen Wert enthält. Übergeben Sie einen String, muss er in XML (XMP Standard) formatiert sein. Sie können einen leeren String ("") übergeben, um bereits vorhandene Metadaten zu löschen.
Haben Sie in metaName einen Blocknamen oder einen leeren String übergeben, können Sie im Parameter metaInhalt eine XML DOM Referenz des Elements mit den zu schreibenden Metadaten übergeben. Bei einem leeren String werden alle Metadaten geändert.

Tritt unter Windows ein Fehler während der Ausführung des Befehls auf, wird die Systemvariable OK auf 0 gesetzt. Beachten Sie, dass auf Mac OS das Betriebssystem (Image I0) keine Fehler beim Schreiben von Metadaten ausweist. Deshalb ändert dieser Befehl auf Mac OS die Systemvariable OK nicht.

Hinweis: Nur bestimmte Bildformate (insbesondere JPEC und TIFF) unterstützen Metadaten. Umgekehrt akzeptieren Formate wie GIF oder BMP keine Metadaten. Konvertieren Sie ein Bild mit Metadaten in ein Format, das dies nicht unterstützt, geht die Information verloren.

Beispiel 1

Mehrere Werte der Metadaten "Keywords" über Arrays schreiben:

 ARRAY TEXT($arrTkeywords;2)

 $arrTkeywords{1}:="Frankreich"

 $arrTkeywords{2}:="Europa"

 SET PICTURE META(vPicture;"IPTC Keywords";$arrTkeywords)

Beispiel 2

GPS Block über eine DOM Referenz schreiben:

 C_TEXT($domMetas)

 $domMetas:=DOM Parse XML source("metas.xml")

 C_TEXT($gpsRef)

 $gpsRef:=DOM Find XML element($domMetas;"Metadatas/GPS")

 If(OK=1)

    SET PICTURE META(vImage;"GPS";$refGPS)

  //hier zeigt $gpsRef aktuell auf das GPS Element

    ...

 End if

 DOM CLOSE XML($domMetas)

Hinweis

Werden alle Metadaten über Referenz auf ein DOM Element verwaltet, werden die Tags als Attribute, angehängt an ein Element (Kind des referenzierten Elements), gespeichert, dessen Name der Blockname (TIFF, IPTC, etc.) ist. Wird ein bestimmter Metablock bearbeitet, werden die Block Tags als Attribute gespeichert, die über den Befehl direkt an das referenzierte Element angehängt werden.