ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.text 

TextRenderer  - AS3

Paketflash.text
Klassepublic final class TextRenderer
VererbungTextRenderer Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Die TextRenderer-Klasse enthält Funktionen für das erweiterte Anti-Aliasing eingebetteter Schriftarten. Das erweiterte Anti-Aliasing ermöglicht es, Schriften in sehr kleinen Größen mit sehr hoher Qualität wiederzugeben. Verwenden Sie erweitertes Anti-Aliasing vor allem bei Anwendungen mit sehr viel kleinem Text an. Adobe empfiehlt erweitertes Anti-Aliasing nicht für sehr große Schriften (über 48 Punkt). Erweitertes Anti-Aliasing steht erst ab Flash Player 8 zur Verfügung.

Wenn Sie das erweiterte Anti-Aliasing für ein Textfeld verwenden möchten, setzen Sie die antiAliasType-Eigenschaft der Textfeldinstanz:

Erweitertes Anti-Aliasing bietet Continuous Stroke Modulation (CSM), d. h. die fortlaufende Modulierung von Strichstärke und Kantenschärfe. Zu den erweiterten Funktionen gehört die Möglichkeit, mit der setAdvancedAntiAliasingTable()-Methode Einstellungen für bestimmte Schriftarten und Schriftgrade zu definieren.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  displayMode : String
[statisch] Steuert die Wiedergabe von erweitertem Anti-Aliasing-Text.
TextRenderer
  maxLevel : int
[statisch] Die ADF-Qualitätsstufe (Adaptively Sampled Distance Fields) für erweitertes Anti-Aliasing.
TextRenderer
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
setAdvancedAntiAliasingTable(fontName:String, fontStyle:String, colorType:String, advancedAntiAliasingTable:Array):void
[statisch] Legt eine benutzerdefinierte CSM-Nachschlagetabelle für eine Schriftart fest.
TextRenderer
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

displayMode

Eigenschaft
displayMode:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Steuert die Wiedergabe von erweitertem Anti-Aliasing-Text. Die optische Qualität von Text wird subjektiv sehr unterschiedlich beurteilt. Flash Player versucht, die jeweils besten Einstellungen unter verschiedenen Bedingungen vorzunehmen. Unter Umständen wählen Designer für ihren Text jedoch eine andere Einstellung aus. Mit displayMode kann ein Designer auch die Subpixel-Auswahl in Flash Player außer Kraft setzen und unabhängig von der Hardware des Benutzers eine optische Einheitlichkeit erzielen. Legen Sie diese Eigenschaft mithilfe der Werte in der TextDisplayMode-Klasse fest.

Der Standardwert ist "default".



Implementierung
    public static function get displayMode():String
    public static function set displayMode(value:String):void

Verwandte API-Elemente

maxLevel

Eigenschaft 
maxLevel:int

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Die ADF-Qualitätsstufe (Adaptively Sampled Distance Fields) für erweitertes Anti-Aliasing. Die einzigen zulässigen Werte sind 3, 4 und 7.

Beim erweiterten Anti-Aliasing werden die Konturen, die ein Zeichen bestimmen, mittels ADFs (Adaptively Sampled Distance Fields) dargestellt. Je höher die Qualität, desto mehr Cache-Speicherplatz wird für ADF-Strukturen benötigt. Der Wert 3 bedeutet die geringste Speicherbelastung und liefert die geringste Qualität. Größere Schriften erfordern mehr Pufferplatz. Bei einer Schriftgröße von 64 Pixel steigt die Qualitätsstufe von 3 auf 4 bzw. von 4 auf 7, sofern nicht bereits die Stufe 7 eingestellt ist.

Der Standardwert ist 4.



Implementierung
    public static function get maxLevel():int
    public static function set maxLevel(value:int):void
Methodendetails

setAdvancedAntiAliasingTable

()Methode
public static function setAdvancedAntiAliasingTable(fontName:String, fontStyle:String, colorType:String, advancedAntiAliasingTable:Array):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Legt eine benutzerdefinierte CSM-Nachschlagetabelle für eine Schriftart fest. Flash Player versucht, die beste CSM für Ihre Schriftart zu ermitteln. Wenn Sie mit der von Flash Player bereitgestellten CSM nicht zufrieden sind, können Sie Ihre eigene CSM mit der Methode setAdvancedAntiAliasingTable() festlegen.

Parameter

fontName:String — Der Name der Schriftart, auf die Sie Einstellungen anwenden.
 
fontStyle:String — Der durch einen der Werte aus der flash.text.FontStyle-Klasse angegebene Schriftstil.
 
colorType:String — Mit diesem Wert wird bestimmt, ob der Strich dunkel oder hell ist. Verwenden Sie einen der Werte aus der flash.text.TextColorType-Klasse.
 
advancedAntiAliasingTable:Array — Ein Array mit einem oder mehreren CSMSettings-Objekten für die angegebene Schriftart. Jedes Objekt enthält die folgenden Eigenschaften:
  • fontSize
  • insideCutOff
  • outsideCutOff

