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ö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.
grafity
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