Textimage (SP-Tag)

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen

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