4D Doc Center : SET PICTURE METADATA

Home

4D v14.3

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, wenn sie änderbar sind.

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.

Warnung: Bestimmte Metadaten sind nur lesbar und lassen sich deshalb nicht mit SET PICTURE METADATA verändern. Das gilt zum Beispiel für TIFF XResolution/TIFF YResolution, EXIF Color Space oder EXIF Pixel X Dimension/EXIF Pixel Y Dimension.

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.

Hinweise:
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.
Unter OS X Version 10.7 (Lion) kann ein Fehler in einem nativen Framework dazu führen, das das Encoden bzw Decoden von Bild-Metadaten zu Genauigkeitsverlusten in GPS Koordinaten führen. Wir empfehlen daher dringend auf OS X 10.8 (Moutain Lion) oder 10.9 (Maverick) zu aktualisieren.

Beispiel 1

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

 ARRAY TEXT($arrTkeywords;2)

 $arrTkeywords{1}:="Frankreich"

 $arrTkeywords{2}:="Europa"

 SET PICTURE METADATA(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 METADATA(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 gespeichert, angehängt an ein Element (Kind des referenzierten Elements), 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.