Webgate Anywhere 4.1 - TMLScript Referenz

Methode tmlform.attachImage(document, size) tmlform.attachImage(document, [altFileName,] keepRatio, compression, width, height )
An Objekt	TMLForm
Verwendung	Überträgt eine benutzerdefiniert umformatierte Grafik-Datei in ein Dokument
Beschreibung	Formatiert eine hochgeladene Grafikdatei um und überträgt diese in ein Dokument. Dieses kann ein Inhaltsdokument oder ein Benutzerprofil (jeweils WGAPI-Objekte) sein. Das Zielformat der Grafikdatei ist immer JPEG. Zwei Varianten existieren: Variante 1 formatiert die Grafik mit gleicher Höhe und Breite - wie in Parameter size angegeben - um. Variante 2 formatiert die Grafik nach angegebener Höhe, Breite und Kompression um. Zusätzlich bietet sich die Möglichkeit die Grafikdatei unter einem alternativen Dateinamen im Dokument abzulegen. Seit WGA 3.3 existiert für die Aufgabe der Umskalierung von Grafiken der wesentlich leistungsfähigere ImageScaler.
Parameter	document (WGAPI-Objekt WGContent | WGUserProfile): Das Dokument an welches die Datei übertragen werde noll. size (Number): Variante 1: Sowohl Höhe als auch Breite der Grafikdatei. altFileName (String): Variante 2: Ein alternativer Dateiname unter welchem die Datei im Dokument abgelegt wird keepRatio (String): Variante 2: Wird hier "true" übergeben, so wird das Seitenverhältnis (Höhe zu Breite) der Grafikdatei beibehalten. Bei Grafiken im Breitformat (Breite > Höhe) bedeutet das, dass nur der Parameter "width" ausgewertet wird und die neue Höhe entsprechend des Seitenverhältnisses automatisch berechnet wird. Bei Grafiken im Hochformat oder quadratischem Format (Höhe >= Breite) bedeutet diess dass nur der Parameter "height" ausgewertet wird und die neue Breite entsprechend des Seitenverhältnisses automatisch berechnet wird. Wird "false" übergeben so wird die Grafik anhand beider Parameter "width" und "height" umgeformt so dass eine Veränderung des Seitenberhältnisses möglich ist. compression (String): Variante 2: Bestimmt die Kompressionsrate der umformatierten JPEG-Datei. Die Stringentsprechung eines Fließkommawertes zwischen 0 und 1 (exklusive) ist hier zu übergeben wobei 0.1 für keine und 0.9 für starke Kompression steht. width (String): Variante 2: Stringentsprechung eines Ganzzahlwertes. Die neue Breite der Datei in Pixeln. height (String): Variante 2: Stringentsprechung eines Ganzzahlwertes. Die neue Höhe der Datei in Pixeln.
Verfügbar in	WebTML-Seiten und normalen WebTML-Aktionen Master-Aktionen
Beispiele	this.tmlform.attachimage( this.content(), this.tmlform.field("filename"), "true", "0.9", "100", "100" ); In diesem Beispiel würde die hochgeladene Grafik mit dem Filenamen, der in dem Feld "filename" spezifiziert wurde, an das aktuelle Content-Dokument angehangen. Die Grafik würde dabei mit einer Kompression von 0.9 auf eine maximale Grafikgrösse von 100x100 px. skaliert werden