ZF Zend Framework

Behind the Site

Programmer's Reference Guide

Kapitel 47. Zend_Text
Zurück     Weiter

Kapitel 47. Zend_Text

Inhaltsverzeichnis

47.1. Zend_Text_Figlet
47.2. Zend_Text_Table

47.1. Zend_Text_Figlet

Zend_Text_Figlet ist eine Komponente die es Entwicklern erlaubt einen sogenannten FIGlet Text zu erstellen. FIGlets sind ein spezielles Schriftformat, das FLT (FigLet Font) genannt wird. Standardmäßig wird eine Schriftart mit Zend_Text_Figlet ausgeliefert, aber man kann zusätzliche Schriftarten unter http://www.figlet.org herunterladen.

[Anmerkung] Komprimierte Schriftarten

Zend_Text_Figlet unterstützt gezippte Schriftarten. Das bedeutet das man eine .flf Datei nehmen und diese gzip-pen kann. Um Zend_Text_Figlet zu erlauben diese Datei zu erkennen, muß die gezippte Schriftart die Erweiterung .gz haben. Weiters, um die gezippte Schriftart verwenden zu können muß in PHP die Erweiterung GZIP aktiviert sein.

[Anmerkung] Encoding

Zend_Text_Figlet erwartet das Strings standardmäßig UTF-8 kodiert sind. Wenn das nicht der Fall ist, kann die Zeichenkodierung als zweiter Parameter an die render() Methode übergeben werden.

Man kann mehrere Optionen für ein FIGlet definieren. Wenn ein Zend_Text_Figlet instanziiert wird, kann ein Array oder eine Instanz von Zend_Config übergeben werden.

  • font - Definiert die Schriftart die für die Darstellung verwendet werden soll. Wenn keine definiert wird, wird die eingebaute Schriftart verwendet.

  • outputWidth - Definiert die maximale Breite des Ausgabestrings. Das wird für die Trennung von Wörtern verwendet sowie für die Feineinstellung. Achtungvor zu kleinen Werten, da diese zu undefiniertem Verhalten führen können. Der Standardwert ist 80.

  • handleParagraphs - Ein boolscher Wert welcher anzeigt wie neue Zeilen zu handhaben sind. Wenn er auf true gesetzt wird, werden einzelne neue Zeilen ignoriert und stattdessen als einzelnes Leerzeichen behandelt. Nur mehrere neue Zeilen werden als solche behandelt. Der Standardwert ist false.

  • justification - Kann einer der Werte von Zend_Text_Figlet::JUSTIFICATION_* sein. Es gibt JUSTIFICATION_LEFT, JUSTIFICATION_CENTER und JUSTIFICATION_RIGHT. Die standardmäßige Justierung ist mit dem Wert rightToLeft definiert.

  • rightToLeft - Definiert in welche Richtung geschrieben wird. Das kann entweder Zend_Text_Figlet::DIRECTION_LEFT_TO_RIGHT oder Zend_Text_Figlet::DIRECTION_RIGHT_TO_LEFT sein. Standardmäßig wird die Einstellung der Datei der Schriftart verwendet. Wenn die Justierung nicht definiert ist, wird ein Text der von rechts-nach-links geschrieben wird automatisch nach rechts gerückt.

  • smushMode - Ein Integer-Bitfeld welches definiert wie einzelne Zeichen ineinander gesmusht (verflochten) werden. Das kann die Summe von mehreren Werten von Zend_Text_Figlet::SM_* sein. Es gibt die folgenden Smush-Modi: SM_EQUAL, SM_LOWLINE, SM_HIERARCHY, SM_PAIR, SM_BIGX, SM_HARDBLANK, SM_KERN und SM_SMUSH. Ein Wert von 0 schaltet das Smushing nicht aus sondern erzwingt die Anwendung von SM_KERN, wärend es ein Wert von -1 ausschaltet. Eine Erklärung der verschiedenen Smush-Modi kann hier gefunden werden. Die Smush-Mode Option wird normalerweise nur von Schriftart-Designer verwendet um die verschiedenen Layoutmodi mit einer neuen Schriftart zu testen.

Beispiel 47.1. Verwendung von Zend_Text_Figlet

Dieses Beispiel zeigt die einfache Verwendung von Zend_Text_Figlet um einen einfachen FIGlet Text zu erstellen: 


$figlet = new Zend_Text_Figlet();
echo $figlet->render('Zend');

Angenommen es wird eine Monospace Schriftart verwenden dann würde das Beispiel wie folgt aussehen: 


______    ______    _  __   ______
 |__  //   |  ___||  | \| || |  __ \\
   / //    | ||__    |  ' || | |  \ ||
  / //__   | ||___   | .  || | |__/ ||
 /_____||  |_____||  |_|\_|| |_____//
 `-----`'  `-----`   `-` -`'  -----`


Zurück     Weiter
46.2. Zend_Test_PHPUnit  Zum Anfang  47.2. Zend_Text_Table

Search the Manual

Components

Languages Available

Translation Status Reports

View the current status report of Zend Framework manual translations.