Text

Материал из wiki.appsalutecreator.com
Перейти к: навигация, поиск

Text - объект для отображения текстовой информации с поддержкой многоязычности. Для управления текстовыми ресурсами используется TextEditor.

Введение

2223.png


Если необходимо разместить текст на сцене необходимо создать объект с типом text и перетащить на поле текстID текстовую строку из TextEditor. Также можно просто перенести их TextEditor выбранную текстовую запись, при этом автоматически создастся объект с типом Text.

Обязательно в тексте ТекстовойБазы, после символа '|' должен стоять другой символ. Если делаем два переноса, это будет выглядеть: "текст| |тест".

Параметры объекта

Общие параметры

(см. описание Object)

Основные параметры

  • res - Графический ресурс подложки на которой выводится текст. Перетаскивается мышкой из редактора текста (поле должно находится в состоянии редактирования). Может отсутствовать.
  • текстID - Выводимый текст перетаскивается из ресурса текстов, для перетягивания поле в объекте Text должно быть в режиме редактирования. Решетка (#) разделяет на страницы, черта (|) - принудительный переход на новую строку.
  • текст - Выводимый текст без использования базы текстовых ресурсов. Решетка (#) разделяет на страницы, черта (|) - принудительный переход на новую строку.
  • состояние - в поле указывается состояние текстового объекта, в которое он перейдет при загрузке экрана (это поле часто оставляют пустым, а состояния задают машиной).
!!! - Необходимо обязательно сохранять любые изменения с текстом в редакторе TextEditor.
Text1.PNG

Дополнительные параметры

Text2.PNG

Группа - форматирования

  • dx - Бордюр (отступ текста слева и справа от границы прямоугольника объекта);
  • dy - Бордюр (отступ текста сверху и снизу от границы прямоугольника объекта);
  • отступ - Вертикальное расстояние между строчками в пикселях;
  • h align - Горизонтальное форматирование. Если (c) - центрирование по горизонтали, если (r) - прижатие вправо;
  • v align - Вертикальное форматирование. Если (c) - центрирование по вертикали.
2224.png
Text11.png
Text22.png


  • автоматическое уменьшение - Функция позволяет уменьшить размер шрифта, чтобы уместить текст внутри прямоугольника ( размеры текстового объекта).
  • минимальный размер шрифта - Минимальный размер до которого уменьшит функция автоскейла.
  • уменьшать до строк - Нужно для функционала автоматического уменьшения. Попытается строку преобразовать в n строк ( исп. для цен).
890a37f3ed.jpg


Группа - Параметры отображения текста

  • время до открытия - Время перед началом проявления текста (от невидимого до заданной прозрачности);
  • время открытия - Время проявления текста и подложки до alpha в начале;
  • время закрытия - Время исчезновения текста и подложки от alpha до 0 в конце. Если отрицательно - текст не закрывается;
  • буквы - Задержка в ms для перехода к новой букве при подсветке;
  • слова - Задержка в ms перед подсветкой следующего слова;
  • страницы - Задержка в ms перед переходом к следующей странице или увяданию по alpha-каналу.

Группа - Параметры используемого шрифта

  • имя - Номер шрифта - целое число, начиная с 0 (порядковый номер шрифта).
  • размер - Размер шрифта в поинтах.
  • цвет 1 - Цвет текста начального вида (бледный).
  • цвет 2 - Цвет прочитанного текста (контрастный). Чтение делается по буквам.

Группа - Параметры поведения текста

  • автопромотка - Автоматический переход на следующую страницу после завершения отображения текста;
  • зациклить - Зациклить страницы (после последней, перейти опять на первую);
  • подсветка - Тип подсветки: 0-не подсвечивать, 1-по слову; 2-по букве слова (караоке); 3-по букве с начала страницы;
  • звук - 1 - есть озвучка, 0 - нет;
  • случайный выбор - 1 - при переключении страницы будет выбираться случайная, 0 - все страницы последовательно. Если выбрана 1 - в редакторе Texts Editor между страницами надо поставить знак #.


Например:

Text3.PNG
  • голос - голос для озвучки. Звуковой файл для одной реплики.
  • позиционирование текста
    • горизонтальное - 0 - нет выравнивания; 1 - прижать к левому краю; 2 - центр; 3 - к правому;
    • вертикальное - 0 - нет выравнивания; 1 - прижать к верхнему краю; 2 - центр; 3 - к нижнему.

Добавляемые параметры

Menadd.png

Меню выбора Добавляемые параметры к объектам активируется по правой кнопки мыши.

+.png голос для озвучки - голос для озвучки 1 реплики. Следить за тем, чтобы количество звуков совпадало с количеством реплик.

Состояния

  • start - это состояние проверяет время до открытия и переходит либо в beg, если время до открытия не ноль, либо в open, если время до открытия равняется нулю;
  • beg - это состояние "ждет" время до открытия и переходит в open;
  • open - плавно проявляет текст до его нормального alpha в течении времени открытия;
  • first - это состояние перезапускает текст без появления по alpha; в этом состоянии текстовый объект мгновенно отобразит первую (или единственную) страницу текста;
  • next - в этом состоянии текстовый объект мгновенно отобразит следующую за текущей страницу текста (если текущая страница - последняя, то в этом состоянии ничего не произойдет);
  • prev - в этом состоянии текстовый объект мгновенно отобразит предыдущую до текущей страницу текста (если текущая страница - первая, то в этом состоянии ничего не произойдет);
  • close - плавно растворяет текст до alpha=0 в течении времени закрытия, после чего переходит в состояние end;
  • end - в этом состоянии текстовый объект не отображается.

Параметры

  • txtID - меняет объекту текстовый id. Перетягиваем из текстового редактора в поле val_txt необходимый текстовый id.
  • fc1 - предоставляет возможность изменить цвет шрифта текстового объекта. В поле val вписывается цвет в виде 16-го кода.
  • sense - позволяет отображать разные поля текстового id. Если установить значение 0 - у текстового объекта будет отображаться поле word, если 1 - sentence1, если 2 - sentence2.
  • textWidth - ширина текущего текста в текстовом объекте в px (с учетом параметров форматирования текстового объекта).
  • textHeight - высота текущего текста в текстовом объекте в px.

Пример применения

Text3.PNG
Ex3.PNG

Примечания и дополнения

  • Если у одного текстового ID слишком много страниц или же они должны меняться в запутанном порядке, то лучше создать несколько тестовых ID и по очереди присваивать их одному текстовому объекту с помощью машины состояний: команда set, параметры obj(текстовый объект), par(txtID), val_txt(текстовый ID, перетаскивается кнопкой мыши из редактора текстов).
  • Отображать и делать невидимым текст можно несколькими способами, например, менять общие параметры vis или al, но целесообразней использовать состояния текстового объекта start и close.
  • Разделение строк в текстовой базе символом # можно использовать, если страниц 2(3). В этом случае для смены страниц используют состояние next. Если страниц больше 2(3), лучше создать несколько текстовых ID и присваивать их текстовому объекту с помощью машины состояний.
  • Значения временных параметров по умолчанию:
время до открытия - 0,
время открытия - 500,
время закрытия - 500,
буквы - 30,
слова - 30,
страницы - 500.
Другими словами такие значения параметров равносильны нулю.
Для постепенного открытия (закрытия) текста следует указывать временные параметры отличные от значений по умолчанию.


Картинка в тексте


Иконка будет вставлена в текст, если будет символы - $id167$al0.5$dx5.
Расшифровка:
$ - карявка для определения, что впереди что-то есть
id167 - указываем отрисовать картинку с id==167 ( картинка должна присутствовать на этом экране, иначе не покажется; Если картинки нету в ресурсной базе - будет выполнено два пробела);
$al0.5 - указываем альфу картинки;
$dx5 - указываем что картинку смещаем на 5-ть пикселей вправо от точки вставки;
Примечание:
1) Если не указываем $al0.5 или $dx5, то берём стандартное значение ( к примеру $id167 - означает картинка 167 с альфой==1 и без смещения (dx==0));
2) al и dx могут могут быть в любом порядке.
3) Записывать в текст спец. символы можно и через переменную;
4) Текст по высоте будет смещён на половину высоты самой большой картинки в строке ( если половина высоты больше размера шрифта);
5) иконка вставляемая в текст должна быть без лишней альфы ( при отступах учитывается ширина и высота картинки).
Пример:

Viewer 2.jpg


Viewer 3.jpg

Viewer.jpg


Цветной текст


Текстовый объект, если встретит в тексте символы $c0xFF46FF26 ( обязательно пробел до символов и после), то последующий текст будет перекрашен в указанный цвет.

!!! Нельзя указывать вначале текстовой ячейки или сразу после #. После перекрашивания не ставим пробел, должен быть символ ( нельзя так : "текст $c0xFF46FF26 текст2")

Расшифровка:
$c0xFF46FF26
$ - карявка для определения, что впереди что-то есть
с - типа color
0xFF46FF26 - код цвета 0xFF46FF26 ( 0x - обязательно ( указываем 16-тиричную систему исчисления), FF - альфа, 46 - число по Red каналу, FF - Green канал, 26 - Blue канал).

Select Color.jpg

Пример:
Текст_1 $c0xFF46FF26 Текст_2
Текст_1 - будет цветом указанным в текстовом объекте, а Текст_2 - будет зелёным.

Viewer 4.jpg