Das Array advancedAntiAliasingTable kann mehrere Einträge für CSM-Einstellungen zu verschiedenen Schriftgrößen enthalten.

fontSize ist die Größe in Pixel, für die die Einstellungen gelten.

Beim erweiterten Anti-Aliasing werden die Konturen, die ein Zeichen bestimmen, mittels ADFs (Adaptively Sampled Distance Fields) dargestellt. In Flash Player wird ein outsideCutOff-Wert verwendet, unterhalb dessen die Dichten auf 0 gesetzt werden, und ein insideCutOff-Wert, oberhalb dessen die Dichten auf eine Höchstdichte (z. B. 255) gesetzt werden. Zwischen diesen beiden Werten verläuft die Zuordnungsfunktion linear von 0 am unteren Schwellenwert bis zur Höchstdichte am oberen Schwellenwert.

Die Anpassung der Werte für den unteren und den oberen Schwellenwert wirken sich auf die Strichbreite und die Kantenschärfe aus. Der Abstand zwischen diesen beiden Parametern ist mit dem doppelten Filterradius klassischer Anti-Aliasing-Methoden vergleichbar. Ein geringer Abstand bewirkt schärfere Kanten, ein größerer Abstand weichere, stärker gefilterte Kanten. Bei einem Abstand von null ist das Bild mit der resultierenden Dichte ein Bi-level-Bild (Bitmapbild). Bei einem sehr großen Abstand entsteht ein Bild mit wasserfarbenähnlichen Kanten.

Normalerweise werden scharfe, kontrastreiche Kanten für kleinere Punktgrößen und weichere Kanten für Lauftext und höhere Punktgrößen bevorzugt.

Der untere Schwellenwert ist normalerweise ein negativer Wert, der obere Schwellenwert ein positiver. Ihr Mittelpunkt liegt normalerweise um 0. Wenn Sie diese Parameter ändern, um den Mittelpunkt in Richtung negativer Unendlichkeit zu verschieben, erhöht sich die Strichbreite. Bei Verschiebung des Mittelpunkts zur positiven Unendlichkeit hin wird die Strichbreite verringert. Beachten Sie, dass der untere Schwellenwert nicht größer als der obere Schwellenwert sein darf.

Verwandte API-Elemente

TextRendererExample2.as

Im folgenden Beispiel wird eine TextRendererExample-Klasse erstellt, um visuelle Beispiele für erweiterte Anti-Aliasing-Einstellungen mit kleinen und großen Schriftgrößen zu zeigen. Vor dem Testen dieses Beispiels müssen Sie eine Schrift einbetten. Wenn Sie Flex verwenden, wird die Schriftart folgendermaßen eingebettet:
  1. Platzieren Sie die Schriftart Georgia (georgia.ttf) in dasselbe Verzeichnis wie diese AS-Datei.
  2. Fügen Sie direkt unterhalb der Klassendefinition folgende Zeilen hinzu:
  3. [Embed(source="georgia.ttf", fontFamily="Georgia")]
  4. private var embeddedFont:String;
Wenn Sie Flash verwenden, wird die Schriftart folgendermaßen eingebettet:
  1. Platzieren Sie ein Textfeld auf der Bühne und wählen Sie es aus.
  2. Setzen Sie im Eigenschaftsinspektor die Schriftart dieses Textfelds auf Georgia.
  3. Klicken Sie im Eigenschaftsinspektor auf „Embed...“ und wählen Sie „All“ aus.

Hinweise:

  • Für die Kompilierung der SWF-Datei müssen Sie die Option „Sicherheit bei lokaler Wiedergabe“ auf „Nur auf lokale Dateien zugreifen“ einstellen.

package {
    import flash.display.DisplayObject;
    import flash.display.Sprite;
    import flash.events.*;
    import flash.text.*;
    
    public class TextRendererExample2 extends Sprite {

        private var gutter:int = 10;

        public function TextRendererExample2() {
            createTextField(8,AntiAliasType.NORMAL);
            createTextField(8,AntiAliasType.ADVANCED);
            createTextField(24,AntiAliasType.NORMAL);
            createTextField(24,AntiAliasType.ADVANCED);
        }
            
        private function createTextField(fontSize:Number,antiAliasType:String):TextField {
            var tf:TextField = new TextField();
            tf.embedFonts = true;
            tf.autoSize = TextFieldAutoSize.LEFT;
            tf.antiAliasType = antiAliasType;
            tf.defaultTextFormat = getTextFormat(fontSize);
            tf.selectable = false;
            tf.mouseEnabled = true;
            tf.text = "The quick brown fox jumped over the lazy dog.";
            if(numChildren > 0) {
                var sibling:DisplayObject = getChildAt(numChildren - 1);
                tf.y = sibling.y + sibling.height + gutter;
            }
            addChild(tf);
            return tf;
        }
        
        private function getTextFormat(fontSize:Number):TextFormat {
            var format:TextFormat = new TextFormat();
            format.size = fontSize;
            format.font = "Georgia";
            return format;
        }
    }
}




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.