TYPO3-Testaccount
Testen Sie die aktuellste TYPO3-Version kostenlos und unverbindlich für einen Monat!

Jetzt testen!

Schulungen

jetzt buchen

GIFBUILDER

Der GIFBUILDER ist ein Objekt, das in vielen Situationen zur Erzeugung von GIF-Bildern verwendet wird. Wo auch immer das GIFBUIDER-Objekt erwähnt wird, diese Eigenschaften treffen darauf zu.

Anmerkung ( +calc )

Wenn einem Datentyp der unten aufgeführten Eigenschaften die +calc-Funktion angehängt wurde, können Sie die Maße von TEXT und IMAGE-Objekten aus dem GifBuilderObj-Array verwenden. Dazu wird ein Tag wie dieser hier eingefügt: [10.w] oder [10.h], wobei 10 die GifBuilderObj-Nummer im Array ist und w/h entweder Breite oder Höhe des Objekts angibt.

Siehe auch dieses Beispiel (Auszug aus styles.content(default)):

TYPOSCRIPT
styles.header.gfx1 = IMAGE
styles.header.gfx1 {
  wrap = {$styles.header.gfx1.wrap}
  file = GIFBUILDER
  file {
    XY = [10.w]+10 ,{$styles.header.gfx1.itemH}
    backColor = {$styles.header.gfx1.bgCol}
    reduceColors = {$styles.header.gfx1.reduceColors}
    10 = TEXT
    10 {
      text.current = 1
      text.crop = {$styles.header.gfx1.maxChars}
      fontSize = {$styles.header.gfx1.fontSize}
      fontFile = {$styles.header.gfx1.file.fontFile}
      fontColor = {$styles.header.gfx1.fontColor}
      offset = {$styles.header.gfx1.fontOffset}
    }
  }
}

Wie Sie sehen können, hat das GIF-Bild die Breite des darauf abgebildeten Textes plus zehn. Die Höhe wird durch die Konstante {$styles.header.gfx.itemH} definiert.

Das _GIFBUILDER-Toplevel-Object

Sie können über ein Toplevel-Objekt namens _GIFBUILDER einige globals Eigenschaften für den GIFBUILDER konfigurieren. Eine der verfügbaren Eigenschaften der globalen GIFBUILDER-Konfiguration ist charRangeMap.

.charRangeMap

Mit dieser Eigenschaft können Sie global das Auslesen von Schriftdateien über bestimmte Zeichenbereich kontrollieren. Zum Beispiel könnte es sein, dass Sie mit GIFBUILDER Bilder erzeugen wollen, sowohl mit einer bestimmten Schriftart für lateinische Buchstaben, während Sie eine andere TrueType-Schriftart für japanische Glyphen brauchen. Daher müssen Sie angeben, für welchen Bereich von Unicode-Werten welche Schrift verwendet werden soll.

Dies kann man auch direkt im GIFBUILDER-Objekt mit der »splitRendering-Option erwirken, aber wenn Sie auf Ihrer Seite hunterte von GIFBUILDER-Objekten haben, ist es nicht sehr effizient, für jedes einzelne GIFBUILDER-Objekt 5-10 Zeilen für die Konfiguration zu verwenden. Daher ermöglicht es Ihnen diese globale Einstellung, den Grundbereich des Hauptzeichensatzes mit einem alternativen Zeichensatz abzudecken.

Eigenschaft

Datentyp

Beschreibung

Standard

[array]

string

Grundname der Schriftdatei, die für diese Konfiguration verwendet werden soll. Beachten Sie, dass nur der Dateiname der Schrift verwendet wird - der Pfad wird abgeschnitten. Das macht das Zuordnen einfacher und verhindert Probleme, wenn Schriftdateien in andere Verzeichnisse verschoben werden.

Ob Sie also die Datei EXT:myext/fonts/arial.ttf oder t3lib/fonts/arial.ttf verwenden, ist in dieser Konfiguration gleichwertig.

Der Schlüssel:
Der Wert des Arrayschlüssels ist gleichzeitig der Schlüssel, der benutzt wird, wenn diese Konfiguration auf die »splitRendering-Option der einzelnen GIFBUILDER-Objekte angewandt wird. In dem Beispiel unten ist der Schlüssel 123.
Beachten Sie: Wenn der Schlüssel bereits in der lokalen Konfiguration eines GIFBUILDER-Objektes gefunden wird, wird dieser Wert respektiert und nicht überschrieben. Das ermöglicht es Ihnen, lokale Einstellungen zu treffen, die die globalen überschreiben.

Beispiel:

