Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
flash.text 

TextRenderer  - AS3

Pacchettoflash.text
Classepublic final class TextRenderer
EreditarietàTextRenderer Inheritance Object

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9

La classe TextRenderer fornisce la funzionalità per l'antialiasing avanzato dei caratteri incorporati. La modalità di antialiasing avanzato consente di effettuare il rendering di altissima qualità dei caratteri anche a dimensioni ridotte. Trova il suo utilizzo ottimale nelle applicazioni con molto testo di piccole dimensioni. Adobe non consiglia di utilizzare l'antialiasing avanzato per i caratteri molto grandi (superiori a 48 punti). L'antialiasing avanzato è disponibile solo in Flash Player 8 e versioni successive.

Per impostare l'antialiasing avanzato su un campo di testo, impostate la proprietà antiAliasType dell'istanza TextField:

L'antialiasing avanzato fornisce CSM (Continuous Stroke Modulation), ovvero la modulazione continua dello spessore del tratto e della precisione del bordo. Essendo una funzionalità avanzata, il metodo setAdvancedAntiAliasingTable() può essere utilizzato per definire le impostazioni relative a caratteri e dimensioni di caratteri specifici.

Vedere gli esempi

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  displayMode : String
[statico] Controlla il rendering di testo sottoposto ad antialiasing avanzato.
TextRenderer
  maxLevel : int
[statico] Il livello di qualità dei campi con distanza a campionamento adattivo (Adaptively sampled Distance Fields) per l'antialiasing avanzato.
TextRenderer
Metodi pubblici
 MetodoDefinito da
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
  
setAdvancedAntiAliasingTable(fontName:String, fontStyle:String, colorType:String, advancedAntiAliasingTable:Array):void
[statico] Imposta una tabella di ricerca CSM (Continuous Stroke Modulation) personalizzata per un carattere.
TextRenderer
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà

displayMode

proprietà
displayMode:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9

Controlla il rendering di testo sottoposto ad antialiasing avanzato. La qualità visiva del testo è un fattore molto soggettivo e, mentre Flash Player cerca di utilizzare le impostazioni migliori a seconda delle diverse condizioni, i designer potrebbero scegliere un aspetto diverso per il testo. Inoltre, l'uso di displayMode consente ai designer di ignorare la scelta di sottopixel di Flash Player e creare una coerenza d'aspetto indipendente dall'hardware usato dall'utente. Utilizzate i valori della classe TextDisplayMode per impostare questa proprietà.

Il valore predefinito è "default".



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

Elementi API correlati

maxLevel

proprietà 
maxLevel:int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9

Il livello di qualità dei campi con distanza a campionamento adattivo (Adaptively sampled Distance Fields) per l'antialiasing avanzato. Gli unici valori accettabili sono 3, 4 e 7.

L'antialiasing avanzato utilizza ADF per rappresentare i profili che determinano un glifo. A una maggiore qualità corrisponde un impegno superiore della cache per le strutture ADF. Un valore 3 impegna la quantità minima di memoria e fornisce la qualità più bassa. A una dimensione del carattere di 64 pixel, il livello della qualità aumenta da 3 a 4 o da 4 a 7, a meno che il livello sia già impostato su 7.

Il valore predefinito è 4.



Implementazione
    public static function get maxLevel():int
    public static function set maxLevel(value:int):void
Descrizione dei metodi

setAdvancedAntiAliasingTable

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9

Imposta una tabella di ricerca CSM (Continuous Stroke Modulation) personalizzata per un carattere. Flash Player cerca di identificare il CSM più indicato al carattere. Se il risultato non è soddisfacente, è possibile personalizzare il proprio CSM utilizzando il metodo setAdvancedAntiAliasingTable().

Parametri

fontName:String — Il nome del carattere per il quale si applicano le impostazioni.
 
fontStyle:String — Lo stile del carattere indicato utilizzando uno dei valori della classe flash.text.FontStyle.
 
colorType:String — Questo valore determina se il tratto è chiaro o scuro. Utilizzate uno dei valori della classe flash.text.TextColorType.
 
advancedAntiAliasingTable:Array — Un array di uno o più oggetti CSMSettings per il carattere specificato. Ogni oggetto contiene le proprietà seguenti:
  • fontSize
  • insideCutOff
  • outsideCutOff

L'array advancedAntiAliasingTable può contenere diverse voci che specificano le impostazioni CSM relative a diverse dimensioni di caratteri.

fontSize rappresenta le dimensioni, in pixel, per cui si applicano le impostazioni.

L'antialiasing avanzato utilizza ADF (Adaptively Sampled Distance Field, campi con distanza a campionamento adattivo) per rappresentare i profili che determinano un glifo. Flash Player utilizza un valore di taglio esterno (outsideCutOff), sotto il quale le densità vengono impostate su zero, e un valore di taglio interno (insideCutOff), sopra il quale le densità vengono impostate sul valore di densità massimo (ad esempio, 255). Tra questi due valori di taglio, la funzione di mappatura è una curva lineare compresa tra zero al taglio esterno e la densità massima al taglio interno.

La regolazione dei valori di taglio interno ed esterno incide sullo spessore del tratto e sulla precisione del bordo. Lo spazio tra questi due parametri è paragonabile a due volte il raggio del filtro dei metodi di antialiasing classici; uno spazio ridotto fornisce un bordo più nitido, mentre uno spazio più ampio fornisce un bordo più filtrato e sfumato. Quando lo spazio è zero, l'immagine della densità risultante è una bitmap a due livelli. Quando lo spazio è molto ampio, l'immagine della densità risultante ha un bordo simile a un tratto ad acquerello.

Di solito, gli utenti preferiscono bordi nitidi a contrasto elevato quando il testo è di piccole dimensioni, e bordi più sfumati per il testo animato o di grandi dimensioni.

Normalmente, il taglio esterno ha un valore negativo, mentre quello interno ha un valore positivo e il loro punto centrale è di solito vicino allo zero. La regolazione di questi parametri per spostare il punto centrale verso l'infinito negativo aumenta lo spessore del tratto, mentre lo spostamento del punto centrale verso l'infinito positivo diminuisce lo spessore del tratto. Accertatevi che il taglio esterno sia sempre minore di o uguale al taglio interno.

Elementi API correlati

TextRendererExample2.as

Nell'esempio seguente viene creata la classe TextRendererExample per dimostrare esempi visivi di impostazioni antialiasing avanzate con caratteri di piccole e grandi dimensioni. Prima di provare questo esempio, è necessario incorporare un carattere. Se usate Flex, incorporate un carattere nel modo seguente:
  1. Collocate il carattere Georgia, denominato georgia.ttf, nella stessa directory del file AS.
  2. Aggiungete le righe seguenti direttamente sotto la definizione della classe:
  3. [Embed(source="georgia.ttf", fontFamily="Georgia")]
  4. private var loginPassword:String;
Se usate Flash, incorporate un carattere nel modo seguente:
  1. Collocate un campo di testo sullo stage e selezionarlo.
  2. Nella finestra di ispezione Proprietà, impostate il carattere di tale campo di testo su Georgia
  3. Nella finestra di ispezione Proprietà, premete "Incorpora..." e selezionate "Tutto"

Note:

  • È necessario compilare il file SWF con "Sicurezza riproduzione locale" impostato su "Accedi solo ai file locali".

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 ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.