XPath/XQuery-Funktionen: Bildbezogene
Die folgenden XPath/XQuery-Erweiterungsfunktionen im Zusammenhang mit Bildern werden in der aktuellen Version von MobileTogether Designer unterstützt.
Anmerkung zur Benennung von Funktionen und zur Anwendbarkeit der Sprache
Altova-Erweiterungsfunktionen können in XPath/XQuery-Ausdrücken verwendet werden. Dadurch stehen neben den Funktionen in der Standardbibliothek der XPath-, XQuery- und XSLT-Funktionen zusätzliche Funktionen zur Verfügung. •Um Altova-Erweiterungsfunktionen von Funktionen in der Standardbibliothek zu unterscheiden, wurde Altova-Erweiterungsfunktionen in dieser Dokumentation das Suffix [altova:] angehängt, z.B. add-years-to-date [altova:]. •Wenn Sie Altova-Erweiterungsfunktionen jedoch in Ihren XPath/XQuery-Ausdrücken verwenden, müssen Sie die Funktion genau wie jede andere XPath/XQuery-Standardfunktion ohne Präfix oder Suffix verwenden. Verwenden Sie eine Altova-Erweiterungsfunktion folgendermaßen: add-years-to-date(xs:date("2014-01-15"), 10).
|
suggested-image-file-extension(Base64String als string) als string? XP3.1 XQ3.1 Erhält die Base64-Kodierung einer Bilddatei als Argument und gibt die darin enthaltene Dateierweiterung des Bilds zurück. Der Rückgabewert ist ein Vorschlag, basierend auf den in der Kodierung enthaltenen Bilddateitypinformationen. Wenn diese Informationen nicht verfügbar sind, wird ein leerer String zurückgegeben. Diese Funktion ist nützlich, wenn Sie ein Base64-Bild als Datei speichern und die entsprechende Dateierweiterung dynamisch abrufen möchten.
In den Beispielen oben wird von den als Argument der Funktion bereitgestellten Nodes angenommen, dass sie ein Base64-kodiertes Bild enthalten. Im ersten Beispiel wird jpg als Dateityp bzw. Dateierweiterung abgerufen. Im zweiten Beispiel enthält die angegebene Base54-Kodierung keine brauchbaren Dateierweiterungsinformationen.
|
mt-transform-image(Base64Image als Base64BinaryString, Size als item()+, Rotation als xs:integer, Quality als xs:integer) als Base64BinaryString XP3.1 XQ3.1 Erhält ein Base64-kodiertes Bild als erstes Argument und gibt ein transformiertes Base64-kodiertes Bild zurück. Beim zweiten, dritten und vierten Argument handelt es sich um die Bildparameter, die transformiert werden: Größe, Drehung und Qualität.
•Das Argument Size bietet drei Optionen zur Anpassung der Größe.
•Rotation kann einer der folgenden Werte sein: 90, 180, 270, -90, -180, -270. Dies sind Drehungswerte in Grad eines Kreises. Bei positiven Werten, wird das Bild im Uhrzeigersinn gedreht; bei negativen Werten wird das Bild entgegen dem Uhrzeigersinn gedreht. Beachten Sie, dass Sie die aktuelle Drehung des Bilds in Grad (0, 90, 180, 270) mit Hilfe des Altova-Exif-Attributs OrientationDegree anhand des Bild-Exif-Tags Orientation ermitteln können. Da das Attribut OrientationDegree aus dem Orientation-Tag der Exif-Daten stammt, steht es jedoch nur zur Verfügung, wenn der Tag Orientation in den Exif-Daten vorhanden ist (siehe Beschreibung von OrientationDegree weiter unten). •Quality kann ein beliebiger Wert zwischen 0 und 100 sein und bezieht sich auf Werte auf der IJG Qualitätsskala für die JPEG-Komprimierung; es handelt sich hierbei nicht um einen Prozentwert für die Qualität. Die Kompromisse beziehen sich hier auf Dateigröße und Qualität. Bei einem Quellfarbfoto wird 75 normalerweise als optimaler Wert betrachtet. Wenn das Ergebnis bei 75 nicht zufriedenstellend ist, erhöhen Sie den Wert.
Anmerkung: Wenn im Originalbild Exif-Daten vorhanden sind, werden diese bei der Transformation entfernt. Das transformierte Bild enthält keine Exif-Daten mehr.
|
image-exif-data(Base64BinaryString als string) als element? XP3.1 XQ3.1 Erhält ein Base64-kodiertes JPEG-Bild als Argument und gibt ein Element namens Exif zurück, das die Exif-Metadaten des Bilds enthält. Die Exif-Metadaten werden als Attribut-Wert-Paare des Exif-Elements erstellt. Bei den Attributnamen handelt es sich um die Exif-Daten-Tags aus der Base64-Kodierung. Weiter unten sehen Sie eine Liste der Exif-Tags. Wenn die Exif-Daten einen anbieterspezifischen Tag enthalten, so wird auch dieser Tag und sein Wert als Attribut-Wert-Paar zurückgegeben. Zusätzlich zu den Standard-Exif-Metadatentags (siehe Liste unten) werden auch Altova-spezifische Attribut-Wert-Paare generiert. Diese Altova Exif-Attribute sind unten aufgelistet.
|
[ Nach oben ]