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)):
- 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: Beispiel: _GIFBUILDER.charRangeMap { | |
[array]. charMapConfig | »TEXT / splitRendering. [array]- Konfiguration | Die zu setzende splitRendering-Konfiguration. Siehe auch das GIFBUILDER »TEXT-Objekt. Beispiel: _GIFBUILDER.charRangeMap {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 | 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. Beispiel: _GIFBUILDER.charRangeMap {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. | |
x,y+calc | Größe der GIF-Datei | 100,20 | |
"gif" / "jpg" | Ausgabetyp: | gif | |
posint (1-255) | Reduziert die Farben im Bild (bei GIF-Dateien) | ||
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. | ||
HTML-Farbe / stdWrap | Gibt eine Farbe an, die transparent sein soll. Beispielwerte: Option: ANMERKUNG: Es könnte sein, dass diese Eigenschaft nicht funktioniert, wenn Sie die »reduceColors oder die »niceText-Option verwenden. | ||
posint (10-100) | JPG-Qualität (für ».format = jpg/jpeg) | ||
GraphicColor +stdWrap | Hintergrundfarbe für das GIF. | white | |
x,y +calc | Abstand aller Objekte im GIF von der oberen linken Ecke. | 0,0 | |
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. | ||
Pixel | Maximale Breite der GIF-Datei. | ||
Pixel | Maximale Höhe der GIF-Datei. |
Kommentare von registrierten Benutzern:
Wer eine Grafik mit dem GIFBUILDEr importiert und vertikal mittig ausrichten will, kann das auf folgende Weise machen:
