FontDescription  - AS3

Type de repère CFF utilisé pour ce texte. Utilisez les constantes CFFHinting pour cette propriété. Cette propriété s’applique uniquement si la propriété RenderingMode du texte est définie sur RenderingMode.CFF.

Le type de repère CFF (Compact Font Format) utilisé détermine si le moteur d’exécution de Flash force les épaisseurs horizontales fortes à s’aligner sur une grille de sous-pixels ou non.

S’applique uniquement aux polices incorporées.

La valeur par défaut est CFFHinting.HORIZONTAL_STEM.

Pour la propriété CFFHinting, vous pouvez utiliser les constantes suivantes de la classe CFFHinting :

Plus d’exemples

Eléments de l’API associés

Spécifie comment la police doit être recherchée.

La valeur par défaut est FontLookup.DEVICE.

Pour définir les valeurs pour cette propriété, utilisez les valeurs de chaîne suivantes :

Plus d’exemples

Eléments de l’API associés

Nom de la police à utiliser, ou liste de noms de police séparés par une virgule. Pour le rendu de l’élément, le moteur d’exécution sélectionne la première police disponible dans la liste. Par exemple "Arial, Helvetica, _sans" envoie le lecteur chercher Arial, puis Helvetica s’il ne trouve pas Arial, puis _sans si aucune des deux n’est trouvée.

Les moteurs d’exécution de Flash prennent en charge trois noms de polices de périphérique génériques : _sans (pour les polices sans serif), _serif (pour les polices serif) et _typewriter (pour les polices à espacement fixe). Ces noms sont associés aux polices de périphérique propres à la plateforme.

La valeur par défaut est "_serif".

Les moteurs d’exécution de Flash fournissent des polices par défaut pour les glyphes introuvables dans la police sélectionnée. Que la police utilisée soit incorporée ou de périphérique, lorsque le glyphe à restituer y est introuvable, le moteur d’exécution tente de le restituer à l’aide d’une autre police de périphérique susceptible de le contenir.

Eléments de l’API associés

Spécifie la posture de la police.

La valeur par défaut est FontPosture.NORMAL.

Pour définir les valeurs pour cette propriété, utilisez les constantes suivantes de la classe FontPosture :

Eléments de l’API associés

Spécifie l’épaisseur de la police.

La valeur par défaut est FontWeight.NORMAL.

Pour définir les valeurs pour cette propriété, utilisez les constantes suivantes de la classe FontWeight :

Eléments de l’API associés

Indique si l’objet FontDescription est bloqué ou non. Si la propriété est définie sur true, l’objet FontDescription ne peut pas être modifié. Appelez FontDescription.clone() pour obtenir une copie non verrouillée de l’objet FontDescription.

Plus d’exemples

Mode de rendu utilisé pour ce texte. Utilisez les constantes RenderingMode pour cette propriété.

S’applique uniquement aux polices incorporées.

La valeur par défaut est RenderingMode.CFF.

Pour définir les valeurs de cette propriété, utilisez les constantes suivantes de la classe RenderingMode :

Plus d’exemples

Eléments de l’API associés

Crée un objet FontDescription.

Crée une copie non verrouillée et clonée de l’objet FontDescription.

Plus d’exemples

package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class FontDescription_cloneExample extends Sprite {
        private var fd:FontDescription;
        private var fd2:FontDescription;
        
        public function FontDescription_cloneExample():void {
            fd = new FontDescription();
            fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
            fd.fontName = "Palatino";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;
            fd.fontPosture = flash.text.engine.FontPosture.ITALIC;

            var ef1:ElementFormat = new ElementFormat(fd);
            
            var str:String = "This is flash text 0123456789";
            var tb:TextBlock = new TextBlock();
            var te1:TextElement = new TextElement(str, ef1);
            tb.content = te1;
            var line1:TextLine = tb.createTextLine(null, 600);
            addChild(line1);
            
            fd2 = (fd.locked) ? fd.clone() : fd;    
            fd2.fontWeight = flash.text.engine.FontWeight.NORMAL;
            var ef2:ElementFormat = new ElementFormat(fd2);

            tb.content.elementFormat=ef2;
            var line2:TextLine = tb.createTextLine(null, 600);
            addChild(line2);
            
        }
    }    
}

Renvoie la valeur true si une police de périphérique utilisable est disponible avec fontName, fontWeight et fontPosture.

Les classes flash.text.engine ne peuvent utiliser que des polices de périphérique OpenType et TrueType. Si vous utilisez une police basée sur une ancienne technologie de polices, le moteur d’exécution revient à des polices de périphériques en restituant le texte glyphe par glyphe.

Paramètres

Eléments de l’API associés

Renvoie true si une police incorporée est disponible avec les paramètres fontName, fontWeight et fontPosture spécifiés, où Font.fontType correspond à flash.text.FontType.EMBEDDED_CFF. Depuis Flash Player 10, le contenu d’une application peut disposer de deux sortes de polices incorporées. Les polices incorporées normales ne sont utilisées que par les objets TextField. Les polices CFF intégrées ne sont utilisées que par les classes flash.text.engine. Les deux types sont différenciés par la propriété fontType de la classe Font, telle que renvoyée par la fonction enumerateFonts().

Les classes flash.text.engine ne peuvent pas utiliser une police de type EMBEDDED. Si fontLookup est défini sur FontLookup.EMBEDDED_CFF et que l’unique police disponible au moment de l’exécution avec le nom, l’épaisseur et la posture spécifiés est de type EMBEDDED, le moteur d’exécution de Flash revient à des polices de périphériques en restituant le texte glyphe par glyphe, comme si aucune police incorporée ne correspondait au nom et au style spécifiés.

Si des polices EMBEDDED et EMBEDDED_CFF sont disponibles avec le même nom, la même épaisseur et la même posture, la police EMBEDDED_CFF est sélectionnée et le texte est restitué avec la police EMBEDDED_CFF.

Paramètres

Eléments de l’API associés

Cet exemple crée un objet FontDescription, lui affecte une police de périphérique, définit diverses propriétés de police et affecte le nouvel objet à un objet ElementFormat. D’autres mises en forme de police sont effectuées dans ElementFormat. Un nouvel objet TextElement est créé, à l’aide d’ElementFormat et TextElement est utilisé comme contenu pour un TextBlock. Une ligne de texte est créée à partir du TextBlock.

package {

    import flash.display.Sprite;
    import flash.text.engine.*;

    
    public class FontDescriptionExample extends Sprite {
        
        public function FontDescriptionExample():void {
            var fd:FontDescription = new FontDescription();
            fd.fontLookup = flash.text.engine.FontLookup.DEVICE;
            fd.fontName = "Palatino";
            fd.fontWeight = flash.text.engine.FontWeight.BOLD;
            fd.fontPosture = flash.text.engine.FontPosture.ITALIC;

            var ef1:ElementFormat = new ElementFormat(fd);
            ef1.fontSize = 30;
            ef1.color = 0xFF0000;
            
            var str:String = "This is flash text 0123456789";
            var tb:TextBlock = new TextBlock();
            var te1:TextElement = new TextElement(str, ef1);
            tb.content = te1;
            var line1:TextLine = tb.createTextLine(null, 600);
            addChild(line1);
            
        }
    }    
}