FontDescription  - AS3

O tipo de referência CFF usado nesse texto. Use constantes CFFHinting nessa propriedade. Essa propriedade será aplicada apenas se a propriedade RenderingMode do texto for definida como RenderingMode.CFF.

O tipo sugerido de CFF (Formato de fonte compacto) usado determina se o tempo de execução do Flash força troncos horizontais fortes a ajustarem-se a uma grade de subpixel ou não.

Aplica-se apenas a fontes incorporadas.

O valor padrão é CFFHinting.HORIZONTAL_STEM.

Para a propriedade CFFHinting, você pode usar as seguintes constantes da classe CFFHinting:

Elementos da API relacionados

Especifica como a fonte deve ser pesquisada.

O valor padrão é FontLookup.DEVICE.

Para definir valores para essa propriedade, utilize os seguintes valores de string:

Elementos da API relacionados

O nome da fonte a ser usada ou uma lista dos nomes de fonte separados por vírgulas. O tempo de execução renderiza o elemento usando a primeira fonte disponível na lista. Por exemplo, "Arial, Helvética, _sans" fazem com que o player procure Arial e Helvética a seguir, se Arial não é encontrada, _sans a seguir, caso nenhuma é encontrada.

Os tempos de execução do Flash suportam três nomes genéricos de fontes de dispositivo: _sans (para sem serifa), _serif (para fontes serifadas) e _typewriter (para fontes monoespaço). Elas são mapeadas para fontes de dispositivo específicas, de acordo com a plataforma.

O valor padrão é "_serif".

O tempo de execução do Flash oferece fallback de fonte para glifos que não são encontrados na fonte selecionada. Independentemente se a fonte usada está incorporada ou é de dispositivo, se o glifo não for encontrado na fonte, o tempo de execução tenta renderizar o glifo usando outra fonte de dispositivo que o contenha.

Elementos da API relacionados

Especifica a postura da fonte.

O valor padrão é FontPosture.NORMAL.

Para definir valores para esta propriedade, use as seguintes constantes da classe FontPosture:

Elementos da API relacionados

Especifica a espessura da fonte.

O valor padrão é FontWeight.NORMAL.

Para definir valores para esta propriedade, use as seguintes constantes da classe FontWeight:

Elementos da API relacionados

Indica se FontDescription está ou não bloqueado. Se for true, o FontDescription não poderá ser modificado. Chame FontDescription.clone() para obter uma cópia desbloqueada do objeto FontDescription.

O modo de renderização usado nesse texto. Use constantes RenderingMode para essa propriedade.

Aplica-se apenas a fontes incorporadas.

O valor padrão é RenderingMode.CFF.

Para estabelecer valores para esta propriedade, use as seguintes constantes da classe RenderingMode:

Elementos da API relacionados

Cria um objeto FontDescription.

Constrói uma cópia clonada desbloqueada de 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);
            
        }
    }    
}

True é retornado se uma fonte de dispositivo utilizável está disponível com o especificado fontName,fontWeighte fontPosture

As classes flash.text.engine só podem usar fontes de dispositivo OpenType e TrueType. Se uma fonte baseada em uma tecnologia de fontes mais velha for usada, o tempo de execução recorre aos bons dispositivo de fontes conhecidas em uma base de glifo por glifo para renderizar o texto

Parâmetros

Elementos da API relacionados

Retornará true se uma fonte incorporada estiver disponível com os parâmetros fontName, fontWeight e fontPosture, em que Font.fontType é flash.text.FontType.EMBEDDED_CFF. A partir do Flash Player 10, dois tipos de fontes incorporadas podem aparecer em um conteúdo de aplicativo. As fontes incorporadas normais são usadas somente com objetos TextField. As fontes incorporadas CFF são usadas somente pelas classes flash.text.engine. Os dois tipos são diferenciados pela propriedade fontType da classe Font, conforme retornados pela função enumerateFonts().

As classes flash.text.engine não podem usar a fonte de tipo EMBEDDED. Se fontLookup for definido como FontLookup.EMBEDDED_CFF e a única fonte disponível no tempo de execução com o nome, a espessura e a postura especificados for de tipo EMBEDDED, o tempo de execução recorrerá às fontes do dispositivo, glifo por glifo, para renderizar o texto, como se não houvesse nenhuma fonte incorporada com o nome e o estilo especificados.

Se as fontes EMBEDDED e EMBEDDED_CFF estiverem disponíveis com o mesmo nome, espessura e postura, a fonte EMBEDDED_CFF será selecionada e o texto será renderizado com a fonte EMBEDDED_CFF.

Parâmetros

Elementos da API relacionados

Esse exemplo cria um objeto FontDescription, atribui uma fonte de dispositivo a ele, define várias propriedades de fonte e atribui o novo objeto a um objeto ElementFormat. A formatação adicional da fonte é feita em ElementFormat. Um novo TextElement é criado usando o ElementFormat, e o TextElement é usado como conteúdo de um TextBlock. Uma linha de texto é criada a partir do 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);
            
        }
    }    
}