Text
Содержание
Введение
Для отображения текстовой информации с поддержкой многоязычности. Для управления текстовыми ресурсами используется TextEditor.
Если необходимо разместить текст на сцене необходимо создать объект с типом text и перетащить на поле текстID текстовую строку из TextEditor. Также можно просто перенести их TextEditor выбранную текстовую запись, при этом автоматически создастся объект с типом Text.
Параметры объекта
Общие параметры
(см. описание Object)
Основные параметры
- res - Графический ресурс подложки на которой выводится текст. Перетаскивается мышкой из редактора текста (поле должно находится в состоянии редактирования). Может отсутствовать.
- текстID - Выводимый текст перетаскивается из ресурса тектстов, для перетягивания поле в объекте Text должно быть в режиме редактирования. Решетка (#) разделяет на страницы, черта (|) - принудительный переход на новую строку.
- текст - Выводимый текст без использования базы текстовых ресурсов. Решетка (#) разделяет на страницы, черта (|) - принудительный переход на новую строку.
- состояние - текстовый объект обладает тремя состояниями:
- first - в этом состоянии текстовый объект отобразит первую (или единственную) страницу текста;
- next - в этом состоянии текстовый объект отобразит следующую за текущей страницу текста (если текущая страница - последняя, то в этом состоянии ничего не произойдет);
- end - в этом состоянии текстовый объект становится невидимым (и текст и его графический ресурс).
!!! - Необходимо обязательно сохранять любые изменения с текстом в редакторе TextEditor.
Параметры и модификаторы
Группа - форматирования
- dx - Бордюр (отступ текста слева и справа от границы прямоугольника объекта);
- dy - Бордюр (отступ текста сверху и снизу от границы прямоугольника объекта);
- отступ - Вертикальное расстояние между строчками в пикселях;
- h align - Горизонтальное форматирование. Если (c) - центрирование по горизонтали, если (r) - прижатие вправо;
- v align - Вертикальное форматирование. Если (c) - центрирование по вертикали.
Группа - Параметры отображения текста
- время до открытия - Время перед началом проявления текста (от невидимого до заданной прозрачности);
- время открытия - Время проявления текста и подложки до alpha в начале;
- время закрытия - Время исчезновения текста и подложки от alpha до 0 в конце. Если отрицательно - текст не закрывается;
- буквы - Задержка в ms для перехода к новой букве при подсветке;
- слова - Задержка в ms перед подсветкой следующего слова;
- страницы - Задержка в ms перед переходом к следующей странице или увяданию по alpha-каналу.
Группа - Параметры используемого шрифта
- имя - Номер шрифта - целое число, начиная с 0 (порядковый номер шрифта).
- размер - Размер шрифта в поинтах.
- цвет 1 - Цвет текста начального вида (бледный).
- цвет 2 - Цвет прочитанного текста (контрастный). Чтение делается по буквам.
Группа - Параметры поведения текста
- автопромотка - Автоматический переход на следующую страницу после завершения отображения текста;
- зациклить - Зациклить страницы (после последней, перейти опять на первую);
- подсветка - Тип подсветки:
- 0-не подсвечивать,
- 1-по слову;
- 2-по букве слова (караоке);
- 3-по букве с начала страницы.
- звук - 1 - есть озвучка, 0 - нет;
- случайный выбор - 1 - при переключении страницы будет выбираться случайная, 0 - все страницы последовательно. Если выбрана 1 - в редакторе Texts Editor между страницами надо поставить знак #.
Например:
- голос - голос для озвучки. Звуковой файл для одной реплики.
- позиционирование текста
- горизонтальное - 0 - нет выравнивания; 1 - прижать к левому краю; 2 - центр; 3 - к правому;
- вертикальное - 0 - нет выравнивания; 1 - прижать к верхнему краю; 2 - центр; 3 - к нижнему.
Пример применения
Примечания и дополнения
- Если у одного текстового ID слишком много страниц или же они должны меняться в запутанном порядке, то лучше создать несколько тестовых ID и по очереди присваивать их одному текстовому объекту с помощью машины состояний: команда set, параметры obj(текстовый объект), par(txtID), val_txt(текстовый ID, перетаскивается кнопкой мыши из редактора текстов).
- Отображать и делать невидимым текст можно несколькими способами, например, менять общие параметры vis или al, но целесообразней использовать состояния текстового объекта first (объект видимый), end (объект невидимый).
- Разделение строк в текстовой базе символом # можно использовать, если страниц 2(3). В этом случае для смены страниц используют состояние next. Если страниц больше 2(3), лучше создать несколько текстовых ID и присваивать их текстовому объекту с помощью машины состояний.