_GIFBUILDER.charRangeMap {
   123 = arial.ttf
...

[array]. charMapConfig

»TEXT / splitRendering. [array]- Konfiguration

Die zu setzende splitRendering-Konfiguration. Siehe auch das GIFBUILDER »TEXT-Objekt.

Beispiel:

_GIFBUILDER.charRangeMap {
  123 = arial.ttf
  123 {
    charMapConfig {
      fontFile = t3lib/fonts/vera.ttf
      value = -65
      fontSize = 45
    }
    fontSizeMultiplicator=2.3
  }
}

Diese Beispielkonfiguration zeigt, dass GIFBUILDER TEXT-Objekte mit einem Arial-Zeichensatz eine splitConfiguration haben werden, die für alle Zeichen mit einem Unicode-Wert kleiner oder gleich 65 den Zeichensatz t3lib/fonts/vera.ttf verwendet.

[array]. fontSizeMultiplicator

double

Wenn diese Eigenschaft gesetzt ist, wird die GIFBUILDER »TEXT-Schriftgröße mit diesem Wert (xx.xx) multipliziert und die fontSize-Eigenschaft in »charMapConfig wird überschrieben.

[array]. pixelSpace
FontSizeRef

double

Wenn gesetzt, werden die vier [x/y][before/after]-Eigenschaften von splitRendering mit dem Verhältnis zwischen der Schriftgröße und diesem Wert multipliziert.
In anderen Worten: Da die pixelSpace-Einstellungen in Abhängigkeit der Schriftgröße variieren können, können Sie mit diesem Wert angeben, für welche Schriftgröße die pixelSpace-Einstellungen optimiert wurden, und für andere Schriftgrößen werden diese Einstellungen in Abhängigkeit von dieser Schriftgröße angepasst.

Beispiel:

_GIFBUILDER.charRangeMap {
  123 = arial.ttf
  123 {
    charMapConfig {
      fontFile = t3lib/fonts/vera.ttf
      value = 48-57
      color = green
      xSpaceBefore = 3
      xSpaceAfter = 3
    }
    pixelSpaceFontSizeRef = 24
  }
}

In diesem Beispiel sind xSpaceBefore und xSpaceAfter gleich 3, wenn die Schriftgröße 24 ist. Wenn diese Konfiguration auf ein GIFBUILDER TEXT-Objekt angewandt wird, wo die Schriftgröße nur 16 beträgt, werden die Werte auf das Verhältnis 16/24 angepasst, was bedeutet, dass sie in diesem Fall auf 2 reduziert werden.

Allgemeine Eigenschaften

Eigenschaft

Datentyp

Beschreibung

Standard

1,2,3,4...

GifBuilderObj + .if (»if)

.if (»if) ist eine Eigenschaft aller Gifbuilder-Objekte. Wenn die Eigenschaft vorhanden und NICHT gesetzt ist, wird das Objekt nicht gerendert! Das entspricht der Funktionsweise von .if bei der stdWrap-Funktion.

XY

x,y+calc

Größe der GIF-Datei

100,20

format

"gif" / "jpg"

Ausgabetyp:
"jpg"/"jpeg" = jpg-Bild.

gif

reduceColors

posint (1-255)

Reduziert die Farben im Bild (bei GIF-Dateien)

transparentBackground

boolean

Setzen Sie diese Eigenschaft, um den Hintergrund transparent darzustellen. Typo3 erklärt die Farbe an der Position 0,0 (also an der linken oberen Ecke) zur transparenten Farbe.
Wenn Sie Text rendern, sollten Sie »niceText abgestellt lassen, da das Ergebnis ohne das niceText-Antialiasing wahrscheinlich präziser wird dargestellt werden können.

transparentColor

HTML-Farbe / stdWrap

Gibt eine Farbe an, die transparent sein soll.

Beispielwerte:
#ffffcc
red
2555,2555,129

Option:
transparentColor.closest=1
Diese Eigenschaft wird erlauben, dass auch die Farbe, die dieser am nächsten ist, transparent dargestellt wird. Sie können dies gebrauchen, wenn Ihr Bild nicht garantiert "sauber" ist.

ANMERKUNG: Es könnte sein, dass diese Eigenschaft nicht funktioniert, wenn Sie die »reduceColors oder die »niceText-Option verwenden.

quality

posint (10-100)

JPG-Qualität (für ».format = jpg/jpeg)

backColor

GraphicColor +stdWrap

Hintergrundfarbe für das GIF.

white

offset

x,y +calc

Abstand aller Objekte im GIF von der oberen linken Ecke.

0,0

workArea

x,y,w,h + calc

Gibt den Arbeitsbereich der GIF-Datei an. Alle GifBuilderObjekte werden diese Maße im Bezug auf Ausrichtung usw. als die Maße der GIF-Datei ansehen.
Nur »TEXT-Objekte, die diese Maße überschreiten, werden auch außerhalb der workArea dargestellt.

maxWidth

Pixel

Maximale Breite der GIF-Datei.

maxHeight

Pixel

Maximale Höhe der GIF-Datei.

Kommentare von registrierten Benutzern:

 
Autor Nachricht
Verfasst am: Dienstag, 25-09-07 17:18
Christoph Zimmer
Dabei seit: 07. 09. 2006
Beiträge: 91
 Wer eine Grafik mit dem GIFBUILDEr importiert und vertikal mittig ausrichten will, kann das auf folgende Weise machen:

TYPOSCRIPT
10.offset = 0,86-[10.h]/2