Пакет | flash.text.engine |
Класс | public final class FontDescription |
Наследование | FontDescription Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Объект FontDescription применен к объекту ElementFormat, который в свою очередь применяется к ContentElement в TextBlock. После применения объекта FontDescription к объекту ElementFormat для его свойства locked
задается значение true
. Изменение свойств заблокированного объекта FontDescription невозможно. Вместо этого необходимо использовать метод clone()
для создания разблокированной копии объекта, который можно изменить и присвоить объекту ElementFormat.
Примечание. Механизм визуализации текста FTE (Flash Text Engine) не поддерживает шрифты Type 1 или растровые шрифты, такие как Type 3, ATC, sfnt-wrapped CID или Naked CID.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
cffHinting : String
Тип используемого для текста хинтинга CFF. | FontDescription | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
fontLookup : String
Задает способ поиска шрифта. | FontDescription | ||
fontName : String
Имя используемого шрифта или разделенный запятой список имен шрифтов. | FontDescription | ||
fontPosture : String
Задает начертание шрифта. | FontDescription | ||
fontWeight : String
Задает толщину шрифта. | FontDescription | ||
locked : Boolean
Определяет, является ли объект FontDescription заблокированным. | FontDescription | ||
renderingMode : String
Режим визуализации, используемый для данного текста. | FontDescription |
Метод | Определено | ||
---|---|---|---|
FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")
Создает объект FontDescription. | FontDescription | ||
Создание разблокированной клонированной копии объекта FontDescription. | FontDescription | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
[статические]
Возвращает true, если доступен применимый шрифт устройства с указанными значениями fontName, fontWeight и fontPosture. | FontDescription | ||
[статические]
Возвращает значение true, если доступен встроенный шрифт с указанными свойствами fontName, fontWeight и fontPosture, где Font.fontType — это flash.text.FontType.EMBEDDED_CFF. | FontDescription | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object |
cffHinting | свойство |
cffHinting:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Тип используемого для текста хинтинга CFF. Используйте константы CFFHinting
для этого свойства. Это свойство применяется, только если свойство RenderingMode
текста имеет значение RenderingMode.CFF
.
Используемый тип хинтинга CFF (компактного формата шрифтов) определяет, должна ли среда выполнения Flash принудительно вписывать горизонтальные основы в подпискельную сетку ли время выполнения Flash сильные горизонтальные основы поместиться к подпиксельной сетке или нет.
Применяется только к встроенным шрифтам.
По умолчанию используется значение CFFHinting.HORIZONTAL_STEM
.
Для свойства CFFHinting
можно использовать следующие константы класса CFFHinting.
Строковое значение | Описание |
---|---|
CFFHinting.NONE | Задает отсутствие хинтинга CFF. Горизонтальные основы глифов не привязываются к подпиксельной сетке. Этот параметр подходит для анимации или для шрифтов большого размера. |
CFFHinting.HORIZONTAL_STEM | Задает хинтинг CFF. Сильные горизонтальные основы вписываются в подпиксельную сетку на экране. Чтобы использовать этот параметр, свойство RenderingMode должно иметь значение RenderingMode.CFF . |
Реализация
public function get cffHinting():String
public function set cffHinting(value:String):void
Выдает
ArgumentError — Если задано значение, не являющееся элементом класса CFFHinting .
| |
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true ).
|
Связанные элементы API
fontLookup | свойство |
fontLookup:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Задает способ поиска шрифта.
По умолчанию используется значение FontLookup.DEVICE
.
В качестве значений этого свойства используйте следующие строковые значения:
Строковое значение | Описание |
---|---|
FontLookup.DEVICE | Для визуализации текста среда выполнения ищет шрифт устройства с заданным свойством name в локальной системе. |
FontLookup.EMBEDDED_CFF | Для визуализации текста среда выполнения ищет встроенный шрифт CFF с заданными свойством name . Рассматриваются только шрифты типа flash.text.Font.fontType.EMBEDDED_CFF . Если заданный шрифт CFF не встроен в приложение, среда выполнения пытается использовать резервный шрифт устройства для каждого глифа. Этот метод менее эффективен, чем изначальный выбор шрифта устройства. |
Реализация
public function get fontLookup():String
public function set fontLookup(value:String):void
Выдает
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true ).
|
Связанные элементы API
fontName | свойство |
fontName:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Имя используемого шрифта или разделенный запятой список имен шрифтов. Среда выполнения визуализирует элемент с помощью первого доступного шрифта в списке. Например, если задать «Arial, Helvetica, _sans», то проигрыватель сначала выполняет поиск Arial, затем Helvetica, если Arial не обнаружен, а потом _sans, если не обнаружен ни тот, ни другой.
Среда выполнения Flash поддерживает три общих имени шрифтов устройства: _sans (для шрифтов sans serif), _serif (для шрифтов serif) и _typewriter (для моноширинных шрифтов). Они соотносятся с определенными шрифтами устройств в зависимости от платформы.
Значением по умолчанию является _serif
.
Среда выполнения Flash обеспечивает резервные шрифты для глифов, которых нет в выбранном шрифте. Независимо от того, встроен используемый шрифт или нет, если глиф не найден в данном шрифте, среда выполнения пытается визуализировать его с использованием другого шрифта устройства, который может содержать нужный глиф.
Реализация
public function get fontName():String
public function set fontName(value:String):void
Выдает
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true ).
|
Связанные элементы API
fontPosture | свойство |
fontPosture:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Задает начертание шрифта.
По умолчанию используется значение FontPosture.NORMAL
.
Чтобы установить значения для этого свойства, используйте следующие константы класса FontPosture.
Значение | Описание |
---|---|
FontPosture.NORMAL | Обычное начертание шрифта. |
FontPosture.ITALIC | Курсивное начертание шрифта. |
Реализация
public function get fontPosture():String
public function set fontPosture(value:String):void
Выдает
ArgumentError — Если задано значение, не являющееся элементом класса FontPosture .
| |
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true ).
|
Связанные элементы API
fontWeight | свойство |
fontWeight:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Задает толщину шрифта.
По умолчанию используется значение FontWeight.NORMAL
.
Чтобы установить значения для этого свойства, используйте следующие константы класса FontWeight.
Строковое значение | Описание |
---|---|
FontWeight.NORMAL | Обычная толщина шрифта. |
FontWeight.BOLD | Полужирная толщина шрифта. |
Реализация
public function get fontWeight():String
public function set fontWeight(value:String):void
Выдает
ArgumentError — Если задано значение, не являющееся элементом класса FontWeight .
| |
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true ).
|
Связанные элементы API
locked | свойство |
locked:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5., Flash Lite 4 |
Определяет, является ли объект FontDescription заблокированным. Если задано значение true
, изменение объекта FontDescription невозможно. Вызовите метод FontDescription.clone()
для получения разблокированной копии объекта FontDescription.
Реализация
public function get locked():Boolean
public function set locked(value:Boolean):void
Выдает
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true ).
|
renderingMode | свойство |
renderingMode:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Режим визуализации, используемый для данного текста. Используйте константы RenderingMode
для этого свойства.
Применяется только к встроенным шрифтам.
По умолчанию используется значение RenderingMode.CFF
.
Чтобы установить значения для этого свойства, используйте следующие константы класса RenderingMode.
Строковое значение | Описание |
---|---|
RenderingMode.NORMAL | Применяет обычную визуализацию текста, которая соответствует типу визуализации, используемому в Flash Player 7 и более ранних версиях. |
RenderingMode.CFF | Применяет визуализацию CFF (компактного формата шрифтов), которая делает текст более четким. (Эта функция стала доступной в проигрывателе Flash Player 10.) Визуализация CFF обеспечивает высококачественную визуализацию шрифтов мелкого размера. |
Реализация
public function get renderingMode():String
public function set renderingMode(value:String):void
Выдает
ArgumentError — Если задано значение, не являющееся элементом класса RenderingMode .
| |
IllegalOperationError — Если задается после блокирования объекта FontDescription (для свойства locked задано значение true ).
|
Связанные элементы API
FontDescription | () | Конструктор |
public function FontDescription(fontName:String = "_serif", fontWeight:String = "normal", fontPosture:String = "normal", fontLookup:String = "device", renderingMode:String = "cff", cffHinting:String = "horizontalStem")
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Создает объект FontDescription.
ПараметрыfontName:String (default = "_serif ") — Имя используемого шрифта или разделенный запятой список имен шрифтов.
| |
fontWeight:String (default = "normal ") — Задает толщину шрифта.
| |
fontPosture:String (default = "normal ") — Задает начертание шрифта.
| |
fontLookup:String (default = "device ") — Задает метод поиска шрифта.
| |
renderingMode:String (default = "cff ") — Режим визуализации, используемый для данного текста. Используйте константы RenderingMode для этого свойства.
| |
cffHinting:String (default = "horizontalStem ") — Тип хинтинга CFF (компактного формата шрифтов), используемый для этого текста. Используйте константы CFFHinting для этого свойства.
|
Выдает
ArgumentError — Заданное значение fontWeight не является членом класса FontWeight .
| |
ArgumentError — Заданное значение fontPosture не является членом класса FontPosture .
| |
ArgumentError — Заданное значение fontLookup не является членом класса FontLookup .
| |
ArgumentError — Заданное значение renderingMode не является членом класса RenderingMode .
| |
ArgumentError — Заданное значение cffHinting не является членом класса CFFHinting .
|
clone | () | метод |
public function clone():FontDescription
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Создание разблокированной клонированной копии объекта FontDescription.
ВозвращаетFontDescription — Разблокированная копия объекта FontDescription .
|
Пример ( Использование этого примера )
В этом примере создается объект FontDescription
, ему назначается шрифт устройства, задаются разные свойства шрифта и назначается новый объект (и таким образом блокируется) объекту ElementFormat
. Создается новый объект TextElement
с использованием ElementFormat
, затем этотTextElement
используется в качестве содержимого для объекта TextBlock
. Из объекта TextBlock
создается текстовая строка.
Для изменения объекта FontDescription
сначала проверьте его свойство locked
. Если значение true, используйте метод clone()
для создания разблокированной копии объекта FontDescription
, измените его свойства и назначьте его новому объекту ElementFormat. Затем повторно создайте связь нового объекта ElementFormat
и объекта TextBlock
. При повторной разбивке строк новые строки получат новые параметры шрифтов.
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); } } }
isDeviceFontCompatible | () | метод |
public static function isDeviceFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Возвращает true, если доступен применимый шрифт устройства с указанными значениями fontName
, fontWeight
и fontPosture
.
Классы flash.text.engine могут использовать только шрифты устройства типа OpenType и TrueType. Если используется шрифт, созданный на базе более старой технологии шрифтов, среда выполнения выполняет визуализацию текста глиф за глифом, используя заведомо рабочие шрифты устройства.
Параметры
fontName:String — Имя проверяемого шрифта устройства.
| |
fontWeight:String — Задает толщину шрифта. Используйте FontWeight .
| |
fontPosture:String — Задает начертание шрифта. Используйте FontPosture .
|
Boolean — Значение true , если доступен совместимый шрифт устройства, в противном случае, значение — false .
|
Выдает
ArgumentError — Заданное значение fontWeight не является членом класса FontWeight .
| |
ArgumentError — Заданное значение fontPosture не является членом класса FontPosture .
|
Связанные элементы API
isFontCompatible | () | метод |
public static function isFontCompatible(fontName:String, fontWeight:String, fontPosture:String):Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Возвращает значение true, если доступен встроенный шрифт с указанными свойствами fontName
, fontWeight
и fontPosture
, где Font.fontType
— это flash.text.FontType.EMBEDDED_CFF
. Начиная с Flash Player 10, в содержимом приложения могут отображаться два вида встроенных шрифтов. Обычные встроенные шрифты используются только объектами TextField. Встроенные шрифты CFF используются только классами flash.text.engine. Два типа различаются свойством fontType
класса Font
, возвращенным функцией enumerateFonts()
.
Классы flash.text.engine не могут использовать шрифты типа EMBEDDED
. Если fontLookup
имеет значение FontLookup.EMBEDDED_CFF
в среде выполнения единственным доступным шрифтом с заданным именем и стилем является шрифт типа EMBEDDED
, среда выполнения использует шрифты устройства и визуализирует текст глиф за глифом, как будто в файле нет встроенного шрифта с заданным именем и стилем.
Если имеются шрифты EMBEDDED
и EMBEDDED_CFF
с одинаковым именем и стилем, выбирается шрифт типа EMBEDDED_CFF
, и для визуализации текста используется шрифт EMBEDDED_CFF
.
Параметры
fontName:String — Имя проверяемого встроенного шрифта.
| |
fontWeight:String — Задает толщину шрифта. Используйте FontWeight .
| |
fontPosture:String — Задает начертание шрифта. Используйте FontPosture .
|
Boolean — Значение true , если доступен совместимый встроенный шрифт, в противном случае, значение — false .
|
Выдает
ArgumentError — Заданное значение fontWeight не является членом класса FontWeight .
| |
ArgumentError — Заданное значение fontPosture не является членом класса FontPosture .
|
Связанные элементы API
В этом примере создается объект FontDescription
, ему назначается шрифт устройства, задаются разные свойства шрифта и назначается новый объект объекту ElementFormat
. Дополнительное форматирование шрифта выполняется с помощью ElementFormat
. Создается новый объект TextElement
с использованием ElementFormat
, затем этотTextElement
используется в качестве содержимого для объекта TextBlock
. Из объекта 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); } } }
Tue Jun 12 2018, 11:34 AM Z