Textimage (SP-Tag)

Name

<sp:textimage> - Wandelt einen Text in ein Bild um

Syntax

<sp:textimage
   name="variable"
   scope="page"
   text="ein text von ${name}"
   width="100"
   height="15"
   fontname="Arial"
   fontsize="12"
   fontstyle="bold"
   fontcolor="AAAAAA"
   background="000000"
   gravity="c"
   offset="2,5"
   />

Beschreibung

Mit diesem Tag können aus Texten Bilder generiert werden. Über das text-Attribut wird der Text angegeben, aus dem das Bild erzeugt werden soll. Die Angabe von Höhe und Breite ist optional. Werden Höhe und Breite nicht angegeben, ergibt sich die Abmessung des Bildes aus Textlänge, Schriftgröße etc.

Dieser Tag verhält sich in In- und Out-Modus unterschiedlich.

Out-Modus: Wird sp:textimage im Out-Modus betrieben, wird das verkleinerte Bild in einem Verzeichnis textimage unterhalb des Medien-Verzeichnisses des Artikels abgelegt.
In-Modus: Wird sp:textimage im In-Modus betrieben, wird das verkleinerte Bild in der BinDB abgelegt.

Attribute

Name	Type	Required	Default	ab IES Version
`name`	Variable	Ja	None	2
`text`	Text	Ja	None	2
`width`	Expression	Nein	None	2
`height`	Expression	Nein	None	2
`fontname`	Text	Nein	Arial	2
`fontsize`	Expression	Nein	12	2
`fontstyle`	Text	Nein	plain	2
`fontcolor`	Text	Nein	000000	2
`background`	Text	Nein	FFFFFF	2
`gravity`	Text	Nein	c	2
`offset`	Text	Nein	0,0	2
`locale`	Locale	Nein	None	2
`scope`	Scope	Nein	request	2

name: Name der Variable für den Zugriff auf das TextImage-Objekt.

text: Text der in ein Bild umgewandelt werden soll.

width: Breite des Bildes.

height: Höhe des Bildes.

fontname: Name des zu verwendenden Zeichensatzes - muss unter dem angegebenem Namen auf dem IES-Server verfügbar sein.

fontsize: Schriftgröße.

fontstyle: Schriftstil. Mögliche Werte sind plain, bold und italic.

fontColor: Schriftfarbe.

background: Hintergrundfarbe.

gravity

Ausrichtung der Schrift auf dem Bild.

c, center: Schrift zentrieren
n, north: Am oberen Rand ausrichten
ne, northeast: Am oberen-rechten Rand ausrichten
e, east: Am rechten Rand ausrichten
se, southeast: Am unteren-rechten Rand ausrichten
s, south: Am unteren Rand ausrichten
sw, southwest: Am unteren-linken Rand ausrichten
w, west: Am linken Rand ausrichten
nw, northwest: Am oberen-linken Rand aurichten

offset: Der Offset wird mit zwei Kommata getrennten Zahlen angegeben. Der erste Wert gibt den x-offset (horizontale Verschiebung), der zweite den y-offset (vertikale Verschiebung) an.

locale: Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachigen Variablen.

scope: Gültigkeitsbereich, in dem die Variable definiert ist. Möglich sind page und request.

Beispiele

Textbild erzeugen

Template Quelltext

<sp:textimage name="textImage" text="${myLink.systemlink.email}">
url: <sp:print name="textImage.url"/>

Ausgabe

url: /test/test.html.media/textimage/11400032033.png