Text

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

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

Введение

2223.png


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

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

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

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

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

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

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

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

Text params.png

Группа - зачёркивание

  • ресурс (crRes) — графический ресурс зачёркивания текста.
  • смещение по Х (shCrX) — смещение по X ресурса.
  • смещение по Y (shCrY) — смещение по Y ресурса.
  • толщина (str_s) — толщина зачёркивания в пикселях.

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

  • отступ по X (dx) – бордюр (отступ текста слева и справа от границы прямоугольника).
  • отступ по Y (dy) – бордюр (отступ текста сверху и снизу от границы прямоугольника).
  • сдвиг по X (shx) – сдвиг области текста по X от точки выравнивания.
  • сдвиг по Y (shy) – сдвиг области текста по Y от точки выравнивания.
  • междустрочный интервал (skip) - вертикальное расстояние между строчками в пикселях.
  • горизонтальное выравнивание (ha) - горизонтальное форматирование. Если c - центрирование по горизонтали, если r - прижатие вправо, l – влево.
  • вертикальное выравнивание (va) - вертикальное форматирование. Если c - центрирование по Вертикали, если u - прижатие вверх, d – вниз.
  • максимум строк (maxS) — максимальное число строк.
  • максимум символов (maxChar) - максимальное количество символов.
  • только первое слово (first_word) — показывать только первое слово.
  • игнорировать разметку (ignore_marking) — игнорировать символы разметки.
2224.png
Text11.png
Text22.png


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

Группа - время

  • до открытия (tmBeg) - время перед началом проявления текста (от невидимого до заданной прозрачности).
  • открытия (tmShw) - время проявления текста и подложки до alpha в начале.
  • закрытия (tmCls) - время исчезновения текста и подложки от alpha до 0 в конце. Если отрицательно - текст не закрывается.
  • буквы (tmLt) - задержка в ms для перехода к новой букве при подсветке.
  • слова (tmWd) - задержка в ms перед подсветкой следующего слова.
  • страницы (tmSn) - задержка в ms перед переходом к следующей странице или увяданию по alpha-каналу.
  • появление одного символа (tmAppear) - время появления одного символа по альфа-каналу. Только для режима спрятанных символов.
  • до появления символов (tmBefore) - время появления символов по альфа-каналу. Только для режима спрятанных символов.

Группа - шрифт

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

Группа - поведение

  • автопереход по страницам (auto) - Автоматический переход на следующую страницу после завершения отображения текста.
  • зациклить (loop) - Зациклить страницы (после последней, перейти опять на первую).
  • подсветка (light) - Тип подсветки:
  • 0 - не подсвечивать.
  • 1 - по слову.
  • 2 - по букве слова (караоке).
  • 3 - по букве с начала страницы.
  • звук (snd):
  • 0 - нет озвучки.
  • 1 - есть озвучка.
  • случайный выбор страниц (rnd) -
  • 0 - все страницы последовательно.
  • 1 - при переключении страницы будет выбираться случайная. Если выбрана 1 - в редакторе Texts Editor между страницами надо поставить знак #.
  • затухание (fd) - время затухания звука при состоянии end.
  • кол-во слов для подсветки (ightingwordcount) - кол-во слов, которое будет подсвечиваться за раз. Работает для типа подсветки.
  • знаки препинания (punctuations) — знаки препинания до которых будет подсвечиваться текст.
  • прятать % символов (hidesymbols) - указанный процент символов которые будут спрятаны.
Тонкости исп.  hidesymbols :
   при сост. "init" - буквы будут выставленны моментально
   при изменение параметра и передаче сост. "start" - буквы будут проявляться за время "проявления одного символа" ("tmAppear"); 
   Добавленные буквы после сост. "start" записываются в текстовом объекте в поле "appearingChars" с разделителем "|" ;
   П.С. текстовый объект сохраняет маску спрятанных букв в опции ( до тех пор, пока не меняется количество символов - т.е. поменяв txtID или локализацию - маска перегенерируется); 

Группа - по сплайну

  • сплайну (spl) — точки задающие сплайн. Чётное количество цифр через запятую. Каждая пара воспринимается как x, y.
  • позиционирование (splPos) — тип позиционирования.
  • 0 — по ширине.
  • 1 — по центру.
  • нахлёст (splLap) - допустимый нахлёст при масштабировании.


Например:

Text3.PNG

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

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

+.png голос для озвучки (voice) - голос для озвучки одной реплики:

  • voice (id) - звуковой файл.
Важно следить за тем, чтобы количество звуков совпадало с количеством реплик.

+.png эффект — бордюр (effBorder):

  • толщина бордюра (bSize).
  • цвет бордюра (bCol).
  • цвет текста (tCOl).

+.png переменная вставляемая в текст (var):

  • имя (nm) — имя переменной, которое используем в текстовой базе.
  • объект (obj) - объект, который используем ниже.
  • параметр (par) — параметр, значение которого подставим в переменную.


Состояния

Все состояния:

  • beg - по прохождению времени из поля время->до открытия переходит в состояние open;
  • start - форматирует текст, после чего переходит в состояние beg;
  • open - проявляет текст по альфе за время, указанное в поле время->открытия и переходит в состояние first;
  • run - выводит текст из поля txt/txtID по правилам из группы "Подсветка";
  • pause - остановка вывода текста в обьект на подсвеченом слове;
  • wait - показ последней напечатанной страницы, ожидание следующей команды;
  • first - запустить показ первой страницы текста (страницы отделяются в текстовом ID символами #) в соответствии с правилами подсветки;
  • last - запустить показ последней страницы текста (страницы отделяются в текстовом ID символами #) в соответствии с правилами подсветки;
  • next - запустить показ следующей страницы текста в соответствии с правилами подсветки (если текущая страница - последняя, то в этом состоянии ничего не произойдет);
  • prev - запустить показ предыдущей страницы текста в соответствии с правилами подсветки (если текущая страница - первая, то в этом состоянии ничего не произойдет);
  • close - плавно растворяет текст по альфе в течении времени, указанном в поле время->закрытия, после чего переходит в состояние end;
  • cross - зачеркнуть текст;
  • 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