FontDescription  - AS3

Typ przyciągania CFF użyty dla tego tekstu. Wartości tej właściwości powinny być stałymi z klasy CFFHinting. Ta właściwość ma zastosowanie tylko wtedy, gdy właściwość RenderingMode tekstu jest ustawiona na RenderingMode.CFF.

Od typu przyciągania CFF (Compact Font Format) zależy, czy środowisko wykonawcze Flash wymusza dopasowanie grubych poziomych elementów do siatki o jednostkach mniejszych od jednego piksela (siatki subpikselowej).

Ma zastosowanie wyłącznie do osadzonych czcionek.

Wartość domyślna to CFFHinting.HORIZONTAL_STEM.

We właściwości CFFHinting można używać następujących stałych z klasy CFFHinting:

Powiązane elementy interfejsu API

Określa sposób wyszukiwania czcionek.

Wartość domyślna to FontLookup.DEVICE.

W celu ustawienia wartości tej właściwości należy użyć następujących wartości ciągu znaków:

Powiązane elementy interfejsu API

Nazwa użytej czcionki lub lista nazw czcionek oddzielonych od siebie przecinkami. Środowisko wykonawcze renderuje element za pomocą pierwszej dostępnej czcionki na liście. Na przykład "Arial, Helvetica, _sans" powoduje, że odtwarzacz wyszukuje czcionkę "Arial", a w przypadku nieznalezienia czcionki Arial — "Helvetica", a jeśli obie powyższe czcionki nie zostaną znalezione, wyszukuje czcionkę _sans.

Środowisko wykonawcze Flash obsługuje trzy ogólne nazwy czcionek urządzenia: _sans (czcionki bezszeryfowe), _serif (czcionki szeryfowe) i _typewriter (czcionki o równej szerokości). Są one odwzorowane do określonych czcionek urządzenia w zależności od platformy.

Wartością domyślną jest „_serif”.

Środowisko Flash udostępnia czcionki rezerwowe dla glifów, które nie zostaną odnalezione w wybranej czcionce. Jeśli używana czcionka jest czcionką osadzoną lub urządzenia, a glif nie zostanie znaleziony w czcionce, środowisko wykonawcze Flash podejmie próbę jego renderowania za pomocą innej czcionki urządzenia, która będzie w stanie ująć ten glif.

Powiązane elementy interfejsu API

Określa ułożenie czcionki.

Wartość domyślna to FontLookup.NORMAL.

Tej właściwości należy przypisywać następujące stałe z klasy FontPosture:

Powiązane elementy interfejsu API

Określa grubość czcionki.

Wartość domyślna to FontWeight.NORMAL.

Tej właściwości należy przypisywać następujące stałe z klasy FontWeight:

Powiązane elementy interfejsu API

Decyduje, czy obiekt FontDescription jest widoczny, czy nie. Jeśli wartość true obiekt FontDescription nie może być modyfikowany. Aby pobrać niezablokowaną kopię obiektu FontDescription, należy użyć wywołania FontDescription.clone().

Tryb renderowania użyty dla tego tekstu. Wartości tej właściwości powinny być stałymi z klasy RenderingMode.

Ma zastosowanie wyłącznie do czcionek osadzonych.

Wartość domyślna to RenderingMode.CFF.

Tej właściwości należy przypisywać następujące stałe z klasy RenderingMode:

Powiązane elementy interfejsu API

Tworzy obiekt FontDescription.

Tworzy niezablokowany klon obiektu FontDescription.

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

Zwraca wartość true, jeśli dostępna jest możliwa do użycia czcionka urządzenia o podanych parametrach fontName, fontWeight i fontPosture.

Klasy z pakietu flash.text.engine mogą używać tylko czcionek urządzenia typu OpenType i TrueType. W przypadku użycia czcionki opartej na starszej technologii, środowisko wykonawcze dla każdego glifu z osobna wybiera znaną dobrą czcionkę urządzenia w celu prawidłowego zrenderowania tekstu.

Parametry

Powiązane elementy interfejsu API

Zwraca wartość true, jeśli osadzona czcionka jest dostępna z określonymi parametrami fontName, fontWeight ifontPosture, gdzie Font.fontType ma wartość flash.text.FontType.EMBEDDED_CFF. Począwszy od wersji Flash Player 10 w treści aplikacji mogą być stosowane dwa rodzaje osadzonych czcionek. Normalne czcionki osadzone są używane tylko przez obiekty TextField. Osadzone czcionki CFF są używane tylko przez klasy flash.text.engine. Te dwa typy odróżniają właściwość fontType klasy Font, jaka jest zwracana przez funkcję enumerateFonts().

Klasa flash.text.engine nie może korzystać z czcionki typu EMBEDDED. Jeśli dla parametru fontLookup ustawiona jest wartość FontLookup.EMBEDDED_CFF, a jedyna czcionka o określonej nazwie, wadze i ułożeniu, jaka jest dostępna w środowisku wykonawczym, jest typu EMBEDDED, środowisko wykonawcze powróci do czcionek urządzenia według pojedynczych glifów w celu renderowania tekstu — tak, jakby żadna osadzona czcionka nie była dostępna z określoną nazwą i stylem.

Jeśli czcionki EMBEDDED i EMBEDDED_CFF są dostępne (o takiej samej nazwie, wadze i ułożeniu), zostaje wybrana czcionka EMBEDDED_CFF i wówczas tekst jest renderowany z czcionką EMBEDDED_CFF.

Parametry

Powiązane elementy interfejsu API

Ten przykład ilustruje tworzenie obiektu FontDescription, przypisanie do niego czcionki urządzenia, ustawienie różnych właściwości czcionki oraz przypisanie nowego obiektu do obiektu ElementFormat. Dodatkowe formatowanie czcionki odbywa się w obiekcie ElementFormat. Za pomocą obiektu ElementFormat tworzony jest obiekt TextElement. TextElement jest wykorzystywany jako treść obiektu TextBlock. Wiersz tekstu utworzony z obiektu 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);
            
        }
    }    
}