Skip to content

components.BitmapText

Megabyte edited this page Dec 1, 2019 · 5 revisions

компоненты : Иконка компонента BitmapText

Наследуется от Container, и включает в себя все его свойства.

BitmapText - статический, видимый на игровом экране текст, использующий BitFont шрифты имеющиеся в ресурсах проекта. BitmapText - это класс, напрямую взятый из pixi.js

BitmapText поддерживает мультиязычность (локализацию). Подробнее

Добавление BitmapFont шрифтов в проект

Сгенерируйте шрифт при помощи утилиты http://www.angelcode.com/products/bmfont/ в формате '.xml' и переименуйте полученный .fnt файл в .xml. Текстура должна быть в формате PNG. Скопируйте .xml и .png файлы в парку проекта img/fonts, после чего шрифт будет доступен для выбора в редактируемом поле font.name объекта BitmapFont добавленного на сцену.

Для исправления ошибки отрисовки шрифтов в релизном билде, необходимо чтобы имя шрифта начиналось с '@1x_' префикса.

Thing-Editor расширяет стандартный pixi BitmapText несколькими свойствами, для его совместимости с редактором свойств.

Редактируемые свойства:

text

Тип: String

Строковое значение, отвечающее за то, какой именно текст будет отображаться на игровом экране. Поле напрямую унаследовано из pixi


translatableText

Тип: String

Thing-Editor поддерживает мультиязычные проекты Подробнее. Данное поле отвечает за то, какая именно текстовая строка из текстовых ресурсов, будет отображаться на игровом экране. В редакторе свойств это поле имеет вид выпадающего списка со всеми имеющимися в проекте текстовыми ресурсами. Подробнее: Редактор текстовых ресурсов


font.name

Тип: String

Шрифт текстового поля. Выпадающий список с доступными в проекте BitmapFont шрифтами. Подробнее о добавлении шрифтов в проект.


font.size

Тип: Number

Размер шрифта в пикселях.


letterSpacing

Тип: Number

Расстояние между символами в пикселях.


tint

Тип: Number

Свойство pixi.js BitmapText, отвечающее за его цветокоррекцию. В редакторе свойств это значение отображается в шестнадцатеричном виде. Поле имеет Number тип, поэтому, добавлять знак # в начале этого поля не нужно.


font.align

Тип: String

Выравнивание текстового поля по ширине. В редакторе свойств это поле представляет из себя выпадающий список с доступными вариантами выравнивания.


verticalAlign

Тип: String

Выравнивание текстового поля по высоте. В редакторе свойств это поле представляет из себя выпадающий список с доступными вариантами выравнивания.


textProvider

Тип: data-path

Данное поле указывает путь к Label объекту, текстовое значение которого будет браться для отображения. Данное поле дает возможность применить логику Label к BitmapText объекту.


maxWidth

Тип: Number

Данное поле унаследовано из PIXI и управляет переносами строк.


maxW

Тип: Number

Максимальная ширина текста в пикселях. При установке значения этого поля больше 0, для текстового объекта включается механизм ограничения ширины. Это имеет смысл для мультиязычных полей, когда ширина текста может меняться в зависимости от активного языка, либо для текстовых полей с динамически генерируемым текстом, когда размер текста заранее не известен, а экранная область отводимая под текст ограничена.

Ширина текстового поля ограничивается путем установки его scale.x и scale.y, что делает невозможным ручное редактирование scale.x и scale.y текстового поля.

После установки maxW равным нулю, чтобы отключить ограничение ширины, scale.x и scale.y могут остаться не равными единице, в этом случае может понадобиться их ручная корректировка.


Служебные поля:

Edit Text

В редакторе свойств - это поле представляет из себя кнопку, для быстрого перехода в редактор тестовых ресурсов. При ее нажатии произойдет переход к редактированию текстового ресурса, привязанного к даному Text объекту (когда значение поля translatableText установлено), либо произойдет открытие диалога создания нового текстового ресурса, если значение поля translatableText не установлено. В javascript это поле не доступно.

<- Предыдущая страница Следующая страница ->

Связанные темы:

редактор тестовых ресурсов

функции локализации

Свойства, унаследованные от Container

Компоненты

Редактируемые поля

PIXI.BitmapText

Clone this wiki locally