Packageflash.text
Classepublic final class TextRenderer
HéritageTextRenderer Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

La classe TextRenderer permet d'exploiter la fonction avancée d'anti-aliasing des polices incorporées. L'anti-aliasing avancé permet d'obtenir un rendu très précis des polices de petite taille. Utilisez l'anti-aliasing avancé avec les applications comportant beaucoup de texte de petite taille. Adobe ne recommande pas l'utilisation de l'anti-aliasing avancé pour les polices de très grande taille (supérieures à 48 points). L'anti-aliasing avancé est disponible uniquement à partir de Flash Player 8.

Pour définir l'anti-aliasing avancé sur un champ de texte, définissez la propriété antiAliasType de l'occurrence de TextField.

L'anti-aliasing avancé offre une modulation continue du trait (CSM) qui s'applique à la fois à l'épaisseur du trait et à la netteté des bords. En tant que fonctionnalité avancée, vous pouvez utiliser la méthode setAdvancedAntiAliasingTable() pour définir des paramètres pour des tailles de caractères et de polices spécifiques.

Consulter les exemples

Voir aussi

flash.text.TextField.antiAliasType


Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
  displayMode : String
[static] Contrôle la restitution de texte sur lequel l'anti-aliasing avancé est défini.
TextRenderer
  maxLevel : int
[static] Le niveau de qualité des champs de distance échantillonnés de façon adaptative (ADF) à appliquer pour l’anti-aliasing avancé.
TextRenderer
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
Méthodes publiques
 MéthodeDéfini par
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
  
setAdvancedAntiAliasingTable(fontName:String, fontStyle:String, colorType:String, advancedAntiAliasingTable:Array):void
[static] Définit un tableau de recherche personnalisé de la modulation continue du trait (CSM) pour une police.
TextRenderer
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Détails des propriétés
displayModepropriété
displayMode:String  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Contrôle la restitution de texte sur lequel l'anti-aliasing avancé est défini. La qualité visuelle du texte est très subjective, et même si Flash Player tente d’appliquer les meilleurs paramètres aux différentes conditions d’affichage, certains concepteurs opteront pour un aspect différent de rendu de leur texte. Ainsi, l’utilisation de displayMode permet au concepteur de remplacer le choix des sous-pixels effectué par Flash Player et d’obtenir une cohérence visuelle, indépendamment du matériel de l’utilisateur. Utilisez les valeurs de la classe TextDisplayMode pour définir cette propriété.

La valeur par défaut est "default".


Implémentation
    public static function get displayMode():String
    public function set displayMode(value:String):void

Voir aussi

maxLevelpropriété 
maxLevel:int  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Le niveau de qualité des champs de distance échantillonnés de façon adaptative (ADF) à appliquer pour l’anti-aliasing avancé. Les seules valeurs acceptables sont 3, 4 et 7.

L'anti-aliasing avancé a recours aux ADF pour représenter les contours qui déterminent un glyphe. Plus la qualité est élevée, plus les structures ADF consomment de la mémoire cache. Une valeur de 3 occupe le moins d'espace mémoire possible, mais débouche sur la qualité moindre. Les polices de plus grande taille nécessitent davantage d'espace en mémoire cache ; pour les polices dont la taille est de 64 pixels, le niveau de qualité passe de 3 à 4 ou de 4 à 7, à moins que ce niveau ne soit déjà défini sur 7.

La valeur par défaut est 4.


Implémentation
    public static function get maxLevel():int
    public function set maxLevel(value:int):void
Détails des méthodes
setAdvancedAntiAliasingTable()méthode
public static function setAdvancedAntiAliasingTable(fontName:String, fontStyle:String, colorType:String, advancedAntiAliasingTable:Array):void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Définit un tableau de recherche personnalisé de la modulation continue du trait (CSM) pour une police. Flash Player tente de détecter le CSM le plus adapté à la police. Si vous n'êtes pas satisfait par le CSM fourni par Flash Player, vous pouvez personnaliser votre propre CSM à l'aide de la méthode setAdvancedAntiAliasingTable().

Paramètres

fontName:String — Nom de la police pour laquelle vous appliquez des paramètres.
 
fontStyle:String — Le style de police indiqué en utilisant l'une des valeurs de la classe flash.text.FontStyle.
 
colorType:String — Cette valeur détermine si le trait doit être sombre ou clair. Utilisez l'une des valeurs de la classe flash.text.TextColorType.
 
advancedAntiAliasingTable:Array — Un tableau d'un ou plusieurs objets CSMSettings pour la police spécifiée. Chaque objet contient les propriétés suivantes :
  • fontSize.
  • insideCutOff
  • outsideCutOff

Le tableau advancedAntiAliasingTable peut comporter plusieurs entrées qui spécifient les paramètres CSM pour différentes tailles de police.

La fontSize est la taille, en pixels, pour laquelle les paramètres s'appliquent.

L'anti-aliasing avancé a recours aux champs de distance échantillonnés de façon adaptative (ADF) pour représenter les contours qui déterminent un glyphe. Flash Player applique une valeur butoir externe (outsideCutOff), en-deçà de laquelle les densités sont définies sur zéro, et une valeur butoir interne (insideCutOff), au-delà de laquelle les densités sont limitées à une valeur donnée (telle que 255). Entre ces deux valeurs, la fonction de mappage est une courbe linéaire allant de zéro, pour la valeur butoir externe, jusqu'à la valeur de densité maximum définie pour la valeur butoir interne.

Le réglage des valeurs butoir externe et interne affecte l'épaisseur du trait et la netteté des bords. L'espacement séparant ces deux paramètres est comparable au double du rayon du filtre des méthodes classiques d'anti-aliasing ; un espacement étroit fournit un bord plus net, tandis qu'un espacement plus large donne un bord plus doux, plus filtré. Lorsque l'espacement est nul, l'image de densité résultante est un bitmap à deux niveaux. Lorsque l'espacement est très large, le bord de l'image de densité résultante est assez semblable à celui d'une aquarelle.

De manière générale, les utilisateurs préfèrent les bords nets à fort contraste pour les petites tailles et des bords plus doux pour le texte animé et les polices de grande taille.

La valeur butoir externe correspond généralement à une valeur négative, tandis que la valeur interne a une valeur positive. Leur point intermédiaire est proche de zéro. Le réglage de ces paramètres pour décaler le point intermédiaire vers l'infini négatif augmente l'épaisseur du trait, tandis que son décalage vers l'infini positif la réduit. Assurez-vous que la valeur butoir externe soit toujours inférieure ou égale à la valeur interne.

Voir aussi

Exemples Utilisation des exemples
TextRendererExample2.as

L'exemple suivant crée la classe TextRendererExample pour fournir des exemples visuels de paramètres d'anti-aliasing avancé avec des tailles de police petites et grandes. Avant de tester cet exemple, vous devez intégrer une police. Si vous utilisez Flex, intégrez une police de la manière suivante :
  1. Placez la police Georgia, nommée georgia.ttf, dans le même répertoire que ce fichier AS.
  2. Ajoutez les lignes suivantes immédiatement en dessous de la définition de classe :
  3. [Embed(source="georgia.ttf", fontFamily="Georgia")]
  4. private var embeddedFont:String;
Si vous utilisez Flash, intégrez une police de la manière suivante :
  1. Placez un champ de texte sur la scène et sélectionnez-le.
  2. Dans l'inspecteur Propriétés, définissez la police de ce champ de texte sur Georgia
  3. Dans l'inspecteur Propriétés, appuyez sur « Intégrer... » et sélectionnez « Tout »

Remarques :

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;
        }
    }
}




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/text/TextRenderer.html