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önne 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-Verzeichnises 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
object	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 als 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

Hintergrundfabe.

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 (vertikale Verschiebung), der zweite den y-offset (horizontale Verschiebung) an.

locale

Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger 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