https://wiki.appsalutecreator.com/api.php?action=feedcontributions&user=Achet&feedformat=atomwiki.appsalutecreator.com - Вклад участника [ru]2024-03-29T06:09:06ZВклад участникаMediaWiki 1.31.15https://wiki.appsalutecreator.com/index.php?title=AtomicPuzzle&diff=9707AtomicPuzzle2018-09-25T08:17:35Z<p>Achet: /* Файл уровней */</p>
<hr />
<div>{{TOC right}}<br />
'''AtomicPuzzle''' - [[Object|объект]] редактора, который реализует игровую механику "Atomic Puzzle" - задача игрока логически удалить атомы с молекулы, тем самым уничтожив ее, не оставив ни одного атома.<br />
----<br />
<br />
=='''Основные свойства'''==<br />
<br />
[[Файл:Atom1.png|thumb|right]]<br />
<br />
* '''''файл уровня''''' - файл с описанием уровней.<br />
* '''''номер уровня''''' - номер текущего уровня.<br />
* '''''прокликиваемый''''' - Если 1, то прямоугольник прозрачен для клика мышкой (пропускает объектам под собой). Если 2, то прямоугольник сам обрабатывает клик, но и пропускает его дальше.<br />
* '''звуки'''<br />
** '''''конец хода (обычный)''''' - звук конца обычного хода.<br />
** '''''конец хода (обмен)''''' - звук конца хода при применении бонуса обмена.<br />
** '''''конец хода (закраска)''''' - звук конца хода при применении бонуса закраска.<br />
* '''параметры анимации'''<br />
** '''''начальная скорость движения''''' - начальная скорость движения.<br />
** '''''ускорение движения''''' - ускорение движения.<br />
** '''''время исчезновения ms''''' - время исчезновения ms.<br />
** '''''время пульсации линии ms''''' - время пульсации линии ms.<br />
** '''''минимальное значение альфы при пульсации''''' - минимальное значение альфы при пульсации.<br />
* '''счетчики'''<br />
** '''''ходы''''' - счетчик оставшихся ходов.<br />
** '''''время''''' - счетчик оставшегося времени.<br />
* '''сохранение'''<br />
** '''''сохранять в профиль''''' - Если ==1, то значение будет сохранено в текущий профиль, если 0 - то глобально..<br />
** '''''поле в опциях''''' - Поле в опциях, в которое будет сохраняться номер последнего пройденного уровня.<br />
<br />
=='''Дополнительные параметры'''==<br />
* '''графика атома''' - ресурс, используемый для отрисовки игрового атома<br />
** '''''номер''''' - Номер атома в файле уровня.<br />
** '''''клип''''' - Клип атома.<br />
** '''''подсветка''''' - Клип подсветки атома.<br />
** '''''эффект удаления''''' - эффект удаления.<br />
<br />
* '''графика линии''' - графика соединения между атомами<br />
** '''''клип''''' - клип линии. Пивот должен быть в левой/центральной точке.<br />
** '''''подсветка''''' - клип подсветки линии.<br />
<br />
* '''изменить состояние объекта - победа''' - обработчик победы<br />
** '''''объект''''' - объект, состояние которого меняем.<br />
** '''''состояние''''' - новое состояние для объекта из предыдущего поля.<br />
<br />
* '''изменить состояние объекта - поражение''' - обработчик поражения<br />
** '''''объект''''' - объект, состояние которого меняем.<br />
** '''''состояние''''' - новое состояние для объекта из предыдущего поля.<br />
<br />
* '''изменить состояние объекта - ход''' - изменить состояние объекта - ход<br />
** '''''объект''''' - объект, состояние которого меняем.<br />
** '''''состояние''''' - новое состояние для объекта из предыдущего поля.<br />
<br />
<br />
<br />
== '''Замечание''' ==<br />
<br />
'''Обязательно нужно указать параметр ('''turns''') это количество шагов,если для победы вам нужно больше шагов чем написано в параметре, то вы не когда не выиграете. '''<br />
<br />
<br />
<br />
=='''Файл уровней'''==<br />
<br />
<?xml version="1.0" encoding="UTF-8"?><br />
<levels><br />
<level id="0" w="6" h="6" exit_x="5" exit_y="2" turns="20" time="120" final_shift="40" final_vx="5"><br />
<field val="0,0,3,0,0,-3,<br />
0,0,-2,0,0,0,<br />
1,0,0,-2,-2,0,<br />
2,0,0,0,0,0,<br />
-2,0,0,0,0,0,<br />
0,2,0,3,0,0"/><br />
<wall x1="0" y1="0" x2="1" y2="0" /><br />
<answer val="0,3,1,3,0,4,0,3,1,5,0,5,3,5,2,5,5,0,5,3,2,0,3,0,2,1,2,0,3,2,3,3,4,2,4,3,0,2,4,2"/> <br />
</level><br />
</levels><br />
<br />
=='''Пример'''==<br />
S:\!MOBILE\!!!EditorGames\Wiki_sample<br />
<br />
atom.zip</div>Achethttps://wiki.appsalutecreator.com/index.php?title=Statesmanager&diff=9705Statesmanager2018-09-17T14:47:38Z<p>Achet: /* Состояния */</p>
<hr />
<div>[[Object|Объект]] предназначен для постановки объектов в очередь выполнения единообразными командами. Можно применять для управления отображением всплывающих окон.<br />
<br />
=Свойства=<br />
<br />
==Процесс==<br />
*'''объект открытия''' (obj) - объект который будет переведён в заданное состояние, если данный объект будет первым в очереди на открытие и передадим менеджеру окон состояние ''next''; <br />
*'''состояние открытия''' (st) - перевести выбранный объект в заданное состояние;<br />
*'''объект back''' (obj_b) - объект который будет переведён в заданное состояние, если данный объект будет первым в очереди на закрытие и передадим менеджеру окон состояние ''back''; <br />
*'''состояние back''' (st_b) - перевести выбранный объект в заданное состояние.<br />
<br />
==Визуализация окон==<br />
*'''fading_t''' - Время фейдинга для окон типа ''по альфе''. Statesmanager'у должен приходить таймер!!!<br />
<br />
<br />
=Дополнительные параметры=<br />
[[Файл:+.png]] '''изменить состояние объекта - очередь back пуста:'''<br />
:'''объект''' ('' obj '') - Перевести объект в состояние из следующего поля;<br />
:'''состояние''' ('' st '') - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''изменить состояние объекта - очередь next пуста:'''<br />
:'''объект''' ('' obj '') - Перевести объект в состояние из следующего поля;<br />
:'''состояние''' ('' st '') - Новое состояние для объекта из предыдущего поля.<br />
<br />
<br />
=Параметры которые мы можем считать из statesmanager=<br />
*'''n_back''' - количество событий в очереди на закрытие (не учитывая события добавленные как попапы);<br />
*'''n_next''' - количество событий в очереди на открытие (не учитывая события добавленные как попапы).<br />
*'''n_popup''' - количество событий открытых как попапы.<br />
<br />
<br />
=Состояния=<br />
*'''add_first''' - добавить событие в начало очереди на открытие;<br />
*'''add_first_uni''' - добавить событие в начало очереди на открытие, но если данное событие уже добавлено в очередь, то повторно оно не добавиться (удобно если окно не должно открываться дважды);<br />
*'''add_last''' - добавить событие в конец очереди на открытие;<br />
*'''add_last_uni''' - добавить событие в конец очереди на закрытие, но если данное событие уже добавлено в очередь, то повторно оно не добавиться;<br />
*'''add_popup''' - добавить в очередь попапов событие, и сразу его открыть (добавляется в очередь беков на закрытие в начало). Примечание попапы добавляются в свою очередь на закрытие и открытие, параметры объекта statesmanagera (n_back и n_next) не повышаются при добавления попапа. <br />
*'''add_popup_uni''' - добавить попап с проверкой уникальности;<br />
*'''next''' - активировать первое событие в очереди на открытие;<br />
*'''back''' - активировать back для текущего события в очереди на закрытие;<br />
*'''clear''' - очищает стек очереди, очищает обе очереди (на открытие и на закрытие, включая попапы);<br />
*'''clear_back''' - очищает стек очереди на закрытие ( чистит очередь окон на закрытие, очередь попапов не трогает);<br />
*'''delete''' - удалить из очереди элемент с id из param;<br />
*'''log''' - записывает в лог, три очереди ( очередь next и две очереди беков (попапы и окна)):<br />
*'''add_state_last''' - добавить в очередь состояний вызываемых при закрытых окнах <br />
*'''double_back''' - активировать back текущего и следующего событий в очереди на закрытие;<br />
*'''triple_back''' - активировать back текущего и двух следующих событий в очереди на закрытие;<br />
<br />
==================================================<br />
NEXT QUEUE<br />
id = 15, st = open<br />
id = 18, st = open<br />
id = 21, st = open<br />
id = 72, st = open<br />
id = 68, st = open<br />
id = 80, st = open<br />
id = 80, st = open<br />
id = 76, st = open<br />
03/10/14 11:53:17.485: <br />
==================================================<br />
POPUP QUEUE<br />
03/10/14 11:53:17.485: <br />
==================================================<br />
BACK QUEUE<br />
id = 11, st = open<br />
<br />
<br />
==Альтернативное описание состояний, взятое прямиком из кода==<br />
"idle", //!< Состояние простоя<br />
"add_first", //!< Добавить событие в начало очереди<br />
"add_last", //!< Добавить событие в конец очереди<br />
"add_first_uni", //!< Добавить событие в начало очереди<br />
"add_last_uni", //!< Добавить событие в конец очереди<br />
"next", //!< Активировать первое событие в очереди<br />
"back", //!< Активировать back для текущего события в очереди<br />
"clear", //!< Очистить обе очереди<br />
"add_popup", //!< Начать ветку попапов от текущего элемента очереди. Срабатывает<br />
//!< сразу, до зачиски всех попапов next не делает ничего, back сначала <br />
//!< закрывает попапы<br />
"delete", //!< Удалить из очереди элемент с id из param;<br />
"log" //!< Вывести содержимое всех трех очередей в лог<br />
"double_back", //!< двойной back (и отличная песня ZZ Top, к тому же)<br />
"triple_back" //!< тройной back<br />
<br />
=Схема работы=<br />
<br />
1) Добавить объекты по одному в очередь<br />
<br />
2) вызывать состояния next или back - объекты у которых вызваны состояния убираются из очереди<br />
очередь разбирается с конца<br />
<br />
<br />
=Пример реализации=<br />
<br />
==Очередь из окон==<br />
Задача: У нас открывается окно 1, после его закрытия открывается окно 2,окно 3 и т.д. (после закрытия одного окна открывается другое).<br />
<br />
Пример: Закончили уровень, и после закрытия окна с результатами, мы должны показать два окошка с новыми задачами.<br />
<br />
<br />
'''Реализация:'''<br />
<br />
*'''1) Открываем окно с результатами:'''<br />
:Из машины окна, вызываем состояние ''next'' машине обработчику менеджера окон (9win_root). Предварительно записываем состояния для закрытия и открытия данного окна машины (состояния ''close'' и ''open'' соответственно):<br />
<br />
::[[Файл:Statesmanager W next.png]]<br />
<br />
:В машине обработчике менеджера окон (9win_root), в состоянии ''next'' мы задаём менеджеру окон и передаём состояние ''add_first'', а затем ''next''. То есть мы добавляем первым в очередь на открытие наше окно с результатами и его открываем:<br />
<br />
::[[Файл:Statesmanager Next.png]]<br />
<br />
<br />
*'''2) Добавляем в очередь окно с задачей:'''<br />
:Из машины окна, вызываем состояние ''add'' машине обработчику менеджера окон (9win_root). Предварительно записываем состояния для закрытия и открытия данного окна машины (состояния ''close'' и ''open'' соответственно):<br />
<br />
::[[Файл:Statesmanager W add.png]]<br />
<br />
:В машине обработчике менеджера окон (9win_root), в состоянии ''add'' мы задаём менеджеру окон и передаём состояние ''add_last''( то есть мы добавляем окно в конец очереди на открытие).<br />
:[[Файл:Statesmanager.Add.png]]<br />
<br />
<br />
*'''3) Аналогично добавляем другие задачи.'''<br />
<br />
<br />
*'''4) Для закрытия окна с результатами уровня, мы передаём менеджеру окон состояние ''back'' (закрываем окно, первое в списке на закрытие), а затем состояние ''next'' (открываем первое окно в очереди на открытие, в нашем случае - первую добавленную задачу) '''.<br />
<br />
<br />
[[Category:Main objects]]</div>Achethttps://wiki.appsalutecreator.com/index.php?title=Progress&diff=9587Progress2018-06-18T13:17:17Z<p>Achet: /* Основные параметры */</p>
<hr />
<div>{{TOC right}}<br />
== Общие сведения ==<br />
[[Object|объект]] '''Progress''' используют для отображения каких либо ачивментов, например когда игрок проходить уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую.<br />
<br />
== Основные параметры ==<br />
[[Файл:Progress_properties.png|250px|right]]<br />
*'''тип''' - тип прогрессбара: 0 - анимационный, 1 - линейный, 2 - дугообразный;<br />
* '''имя''' - объекта в дереве проекта. Может быть произвольным<br />
* '''синхронизация''' - синхронизация между лейаутами: нет - нет синхронизации; да - есть синхронизация.<br />
* '''положение'''<br />
** '''x''' - положение объекта по оси х<br />
** '''y''' - положение объекта по оси y<br />
* '''размер'''<br />
** '''w''' - ширина объекта в пикслях<br />
** '''h''' - высота объекта в пикселях<br />
* '''модификаторы'''<br />
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)<br />
** '''blending''' - Alpha смешивание: parent=0, blend=1, half=2, add=3, sub=4, none=5<br />
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.<br />
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.<br />
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.<br />
* '''память''' - если 1 - не обновляет свои параметры при последующем открытии экрана, 0 - обновляет<br />
* '''z''' - параметр порядка рисования объекта. Сначала рисуются объекты с большим z, а под ними с меньшим<br />
* '''тайлинг''' - если да - включить тайлинг<br />
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше<br />
<br />
*'''игра''' ''(game)'' - Имя игры (раздела в опциях), который надо вычитать для получения начального значения прогресса (например, для отображения результатов).<br />
<br />
*'''уровень''' ''(level)'' - Имя уровня (параметра в разделе игра - см.выше), который надо вычитать для получения начального значения прогресса (например, для отображения результатов). Для каждого прогресса разделы равны: [game.]level0, [game.]level1,...<br />
<br />
*'''сохранять в профиль''' ''(prof)'' - Если = 1, то значение будет сохранено в текущий профиль, если 0 - то глобально.<br />
<br />
*'''тип изменения''' ''(chType)'' - Тип изменения (увеличение (0), уменьшение (1)).Если параметр меняется то прогрессу нужно передать состояние ('''init''') !<br />
<br />
*'''изменение''' ''(chVal)'' - Изменение значения прогреса при вызове состояния next<br />
<br />
*'''значение''' ''(val)'' - Текущее значение прогрессбара<br />
<br />
*'''мин.зн''' ''(minVal)'' - Минимальное значение прогрессбара<br />
<br />
*'''макс.зн''' ''(maxVal)'' - Максимальное значение прогрессбара<br />
<br />
*'''нахлест заполнителя''' ''(cov)'' - Нахлест текстур заполнителя в пикселях<br />
<br />
*'''скорость''' ''(vel)'' - Скорость анимации изменения прогреса в точках за секунду<br />
<br />
'''Группа - позиционирование'''<br />
<br />
*'''горизонтальное''' - 0 - нет выравнивания; 1 - прижать к левому краю; 2 - центр; 3 - к правому<br />
<br />
*'''вертикальное''' - 0 - нет выравнивания; 1 - прижать к верхнему краю; 2 - центр; 3 - к нижнему<br />
<br />
'''Группа - ресурсы'''<br />
<br />
*'''нач.граница''' ''(resBBord)'' - Ресурс, который рисуется в начальной точке прогрессбара<br />
<br />
*'''заполнитель''' ''(resTail)'' - Ресурс, который будет тайлиться в зависимости от заполнения прогресса<br />
<br />
*'''указатель''' ''(resCurr)'' - Ресурс, который рисуется в текущей точке прогрессбара<br />
<br />
*'''объект указатель''' ''(objCurr)'' - Объект, который рисуется в текущей точке прогрессбара<br />
<br />
'''Группа - анимационный'''<br />
<br />
*'''res''' ''(res)'' — в качестве графического ресурса используется анимация с нужным на количеством кадров. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования)<br />
<br />
*'''количество''' ''(num)'' — количество прогресс баров<br />
<br />
*'''dx''' ''(dx)'' — расстояние между прогресс барами по X, если их больше 1<br />
<br />
*'''dy''' ''(dy)'' — расстояние между прогресс барами по Y, если их больше 1<br />
<br />
*'''вертикальный''' ''(ver)'' – если 1, то прогресс бар будет размножен вертикально, 0 - горизонтально<br />
<br />
'''Группа - дугообразный'''<br />
<br />
*'''нач.угол''' ''(angBeg)'' - Угол, с которого рисуем дугу<br />
<br />
*'''угол дуги''' ''(angCurv)'' - Угол в котором дуга завершается<br />
<br />
*'''направление''' ''(angDir)'' - Направление угла дуги. 0-по часовой стрелке, 1-против часовой стрелки<br />
<br />
==Добавляемые параметры==<br />
Меню выбора ''Добавляемые параметры'' к объектам активируется по нажатию правой кнопки мыши.<br />
<br />
[[Файл:+.png]] '''диапазон''' - Диапазон при котором меняется заполнитель.<br />
<br />
*'''нач.зн''' - Начальное значение прогрессбара <br />
<br />
*'''кон.зн''' - Конечное значение прогрессбара<br />
<br />
*'''заполнитель''' - Ресурс, который будет тайлиться когда прогрессбар принимает значение из диапазона<br />
<br />
*'''нач объект''' - При входе в диапазон перевести объект в состояние из следующего поля<br />
<br />
*'''нач состояние''' - Новое состояние для объекта из предыдущего поля<br />
<br />
*'''нач объект''' - При выходе из диапазона перевести объект в состояние из следующего поля<br />
<br />
*'''нач состояние''' - Новое состояние для объекта из предыдущего поля <br />
<br />
[[Файл:+.png]] '''Изменилось значение: изменить параметры объекта''' - после изменения значения прогресбара изменить параметр объекта.<br />
<br />
*'''объект''' - объект, состояние которого меняем <br />
<br />
*'''свойство''' - параметр, который мы изменяем<br />
<br />
*'''значение''' - новое значение параметра<br />
<br />
[[Файл:+.png]] '''Изменилось значение: изменить состояние объекта''' - после изменения значения прогресбара перевести объект в новое состояние.<br />
<br />
*'''объект''' - объект, состояние которого меняем<br />
<br />
*'''состояние''' - новое состояние для объекта из предыдущего поля<br />
<br />
[[Файл:+.png]] '''Завершен прогрес: изменить параметры объекта''' - после завершения прогреса изменить параметр объекта.<br />
<br />
*'''объект''' - объект, состояние которого меняем<br />
<br />
*'''свойство''' - параметр, который мы изменяем<br />
<br />
*'''значение''' - новое значение параметра<br />
<br />
[[Файл:+.png]] '''Завершен прогрес: изменить состояние объекта''' - после завершения прогресса перевести объект в новое состояние.<br />
<br />
*'''объект''' - объект, состояние которого меняем<br />
<br />
*'''состояние''' - новое состояние для объекта из предыдущего поля<br />
<br />
= Использование объекта =<br />
<br />
Для отображения нужного кадра анимации прогресс бар вычитывает данные из [[Options]] в зависимости от значения 0,1,2.... показывает определенный фрейм анимации<br><br />
Чтение значений из опций осуществляется с помощью полей '''''игра''''' и '''''уровень'''''<br><br />
Эти параметры можно менять с помощью машин, тогда прогресс будет вычитывать разные значения.<br><br />
<br />
Ниже приведена запись из опций с которых прогресс вычитает значения:<br />
<br />
<pk1><br />
<pz01 lv0="2" lv1="1"/><br />
</pk1><br />
<br />
У нас есть два значения lv0="2" и lv1="1"<br />
<br />
Напоминаем, что у нас есть такое поле как '''количество''' и мы может одним progress`ом вычитать эти два значения и отобразить если поставим кол-во = 2.<br><br />
Для этого в поле игра мы пишем "pk1.pz01", а в уровень пишем просто "lv". Запись в опциях lv0 и lv1 означает что это значения для прогресс бара с кол-ом = 2 и в первую свою копию он считает значение lv0 во вторую lv1 и отобразит две к примеру звезды и каждую со своим фреймом.<br><br />
pk01, pz01, lv0, lv1 и т.д. это просто ключи по которым прогресс вычитывает нужные значение, по-этому они могут быть произвольными.<br><br />
<br />
'''Одно только правило:''' Если у нас указано кол-во. То в опции параметр уровень мы должны записывать с числовой приставкой (например lv0,lv1,lv2) и т.д. Если у нас кол = 1, то прогресс будет вычитывать значение из lv0.<br />
<br />
При работе с '''дуговым''' прогрессом важно знать:<br />
<br />
Радиус дуги = высота прогресса / 2 . Центр окружности в точке пересечений диагоналей объекта прогресс.<br />
<br />
= Передаваемые состояния =<br />
<br />
:'''next''' - добавит к текущему значению ''chVal''(''изменение'') и визуально c скоростью "vel" (''скорость'') сменит своё состояние ("при увеличении" - станет более заполненным);<br />
<br />
= Пример=<br />
Пример использования объекта, типа Progress в хидденах:<br />
<br />
[[Файл:Progress1_1.jpg|700px]] [[Файл:Progress2_1.jpg|205px]]<br />
<br />
В данном примере используется 2 объекта типа Progress, тип которых - линейный: 1 - combo_progress для отображения комбо прогресса в очковой системе хидденлиста,<br /> 2 - cnt_prgss для отображения количества найденных объектов. <br />
<br />
Параметры объектов типа Progress следующие:<br />
<br />
[[Файл:Progress3_1.jpg|250px]] [[Файл:Progress4_1.jpg|250px]]<br />
<br />
[[Category:Main objects]]</div>Achethttps://wiki.appsalutecreator.com/index.php?title=Machine&diff=9522Machine2018-05-08T15:05:45Z<p>Achet: /* dragRot */</p>
<hr />
<div>{{TOC right}}<br />
[[Machine]] - [[Object|объект]] '''машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.<br />
<br />
== Введение ==<br />
<br />
Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё<br />
<br />
Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):<br />
<center><br />
[[Файл:def_states.png]]<br />
</center><br />
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.<br />
<br />
Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.<br />
<br />
Все команды состояния, разбиваются на три группы:<br />
* '''[[#Инициализация|Инициализация]]''':<br />
** '''[[#draw|draw]]''' - установка графического ресурса;<br />
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);<br />
** '''[[#set|set]]''' - установка состояния другого объекта;<br />
** '''[[#play|play]]''' - проиграть звук;<br />
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;<br />
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки;<br />
** '''[[#download|download]]''' - запуск процедуры закачки контента.<br />
* '''[[#Процессы|Процессы]]''':<br />
** '''[[#wait|wait]]''' - задержка по времени;<br />
** '''[[#move|move]]''' - равномерное движение;<br />
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;<br />
** '''[[#alpha|alpha]]''' - изменение прозрачности;<br />
** '''[[#scale|scale]]''' - изменение размера;<br />
** '''[[#phys|phys]]''' - ускоренное движение;<br />
** '''[[#rgb|rgb]]''' - изменить rgb-каналы;<br />
** '''[[#spline|spline]]''' - движение по сплайну (по кривой).<br />
* '''[[#Воздействия|Воздействия]]''':<br />
** '''[[#click|click]]''' - что делать при клике на машине;<br />
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;<br />
** '''[[#drag|drag]]''' - машину схватили и тащат;<br />
** '''[[#throw|throw]]''' - машину схватили и кинули;<br />
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;<br />
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;<br />
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;<br />
** '''[[#touch_up|touch_up]]''' - отжатие мыши от машины;<br />
** '''[[#tap|tap]]''' - умный тач;<br />
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;<br />
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.<br />
<br />
Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу. Для разных команд использование этого параметра несколько '''отличается'''!<br />
<br />
Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],<br />
начиная с [[Checkbox как машина состояний|третьего]].<br />
<br />
== Свойства ==<br />
<br />
Общие для всех объектов свойства описаны в документе [[Object|Object]].<br />
Дополнительные свойства:<br />
<br />
* '''в опции''' - да - машина будет сохранять свое состояние в опции и при следующей инициализации инициал-ся не в первом состоянии, а в состоянии, записанном в опциях.<br />
* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.<br />
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.<br />
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).<br />
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.<br />
* '''отладка''' - Отображать в окне состояний текущий объект.<br />
* '''курсор''' - Графический ресурс курсора текущего и всех дочерних объектов.<br />
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.<br />
<br />
== Инициализация ==<br />
<br />
При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.<br />
<br />
'''''Замечание.''''' По возможности, нужно избегать передачи значений другим объектам, в начальном состоянии машины, так как такие команды будут выполнятся даже тогда, когда машина будет выключена на визуальной сцене.<br />
<br />
=== draw ===<br />
<br />
Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:<br />
<br />
* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);<br />
* '''f''' - начальный кадр;<br />
* '''ft''' - длительность кадра в миллисекундах;<br />
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран один раз;<br />
* '''rev''' - играть анимацию в обратном порядке; 0 - прямой порядок проигрывания, 1 - обратный порядок проигрывания;<br />
* '''go''' - перейти в состояние;<br />
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать логические операторы (см. [[#if|if]]);<br />
* '''break''' - прервать команды.<br />
<br />
Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.<br />
<br />
Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).<br />
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).<br />
<br>Если есть анимация открывающейся и закрывающейся книги (коробки, двери и т.д.) не обязательно подгружать в проект две анимации, можно использовать одну, но запускать ее в обратном порядке, для этого есть параметр '''rev'''.<br />
<br />
=== init ===<br />
<br />
====Параметры объекта====<br />
<br />
* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;<br />
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;<br />
* '''al''' - Прозрачность: от 0 (прозрачен) до 1 (не прозрачен);<br />
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);<br />
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима), если vis = 0, это равноценно отключению объекта в редакторе;<br />
* '''z координата''' - координата машины по z.<br />
* '''z приращение''' - приращение координаты машины по z относительно текущего<br />
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше;<br />
<br />
====Параметры движения====<br />
<br />
* '''v''' - скорость для команды move<br />
* '''vr''' - угловая скорость для команды rot<br />
* '''vx''','''vy''' - начальная скорость для команды phys<br />
* '''ax''','''ay''' - ускорение для команды phys<br />
<br />
====Системные действия====<br />
<br />
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга.<br />
Если на девайсе была нажата кнопка "отрейтинговать", то в опции запишется параметр rating значение 1, если нажата кнопка "позже" - rating 2, "никогда" - rating 3.<br />
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто.<br />
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут.<br />
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран.<br />
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние.<br />
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.<br />
* '''id внешней ссылки в текстовой базе''' - Ссыслка будет взята из текстовой базы в соответствии с текущим маркетом.<br />
* '''[[#Clone|clone]]''' - Значение 1 означает, что в текущем местоположении машины будет создана ее копия<br />
<br />
====Переходы и параметры выполнения====<br />
<br />
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия выполнения; можно использовать логические операторы (см. [[#if|if]]);<br />
* '''break''' - прервать команды.<br />
<br />
Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений<br />
<br />
=== set ===<br />
<br />
Перевод другого объекта в некоторое состояние или изменение его параметров.<br />
<br />
* '''obj''' - изменяемый объект (выбирается из списка объектов). В значении объекта можно указать this, это значит что машина сама себе пропишет какой то параметр или состояние.<br />
* '''scr_param''' - глобальный либо текущий экран, параметры которого меняем.<br />
* '''scr_state''' - экран, состояние которого меняем.<br />
* '''parent''' - Объект, который будет установлен в качестве родителя объекту из obj. Объект obj будет оторван от текущего своего родителя и добавлен в детей объекта parent. При этом у obj сбивается значение Z. Если оно должно быть отличным от нуля, то нужно установить заново после смены родителя.<br><br />
* '''st''' - состояние в которое переводится объект.<br><br />
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr,val_vid,val_res,val_node.<br />
* '''mSt''' - Состояние машины в котором будем изменять параметр команды.<br />
* '''mCmd''' - Имя команды, параметр которой меняем.<br />
* '''mCmdN''' - Порядковый номер в перечне одноименных команд состояния.<br />
* '''mPar''' - Установить этот параметр команды в значение val.<br />
* '''val_obj''' - id объекта, будет записано в в par<br />
* '''val_txt''' - id текста, будет записано в в par(параметр для текстов "txtID")<br />
* '''val_vid''' - id video, будет записано в par(параметр для видео "video" - RGB, "videoA" - Alpha)<br />
* '''val_scr''' - id экрана, будет записано в в par<br />
* '''val_res''' - Новое значение графического ресурса (перетаскивается из редактора ресурсов). (пока не работает)<br />
* '''val_node''' - Новое нода графа (выбирается из списка, при заданном объекте)<br />
* '''val''' - значение параметра объекта для установки<br />
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj<br />
* '''round''' - округлить значение, записываемое в val<br><br />
* '''position''' - объект указанный в поле '''obj''' будет отпозиционирован относительно указанного объекта в этом поле ( можно одновременно и задавать состояние '''st''' в которое перевести объект ( поле obj ) ); <br />
* '''pos_dx''' - смещение по оси X от точки пивоты объекта из поля выше ( если это поле не указывать, смещение будет = 0 );<br />
* '''pos_dy''' - смещение по оси Y от точки пивоты объекта из поля выше ( если это поле не указывать, смещение будет = 0 )<br />
* '''scr''' - экран на который мы хотим перейти<br />
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется<br><br />
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set. <br />
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).<br />
<br />
Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.<br />
<br />
=== play ===<br />
<br />
Проиграть звук<br />
<br />
*'''snd''' - Короткий звук (перетаскивается из редактора ресурсов);<br />
*'''voice''' - Голос (перетаскивается из редактора ресурсов);<br />
*'''mus''' - Длинный звук (перетаскивается из редактора ресурсов);<br />
*'''mus_field''' - Проиграть длинную музыку, id взяв из переменной машины, указанной в этом поле; (К примеру у машины есть параметр location_music=="7695" и в mus_field="location_music". То машина проиграет длинную музыку с id 7695)<br />
*'''preload''' - Указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;<br />
*'''loop''' - Зациклить указанный звук. Использовать вместе с snd или voice;<br />
*'''mus_loop''' - Зациклить указанную музыку. По умолчанию музыка всегда зацикленна. То есть, фактически этой флаг используется, когда нужно убрать зацикливание.<br />
*'''repeat''' - Число повторов указанного звука при отключенном loop;<br />
*'''mus_stop''' - Остановить музыку. Если используется вместе с mus, то остановится указанная. Если нет - то вся текущая.<br />
*'''stop''' - Остановить указанный звук. Использовать вместе с snd или voice.<br />
*'''mus_fading''' - Время появления/затухания указанной музыки в ms. Использовать вместе с mus.<br />
*'''fading''' - Время появления/затухания указанного звука. Использовать вместе с snd или voice. <br />
*'''volume''' - Установить громкость для всех звуков данной машины - тех что уже играют и тех, что будут запущены впоследствии;<br />
*'''не выгружать''' - Позволяет продолжать проигрывание звука при смене экранов.<br />
*'''go''' - Выбор состояния, в которое нужно перейти после проигрывания музыки/звука/голоса.<br />
*'''if''' - Номер (начиная с нуля) условия перехода [[#if|if]].<br />
<br />
Особенности применения:<br />
<br />
1) Короткий звук (''snd'') нельзя запустить в первом (инитном) состоянии машины. Для того, чтобы запустить звук сразу при загрузке экрана, нужно в первом состоянии машины записать мгновенный переход во второе состояние мамашины (например, команда ''wait'', поле ''go'', в поле выбрать второе состояние), а во втором состоянии уже запустить звук.<br />
<br />
2) Если звук нужно зациклить и проигрывать какое-то количество раз (''loop=1,2,3,..,n'') или бесконечно (''loop=-1''), то нужно проследить чтобы состояние, в котором запускается звук, не вызывалось повторно во время проигрывания звука, иначе возникнет наложение звуков.<br />
<br />
3) Если во время проигрывания звука машина меняет свое состояние, звук продолжает играть.<br />
<br />
4) Если в одной машине почти одновременно воспроизводится несколько звуков, то они прерывают друг друга.<br />
<br />
5) Если каждый звук воспроизводится в отдельной машине, то они звучат параллельно.<br />
<br />
6) Если не указан звук и голос, то команда (''stop'') остановит все звуки, запущенные этой машиной.<br />
<br />
7) Музыка (''mus'') может быть формата .ogg или .mp3. На экране может воспроизводится только одна .mp3 музыка. Любой запуск .mp3 музыки независимо от того, в какой машине он осуществляется, будет прекращать проигрывание предыдущей .mp3 музыки. В тоже время может воспроизводиться несколько .ogg музыки.<br />
<br />
8) Музыка, которая проигрывается на глобальном экране, проигрывается на всех экранах проекта.<br />
<br />
=== var ===<br />
<br />
Переменная, которой присваивается значение параметра объекта<br />
<br />
*'''name''' - имя переменной;<br />
*'''tp''' - тип переменной;<br />
*'''obj''' - объект, используемый далее;<br />
*'''par''' - имя параметра, значение которого присваивается переменной;<br />
*'''val''' - значение переменной, если отсутствуют obj и par;<br />
*'''user''' - если стоит "1", то будет считываться с текущего профиля в опциях<br />
*'''func''' - в выпадающем списке можно выбрать функцию:<br />
**'''random''' - использует arg1 и arg2, возвращает случайное целое число в диапазоне arg1 .. arg2.<br />
**'''conc''' - объединяет 4 строки arg1,arg2,arg3,arg4. Возвращает строку, в которой соединены все строки<br />
**'''exp''' - экспонента от аргумента arg1.<br />
**'''ln''' - натуральный логарифм аргумента arg1.<br />
*'''arg1''' - аргумент функции<br />
*'''arg2''' - аргумент функции<br />
*'''arg3''' - аргумент функции<br />
*'''arg4''' - аргумент функции<br />
<br />
Обозначенная переменная существует (может использоваться) только в текущем состоянии. Переменная может определятся в одном состоянии только один раз. Если созданной переменной нужно изменить значение в рамках состояния, это можно сделать через другую переменную или через параметр опций ([[Options]]). Если ее значение нужно использовать в другом состоянии, то оно присваивается параметру опций, а затем заново считывается в новом состоянии. Переменные можно указывать в поле ''val'' с другими математическими действиями и цифрами, при этом каждое действие заключать в скобки. Если в поле ''val'' указать имя переменной ''А'' без скобок - воспримется строка ''А'', если указать в скобках - воспримется значение переменной.<br />
<br />
=== buy === <br />
<br />
'''(in-app совершить in-app покупку)'''<br />
<br />
При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).<br />
<br />
* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];<br />
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;<br />
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;<br />
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;<br />
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.<br />
<br />
=== download ===<br />
<br />
'''(скачать загружаемый контент)'''<br />
<br />
При переходе в состояние будет совершена попытку закачать контент.<br />
* '''url''' - ссылка на zip архив с контентом в интернете.<br />
* '''объект успех''' - объект, которому в случае успешной закачки будет задаваться указанное состояние.<br />
* '''состояние (успех)''' - состояние, которое будет устанавливаться выше указанному объекту, в случае успешной закачки.<br />
* '''объект (провал)''' -объект, которому, в случае неудачи закачки, будет устанавливаться указанное состояние.<br />
* '''состояние (провал)''' - состояние, которое, в случае неудачи закачки,будет устанавливаться выше указанному объекту.<br />
* '''счетчик прогресса''' - объект, типа счетчик, который отображает прогресс закачки контента. Крайне желательно, что бы он измерялся в диапазоне от 0 до 100.<br />
<br />
Существует несколько причин при которых вызывается состояние "провал". Для того что бы сообщить пользователю, по какой именно причине возник провал закачки, следует идентифицировать причины провала. Это возможно сделать с помощью параметра <br />
<pre><br />
downloadErrCode<br />
</pre><br />
Ниже приведены значение параметра которые помогут вывести нужное текстовое сообщение :<br />
<pre><br />
GCUSTOM_ERROR_CODE_ERROR_UNKNOWN = 1, //!< ошибка не классифицирована<br />
GCUSTOM_ERROR_CODE_WIFI_DISABLED = 2, //!< отключен WIFI<br />
GCUSTOM_ERROR_CODE_SDCARD_UNAVAILABLE = 3, //!< SD-карта недоступна<br />
GCUSTOM_ERROR_CODE_SDCARD_FULL = 4, //!< SD-карта переполнена перед закачкой<br />
GCUSTOM_ERROR_CODE_UNZIP_FAIL = 5 //!< ошибка при распаковки пака (скорее всего на SD-карте не<br />
хватает места для распаковки <br />
</pre><br />
<br />
== Процессы ==<br />
<br />
Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.<br />
<br />
Если в команде процесса есть условие '''[[#if|if]]''', то после окончания работы команды она ждет пока это условие не выполнится. Только после этого переходит к следующей команде этого же типа<br />
или в другое состояние (если есть параметр go).<br />
Исключением является команда wait, которая '''не''' ждёт срабатывания '''[[#if|if]]'''. Если он по окончанию wait сработал, то происходит переходит в другое состояние, если есть параметр go.<br />
Если параметра go нет, то в любом случае запускается следующий wait (т.е. if относится только к переходу go).<br />
<br />
=== wait ===<br />
<br />
Команда паузы (временной задержки). Если параметра '''t''' нет, то срабатывает сразу.<br />
Может также использоваться для логических ветвлений, случайных переходов в другие состояния и т.д.<br />
<br />
* '''t''' - длительность выполнения команды в ms;<br />
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);<br />
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;<br />
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;<br />
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;<br />
* '''loop''' - зациклить команды;<br />
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).<br />
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.<br />
Простейший набор параметров команды wait выглядит следующим образом:<br />
<pre><br />
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние<br />
</pre><br />
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):<br />
<pre><br />
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1<br />
<wait go="st2"/> // иначе, перейдем в st2<br />
</pre><br />
Этот же синтаксис позволяет делать состояния с различным временем жизни:<br />
<pre><br />
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms<br />
<wait t="100" go="next"/> // или 200ms<br />
</pre><br />
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:<br />
<pre><br />
<wait t="1000" dt="200" go="next"/><br />
</pre><br />
<br />
=== move ===<br />
<br />
Перемещение по сцене:<br />
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект. Можно указывать переменные заданные с помощью [http://ge.absolutist.com/index.php/Machine#var_2 переменной var];<br />
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;<br />
* '''v''' - скорость перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;<br />
* '''t''' - время перемещения (v игнорируется);<br />
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;<br />
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится; <br />
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;<br />
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).<br />
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.<br />
<br />
В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.<br />
<br />
Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за секунду (а не миллисекунду!)<br />
<br />
=== rot ===<br />
<br />
Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.<br />
* '''ta''' - целевой угол поворота объекта;<br />
* '''da''' - на сколько надо повернуться (ta игнорируется);<br />
* '''v''' - угловая скорость поворота в градусах в секунду;<br />
* '''t''' - время поворота (v игнорируется);<br />
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.<br />
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду rot, пока if не выполнится; <br />
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;<br />
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).<br />
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.<br />
<br />
Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.<br />
<br />
=== alpha ===<br />
<br />
Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)<br />
* '''ta''' - целевая прозрачность<br />
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)<br />
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)<br />
* '''t''' - время изменения (v игнорируется)<br />
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.<br />
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду alpha, пока if не выполнится; <br />
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.<br />
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).<br />
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.<br />
<br />
Если у объекта прозрачность ''al=0.00'', то он невидим для всякого взаимодействия. Если у объекта прозрачность ''al=0.01'', то он видим для клика, но невидим для дропа(команда drop на объект не видит объект с прозрачностью ''0.01''). Если у объекта ''al=0.02'', то он видим и для клика, и для дропа.<br />
<br />
=== scale ===<br />
<br />
Изменение размеров объекта<br />
* '''tx''', '''ty''' - целевой масштаб по каждой оси<br />
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси<br />
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)<br />
* '''t''' - длительность выполнения команды (v игнорируется)<br />
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.<br />
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду scale, пока if не выполнится; <br />
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.<br />
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).<br />
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.<br />
<br />
=== phys ===<br />
<br />
Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).<br />
<br />
* '''vx''', '''vy''' - начальная скорость<br />
* '''ax''', '''ay''' - величина ускорения по каждой оси<br />
* '''a''' - полное ускорение<br />
* '''tvx''', '''tvy''' - целевая скорость<br />
* '''tx''', '''ty''' - целевая координата<br />
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.<br />
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится; <br />
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.<br />
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов). <br />
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.<br />
<br />
Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координате y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.<br />
<pre><br />
<br />
<st id="down"> // падаем<br />
<phys vy="0" ay="20" ty="0" go="touch"/><br />
</st><br />
<br />
<st id="touch"> // касаемся земли<br />
<move dy="24" t="300"/> // опускаем центр при сжатии<br />
<scale ty="0.8" t="300"/> // сжимаемся<br />
<move dy="-24" t="300"/> // поднимаем центр при разжатии<br />
<scale ty="1" t="300" go="up"/> // разжимаемся<br />
</st><br />
<br />
<st id="up"> // взлетаем<br />
<phys vy="0" ty="-200" go="down"/><br />
</st><br />
<br />
</pre><br />
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.<br />
<br />
=== rgb ===<br />
<br />
* '''trgb''' - целевой эффект rgb; подразумевает под собой цвет в виде HEX-кода; по-умолчанию: FFFFFF;<br />
* '''t''' - длительность выполнения команды в ms;<br />
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;<br />
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;<br />
* '''loop''' - зациклить команды;<br />
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).<br />
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.<br />
<br />
=== spline ===<br />
<br />
Сплайн позволяет перемещать машину по заранее заданной траектории.<br />
<br />
====Параметры====<br />
<br />
*'''key''' - точки сплайна по которым движется <br />
*'''t''' - время движения по траектории<br />
*'''go''' - по окончанию переход в состояние<br />
*'''if''' - условие перехода<br />
*'''loop''' - количество повторений<br />
*'''break''' - прервать команды на этой<br />
*'''wait''' - номер запускаемого действия<br />
*'''init''' - номер запускаемого действия<br />
*'''alpha''' - номер запускаемого действия<br />
*'''rot''' - номер запускаемого действия<br />
*'''move''' - номер запускаемого действия<br />
*'''set''' - номер запускаемого действия<br />
*'''phys''' - номер запускаемого действия<br />
*'''scale''' - номер запускаемого действия<br />
*'''drow''' - номер запускаемого действия<br />
<br />
====Построение сплайна====<br />
<br />
# в состоянии машины добавляем правой кнопкой мыши действие "spline"<br />
# добавляем минимально необходимые параметры: '''key''' и '''t''', указываем время движения в '''t'''<br />
# выделяем для редактирования поле '''key'''<br />
# записываем координаты точек через запятую, сначала x потом y, например: -211,-248,-151,-248,-91,-247,59,-246,60,101,60,159,1,190<br />
Если записали все координаты вручную, то можно сохранить и проверять.<br />
Или можно в окне списка состояний нажать на кнопку "build spline" (справа вверху).<br />
[[Файл:Btn spline.jpg|500px]]<br />
<br />
Окно с списком состояний закроется, появится дополнительная панель с настройками сплайна и появится возможность указывать мышкой по экрану точки для сплайна.<br />
<br />
[[Файл:Spline panel.jpg|500px]]<br />
<br />
Точки сплайна указываются кликом левой кнопки мыши по экрану.<br />
<br />
Возможности редактирования:<br />
<br />
'''режимы:'''<br />
*'''add''' - по нажатию левой кнопкой мыши по экрану - будет добавлена новая точка, которая соединится с предыдущей<br />
*'''select''' - по нажатию левой кнопкой мыши по точке сплайна появится возможность отредактировать её положение перетащив её или поменяв её координаты в полях x и у<br />
*'''delete''' - по нажатию левой кнопкой мыши по точке сплайна точка удалится<br />
<br />
Чтобы удалить все точки сплайна необходимо нажать на кнопку "'''delete all knots'''"<br />
<br />
Сохранить сплайн можно нажав на кнопку "'''Save spline'''"<br />
<br />
====Дополнительные сведения====<br />
<br />
* Время движения между двумя соседними точками всегда одинаково, то есть чем дальше друг от друга соседние точки, тем быстрее будет двигаться объект, чем ближе - тем медленней.<br />
* Координаты сплайна просчитываются относительно точки пивота родительского объекта, если соответствующая машина является подобъектом. На координаты могут влиять модификаторы родительского объекта.<br />
<br />
== Воздействия ==<br />
<br />
=== click ===<br />
<br />
Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.<br />
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);<br />
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.<br />
<br />
По клику машина записывает координаты клика в параметры: clickX, clickY.<br />
<br />
=== touch_in ===<br />
<br />
Наведение мыши/пальца на машину, если палец "тащат" по экрану.<br />
* '''go''' - состояние в которое при выполнении команды нужно перейти (если if нет, то в любом случае);<br />
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход ''go''.<br />
<br />
=== touch_out ===<br />
Выведение мыши/пальца из машины, если палец "тащат" по экрану.<br />
* '''go''' - состояние в которое при клике нужно перейти;<br />
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход ''go''.<br />
<br />
=== touch_up ===<br />
<br />
Отжатие мыши от машины<br />
<br />
* '''go''' - состояние в которое при отжатии мыши нужно перейти;<br />
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход ''go''.<br />
<br />
=== mouse_in ===<br />
<br />
Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)<br />
* '''go''' - состояние в которое при выполнении команды нужно перейти (если if нет, то в любом случае);<br />
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход ''go''.<br />
<br />
=== mouse_out ===<br />
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)<br />
* '''go''' - состояние в которое при выполнении команды нужно перейти (если if нет, то в любом случае);<br />
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход ''go''.<br />
<br />
=== drag ===<br />
<br />
Данная команда позволяет "таскать" объект по сцене нажав и удерживая клавишу мишки или (палец в случае сенсорного устройства) на нем.Так же есть возможность ограничить разрешенную область таскания, за пределы которой объект вытащить невозможно. [[Файл:drag.jpg|right]]<br />
* '''x1''' - разрешено таскать, когда координата объекта правее;<br />
* '''x2''' - разрешено таскать, когда координата объекта левее;<br />
* '''y1''' - разрешено таскать, когда координата объекта ниже;<br />
* '''y2''' - разрешено таскать, когда координата объекта выше;<br />
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;<br />
* '''obj''' - объект у которого надо изменить состояние;<br />
* '''st''' - новое состояние объекта obj;<br />
* '''за пивот''' - "да" - таскать объект за пивот, "нет" - за ту точку, за которую схватили<br />
* '''приклеивать''' - приклеивать при клике к мышке.<br />
<br />
=== dragRot ===<br />
<br />
Данная команда позволяет вращать объект вокруг точки пивота. Нажав и удерживая клавишу мишки или палец (в случае сенсорного устройства) на нем, мы можем вращать его по часовой либо против часовой стрелки. При многократном вращении вокруг своей оси значение его угла не накапливается, а обнуляется выходя за границы [360 ; -360] градусов. [[Файл:dragRot.jpg|right]]<br />
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;<br />
* '''obj''' - объект у которого надо изменить состояние;<br />
* '''st''' - новое состояние объекта obj;<br />
* '''maxVel''' - Максимальная скорость вращения градус/сек;<br />
* '''objStart''' - объект при начале вращения;<br />
* '''stStart''' - его новое состояние;<br />
* '''objEnd''' - объект при завершении вращения;<br />
* '''stEnd''' - его новое состояние; <br />
'''''Замечание.''''' ('''dragRot''') и обычный ('''drag''') не работает если сцена таскаемая.<br />
<br />
=== drop ===<br />
<br />
Если нажатая кнопка мышки отпускается, вызывается эта команда. Обычно она используется в связке с командой drag<br />
* '''obj''' - объект, на который надо уронить таскаемый объект;<br />
* '''go''' - состояние в которое переходим при отпускании мышки;<br />
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.<br />
<br />
Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:<br />
<pre><br />
<br />
<st id="drag"><br />
<drag x1="-350" x2="350" y1="-250" y2="250"/><br />
<drop obj="box" go="open"/><br />
</st><br />
<br />
<st id="open"><br />
<set obj="box" st="open"/><br />
<scale tx="0.01" ty="0.01" t="500" go="hide"/><br />
</st><br />
<br />
<st id="hide"><br />
<init x="268" y="30"/><br />
<scale tx="1" ty="1" t="500" go="drag"/><br />
</st><br />
<br />
<br />
</pre><br />
Ящик:<br />
<pre><br />
<br />
<st id="close"> // начальное состояние ящика<br />
<init al="1"/> // если его кто-то сюда переведет - он появится.<br />
</st><br />
<br />
<st id="open"> <br />
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms<br />
</st><br />
<br />
</pre><br />
<br />
====Использование свойства "Условие перехода" ====<br />
<br />
Можно прописать условие, при котором выполняется переход при дропе.<br />
[[Файл:Drop_if.png|300px|thumb|right]]<br />
<br />
С помощью этого условия мы можем научить наш объект выполнять разные задачи в зависимости от того, как именно его дропнули.<br />
Пусть есть объект который можно таскать. Когда объект не таскается должен быть включен флаер, привязанный к этому объекту. При клике на объект, он должен поворачиваться на 90 градусов. При дропе на соответствующую маску объект стает на свое место(Если выполнены условия, к примеру: установлен предыдущий объект и наш объект имеет правильный угол). Если дроп в любое другое место, то должен включится флаер.<br />
<br />
Для того, чтобы научить машину различать клик по ней и ее таскание сделаем следующее. Пропишем ей 2 состояния: click и drag, а также выставим ей параметр "хранить нажатость" = 1. В click будем вычислять координаты объекта и записывать объекту параметр допустимого смещения при котором таскание будет восприниматься как клик. (В данном примере эти параметры: cx, cy, vx, vy. А допустимое смещение составляет 10 пикселей.)<br />
<br />
В состоянии drag будем проверять попадает ли координата объекта при дропе в границы допустимого смещения. Для того чтобы сравнить параметр объекта с переменной, вычтем из нашего объекта, то что мы записали в click. В зависимости от условий и места дропа переходим в соответствующее состояние.<br />
<br />
[[Файл:Click.png|330px]] [[Файл:Drag st.png|630px]]<br />
<br />
=== throw ===<br />
<br />
Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:<br />
* '''go''' - состояние, в которое, при клике, надо перейти;<br />
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;<br />
* '''force''' - получаемая скорость равна разнице пикселей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.<br />
<br />
Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).<br />
<br />
=== tap ===<br />
<br />
* '''go''' - Состояние в которое нужно перейти после окончания времени.<br />
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.<br />
<br />
=== apply ===<br />
<br />
Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.<br />
* '''obj''' - сработает , если пересеклись с этим объектом;<br />
* '''x1''' - сработает, если центр объекта левее этого x-са;<br />
* '''x2''' - сработает, если центр объекта правее этого x-са;<br />
* '''y1''' - сработает, если центр объекта выше этого y-ка;<br />
* '''y2''' - сработает, если центр объекта ниже этого y-ка;<br />
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)<br />
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)<br />
* '''st''' - состояние, в которое надо перевести объект obj<br />
* '''go''' - состояние, в которое надо перейти при срабатывании;<br />
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.<br />
<br />
[[Файл:Апплай.png|500px]]<br />
<br />
Блок схема работы '''apply'''<br />
<br />
[[Файл:Блок схема apply.png|500px]]<br />
<br />
* Сначала у нас проверяется координаты '''x1''', '''x2''', '''y1''', '''y2'''.<br />
* Далее проверяет если '''obj'''<br />
* Если '''obj''' нет, то идёт проверку, и выдаёт результат<br />
(если при этом если '''x1''', '''x2''', '''y1''', '''y2''' нет, то они считаются по ширине и высоте всего экрана.)<br />
* Если есть '''obj''', то проверяет есть ли радиусы '''rm''', '''ro'''.<br />
* Если он есть, то значит у нас '''apply''' по кругам<br />
* Если нет, то проверяем наличие '''x1''', '''x2''', '''y1''', '''y2'''.<br />
* Если они есть, то проверка и результат.<br />
* Если их нет, то проверка идёт по шейпам объектов, и выдаётся результат/<br />
Если не будет стоять ни каких галочек, то проверка будет идти по шейпам объектов.<br />
<br />
<br />
Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":<br />
<pre><br />
<br />
<st id="trow"><br />
<init x="-350" y="150"/> // начальное положение<br />
<throw go="fly"/> // бросаем<br />
</st><br />
<br />
<st id="fly"><br />
<phys ay="100"/> // летим<br />
<apply y2="300" go="throw"/> // с землей<br />
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой<br />
</st><br />
<br />
</pre><br />
<br />
== Условия ==<br />
<br />
=== if ===<br />
<br />
В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются<br />
в параметре if других команд. Эти номера можно соединять при помощи логических связок:<br />
* '''&''' - логическое '''и''' (вместо значка '''&''' можно использовать запятую ''',''');<br />
* '''|''' - логическое '''или''';<br />
* '''!''' - логическое '''не'''.<br />
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',<br />
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.<br />
<br />
'''!!!Важно:''' нужно использовать полную скобочную структуру : "((1&2)&3)" - правильно, "1,2,3" - не правильно ( не гарантируется 100% адекватная работа).<br />
<br />
Логические связки используются также как математической логике или любом языке программирования. <br />
Так:<br />
* A '''&''' B - истинно, если истинны оба условия A и B;<br />
* A '''|''' B - истинно, если истинно хотя бы одно условие (или оба);<br />
* '''!''' А - истинно, если условие A ложно.<br />
Скобки в логическом выражении определяют приоритет (порядок) выполнения логических операций.<br />
Отметим несколько тождеств, справедливых при формировании логических высказываний:<br />
* !(A & B) = (!A) | (!B)<br />
* !(A | B) = (!A) & (!B)<br />
* !(!A) = A<br />
<br />
Если при формировании условия (ниже) есть несколько проверок, то они соединены логическим '''и'''.<br />
Т.е., если хотя бы одна из них не выполняется, то считается, что условие не выполнилось.<br />
<br />
Параметры команды:<br />
* '''obj''' - находится ли объект obj в состоянии st или имеет ли его параметр par значение val. В этом поле можно указать this, это значит что if будет проводить проверку текущего объекта. Добавлено это вместе с параметром clone. Клоны рождаются и умирают в рамках одного экрана. Для различия клонов между собой машина имеет уникальный параметр "clone_num" у оригинала = -1, у клонов от 0 до N, собственно с помощью this машина может сама себя проверить клон ли она и если да то какой у нее номер;<br />
* '''st''' - имя состояния в котором может находиться объект obj;<br />
* '''par''' - имя параметра объекта obj, значение которого сравнивается с полем val;<br />
* '''val''' - значение параметра par, которое проверяется у объекта obj;<br />
* '''val_txt''' - Значение текстового параметра объекта для проверки условия;<br />
* '''val_res''' - Значение ресурсного параметра объекта для проверки условия;<br />
* '''val_obj''' - Значение id объекта для проверки условия;<br />
* '''op''' - операция сравнения par op val. Если операции нет, то предполагается проверка на равенство par=val. Иначе используются операторы:<br />
** '''<''' - меньше (par < val);<br />
** '''>''' - больше (par > val);<br />
** '''!=''' - не равно (par != val);<br />
** '''<>''' - не равно (par <> val);<br />
** '''>=''' - больше или равно (par >= val);<br />
** '''<=''' - меньше или равно (par <= val);<br />
* '''curScr''' - если текущий экран совпадает с этим, то условие выполнилось;<br />
* '''prScr''' - если предыдущий экран совпадает с этим, то условие выполнилось;<br />
* '''wasScr''' - если был (когда либо) этот экран, то условие выполнилось.<br />
* '''buy''' - был ли куплен данный inn-app (проверяется флаг поля в объекте [[Options]]);<br />
* '''url''' - валиден (правилен и может быть запущен) ли данный интернет-адрес; на ios ссылка должна выглядеть так comabsolutisttwilighttown://, т.е. в конце ссылки добавляем ://<br />
* '''is_mus''' - играет ли сейчас музыка (значение 1);<br />
* '''guest''' - объект который установил состояние (используется вместо параметра obj). Если указанный объект не менял состояние этой машины, то условие не срабатывает.<br />
<br />
Если использовать obj, par, val, то будет происходить проверка на равенство значения параметра объекта и значения записанного в поле val.<br />
Если же использовать obj, par, op, val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записанного в поле val.<br />
<br />
Для проверки текущего значения прозрачности у объекта можно воспользоваться параметром ''cur_al''<br />
<br />
У машины (другой или самой себя) можно проверить текущее состояние '''st''' и предыдущее состояние '''prev_st''', эти параметры живут на время сессии.<br />
<br />
== Математика ==<br />
<br />
=== Основные математические операции ===<br />
Математика в appsalute creator представлена 6-ю основными операциями: (плюс), (минус), (умножить), (поделить), (целочисленное деление), (остаток от деления) <br><br />
Организована благодаря совместному использованию '''[[#var|var]]''' и '''[[#set|set]]'''. <br />
[[Файл:Example_mod.png|300px|right|Пример использования операции остатка от деления]]<br />
''(плюс)'' '''+'''<br><br />
''(минус)'' '''-'''<br><br />
''(умножить)'' '''*'''<br><br />
''(поделить)'' '''/'''<br><br />
''(целочисленное деление)'' '''\'''<br><br />
''(остаток от деления)'' '''%'''<br><br />
<br><br />
Примеры использования последних двух операций:<br><br />
5\2=2<br><br />
5%2=1<br><br />
<br />
=== var ===<br />
Благодаря использованию '''[[#var|var]]''' существует возможность cчитать любой числовой параметр любого объекта. Например: x - координату какой-то машины, текущее значение любого объекта counter или timer и конечно же считывание значения любого параметра из опций! Каким образом это устроено? Рассмотрим подробнее '''[[#var|var]]''': <br><br />
[[Файл:VAR.png|right]]<br />
*'''name''' - здесь выбираем имя для нашей будущей переменной, которой будем оперировать далее<br />
*'''obj''' - выбирается объект, параметры которого мы хотим считать<br />
*'''par''' - параметр, который нужно вычитать из объекта, указанного выше<br />
*'''val''' - указывается числовое значение, которое будет установлено по умолчанию в случае отсутствия obj и par<br />
*'''user''' - если стоит "1", то будет считываться с текущего профиля в опциях<br />
На изображении справа можно наблюдать каким образом организован '''[[#var|var]]'''. В данном случае объявлена переменная x_cor, которая считывает x-координату объекта actor_1, при этом считывание переменной происходит из текущего профиля, так, как в поле user установлено значение равное "1".<br />
<br />
=== set ===<br />
[[Файл:SET.png|right]]<br />
Использование '''[[#var|var]]''' без '''[[#set|set]]''' не имеет смысла. Так, как переменная создается, но не используется дальше. Рассмотрим следующий пример, где вычитаем x - координату из одного объекта и сохраним ее в опции, предварительно увеличив ее на 50 единиц (в данном случае 50 пикселей).<br />
На рисунке справа можно наблюдать, каким образом это сделано. В состоянии '''init''' объявляется переменная '''x_cor''', которая считывает координату '''x''' из объекта '''actor_1''', таким образом в переменную '''x_cor''' запишется положение по '''x''' объекта '''actor_1'''. Поле '''user''' в данном случае в '''1''' не обязательно устанавливать, так как работа ведется с машинами, а не с опциями. Если бы на месте '''actor_1''' оказался объект '''options''', то это было бы просто необходимо, иначе программа считает значение не из профиля. Далее в '''[[#set|set]]''' выбран объект '''options''', в параметр '''x_position''' которого будет сохранятся значение переменной '''x_cor''' увеличенной на 50. В поле '''round''' идет округление вычисляемого значения, если оно установлено в 1. Поле '''user ''' установлено в 1, это значит, что параметр '''x_position''' будет сохранен в профиль. После это выполняется сохранение опций путем задания объекту '''options''' состояния '''save'''.<br><br />
! ! !ВАЖНО: чтобы выполнить какие-то действия с '''[[#var|var]]''' его обязательно нужно указывать в поле '''val''' в '''set''', при этом, если он используется, то все выражение должно стоять в скобках. Если в поле '''val''' не используется переменная, то скобки необязательны.<br />
<br><br />
<br><br />
Существует также возможность использовать '''[[#var|var]]''' совместно с '''[[#if|if]]''', а также '''[[#var|var]]''' с '''[[#move|move]]'''<br />
<br><br />
Так же добавилась возможность записывать значение переменной в состояние "st", что значительно уменьшает<br />
необходимость в записи 1000 if-ов. При этом, тип переменной в '''[[#var|var]]''' должен быть "строка".<br />
И добавилась возможность записи переменной boolean: ((a)==(b)). true = 1, false = 0. Довольно полезная вещь,<br />
если не хотите забивать "память" ненужной математикой.<br />
<br />
=== var и if ===<br />
[[Файл:IF.png|right]]<br />
При подробном рассмотрении '''[[#if|if]]''' можно заметить, что в нем есть поле '''val''', соответственно в этом поле можно указать переменную. Таким образом в поле '''val''' необязательно указывать константу, а можно указать какую-то переменную, которая может постоянно изменяться. Например, существует два объекта, один находится состоянии покоя, а другой находится в движении. При этом первый объект (тот, который в состоянии покоя) постоянно опрашивает положение второго объекта, и в случае, если у объекта, который движется, '''х''' координата равна '''х''' координате первого объекта, то первый объект входит в состояние, где он начинает свое движение. На рисунке показан объект, который находится в состоянии покоя, рассмотрим его состояния:<br><br />
В данном объекте существует два состояния: '''init''' и '''move'''. В '''init''' объект опрашивает другой объект и в случае, когда условие срабатывает, то переходит в состояние '''move''', где начинает свое движение.<br />
В '''init''' создаем переменную, в которую записываем положение по '''x''' объекта '''actor_2''', в '''if''' проверяется условие на соответствие координат объектов '''actor_1''' и '''actor_2''', в данном случае координата объекта '''actor_2''' представлена в виде переменной '''x_cor'''. Если условие выполняется, то происходит переход в состояние '''move''', если нет, то заново проходим состояние '''init''' и повторяем вышеописанную последовательность действий.<br />
<br><br />
<br><br />
<br><br />
<br><br />
<br />
=== var и move ===<br />
Также с помощью '''[[#var|var]]''' есть возможность указать целевые координаты в '''[[#move|move]]'''. То есть, не обязательно указывать целевые координаты в виде констант, их можно указать теперь с помощью переменных. При использовании '''[[#var|var]]''' и '''[[#move|move]]''' можно организовать обмен двух объектов местами с анимацией движения. Для этого необходимо определять какой объект нажат первым, а какой вторым, сохранять их координаты через объект '''options''' и только потом менять их местами. На рисунке можно увидеть, как это организовано.<br />
[[Файл:var_move.png|1000px|thumb|center|]]<br />
Рассмотрим подробнее состояние данной машины:<br />
<br><br />
* '''init'''<br><br />
В этом состоянии ожидаем клик на объект и обнуляем параметр, который отвечает за то, какой по счету объект сейчас нажат. Так, как при обмене объектов, если мы делаем это по клику, важно знать, по какому кликнули первым, а по какому вторым.<br />
* '''check'''<br><br />
Проверяется параметр '''number''', если он равен '''0''', то это значит, что еще ничего не кликали и мы переходим в состояние, где в опции записываются координаты этого объекта, который считается нажатым первым. Если не равен '''0''', то считается, что этот объект нажат вторым и переходит в состояние, где в опции записываются координаты этого объекта, который считается нажатым вторым по счету.<br />
* '''first_object'''<br><br />
В этом состоянии записываются координаты объекта в опции. Чтобы записать координаты в опции используются '''[[#var|var]]''' и '''[[#set|set]]''' упоминаемые выше. В опции координаты первого нажатого объекта сохраняются под параметрами '''x_first''' и '''y_first'''. В конце параметру '''number''' присваиваем значение '''1''', чтобы указать, что следующий нажатый объект будет вторым по счету. <br />
* '''second_object'''<br><br />
В этом состоянии объект будет в том случае, если он будет нажатым вторым по счету, то есть после состояния '''check''' объект попадет в это состояние, где он запишет свои текущие координаты под параметрами '''x_second''' и '''y_second'''. Запись координат происходит таким же самым образом, что и в состоянии '''first_object'''. После этого он автоматически переходит в следующее состояние.<br />
* '''move_first'''<br><br />
В этом состоянии объект будет в том случае, если он был нажат первым, поэтому он будет двигаться на место второго нажатого объекта, который сохранил свои координаты в параметры'''x_second''' и '''y_second'''. Движение происходит следующим образом: сперва в переменную вычитываем координаты второго объекта, а потом в '''move''' вместо целевых координат записываем переменные, которые обязательно должны быть взяты в скобки.<br />
* '''move_second'''<br><br />
В этом состоянии объект будет в том случае, если он был нажат вторым, поэтому он будет двигаться на место первого нажатого объекта, который сохранил свои координаты в параметры '''x_first''' и '''y_first'''. Движение происходит следующим образом: сперва в переменную вычитываем координаты первого объекта, а потом в '''move''' вместо целевых координат записываем переменные, которые обязательно должны быть взяты в скобки.<br />
<br />
В результате проделанных манипуляций с машинами по кликам на две машины, они обменяются местами с анимацией движения. Это может быть очень полезным во многих мини играх!!!<br />
<br />
=== Важно знать ===<br />
* Переменная действует в рамках одного состояния, если нужно, чтобы она была глобальной, нужно сохранить ее в опции и потом в нужный момент считывать ее из опций.<br />
* Если складываем два числа, то в поле '''val''' они должны быть записаны в скобках: (5+3).<br />
* Если возникает необходимость написать какое-то более сложное арифметическое вычисление, то следует помнить, что на одно действие приходятся одни скобки. Например: (((5+3)\2)*2).<br />
* Количество открывающих и закрывающих скобок должно быть одинаковым.<br />
* В скобках можно писать переменную, если она была объявлена выше: (5+a).<br />
* Переменная может состоять из цифр и букв и знака нижнего подчеркивания.<br />
* Иногда бывает необходимым использование '''round''' в '''set''', так например, если какой-то параметр получен с помощью арифметических вычислений и потом используется его в каком-то условии, и условие проверяет параметр, как целочисленное значение, то могут возникнуть ошибки. Так, как число будет записано в следующем виде 123.0000 и программа будет считать, что оно не целочисленное, а дробное. И чтобы избавится от лишних нулей в дробной части следует округлять число.<br />
* Действия, которые требуют времени, такие как move, rot, wait и другие перестают работать для уменьшения вычислительной нагрузки на устройство.<br />
* Действия, которые не требуют времени, такие как set, init и другие продолжают функционировать.<br />
<br />
<br />
<pre><br />
Если с помощью переменной менять объекту любой параметр, например, координату X, то она<br />
запомнится (запишется как значение по умолчанию).<br />
Тогда при повторном попадании на экран считается не тот X, который указан в свойствах,<br />
а тот, который установлен через переменную.<br />
Если нужно при ините экрана возвращать начальные значения параметров,<br />
то можно сделать это двумя способами:<br />
- не использовать переменную;<br />
- создать отдельное состояние, которое будет "вручную" устанавливать начальные значения<br />
параметрам при ините экрана.<br />
Если координата (или другой параметр) меняется другим способом, то будут автоматически<br />
при ините экрана подтягиваться значения из свойств объекта.<br />
</pre><br />
<br />
=== Примеры применений ===<br />
С помощью математики можно организовать следующее:<br />
* динамические опции (изменение звука и музыки с помощью ползунка);<br />
* анимацию каунтера в играх (по окончанию уровня можно наблюдать, как изменяются очки);<br />
* подсчет очков (гибкая система подсчета очков);<br />
* обмен объектов местами (использование var и move)<br />
* увеличение z-координаты любого объекта (когда необходимо, чтобы нажатый или таскаемый объект был выше других по z);<br />
* простейший калькулятор;<br />
* и много других.<br />
<br />
== Копирование машины состояния с сохранением ссылки на себя ==<br />
Довольно часто бывает, что машина состояний ссылается только на глобальные объекты и на саму себя. При этом, если мы просто скопируем объект, он будет ссылаться на свою предыдущую копию. Этого можно избежать, сделав 3 шага:<br />
1. Переместить объект в отдельную сцену<br />
2. Скопировать данную сцену(имеется в виду обычное копирование, без ссылки)<br />
3. Перенести объект и его копию обратно, в нужную сцену<br />
4. Созданные сцены можно удалить :)<br />
<br />
== Guest ==<br />
<br />
'''Guest (гость)''' - объект, который перевел машину в текущее состояние. Пример: кнопка ''btn1'' по клику переводит машину ''mch1'' в состояние ''st1'', в этом состоянии у машины ''mch1'' гостем является кнопка ''btn1''. Гостем может быть объект любого типа, если он может менять состояние другому объекту (например: хидден-объект по нахождению может менять состояние объекту, кнопка, машина, пэчворк и т.д.)<br />
<br />
В машине состояний можно считывать (проверять) и передавать параметры и состояния гостя. Любое поле ''obj'' в выпадающем списке содержит строку ''guest'', что позволяет работать с гостем, как с любым другим объектом.<br />
<br />
=== Пример использования ===<br />
<br />
[[Файл:Guest1.jpg|left]]<br />
Пускай экран содержит 3 кнопки (''btn1'', ''btn2'' и ''btn3'') и одну машину ''mch1''. Нужно сделать так, чтобы по клику на любую из кнопок машина перемещалась в ее координаты и переводила кнопку в состояние ''disable''. Так же по клику на кнопку ''btn2'', машина должна перейти в состояние ''bonus''.<br><br />
Всем трем кнопкам по клику пропишем передавать объекту ''mch1'' состояние ''check''.<br><br><br />
Создадим в машине три состояния: ''init'' - состояние в котором машина будет находиться по умолчанию, ''check'' - состояние, которое будет вызываться тремя кнопками, в этом состоянии у машины ''mch1'' одна из трех кнопок будет гостем, ''bonus'' - последнее состояние.<br><br />
Две команды ''var'' считывают у гостя координаты, т.к. мы не знаем, какая именно кнопка перевела машину ''mch1'' в состояние ''check'', то обращаемся к гостю, а не к кнопкам. За ними следует две команды ''set'', которые передают координаты гостя машине. Еще один ''set'' переводит гостя в состояние ''disable''. И через ''wait'' осуществляется переход в состояние ''bonus'', если гость ''btn2''.<br />
<br />
<pre><br />
При смене состояния гость сохраняется, т.е. в состоянии bonus гостем останется btn2.<br />
</pre><br />
<pre><br />
Если машина изначально сама себе меняет состояния, то у нее нет гостя.<br />
</pre><br />
<br />
[[Файл:Guest2.jpg]]<br />
<br />
== Массив (Array) ==<br />
<br />
В данном объекте реализован массив, имеющий максимальную длину в 20 элементов.<br />
<br />
=== Свойства объекта массив: ===<br />
<br />
len - длинна массива. Длинна массива может как считываться, так и записываться. Влияет на количество сохраняемых объектов в Options.<br />
<br />
index1 - индекс элемента. (данный массив можно расширить до многомерного и использовать несколько индексов)<br />
<br />
val - значение элемента массива, с индексом index1<br />
<br />
a1..a20 - внутренние элементы массива(обращаться можно через свойство par объекта). Предполагается, что пользователь редактора к ним обращаться напрямую не будет, однако иногда для удобства полезны.<br />
<br />
=== Состояния объекта массив: ===<br />
<br />
get - при вызове этого состояния во внутреннюю переменную val записывается значение элемента с индексом index1<br />
<br />
set - при вызове этого состояния во внутреннюю переменную a1..a20, соответствующую индексу index1 записывается значение val<br />
<br />
load - загрузить значения массива из xml.<br />
<br />
save - сохранить элементы массива от 1 до len<br />
<br />
=== Как использовать? ===<br />
<br />
1. Загружаем массив, переводя объект array в состояние load<br />
<br />
2. Записываем значения массива<br />
<br />
а). Задаём значение свойству index1 объекта array (устанавливаем индекс ячейки, в которую будет заноситься число)<br />
б). Задаём значение свойству val объекта array (устанавливаем значение, которое будет заноситься в ячейку<br />
с индексом index1)<br />
в). Переводим объект array в состояние set<br />
<br />
3. Считываем значения массива<br />
а). Задаём значение свойству index1 объекта array (устанавливаем индекс ячейки, из которой будет считываться число)<br />
б). Переводим объект array в состояние get<br />
в). Считываем значение из свойства val объекта array<br />
<br />
4. Сохраняем массив, переводя объект array в состояние save. Если хотите изменить количество сохраняемых элементов - предварительно измените параметр len.<br />
<br />
=== Копирование объекта ===<br />
<br />
При копировании, необходимо заменить в состояниях load и save array.имя_параметра на другое имя. Например, array2.имя_параметра. Копировать следует через использование доп. сцены (см. выше)<br />
<br />
=== Достоинства ===<br />
<br />
Позволяет избежать необходимости каждый раз создавать большое количество if-ов и set-ов, если необходимо работать с нумерованным списком. Можно один раз создать структуру и копировать её неограниченное количество раз<br />
<br />
=== Недостатки ===<br />
<br />
Данный объект содержит довольно большое количество кода, поэтому при большом их обилии/длине может занизить скорость работы сцены и скорость загрузки сцены.<br />
<br />
=== Исходный XML код===<br />
Прим. id="369" - идентификатор объекта Options, сохраняющего все переменные приложения. id="7845" - идентификатор объекта<br />
<br />
<pre><br />
<obj id="7845" type="machine" nm="array" sync="1" w="1" h="1"><br />
<st id="init"/><br />
<st id="get"><br />
<var nm="a1" obj="7845" par="a1"/><br />
<var nm="a2" obj="7845" par="a2"/><br />
<var nm="a3" obj="7845" par="a3"/><br />
<var nm="a4" obj="7845" par="a4"/><br />
<var nm="a5" obj="7845" par="a5"/><br />
<var nm="a6" obj="7845" par="a6"/><br />
<var nm="a7" obj="7845" par="a7"/><br />
<var nm="a8" obj="7845" par="a8"/><br />
<var nm="a9" obj="7845" par="a9"/><br />
<var nm="a10" obj="7845" par="a10"/><br />
<var nm="a11" obj="7845" par="a11"/><br />
<var nm="a12" obj="7845" par="a12"/><br />
<var nm="a13" obj="7845" par="a13"/><br />
<var nm="a14" obj="7845" par="a14"/><br />
<var nm="a15" obj="7845" par="a15"/><br />
<var nm="a16" obj="7845" par="a16"/><br />
<var nm="a17" obj="7845" par="a17"/><br />
<var nm="a18" obj="7845" par="a18"/><br />
<var nm="a19" obj="7845" par="a19"/><br />
<var nm="a20" obj="7845" par="a20"/><br />
<set obj="7845" par="val" val="(a1)" round="1" if="0"/><br />
<set obj="7845" par="val" val="(a2)" round="1" if="1"/><br />
<set obj="7845" par="val" val="(a3)" round="1" if="2"/><br />
<set obj="7845" par="val" val="(a4)" round="1" if="3"/><br />
<set obj="7845" par="val" val="(a5)" round="1" if="4"/><br />
<set obj="7845" par="val" val="(a6)" round="1" if="5"/><br />
<set obj="7845" par="val" val="(a7)" round="1" if="6"/><br />
<set obj="7845" par="val" val="(a8)" round="1" if="7"/><br />
<set obj="7845" par="val" val="(a9)" round="1" if="8"/><br />
<set obj="7845" par="val" val="(a10)" round="1" if="9"/><br />
<set obj="7845" par="val" val="(a11)" round="1" if="10"/><br />
<set obj="7845" par="val" val="(a12)" round="1" if="11"/><br />
<set obj="7845" par="val" val="(a13)" round="1" if="12"/><br />
<set obj="7845" par="val" val="(a14)" round="1" if="13"/><br />
<set obj="7845" par="val" val="(a15)" round="1" if="14"/><br />
<set obj="7845" par="val" val="(a16)" round="1" if="15"/><br />
<set obj="7845" par="val" val="(a17)" round="1" if="16"/><br />
<set obj="7845" par="val" val="(a18)" round="1" if="17"/><br />
<set obj="7845" par="val" val="(a19)" round="1" if="18"/><br />
<set obj="7845" par="val" val="(a20)" round="1" if="19"/><br />
<if obj="7845" par="index1" val="1"/><br />
<if obj="7845" par="index1" val="2"/><br />
<if obj="7845" par="index1" val="3"/><br />
<if obj="7845" par="index1" val="4"/><br />
<if obj="7845" par="index1" val="5"/><br />
<if obj="7845" par="index1" val="6"/><br />
<if obj="7845" par="index1" val="7"/><br />
<if obj="7845" par="index1" val="8"/><br />
<if obj="7845" par="index1" val="9"/><br />
<if obj="7845" par="index1" val="10"/><br />
<if obj="7845" par="index1" val="11"/><br />
<if obj="7845" par="index1" val="12"/><br />
<if obj="7845" par="index1" val="13"/><br />
<if obj="7845" par="index1" val="14"/><br />
<if obj="7845" par="index1" val="15"/><br />
<if obj="7845" par="index1" val="16"/><br />
<if obj="7845" par="index1" val="17"/><br />
<if obj="7845" par="index1" val="18"/><br />
<if obj="7845" par="index1" val="19"/><br />
<if obj="7845" par="index1" val="20"/><br />
</st><br />
<st id="set"><br />
<var nm="val" obj="7845" par="val"/><br />
<set obj="7845" par="a1" val="(val)" round="1" if="0"/><br />
<set obj="7845" par="a2" val="(val)" round="1" if="1"/><br />
<set obj="7845" par="a3" val="(val)" round="1" if="2"/><br />
<set obj="7845" par="a4" val="(val)" round="1" if="3"/><br />
<set obj="7845" par="a5" val="(val)" round="1" if="4"/><br />
<set obj="7845" par="a6" val="(val)" round="1" if="5"/><br />
<set obj="7845" par="a7" val="(val)" round="1" if="6"/><br />
<set obj="7845" par="a8" val="(val)" round="1" if="7"/><br />
<set obj="7845" par="a9" val="(val)" round="1" if="8"/><br />
<set obj="7845" par="a10" val="(val)" round="1" if="9"/><br />
<set obj="7845" par="a11" val="(val)" round="1" if="10"/><br />
<set obj="7845" par="a12" val="(val)" round="1" if="11"/><br />
<set obj="7845" par="a13" val="(val)" round="1" if="12"/><br />
<set obj="7845" par="a14" val="(val)" round="1" if="13"/><br />
<set obj="7845" par="a15" val="(val)" round="1" if="14"/><br />
<set obj="7845" par="a16" val="(val)" round="1" if="15"/><br />
<set obj="7845" par="a17" val="(val)" round="1" if="16"/><br />
<set obj="7845" par="a18" val="(val)" round="1" if="17"/><br />
<set obj="7845" par="a19" val="(val)" round="1" if="18"/><br />
<set obj="7845" par="a20" val="(val)" round="1" if="19"/><br />
<if obj="7845" par="index1" val="1"/><br />
<if obj="7845" par="index1" val="2"/><br />
<if obj="7845" par="index1" val="3"/><br />
<if obj="7845" par="index1" val="4"/><br />
<if obj="7845" par="index1" val="5"/><br />
<if obj="7845" par="index1" val="6"/><br />
<if obj="7845" par="index1" val="7"/><br />
<if obj="7845" par="index1" val="8"/><br />
<if obj="7845" par="index1" val="9"/><br />
<if obj="7845" par="index1" val="10"/><br />
<if obj="7845" par="index1" val="11"/><br />
<if obj="7845" par="index1" val="12"/><br />
<if obj="7845" par="index1" val="13"/><br />
<if obj="7845" par="index1" val="14"/><br />
<if obj="7845" par="index1" val="15"/><br />
<if obj="7845" par="index1" val="16"/><br />
<if obj="7845" par="index1" val="17"/><br />
<if obj="7845" par="index1" val="18"/><br />
<if obj="7845" par="index1" val="19"/><br />
<if obj="7845" par="index1" val="20"/><br />
</st><br />
<st id="load"><br />
<var nm="a1" obj="369" par="array.a1" user="1"/><br />
<var nm="a2" obj="369" par="array.a2" user="1"/><br />
<var nm="a3" obj="369" par="array.a3" user="1"/><br />
<var nm="a4" obj="369" par="array.a4" user="1"/><br />
<var nm="a5" obj="369" par="array.a5" user="1"/><br />
<var nm="a6" obj="369" par="array.a6" user="1"/><br />
<var nm="a7" obj="369" par="array.a7" user="1"/><br />
<var nm="a8" obj="369" par="array.a8" user="1"/><br />
<var nm="a9" obj="369" par="array.a9" user="1"/><br />
<var nm="a10" obj="369" par="array.a10" user="1"/><br />
<var nm="a11" obj="369" par="array.a11" user="1"/><br />
<var nm="a12" obj="369" par="array.a12" user="1"/><br />
<var nm="a13" obj="369" par="array.a13" user="1"/><br />
<var nm="a14" obj="369" par="array.a14" user="1"/><br />
<var nm="a15" obj="369" par="array.a15" user="1"/><br />
<var nm="a16" obj="369" par="array.a16" user="1"/><br />
<var nm="a17" obj="369" par="array.a17" user="1"/><br />
<var nm="a18" obj="369" par="array.a18" user="1"/><br />
<var nm="a19" obj="369" par="array.a19" user="1"/><br />
<var nm="a20" obj="369" par="array.a20" user="1"/><br />
<set obj="7845" par="a1" val="(a1)" round="1" if="0"/><br />
<set obj="7845" par="a2" val="(a2)" round="1" if="1"/><br />
<set obj="7845" par="a3" val="(a3)" round="1" if="2"/><br />
<set obj="7845" par="a4" val="(a4)" round="1" if="3"/><br />
<set obj="7845" par="a5" val="(a5)" round="1" if="4"/><br />
<set obj="7845" par="a6" val="(a6)" round="1" if="5"/><br />
<set obj="7845" par="a7" val="(a7)" round="1" if="6"/><br />
<set obj="7845" par="a8" val="(a8)" round="1" if="7"/><br />
<set obj="7845" par="a9" val="(a9)" round="1" if="8"/><br />
<set obj="7845" par="a10" val="(a10)" round="1" if="9"/><br />
<set obj="7845" par="a11" val="(a11)" round="1" if="10"/><br />
<set obj="7845" par="a12" val="(a12)" round="1" if="11"/><br />
<set obj="7845" par="a13" val="(a13)" round="1" if="12"/><br />
<set obj="7845" par="a14" val="(a14)" round="1" if="13"/><br />
<set obj="7845" par="a15" val="(a15)" round="1" if="14"/><br />
<set obj="7845" par="a16" val="(a16)" round="1" if="15"/><br />
<set obj="7845" par="a17" val="(a17)" round="1" if="16"/><br />
<set obj="7845" par="a18" val="(a18)" round="1" if="17"/><br />
<set obj="7845" par="a19" val="(a19)" round="1" if="18"/><br />
<set obj="7845" par="a20" val="(a20)" round="1" if="19"/><br />
<if obj="7845" par="len" op="&gt;" val="0"/><br />
<if obj="7845" par="len" op="&gt;" val="1"/><br />
<if obj="7845" par="len" op="&gt;" val="2"/><br />
<if obj="7845" par="len" op="&gt;" val="3"/><br />
<if obj="7845" par="len" op="&gt;" val="4"/><br />
<if obj="7845" par="len" op="&gt;" val="5"/><br />
<if obj="7845" par="len" op="&gt;" val="6"/><br />
<if obj="7845" par="len" op="&gt;" val="7"/><br />
<if obj="7845" par="len" op="&gt;" val="8"/><br />
<if obj="7845" par="len" op="&gt;" val="9"/><br />
<if obj="7845" par="len" op="&gt;" val="10"/><br />
<if obj="7845" par="len" op="&gt;" val="11"/><br />
<if obj="7845" par="len" op="&gt;" val="12"/><br />
<if obj="7845" par="len" op="&gt;" val="13"/><br />
<if obj="7845" par="len" op="&gt;" val="14"/><br />
<if obj="7845" par="len" op="&gt;" val="15"/><br />
<if obj="7845" par="len" op="&gt;" val="16"/><br />
<if obj="7845" par="len" op="&gt;" val="17"/><br />
<if obj="7845" par="len" op="&gt;" val="18"/><br />
<if obj="7845" par="len" op="&gt;" val="19"/><br />
</st><br />
<st id="save"><br />
<var nm="len" obj="7845" par="len"/><br />
<var nm="a1" obj="7845" par="a1"/><br />
<var nm="a2" obj="7845" par="a2"/><br />
<var nm="a3" obj="7845" par="a3"/><br />
<var nm="a4" obj="7845" par="a4"/><br />
<var nm="a5" obj="7845" par="a5"/><br />
<var nm="a6" obj="7845" par="a6"/><br />
<var nm="a7" obj="7845" par="a7"/><br />
<var nm="a8" obj="7845" par="a8"/><br />
<var nm="a9" obj="7845" par="a9"/><br />
<var nm="a10" obj="7845" par="a10"/><br />
<var nm="a11" obj="7845" par="a11"/><br />
<var nm="a12" obj="7845" par="a12"/><br />
<var nm="a13" obj="7845" par="a13"/><br />
<var nm="a14" obj="7845" par="a14"/><br />
<var nm="a15" obj="7845" par="a15"/><br />
<var nm="a16" obj="7845" par="a16"/><br />
<var nm="a17" obj="7845" par="a17"/><br />
<var nm="a18" obj="7845" par="a18"/><br />
<var nm="a19" obj="7845" par="a19"/><br />
<var nm="a20" obj="7845" par="a20"/><br />
<set obj="369" par="array.a1" val="(a1)" round="1" user="1" if="0"/><br />
<set obj="369" par="array.a2" val="(a2)" round="1" user="1" if="1"/><br />
<set obj="369" par="array.a3" val="(a3)" round="1" user="1" if="2"/><br />
<set obj="369" par="array.a4" val="(a4)" round="1" user="1" if="3"/><br />
<set obj="369" par="array.a5" val="(a5)" round="1" user="1" if="4"/><br />
<set obj="369" par="array.a6" val="(a6)" round="1" user="1" if="5"/><br />
<set obj="369" par="array.a7" val="(a7)" round="1" user="1" if="6"/><br />
<set obj="369" par="array.a8" val="(a8)" round="1" user="1" if="7"/><br />
<set obj="369" par="array.a9" val="(a9)" round="1" user="1" if="8"/><br />
<set obj="369" par="array.a10" val="(a10)" round="1" user="1" if="9"/><br />
<set obj="369" par="array.a11" val="(a11)" round="1" user="1" if="10"/><br />
<set obj="369" par="array.a12" val="(a12)" round="1" user="1" if="11"/><br />
<set obj="369" par="array.a13" val="(a13)" round="1" user="1" if="12"/><br />
<set obj="369" par="array.a14" val="(a14)" round="1" user="1" if="13"/><br />
<set obj="369" par="array.a15" val="(a15)" round="1" user="1" if="14"/><br />
<set obj="369" par="array.a16" val="(a16)" round="1" user="1" if="15"/><br />
<set obj="369" par="array.a17" val="(a17)" round="1" user="1" if="16"/><br />
<set obj="369" par="array.a18" val="(a18)" round="1" user="1" if="17"/><br />
<set obj="369" par="array.a19" val="(a19)" round="1" user="1" if="18"/><br />
<set obj="369" par="array.a20" val="(a20)" round="1" user="1" if="19"/><br />
<set obj="369" par="array.len" val="(len)" round="1" user="1"/><br />
<if obj="7845" par="len" op="&gt;" val="0"/><br />
<if obj="7845" par="len" op="&gt;" val="1"/><br />
<if obj="7845" par="len" op="&gt;" val="2"/><br />
<if obj="7845" par="len" op="&gt;" val="3"/><br />
<if obj="7845" par="len" op="&gt;" val="4"/><br />
<if obj="7845" par="len" op="&gt;" val="5"/><br />
<if obj="7845" par="len" op="&gt;" val="6"/><br />
<if obj="7845" par="len" op="&gt;" val="7"/><br />
<if obj="7845" par="len" op="&gt;" val="8"/><br />
<if obj="7845" par="len" op="&gt;" val="9"/><br />
<if obj="7845" par="len" op="&gt;" val="10"/><br />
<if obj="7845" par="len" op="&gt;" val="11"/><br />
<if obj="7845" par="len" op="&gt;" val="12"/><br />
<if obj="7845" par="len" op="&gt;" val="13"/><br />
<if obj="7845" par="len" op="&gt;" val="14"/><br />
<if obj="7845" par="len" op="&gt;" val="15"/><br />
<if obj="7845" par="len" op="&gt;" val="16"/><br />
<if obj="7845" par="len" op="&gt;" val="17"/><br />
<if obj="7845" par="len" op="&gt;" val="18"/><br />
<if obj="7845" par="len" op="&gt;" val="19"/><br />
</st><br />
</obj><br />
</pre><br />
<br />
=== Машина состояний объекта ===<br />
[[Файл:array.jpg]]<br />
<br />
<br />
== Пример использования ==<br />
<br />
[http://fs5.absolutist.com/files/wikisample/machine.rar Download]<br />
<br />
== Clone ==<br />
Clone - параметр команды init в разделе "системные действия".<br />
<br />
[[Файл:Clone1.PNG]]<br />
<br />
<br />
Значение 1 означает, что в текущем местоположении машины будет создана ее копия.<br />
<br />
[[Файл:Clone2.PNG]]<br />
<br />
=== Свойства ===<br />
<br />
1) Клонированная машина состояний имеет все свойства, состояния и параметры исходного объекта клонирования.<br />
<br />
2) Клоны рождаются и умирают в рамках одного экрана.<br />
<br />
3) Клоны отличаются друг от друга лишь параметром '''clone_num''', который у оригинала равен "-1", а у клонов от 0 до N.<br />
<br />
4) Нежелательно применять клонирование к клону во избежание путаницы значений параметра '''clone_num'''.<br />
<br />
5) Если при проверке условия [[#if|if]] в поле '''obj''' указать this, это значит что if будет проводить проверку текущего объекта. Таким образом машина может сама себя проверить по параметру '''clone_num''' клон ли она и если да то какой у нее номер;<br />
<br />
=== Пример использования ===<br />
<br />
По ссылке пример использования с подробным описанием машин.<br />
<br />
[http://fs5.absolutist.com/files/wikisample/Clone.zip Download]<br />
<br />
== Параметр команды машины состояний ==<br />
<br />
В случае, когда необходимо изменить значение какого-либо параметра в командах машины состояний (например v в команде move) в процессе работы приложения, можно использовать блок "Параметр команды машины состояний" в команде ''set'' машины состояний. Приведу пример использования этого блока.<br />
<br />
Пусть есть 2 машины: управляющая и управляемая.<br />
<br />
[[Файл:Stm1.jpg|300px]][[Файл:Stm2.jpg|300px]]<br />
<br />
Управляемая машина практически пустая и не содержит каких либо данных о движении, но тем не менее при запуске она будет двигаться, меняя направление. Это движение - заслуга управляющей машины, которая на ходу изменяет параметры движения управляемой. Рассмотрим более детально ее состояния.<br />
<br />
В первом состоянии "wait" мы пытаемся изменить скорость движения управляемой машины. Для этого указали объект (sun), состояние в котором хотим поменять параметр (у машины sun это состояние move), имя команды в которой меняем параметр (в данном случае это move), номер команды (если таких команд несколько, то нужно указать порядковый номер начиная с 0; в нашем случае команда одна), имя параметра (мы хотим изменить скорость, поэтому имя параметра v) и значение (указали значение 200). После этого переходим в следующее состояние.<br />
<br />
В состоянии "1" управляющей машины сначала мы вывели объект sun из состояния move, изменили параметр целевой координаты x на 512 и затем вернули в состояние move, чтобы применить изменения параметров. Таким образом управляемая машина начала движение в x=512 со скоростью 200. Через 2 секунды мы переводим управляющую машину в состояние "2", где аналогичным образом изменяется целевая координата на -512.<br />
<br />
Такой способ задания параметров может найти применение в случае, когда параметры нужно задавать переменными.<br />
<br />
==Запись в viewer.log ==<br />
<br />
Во время работы приложения, машина состояний может писать информацию о своей работе в viewer.log. Для этого параметр '''Level''', в разделе '''[GameTrace]''' файла '''app.icf''' должен быть выставлен в значение '''Verbose'''.<br />
<br />
При этом нужно иметь ввиду, что приложение работает более медленно, чем при обычном использовании. При настройке процессов, привязанных к времени (анимация и т.д.) логирование нужно отключать, путем установки флага '''Level''' в значение '''Info'''.<br />
<br />
Ниже приведен пример записи из viewer.log. Жирным шрифтом выделено полезную информацию. <br />
<br />
*Machine::state() state machine '''stat_google_gold (id:30818)''' from '''enough_coins''' to '''enough_coins''' through object '''c_current_gold (id:8807)''' from state '''inc''' - машина с именем и id: '''stat_google_gold (id:30818)''' перешла из состояния: '''enough_coins''' в: '''enough_coins'''; ее состояние изменил объект с именем и id: '''c_current_gold (id:8807)''' из состояния: '''inc'''.<br />
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:17''' - машина с id '''(id:28076)''' начала выполнять команду '''set id:17'''; сначала проверяется истинно ли условие выполнения команды (if).<br />
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(0)=no''' - имеем некоторое сложное условие, проверяем его составляющие; if(0) не выполняется (имеет значение false).<br />
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(1)=yes''' - условие if(1) выполняется (имеет значение true).<br />
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(2)=yes''' - условие if(2) выполняется (имеет значение true).<br />
*GMachine::Command::checkIf() GMachine'''(id:28076)'''::Command::'''checkIf id:17 expr:((0|(!1))|(!2)) res:false''' - проверяется все выражение; общий результат false, set(17) не выполняется.<br />
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18''' - машина с id '''(id:28076)''' начала выполнять команду '''set id:18''', в данном set условие if отсутствует.<br />
*GMachine::Command::checkIf() GMachine'''(id:28076)'''::Command::'''checkIf id:18 expr: res:true''' - в команде set(18) условие '''checkIf id:18 expr: res:true''' есть истинно (точнее - не есть ложным, так как оно отсутствует); set(18) будет выполнен.<br />
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18 checkIf success''' - проверка условия прошла успешно, выполняем set(18).<br />
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18 obj:16039 -> par:param_name val:bundle_coins us:0''' - результат выполнения set(18) - объекту '''obj:16039''' устанавливаем параметр '''par:param_name val:bundle_coins''' равным '''us:0'''.<br />
*GMachine::Command::getVarValue() Command::'''getVarValue(bundle_item): float result = 0.00''' - вычитываем переменную с помощью команды var; вычитываем параметр '''bundle_item''', результат операции '''float result = 0.00'''.<br />
*GMachine::Set::init() Set::init: Expression: '''(bundle_coins)=0.000000(float)''' - используем значение переменной в команде set; переменная вчитывается в момент обращения к ней из другой команды (set, move и др.).<br />
<br />
==Использование скриптов Lua ==<br />
В машине состояний можно использовать скрипты [[Lua]]<br />
<br />
<br />
==Окно==<br />
В свойствах машины состояний есть 2 новых поля:<br />
*'''окно''' - если ''да'', то машина считает себя окном. При включении данного параметра с момента постановки окна в очередь ''statesmanager'а'' и до вызова ''back'' в текущей машине блокируются внешние воздействия и переход между состояниями.<br />
*'''тип окна''' - обычное; по альфе - при открытии отключает все нижние сцены по альфе; с фото - при открытии отключает все нижние сцены по альфе, предварительно делая фото этих сцен. Выключение сцен ''по альфе'' и ''с фото'' используются для больших окон основной очереди.<br />
[[mwindow]]<br />
<br />
[[Category:Main objects]]</div>Achethttps://wiki.appsalutecreator.com/index.php?title=Table&diff=9444Table2018-02-19T12:13:03Z<p>Achet: /* Использование таблицы для анимации */</p>
<hr />
<div>{{TOC right}}<br />
'''Общие параметры'''<br />
<br />
Таблица имеет набор стандартных параметров (см. описание параметров [[Object|Object]]).<br />
<br />
[[Файл:Tabletext.png]]<br />
<br />
Таблица (Тable) является универсальным объектом. Она может использоваться как:<br />
<br />
- самостоятельный элемент включая в себя различные элементы ([[Image|Image]], [[Text|Text]], [[Button|Button]], [[Machine|Machine]] и пр.);<br />
<br />
- дополнение к таким объектам как [[Patchwork|Patchwork]], [[HiddenList|HiddenList]], [[Invetory|Invetory]] и др. Выступая в роли «поля» для отображения их элементов.<br />
<br />
[[Файл:Table4.png|right]]<br />
<br />
[[Файл:Table5.png]]<br />
<br />
[[Файл:Table6.png]]<br />
<br />
Для того чтобы поместить объекты в таблицу, необходимо внести их в группу таблицы в дереве проекта.<br />
Заполнение таблицы происходит по столбцам. Если в таблице число видимых колонок/строчек меньше общего количества колонок/строчек, то, в таком случае, таблицу можно листать в нужном направлении.<br />
<br />
== Основные параметры таблицы ==<br />
<br />
*'''курсор''' ''(curs)'' - графический ресурс курсора текущего и всех дочерних объектов;<br />
*'''указатель''' ''(pointer)'' - Объект указывающий на произвольное место таблицы, в параметры (pCurCol,pCurRow,pCurIndex) будет записываться позиция ячейки на которую указывает пивот объекта. При вызове состояния flytopointer таблица будет перематываться на ячейку указанную в параметрах (pNewCol,pNewRow,pNewIndex).<br />
<br />
[[Файл:Table new1.png|300px|right]]<br />
'''Группа - таблица'''<br />
<br />
''(Курсивом в скобках указан id параметра, или состояния)''<br />
*'''подложка объект''' ''(bgobj)'' - Объект картинка на которой выводится таблица. Задумывалась картинка, которая будет тайлиться до размеров таблицы. В дереве не важно где хранить этот объект.<br />
*'''колонок''' ''(cols)'' - Максимальное число колонок (ячейки должны поместиться).<br />
*'''колонок видно''' ''(cShw)'' - Количество колонок, видимых в области вывода таблицы (если включен флаг: ширина фиксированная).<br />
*'''строчек''' ''(rows)'' - Максимальное число строчек (ячейки должны поместиться).<br />
*'''строчек видно''' ''(rShw)'' - Количество строчек, видимых в области вывода таблицы (если включен флаг: высота фиксированная).<br />
*'''скорость листания''' ''(vel)'' - Скорость листания страниц (точек/секунду).<br />
*'''отсечение''' ''(cut)'' - "ширина и высота" - обрезать графику таблицы по ширине и высоте; "ширина" - обрезать графику таблицы по ширине; "высота" - обрезать графику таблицы по высоте; "нет" - не обрезать.<br />
*'''добавлять по строкам''' ''(bystr)'' - 1 - добавлять по строкам; 0 - добавлять по столбцам.<br />
*'''центрировать''' ''(cntr)'' - "нет" - не центрировать (ячейки заполняются начиная от левого края таблицы); "растянуть" - если количество заполненных ячеек меньше видимых, то они равномерно растягиваются по длине таблицы (при этом только увеличивается расстояние между ячейками); "прижать к центру" - если количество заполненных ячеек меньше видимых, то эти ячейки располагаются по центру таблицы (при этом расстояния между ячейками не увеличиваются).<br />
*'''добавлять только видимые''' - добавлять только видимые объекты таблицы (vis=1)<br />
<br />
'''Группа - бордюры таблицы'''<br />
<br />
*'''бордюр X''' ''(dx)'' - Ширина бордюра по x (отступ во внутрь слева и справа) от подложки или от ширины объекта для отображения видимых ячеек.<br />
*'''бордюр Y''' ''(dy)'' - Ширина бордюра по y (отступ во внутрь сверху и снизу) от подложки или от высоты объекта для отображения видимых ячеек.<br />
*'''отступ X''' ''(dxC)'' - Отступ по x во внутрь (слева и справа) в ячейке, чтобы содержимое соседних ячеек не сливалось.<br />
*'''отступ Y''' ''(dyC)'' - Отступ по y во внутрь (сверху и снизу) в ячейке, чтобы содержимое соседних ячеек не сливалось.<br />
<br />
'''Группа - смещение'''<br />
<br />
*'''смещ. X''' - Смещение по x объекта в ячейке.<br />
*'''смещ. Y''' - Смещение по y объекта в ячейке.<br />
*'''фон X''' - Смещение по x фона в ячейке.<br />
*'''фон Y''' - Смещение по y фона в ячейке.<br />
*'''зачеркивания X''' - Смещение по x ресурса зачеркивания ячейки.<br />
*'''зачеркивания Y''' - Смещение по y ресурса зачеркивания ячейки.<br />
<br />
'''Группа - размеры ячеек'''<br />
<br />
*'''фон''' - Графический ресурс фона ячейки. Перетаскивается мышкой из редактора ресурсов. Может отсутствовать.<br />
*'''ширина фиксированная''' - Если равно 1, то ширины колонок будут фиксированные и определяются полем: колонок видно.<br />
*'''высота фиксированная''' - Если равно 1, то высоты строчек будут фиксированные и определяются полем: строчек видно.<br />
*'''сжимать''' - Если равно 1, то будет сжимать картинки без искажения пропорций, чтобы они помещались в ячейке.<br />
*'''текущая колонка''' - Номер первой видимой колонки, начиная с 0-ля.<br />
*'''текущая строка''' - Номер первой видимой строки, начиная с 0-ля.<br />
<br />
'''Группа - параметры текста'''<br />
<br />
*'''текстID''' ''(tTxtID)'' - Текст (id из редактора текста), отображаемый построчно в таблице.<br />
*'''текст''' ''(tTxt)'' - Cтрока, отображаемая в таблице.<br />
*'''имя''' ''(fn)'' - Номер шрифта - целое число, начиная с 0 (порядковый номер шрифта).<br />
*'''размер''' ''(fs)'' - Размер шрифта в поинтах. <br />
*'''цвет 1''' ''(fc1)'' - Цвет текста обычного вида.<br />
*'''цвет 2''' ''(fc2)'' - Цвет текста помеченной ячейки.<br />
*'''alpha2''' ''(al2)'' - Прозрачность картинки в помеченной ячейке.<br />
*'''поз. гориз.''' ''(cellAlHor)'' - Горизонтальное выравнивание текста (0 - нет выравнивания; 1 - прижать к левому краю; 2 - центр; 3 - к правому).<br />
*'''поз. верт.''' ''(cellAlVer)'' - Вертикальное выравнивание текста (0 - нет выравнивания; 1 - прижать к верхнему краю; 2 - центр; 3 - к нижнему).<br />
*'''цвет зачеркивания 1''' ''(str_c1)'' - Цвет зачеркивания текста обычного вида.<br />
*'''цвет зачеркивания 2''' ''(str_c2)'' - Цвет зачеркивания текста помеченной ячейки.<br />
*'''ресурс зачеркивания''' ''(crRes)'' - Графический ресурс зачеркивания ячейки. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Может отсутствовать.<br />
*'''толщина зачеркивания''' ''(str_s)'' - Толщина зачеркивания в пикселях.<br />
*'''отступ''' ''(skip)'' - Вертикальное расстояние в пикселях в одной ячейке между словами в словосочетании (например в словосочетании Морская звезда, если оно не помещается горизонтально в одну ячейку - это вертикальное расстояние между Морская и звезда).<br />
<br />
'''Группа - анимация перемещения ячеек'''<br />
*'''анимация''' - (0-выкл, 1-вкл), где 0 - быстрое перемещение ячейки без анимации,<br />
*'''скорость анимации''' - время перемещения ячейки при включенной анимации.<br />
<br />
== Дополнительные параметры ==<br />
'''Группа - Управление''' <br />
<br />
[[Файл:Table new2 new.PNG|450px|right]]<br />
<br />
Когда таблица листаемая, можно отображать индикаторы страниц. У каждого индикатора два состояния: вкл - если соответствующая страница видна на экране и выкл в противоположном случае. Нажав на соответствующий индикатор, таблица перемещается со скоростью, указанной в параметре "скорость листания" <br />
на необходимую страницу.<br />
<br />
*'''индикатор ВКЛ''' - Картинка включенного индикатора.<br />
*'''индикатор ВЫКЛ''' - Картинка выключенного индикатора.<br />
*'''левая кнопка''' - Кнопка для листания списка влево.<br />
*'''правая кнопка''' - Кнопка для листания списка вправо.<br />
*'''верхняя кнопка'''- Кнопка для листания списка вверх. <br />
*'''нижняя кнопка''' - Кнопка для листания списка вниз. <br />
*'''отступ X''' - Отступ по x от таблицы.<br />
*'''отступ Y''' - Отступ по y от таблицы.<br />
*'''отступ W''' - Отступ между ячейками таблицы индексов.<br />
<br />
'''Группа - листание'''<br />
<br />
*'''изинг скорости листания''' ''(scrVelEasing)'' - Изинг скорости листания ([http://easings.net/ru шаблоны])<br />
*'''макс. скорость листания''' ''(scrMaxSpeed)'' - Максимальная скорость листания при броске<br />
*'''макс. длинна листания в страницах''' ''(scrMaxPages)'' - Максимальная длинна листания при броске в страницах - максимальное кол-во страниц (элементов?), на которое можно листнуть таблицу за раз<br />
*'''тип листания''' - Тип листания таблицы: 0 - по страницам; 1 - в зависимости от скорости (IOS).<br />
*'''листать как книгу''' - да - при нечетном колличестве добавляемых страниц будут добавляться пустые ячейки; нет - листание по колличеству видимых ячеек.<br />
*'''старт листания''' - Смещение в точках, начиная с которого скролим таблицу.<br />
*'''гориз. листание''' - Горизонтальное листание таблицы: 0 - выключено; 1 - включено.<br />
*'''вертик. листание''' - Вертикальное листание таблицы: 0 - выключено; 1 - включено.<br />
*'''цикл. листание''' - Циклическое листание таблицы: 0 - выключено; 1 - включено.<br />
*'''листание 360 градусов''' - Разрешено листание в двух направлениях: 0 - выключено; 1 - включено.<br />
*'''затухание''' - Затухание скорости листания таблицы: 0 - выключено; 1 - включено.<br />
<br />
== Добавляемые параметры ==<br />
[[Файл:Table2_1.PNG|right]]<br />
Открывается при нажатии правой кнопки мыши в поле параметров таблицы.<br />
<br />
[[Файл:+.png]] '''ширина настраиваемая'''<br />
*'''ширина колонок''' - Через точку с запятой указываем ширину колонок по-порядку.<br />
[[Файл:+.png]] '''высота настраиваемая'''<br />
*'''высота строчек''' - Через точку с запятой указываем высоту строчек по-порядку.<br />
[[Файл:+.png]] '''добавить ячейку в таблицу'''<br />
*'''текстID''' - Строка (id из редактора строк), отображаемая в ячейке.<br />
*'''текст''' - Строка, отображаемая в ячейке.<br />
*'''картинка''' - Картинка, рисуемая в ячейке (строки игнорируются).<br />
<br />
[[Файл:+.png]] '''изменить состояние объекта''' - при тапе<br />
*'''объект''' - Строка которого мы меняем.<br />
*'''состояние''' - Значение нового состояния.<br />
<br />
[[Файл:+.png]] '''при листании влево - изменить состояние объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании влево - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
[[Файл:+.png]] '''при листании вправо - изменить состояние объекта''' <br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании вправо - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
[[Файл:+.png]] '''при листании вниз - изменить состояние объекта''' <br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании вниз - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
[[Файл:+.png]] '''при листании вверх - изменить состояние объекта''' <br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании вверх - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
== Состояния таблицы ==<br />
Так же мы можем управлять таблицей изменяя ее состояния.<br />
<br />
*'''first''' - Перелистнуть на первую страницу таблицы.<br />
*'''last''' - Перелистнуть на последнюю страницу таблицы.<br />
*'''prev''' - Перелистнуть на предыдущую страницу таблицы (влево по горизонтали).<br />
*'''next''' - Перелистнуть на следующую страницу таблицы (вправо по горизонтали).<br />
*'''up''' - Перелистнуть на следующую страницу таблицы (вверх по вертикали).<br />
*'''down''' - Перелистнуть на предыдущую страницу таблицы (вниз по вертикали).<br />
*'''refresh''' - Обновить таблицу.<br />
*'''reload''' - перезаполнить таблицу. Необходимо в случае, когда объекты в таблицу добавляются путем установки таблицы в качестве родителя (передаём сразу при смене родителя, после каждой смены родителя).<br />
*'''flyto''' - Таблица плавно приедет к значению curRow и curCol, если они были изменены.<br />
*'''flytopointer''' - перелистывание таблицы на ячейку указанную в параметрах ''pNewCol, pNewRow, pNewIndex''. В таблице должен быть задан указатель. В параметры ''pCurCol, pCurRow, pCurIndex'' будет записываться позиция ячейки на которую указывает пивот указателя.<br />
*'''movetopointer''' - мгновенное перелистывание таблицы на ячейку указанную в параметрах ''pNewCol, pNewRow, pNewIndex''. В таблице должен быть задан указатель. В параметры ''pCurCol, pCurRow, pCurIndex'' будет записываться позиция ячейки на которую указывает пивот указателя.<br />
*'''find'''- состояние, по которому таблица найдет объект, указанный в параметре find_obj и результат поиска запишет в параметр found_Col и found_Row. <br />
<br />
Если изменить таблице значение параметра (текущего рядка или столбика), то после необходимо передать таблице состояние refresh или flyto, чтобы увидеть изменения. При refresh рядок или столбец поменяется мгновенно, при flyto таблица "приплывет" к нужному рядку или столбцу.<br />
<br />
==Вычитываемые параметры==<br />
<br />
*'''maxRow''' - Количество заполненных строк.<br />
*'''maxCol''' - Количество заполненных колонок.<br />
*'''curRow''' - Текущая строка.<br />
*'''curCol''' - Текущая колонка.<br />
*'''clickRow''' - Номер последней нажатой строки.<br />
*'''clickCol''' - Номер последнего нажатого столбца.<br />
*'''pCurCol''' - Номер колонки, на которую указывает пивот указателя. До вызова состояний ''flytopointer'' или ''movetopointer'' pCurCol=-1.<br />
*'''pCurRow''' - Номер строки, на которую указывает пивот указателя. До вызова состояний ''flytopointer'' или ''movetopointer'' pCurRow=-1.<br />
*'''pCurIndex''' - Индекс ячейки, на которую указывает пивот указателя. До вызова состояний ''flytopointer'' или ''movetopointer'' pCurIndex=-1. <br />
*'''find_obj''' - Объект который нужно найти в состояние (find)<br />
<br />
== Использование таблицы для анимации ==<br />
<br />
=== Использование состояния flyto ===<br />
<br />
Иногда нужно получить анимацию выезда (или другого движения) некоторого объекта (окна, рисунка и тд) на экран. Это можно сделать с помощью таблицы. Ниже приведен пример для движения вниз (с постепенным пропаданием объекта из видимости). Делаем следующее: создаем таблицу(ее параметры приведены на рисунке) нужного размера(как минимум, чтобы поместился нужный объект). В нее помещаем 2 объекта: пустой рисунок(при движении он заменит собой движущийся объект) и объект-родитель(image размером 0*0 ), в котором находится объект, который будет двигаться.<br />
<br />
'''Важно!''' Для корректного отображения объекта в таблице, нужно:<br />
* Создать таблицу и разместить ее нужным образом,.<br />
* Разместить объект родитель посередине движущегося объекта <br />
* Поместить движущийся объект в родителя<br />
* Поместить родителя в таблицу<br />
<br />
Если нужно подкорректировать положение объекта в таблице, то нужно изменять именно его координаты. Изменение координат родителя не приведет к смещению объекта на экране вьювера.<br />
<br />
Для запуска анимации таблице нужно изменить значение текущей строки (столбца, при горизонтальном движении), после чего передать ей состояние <br />
flyto. Скорость анимации можно настроить изменяя параметр таблицы - скорость листания.<br />
<br />
[[Файл:Tblanimmove.png|250px|Расположение в дереве проекта]] [[Файл:Animmovestate.png|250px|Машина, запускающая анимацию]] [[Файл:Tableanimmove.png|250px|Параметры таблицы]]<br />
<br />
В объекта-родителя можно помещать не только картинки, но и машины(которые могут реализовывать собственное движение, при этом, при попадании за край таблицы, объект постепенно уходит из зоны видимости). Также в родителя можно поместить еще одну анимацию с помощью таблицы.<br />
<br />
<br />
В данном случае нужно движение по вертикали вниз. Для этого таблица имеет следующие параметры: 1 столбец, 2 строки, нелистаемая( тк не нужно взаимодействовать с объектами ). Принцип работы прост ячейка (1,0) заменяется на (0,0).<br />
<br />
<br />
=== Передвижение предмета под границу окна ===<br />
<br />
Такой же эффект можно достичь, если использовать ректангл. Помещаем окно в ректангл и задаем ему параметр отсечение.<br />
Использование ректангла потребляет меньше ресурсов.<br />
<br />
С помощью таблицы можно ограничить зону видимости предмета на экране. При этом, при выходе за эту зону, объект пропадает из видимости постепенно (эффект вылетания). <br />
<br />
Для этого помещаем наше окно в родительский объект(до помещения окна в родителя, родитель должен находится в центре окна). После создаем таблицу по размеру окна, и располагаем ее на сцене нужным образом. Потом помещаем в нее объект-родитель. Теперь таблица является границами видимости окошка и его элементов. Всё, что будет за границами таблицы будет невидимо. После этого, желательно, поместить таблицу в image 0*0.<br />
<br />
[[Файл:Wndtable.png|250px|Расположение в дереве проекта]][[Файл:Parwndtabl.png|250px|Параметры таблицы]]<br />
<br />
В данном случае у таблицы 1 столбец, 1 строка и 1 ячейка, в которой находится наше окошко. Листаться объекты в таблице не должны, но с ними нужно взаимодействовать. Если отключить листание вообще, то объекты не реагируют на воздействие. Для того, чтобы объекты вели себя корректно, делаем следующее: включаем листание 360 градусов (по горизонтали и вертикали) и выставляем большое значение в параметра "старт листание(чтобы клик по окошку таблица не воспринимала как попытку листания)". <br />
<br />
<br />
=== Состояние Find ===<br />
Для реализации состояние find, по которому таблица найдет объект, указанный в параметре find_obj и результат поиска запишет в параметр found_Col и found_Row. Необходимо создать переменную. [[Файл:TableFindObj.png|Реализация состояние find, по которому таблица найдет объект.]]<br />
<br />
== Перемещение ячеек таблицы ==<br />
Параметры таблицы:<br />
*'''moveCellColFrom''' - указываем номер ячейки (в столбце), которую хотим переместить<br />
<br />
*'''moveCellRowFrom''' - указываем номер ячейки (в строке), которую хотим переместить<br />
<br />
*'''moveCellColTo''' - указываем номер ячейки (в столбце), в которую хотим вставить нужную нам ячейку <br />
<br />
*'''moveCellRowTo''' - указываем номер ячейки (в строке), в которую хотим вставить нужную нам ячейку<br />
<br />
*'''moveCellAnim''' - (0-выкл, 1-вкл), где 0 - быстрое перемещение ячейки без анимации<br />
<br />
*'''moveCellAnimTime''' - время перемещения ячейки при moveCellAnim = 1<br />
<br />
<br />
Состояние '''moveCell''' - запуск перемещения ячейки<br />
<br />
== Пример ==<br />
<br />
[http://fs5.absolutist.com/files/wikisample/Table.rar Download]<br />
<br />
[[Category:Main objects]]</div>Achethttps://wiki.appsalutecreator.com/index.php?title=%D0%A4%D0%B0%D0%B9%D0%BB:TableFindObj.png&diff=9443Файл:TableFindObj.png2018-02-19T12:09:17Z<p>Achet: Реализация состояние find, по которому таблица найдет объект.</p>
<hr />
<div>Реализация состояние find, по которому таблица найдет объект.</div>Achethttps://wiki.appsalutecreator.com/index.php?title=Table&diff=9442Table2018-02-19T12:03:21Z<p>Achet: /* Вычитываемые параметры */</p>
<hr />
<div>{{TOC right}}<br />
'''Общие параметры'''<br />
<br />
Таблица имеет набор стандартных параметров (см. описание параметров [[Object|Object]]).<br />
<br />
[[Файл:Tabletext.png]]<br />
<br />
Таблица (Тable) является универсальным объектом. Она может использоваться как:<br />
<br />
- самостоятельный элемент включая в себя различные элементы ([[Image|Image]], [[Text|Text]], [[Button|Button]], [[Machine|Machine]] и пр.);<br />
<br />
- дополнение к таким объектам как [[Patchwork|Patchwork]], [[HiddenList|HiddenList]], [[Invetory|Invetory]] и др. Выступая в роли «поля» для отображения их элементов.<br />
<br />
[[Файл:Table4.png|right]]<br />
<br />
[[Файл:Table5.png]]<br />
<br />
[[Файл:Table6.png]]<br />
<br />
Для того чтобы поместить объекты в таблицу, необходимо внести их в группу таблицы в дереве проекта.<br />
Заполнение таблицы происходит по столбцам. Если в таблице число видимых колонок/строчек меньше общего количества колонок/строчек, то, в таком случае, таблицу можно листать в нужном направлении.<br />
<br />
== Основные параметры таблицы ==<br />
<br />
*'''курсор''' ''(curs)'' - графический ресурс курсора текущего и всех дочерних объектов;<br />
*'''указатель''' ''(pointer)'' - Объект указывающий на произвольное место таблицы, в параметры (pCurCol,pCurRow,pCurIndex) будет записываться позиция ячейки на которую указывает пивот объекта. При вызове состояния flytopointer таблица будет перематываться на ячейку указанную в параметрах (pNewCol,pNewRow,pNewIndex).<br />
<br />
[[Файл:Table new1.png|300px|right]]<br />
'''Группа - таблица'''<br />
<br />
''(Курсивом в скобках указан id параметра, или состояния)''<br />
*'''подложка объект''' ''(bgobj)'' - Объект картинка на которой выводится таблица. Задумывалась картинка, которая будет тайлиться до размеров таблицы. В дереве не важно где хранить этот объект.<br />
*'''колонок''' ''(cols)'' - Максимальное число колонок (ячейки должны поместиться).<br />
*'''колонок видно''' ''(cShw)'' - Количество колонок, видимых в области вывода таблицы (если включен флаг: ширина фиксированная).<br />
*'''строчек''' ''(rows)'' - Максимальное число строчек (ячейки должны поместиться).<br />
*'''строчек видно''' ''(rShw)'' - Количество строчек, видимых в области вывода таблицы (если включен флаг: высота фиксированная).<br />
*'''скорость листания''' ''(vel)'' - Скорость листания страниц (точек/секунду).<br />
*'''отсечение''' ''(cut)'' - "ширина и высота" - обрезать графику таблицы по ширине и высоте; "ширина" - обрезать графику таблицы по ширине; "высота" - обрезать графику таблицы по высоте; "нет" - не обрезать.<br />
*'''добавлять по строкам''' ''(bystr)'' - 1 - добавлять по строкам; 0 - добавлять по столбцам.<br />
*'''центрировать''' ''(cntr)'' - "нет" - не центрировать (ячейки заполняются начиная от левого края таблицы); "растянуть" - если количество заполненных ячеек меньше видимых, то они равномерно растягиваются по длине таблицы (при этом только увеличивается расстояние между ячейками); "прижать к центру" - если количество заполненных ячеек меньше видимых, то эти ячейки располагаются по центру таблицы (при этом расстояния между ячейками не увеличиваются).<br />
*'''добавлять только видимые''' - добавлять только видимые объекты таблицы (vis=1)<br />
<br />
'''Группа - бордюры таблицы'''<br />
<br />
*'''бордюр X''' ''(dx)'' - Ширина бордюра по x (отступ во внутрь слева и справа) от подложки или от ширины объекта для отображения видимых ячеек.<br />
*'''бордюр Y''' ''(dy)'' - Ширина бордюра по y (отступ во внутрь сверху и снизу) от подложки или от высоты объекта для отображения видимых ячеек.<br />
*'''отступ X''' ''(dxC)'' - Отступ по x во внутрь (слева и справа) в ячейке, чтобы содержимое соседних ячеек не сливалось.<br />
*'''отступ Y''' ''(dyC)'' - Отступ по y во внутрь (сверху и снизу) в ячейке, чтобы содержимое соседних ячеек не сливалось.<br />
<br />
'''Группа - смещение'''<br />
<br />
*'''смещ. X''' - Смещение по x объекта в ячейке.<br />
*'''смещ. Y''' - Смещение по y объекта в ячейке.<br />
*'''фон X''' - Смещение по x фона в ячейке.<br />
*'''фон Y''' - Смещение по y фона в ячейке.<br />
*'''зачеркивания X''' - Смещение по x ресурса зачеркивания ячейки.<br />
*'''зачеркивания Y''' - Смещение по y ресурса зачеркивания ячейки.<br />
<br />
'''Группа - размеры ячеек'''<br />
<br />
*'''фон''' - Графический ресурс фона ячейки. Перетаскивается мышкой из редактора ресурсов. Может отсутствовать.<br />
*'''ширина фиксированная''' - Если равно 1, то ширины колонок будут фиксированные и определяются полем: колонок видно.<br />
*'''высота фиксированная''' - Если равно 1, то высоты строчек будут фиксированные и определяются полем: строчек видно.<br />
*'''сжимать''' - Если равно 1, то будет сжимать картинки без искажения пропорций, чтобы они помещались в ячейке.<br />
*'''текущая колонка''' - Номер первой видимой колонки, начиная с 0-ля.<br />
*'''текущая строка''' - Номер первой видимой строки, начиная с 0-ля.<br />
<br />
'''Группа - параметры текста'''<br />
<br />
*'''текстID''' ''(tTxtID)'' - Текст (id из редактора текста), отображаемый построчно в таблице.<br />
*'''текст''' ''(tTxt)'' - Cтрока, отображаемая в таблице.<br />
*'''имя''' ''(fn)'' - Номер шрифта - целое число, начиная с 0 (порядковый номер шрифта).<br />
*'''размер''' ''(fs)'' - Размер шрифта в поинтах. <br />
*'''цвет 1''' ''(fc1)'' - Цвет текста обычного вида.<br />
*'''цвет 2''' ''(fc2)'' - Цвет текста помеченной ячейки.<br />
*'''alpha2''' ''(al2)'' - Прозрачность картинки в помеченной ячейке.<br />
*'''поз. гориз.''' ''(cellAlHor)'' - Горизонтальное выравнивание текста (0 - нет выравнивания; 1 - прижать к левому краю; 2 - центр; 3 - к правому).<br />
*'''поз. верт.''' ''(cellAlVer)'' - Вертикальное выравнивание текста (0 - нет выравнивания; 1 - прижать к верхнему краю; 2 - центр; 3 - к нижнему).<br />
*'''цвет зачеркивания 1''' ''(str_c1)'' - Цвет зачеркивания текста обычного вида.<br />
*'''цвет зачеркивания 2''' ''(str_c2)'' - Цвет зачеркивания текста помеченной ячейки.<br />
*'''ресурс зачеркивания''' ''(crRes)'' - Графический ресурс зачеркивания ячейки. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Может отсутствовать.<br />
*'''толщина зачеркивания''' ''(str_s)'' - Толщина зачеркивания в пикселях.<br />
*'''отступ''' ''(skip)'' - Вертикальное расстояние в пикселях в одной ячейке между словами в словосочетании (например в словосочетании Морская звезда, если оно не помещается горизонтально в одну ячейку - это вертикальное расстояние между Морская и звезда).<br />
<br />
'''Группа - анимация перемещения ячеек'''<br />
*'''анимация''' - (0-выкл, 1-вкл), где 0 - быстрое перемещение ячейки без анимации,<br />
*'''скорость анимации''' - время перемещения ячейки при включенной анимации.<br />
<br />
== Дополнительные параметры ==<br />
'''Группа - Управление''' <br />
<br />
[[Файл:Table new2 new.PNG|450px|right]]<br />
<br />
Когда таблица листаемая, можно отображать индикаторы страниц. У каждого индикатора два состояния: вкл - если соответствующая страница видна на экране и выкл в противоположном случае. Нажав на соответствующий индикатор, таблица перемещается со скоростью, указанной в параметре "скорость листания" <br />
на необходимую страницу.<br />
<br />
*'''индикатор ВКЛ''' - Картинка включенного индикатора.<br />
*'''индикатор ВЫКЛ''' - Картинка выключенного индикатора.<br />
*'''левая кнопка''' - Кнопка для листания списка влево.<br />
*'''правая кнопка''' - Кнопка для листания списка вправо.<br />
*'''верхняя кнопка'''- Кнопка для листания списка вверх. <br />
*'''нижняя кнопка''' - Кнопка для листания списка вниз. <br />
*'''отступ X''' - Отступ по x от таблицы.<br />
*'''отступ Y''' - Отступ по y от таблицы.<br />
*'''отступ W''' - Отступ между ячейками таблицы индексов.<br />
<br />
'''Группа - листание'''<br />
<br />
*'''изинг скорости листания''' ''(scrVelEasing)'' - Изинг скорости листания ([http://easings.net/ru шаблоны])<br />
*'''макс. скорость листания''' ''(scrMaxSpeed)'' - Максимальная скорость листания при броске<br />
*'''макс. длинна листания в страницах''' ''(scrMaxPages)'' - Максимальная длинна листания при броске в страницах - максимальное кол-во страниц (элементов?), на которое можно листнуть таблицу за раз<br />
*'''тип листания''' - Тип листания таблицы: 0 - по страницам; 1 - в зависимости от скорости (IOS).<br />
*'''листать как книгу''' - да - при нечетном колличестве добавляемых страниц будут добавляться пустые ячейки; нет - листание по колличеству видимых ячеек.<br />
*'''старт листания''' - Смещение в точках, начиная с которого скролим таблицу.<br />
*'''гориз. листание''' - Горизонтальное листание таблицы: 0 - выключено; 1 - включено.<br />
*'''вертик. листание''' - Вертикальное листание таблицы: 0 - выключено; 1 - включено.<br />
*'''цикл. листание''' - Циклическое листание таблицы: 0 - выключено; 1 - включено.<br />
*'''листание 360 градусов''' - Разрешено листание в двух направлениях: 0 - выключено; 1 - включено.<br />
*'''затухание''' - Затухание скорости листания таблицы: 0 - выключено; 1 - включено.<br />
<br />
== Добавляемые параметры ==<br />
[[Файл:Table2_1.PNG|right]]<br />
Открывается при нажатии правой кнопки мыши в поле параметров таблицы.<br />
<br />
[[Файл:+.png]] '''ширина настраиваемая'''<br />
*'''ширина колонок''' - Через точку с запятой указываем ширину колонок по-порядку.<br />
[[Файл:+.png]] '''высота настраиваемая'''<br />
*'''высота строчек''' - Через точку с запятой указываем высоту строчек по-порядку.<br />
[[Файл:+.png]] '''добавить ячейку в таблицу'''<br />
*'''текстID''' - Строка (id из редактора строк), отображаемая в ячейке.<br />
*'''текст''' - Строка, отображаемая в ячейке.<br />
*'''картинка''' - Картинка, рисуемая в ячейке (строки игнорируются).<br />
<br />
[[Файл:+.png]] '''изменить состояние объекта''' - при тапе<br />
*'''объект''' - Строка которого мы меняем.<br />
*'''состояние''' - Значение нового состояния.<br />
<br />
[[Файл:+.png]] '''при листании влево - изменить состояние объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании влево - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
[[Файл:+.png]] '''при листании вправо - изменить состояние объекта''' <br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании вправо - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
[[Файл:+.png]] '''при листании вниз - изменить состояние объекта''' <br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании вниз - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
[[Файл:+.png]] '''при листании вверх - изменить состояние объекта''' <br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании вверх - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
== Состояния таблицы ==<br />
Так же мы можем управлять таблицей изменяя ее состояния.<br />
<br />
*'''first''' - Перелистнуть на первую страницу таблицы.<br />
*'''last''' - Перелистнуть на последнюю страницу таблицы.<br />
*'''prev''' - Перелистнуть на предыдущую страницу таблицы (влево по горизонтали).<br />
*'''next''' - Перелистнуть на следующую страницу таблицы (вправо по горизонтали).<br />
*'''up''' - Перелистнуть на следующую страницу таблицы (вверх по вертикали).<br />
*'''down''' - Перелистнуть на предыдущую страницу таблицы (вниз по вертикали).<br />
*'''refresh''' - Обновить таблицу.<br />
*'''reload''' - перезаполнить таблицу. Необходимо в случае, когда объекты в таблицу добавляются путем установки таблицы в качестве родителя (передаём сразу при смене родителя, после каждой смены родителя).<br />
*'''flyto''' - Таблица плавно приедет к значению curRow и curCol, если они были изменены.<br />
*'''flytopointer''' - перелистывание таблицы на ячейку указанную в параметрах ''pNewCol, pNewRow, pNewIndex''. В таблице должен быть задан указатель. В параметры ''pCurCol, pCurRow, pCurIndex'' будет записываться позиция ячейки на которую указывает пивот указателя.<br />
*'''movetopointer''' - мгновенное перелистывание таблицы на ячейку указанную в параметрах ''pNewCol, pNewRow, pNewIndex''. В таблице должен быть задан указатель. В параметры ''pCurCol, pCurRow, pCurIndex'' будет записываться позиция ячейки на которую указывает пивот указателя.<br />
*'''find'''- состояние, по которому таблица найдет объект, указанный в параметре find_obj и результат поиска запишет в параметр found_Col и found_Row. <br />
<br />
Если изменить таблице значение параметра (текущего рядка или столбика), то после необходимо передать таблице состояние refresh или flyto, чтобы увидеть изменения. При refresh рядок или столбец поменяется мгновенно, при flyto таблица "приплывет" к нужному рядку или столбцу.<br />
<br />
==Вычитываемые параметры==<br />
<br />
*'''maxRow''' - Количество заполненных строк.<br />
*'''maxCol''' - Количество заполненных колонок.<br />
*'''curRow''' - Текущая строка.<br />
*'''curCol''' - Текущая колонка.<br />
*'''clickRow''' - Номер последней нажатой строки.<br />
*'''clickCol''' - Номер последнего нажатого столбца.<br />
*'''pCurCol''' - Номер колонки, на которую указывает пивот указателя. До вызова состояний ''flytopointer'' или ''movetopointer'' pCurCol=-1.<br />
*'''pCurRow''' - Номер строки, на которую указывает пивот указателя. До вызова состояний ''flytopointer'' или ''movetopointer'' pCurRow=-1.<br />
*'''pCurIndex''' - Индекс ячейки, на которую указывает пивот указателя. До вызова состояний ''flytopointer'' или ''movetopointer'' pCurIndex=-1. <br />
*'''find_obj''' - Объект который нужно найти в состояние (find)<br />
<br />
== Использование таблицы для анимации ==<br />
<br />
=== Использование состояния flyto ===<br />
<br />
Иногда нужно получить анимацию выезда (или другого движения) некоторого объекта (окна, рисунка и тд) на экран. Это можно сделать с помощью таблицы. Ниже приведен пример для движения вниз (с постепенным пропаданием объекта из видимости). Делаем следующее: создаем таблицу(ее параметры приведены на рисунке) нужного размера(как минимум, чтобы поместился нужный объект). В нее помещаем 2 объекта: пустой рисунок(при движении он заменит собой движущийся объект) и объект-родитель(image размером 0*0 ), в котором находится объект, который будет двигаться.<br />
<br />
'''Важно!''' Для корректного отображения объекта в таблице, нужно:<br />
* Создать таблицу и разместить ее нужным образом,.<br />
* Разместить объект родитель посередине движущегося объекта <br />
* Поместить движущийся объект в родителя<br />
* Поместить родителя в таблицу<br />
<br />
Если нужно подкорректировать положение объекта в таблице, то нужно изменять именно его координаты. Изменение координат родителя не приведет к смещению объекта на экране вьювера.<br />
<br />
Для запуска анимации таблице нужно изменить значение текущей строки (столбца, при горизонтальном движении), после чего передать ей состояние <br />
flyto. Скорость анимации можно настроить изменяя параметр таблицы - скорость листания.<br />
<br />
[[Файл:Tblanimmove.png|250px|Расположение в дереве проекта]] [[Файл:Animmovestate.png|250px|Машина, запускающая анимацию]] [[Файл:Tableanimmove.png|250px|Параметры таблицы]]<br />
<br />
В объекта-родителя можно помещать не только картинки, но и машины(которые могут реализовывать собственное движение, при этом, при попадании за край таблицы, объект постепенно уходит из зоны видимости). Также в родителя можно поместить еще одну анимацию с помощью таблицы.<br />
<br />
<br />
В данном случае нужно движение по вертикали вниз. Для этого таблица имеет следующие параметры: 1 столбец, 2 строки, нелистаемая( тк не нужно взаимодействовать с объектами ). Принцип работы прост ячейка (1,0) заменяется на (0,0).<br />
<br />
<br />
=== Передвижение предмета под границу окна ===<br />
<br />
Такой же эффект можно достичь, если использовать ректангл. Помещаем окно в ректангл и задаем ему параметр отсечение.<br />
Использование ректангла потребляет меньше ресурсов.<br />
<br />
С помощью таблицы можно ограничить зону видимости предмета на экране. При этом, при выходе за эту зону, объект пропадает из видимости постепенно (эффект вылетания). <br />
<br />
Для этого помещаем наше окно в родительский объект(до помещения окна в родителя, родитель должен находится в центре окна). После создаем таблицу по размеру окна, и располагаем ее на сцене нужным образом. Потом помещаем в нее объект-родитель. Теперь таблица является границами видимости окошка и его элементов. Всё, что будет за границами таблицы будет невидимо. После этого, желательно, поместить таблицу в image 0*0.<br />
<br />
[[Файл:Wndtable.png|250px|Расположение в дереве проекта]][[Файл:Parwndtabl.png|250px|Параметры таблицы]]<br />
<br />
В данном случае у таблицы 1 столбец, 1 строка и 1 ячейка, в которой находится наше окошко. Листаться объекты в таблице не должны, но с ними нужно взаимодействовать. Если отключить листание вообще, то объекты не реагируют на воздействие. Для того, чтобы объекты вели себя корректно, делаем следующее: включаем листание 360 градусов (по горизонтали и вертикали) и выставляем большое значение в параметра "старт листание(чтобы клик по окошку таблица не воспринимала как попытку листания)".<br />
<br />
== Перемещение ячеек таблицы ==<br />
Параметры таблицы:<br />
*'''moveCellColFrom''' - указываем номер ячейки (в столбце), которую хотим переместить<br />
<br />
*'''moveCellRowFrom''' - указываем номер ячейки (в строке), которую хотим переместить<br />
<br />
*'''moveCellColTo''' - указываем номер ячейки (в столбце), в которую хотим вставить нужную нам ячейку <br />
<br />
*'''moveCellRowTo''' - указываем номер ячейки (в строке), в которую хотим вставить нужную нам ячейку<br />
<br />
*'''moveCellAnim''' - (0-выкл, 1-вкл), где 0 - быстрое перемещение ячейки без анимации<br />
<br />
*'''moveCellAnimTime''' - время перемещения ячейки при moveCellAnim = 1<br />
<br />
<br />
Состояние '''moveCell''' - запуск перемещения ячейки<br />
<br />
== Пример ==<br />
<br />
[http://fs5.absolutist.com/files/wikisample/Table.rar Download]<br />
<br />
[[Category:Main objects]]</div>Achethttps://wiki.appsalutecreator.com/index.php?title=Table&diff=9441Table2018-02-19T12:00:12Z<p>Achet: /* Состояния таблицы */</p>
<hr />
<div>{{TOC right}}<br />
'''Общие параметры'''<br />
<br />
Таблица имеет набор стандартных параметров (см. описание параметров [[Object|Object]]).<br />
<br />
[[Файл:Tabletext.png]]<br />
<br />
Таблица (Тable) является универсальным объектом. Она может использоваться как:<br />
<br />
- самостоятельный элемент включая в себя различные элементы ([[Image|Image]], [[Text|Text]], [[Button|Button]], [[Machine|Machine]] и пр.);<br />
<br />
- дополнение к таким объектам как [[Patchwork|Patchwork]], [[HiddenList|HiddenList]], [[Invetory|Invetory]] и др. Выступая в роли «поля» для отображения их элементов.<br />
<br />
[[Файл:Table4.png|right]]<br />
<br />
[[Файл:Table5.png]]<br />
<br />
[[Файл:Table6.png]]<br />
<br />
Для того чтобы поместить объекты в таблицу, необходимо внести их в группу таблицы в дереве проекта.<br />
Заполнение таблицы происходит по столбцам. Если в таблице число видимых колонок/строчек меньше общего количества колонок/строчек, то, в таком случае, таблицу можно листать в нужном направлении.<br />
<br />
== Основные параметры таблицы ==<br />
<br />
*'''курсор''' ''(curs)'' - графический ресурс курсора текущего и всех дочерних объектов;<br />
*'''указатель''' ''(pointer)'' - Объект указывающий на произвольное место таблицы, в параметры (pCurCol,pCurRow,pCurIndex) будет записываться позиция ячейки на которую указывает пивот объекта. При вызове состояния flytopointer таблица будет перематываться на ячейку указанную в параметрах (pNewCol,pNewRow,pNewIndex).<br />
<br />
[[Файл:Table new1.png|300px|right]]<br />
'''Группа - таблица'''<br />
<br />
''(Курсивом в скобках указан id параметра, или состояния)''<br />
*'''подложка объект''' ''(bgobj)'' - Объект картинка на которой выводится таблица. Задумывалась картинка, которая будет тайлиться до размеров таблицы. В дереве не важно где хранить этот объект.<br />
*'''колонок''' ''(cols)'' - Максимальное число колонок (ячейки должны поместиться).<br />
*'''колонок видно''' ''(cShw)'' - Количество колонок, видимых в области вывода таблицы (если включен флаг: ширина фиксированная).<br />
*'''строчек''' ''(rows)'' - Максимальное число строчек (ячейки должны поместиться).<br />
*'''строчек видно''' ''(rShw)'' - Количество строчек, видимых в области вывода таблицы (если включен флаг: высота фиксированная).<br />
*'''скорость листания''' ''(vel)'' - Скорость листания страниц (точек/секунду).<br />
*'''отсечение''' ''(cut)'' - "ширина и высота" - обрезать графику таблицы по ширине и высоте; "ширина" - обрезать графику таблицы по ширине; "высота" - обрезать графику таблицы по высоте; "нет" - не обрезать.<br />
*'''добавлять по строкам''' ''(bystr)'' - 1 - добавлять по строкам; 0 - добавлять по столбцам.<br />
*'''центрировать''' ''(cntr)'' - "нет" - не центрировать (ячейки заполняются начиная от левого края таблицы); "растянуть" - если количество заполненных ячеек меньше видимых, то они равномерно растягиваются по длине таблицы (при этом только увеличивается расстояние между ячейками); "прижать к центру" - если количество заполненных ячеек меньше видимых, то эти ячейки располагаются по центру таблицы (при этом расстояния между ячейками не увеличиваются).<br />
*'''добавлять только видимые''' - добавлять только видимые объекты таблицы (vis=1)<br />
<br />
'''Группа - бордюры таблицы'''<br />
<br />
*'''бордюр X''' ''(dx)'' - Ширина бордюра по x (отступ во внутрь слева и справа) от подложки или от ширины объекта для отображения видимых ячеек.<br />
*'''бордюр Y''' ''(dy)'' - Ширина бордюра по y (отступ во внутрь сверху и снизу) от подложки или от высоты объекта для отображения видимых ячеек.<br />
*'''отступ X''' ''(dxC)'' - Отступ по x во внутрь (слева и справа) в ячейке, чтобы содержимое соседних ячеек не сливалось.<br />
*'''отступ Y''' ''(dyC)'' - Отступ по y во внутрь (сверху и снизу) в ячейке, чтобы содержимое соседних ячеек не сливалось.<br />
<br />
'''Группа - смещение'''<br />
<br />
*'''смещ. X''' - Смещение по x объекта в ячейке.<br />
*'''смещ. Y''' - Смещение по y объекта в ячейке.<br />
*'''фон X''' - Смещение по x фона в ячейке.<br />
*'''фон Y''' - Смещение по y фона в ячейке.<br />
*'''зачеркивания X''' - Смещение по x ресурса зачеркивания ячейки.<br />
*'''зачеркивания Y''' - Смещение по y ресурса зачеркивания ячейки.<br />
<br />
'''Группа - размеры ячеек'''<br />
<br />
*'''фон''' - Графический ресурс фона ячейки. Перетаскивается мышкой из редактора ресурсов. Может отсутствовать.<br />
*'''ширина фиксированная''' - Если равно 1, то ширины колонок будут фиксированные и определяются полем: колонок видно.<br />
*'''высота фиксированная''' - Если равно 1, то высоты строчек будут фиксированные и определяются полем: строчек видно.<br />
*'''сжимать''' - Если равно 1, то будет сжимать картинки без искажения пропорций, чтобы они помещались в ячейке.<br />
*'''текущая колонка''' - Номер первой видимой колонки, начиная с 0-ля.<br />
*'''текущая строка''' - Номер первой видимой строки, начиная с 0-ля.<br />
<br />
'''Группа - параметры текста'''<br />
<br />
*'''текстID''' ''(tTxtID)'' - Текст (id из редактора текста), отображаемый построчно в таблице.<br />
*'''текст''' ''(tTxt)'' - Cтрока, отображаемая в таблице.<br />
*'''имя''' ''(fn)'' - Номер шрифта - целое число, начиная с 0 (порядковый номер шрифта).<br />
*'''размер''' ''(fs)'' - Размер шрифта в поинтах. <br />
*'''цвет 1''' ''(fc1)'' - Цвет текста обычного вида.<br />
*'''цвет 2''' ''(fc2)'' - Цвет текста помеченной ячейки.<br />
*'''alpha2''' ''(al2)'' - Прозрачность картинки в помеченной ячейке.<br />
*'''поз. гориз.''' ''(cellAlHor)'' - Горизонтальное выравнивание текста (0 - нет выравнивания; 1 - прижать к левому краю; 2 - центр; 3 - к правому).<br />
*'''поз. верт.''' ''(cellAlVer)'' - Вертикальное выравнивание текста (0 - нет выравнивания; 1 - прижать к верхнему краю; 2 - центр; 3 - к нижнему).<br />
*'''цвет зачеркивания 1''' ''(str_c1)'' - Цвет зачеркивания текста обычного вида.<br />
*'''цвет зачеркивания 2''' ''(str_c2)'' - Цвет зачеркивания текста помеченной ячейки.<br />
*'''ресурс зачеркивания''' ''(crRes)'' - Графический ресурс зачеркивания ячейки. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Может отсутствовать.<br />
*'''толщина зачеркивания''' ''(str_s)'' - Толщина зачеркивания в пикселях.<br />
*'''отступ''' ''(skip)'' - Вертикальное расстояние в пикселях в одной ячейке между словами в словосочетании (например в словосочетании Морская звезда, если оно не помещается горизонтально в одну ячейку - это вертикальное расстояние между Морская и звезда).<br />
<br />
'''Группа - анимация перемещения ячеек'''<br />
*'''анимация''' - (0-выкл, 1-вкл), где 0 - быстрое перемещение ячейки без анимации,<br />
*'''скорость анимации''' - время перемещения ячейки при включенной анимации.<br />
<br />
== Дополнительные параметры ==<br />
'''Группа - Управление''' <br />
<br />
[[Файл:Table new2 new.PNG|450px|right]]<br />
<br />
Когда таблица листаемая, можно отображать индикаторы страниц. У каждого индикатора два состояния: вкл - если соответствующая страница видна на экране и выкл в противоположном случае. Нажав на соответствующий индикатор, таблица перемещается со скоростью, указанной в параметре "скорость листания" <br />
на необходимую страницу.<br />
<br />
*'''индикатор ВКЛ''' - Картинка включенного индикатора.<br />
*'''индикатор ВЫКЛ''' - Картинка выключенного индикатора.<br />
*'''левая кнопка''' - Кнопка для листания списка влево.<br />
*'''правая кнопка''' - Кнопка для листания списка вправо.<br />
*'''верхняя кнопка'''- Кнопка для листания списка вверх. <br />
*'''нижняя кнопка''' - Кнопка для листания списка вниз. <br />
*'''отступ X''' - Отступ по x от таблицы.<br />
*'''отступ Y''' - Отступ по y от таблицы.<br />
*'''отступ W''' - Отступ между ячейками таблицы индексов.<br />
<br />
'''Группа - листание'''<br />
<br />
*'''изинг скорости листания''' ''(scrVelEasing)'' - Изинг скорости листания ([http://easings.net/ru шаблоны])<br />
*'''макс. скорость листания''' ''(scrMaxSpeed)'' - Максимальная скорость листания при броске<br />
*'''макс. длинна листания в страницах''' ''(scrMaxPages)'' - Максимальная длинна листания при броске в страницах - максимальное кол-во страниц (элементов?), на которое можно листнуть таблицу за раз<br />
*'''тип листания''' - Тип листания таблицы: 0 - по страницам; 1 - в зависимости от скорости (IOS).<br />
*'''листать как книгу''' - да - при нечетном колличестве добавляемых страниц будут добавляться пустые ячейки; нет - листание по колличеству видимых ячеек.<br />
*'''старт листания''' - Смещение в точках, начиная с которого скролим таблицу.<br />
*'''гориз. листание''' - Горизонтальное листание таблицы: 0 - выключено; 1 - включено.<br />
*'''вертик. листание''' - Вертикальное листание таблицы: 0 - выключено; 1 - включено.<br />
*'''цикл. листание''' - Циклическое листание таблицы: 0 - выключено; 1 - включено.<br />
*'''листание 360 градусов''' - Разрешено листание в двух направлениях: 0 - выключено; 1 - включено.<br />
*'''затухание''' - Затухание скорости листания таблицы: 0 - выключено; 1 - включено.<br />
<br />
== Добавляемые параметры ==<br />
[[Файл:Table2_1.PNG|right]]<br />
Открывается при нажатии правой кнопки мыши в поле параметров таблицы.<br />
<br />
[[Файл:+.png]] '''ширина настраиваемая'''<br />
*'''ширина колонок''' - Через точку с запятой указываем ширину колонок по-порядку.<br />
[[Файл:+.png]] '''высота настраиваемая'''<br />
*'''высота строчек''' - Через точку с запятой указываем высоту строчек по-порядку.<br />
[[Файл:+.png]] '''добавить ячейку в таблицу'''<br />
*'''текстID''' - Строка (id из редактора строк), отображаемая в ячейке.<br />
*'''текст''' - Строка, отображаемая в ячейке.<br />
*'''картинка''' - Картинка, рисуемая в ячейке (строки игнорируются).<br />
<br />
[[Файл:+.png]] '''изменить состояние объекта''' - при тапе<br />
*'''объект''' - Строка которого мы меняем.<br />
*'''состояние''' - Значение нового состояния.<br />
<br />
[[Файл:+.png]] '''при листании влево - изменить состояние объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании влево - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
[[Файл:+.png]] '''при листании вправо - изменить состояние объекта''' <br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании вправо - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
[[Файл:+.png]] '''при листании вниз - изменить состояние объекта''' <br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании вниз - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
[[Файл:+.png]] '''при листании вверх - изменить состояние объекта''' <br />
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.<br />
*'''состояние''' - Новое состояние для объекта из предыдущего поля.<br />
<br />
[[Файл:+.png]] '''при листании вверх - изменить параметр (свойство) объекта'''<br />
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.<br />
*'''свойство''' - Параметр, который мы изменяем.<br />
*'''значение''' - Новое значение параметра.<br />
<br />
== Состояния таблицы ==<br />
Так же мы можем управлять таблицей изменяя ее состояния.<br />
<br />
*'''first''' - Перелистнуть на первую страницу таблицы.<br />
*'''last''' - Перелистнуть на последнюю страницу таблицы.<br />
*'''prev''' - Перелистнуть на предыдущую страницу таблицы (влево по горизонтали).<br />
*'''next''' - Перелистнуть на следующую страницу таблицы (вправо по горизонтали).<br />
*'''up''' - Перелистнуть на следующую страницу таблицы (вверх по вертикали).<br />
*'''down''' - Перелистнуть на предыдущую страницу таблицы (вниз по вертикали).<br />
*'''refresh''' - Обновить таблицу.<br />
*'''reload''' - перезаполнить таблицу. Необходимо в случае, когда объекты в таблицу добавляются путем установки таблицы в качестве родителя (передаём сразу при смене родителя, после каждой смены родителя).<br />
*'''flyto''' - Таблица плавно приедет к значению curRow и curCol, если они были изменены.<br />
*'''flytopointer''' - перелистывание таблицы на ячейку указанную в параметрах ''pNewCol, pNewRow, pNewIndex''. В таблице должен быть задан указатель. В параметры ''pCurCol, pCurRow, pCurIndex'' будет записываться позиция ячейки на которую указывает пивот указателя.<br />
*'''movetopointer''' - мгновенное перелистывание таблицы на ячейку указанную в параметрах ''pNewCol, pNewRow, pNewIndex''. В таблице должен быть задан указатель. В параметры ''pCurCol, pCurRow, pCurIndex'' будет записываться позиция ячейки на которую указывает пивот указателя.<br />
*'''find'''- состояние, по которому таблица найдет объект, указанный в параметре find_obj и результат поиска запишет в параметр found_Col и found_Row. <br />
<br />
Если изменить таблице значение параметра (текущего рядка или столбика), то после необходимо передать таблице состояние refresh или flyto, чтобы увидеть изменения. При refresh рядок или столбец поменяется мгновенно, при flyto таблица "приплывет" к нужному рядку или столбцу.<br />
<br />
==Вычитываемые параметры==<br />
<br />
*'''maxRow''' - Количество заполненных строк.<br />
*'''maxCol''' - Количество заполненных колонок.<br />
*'''curRow''' - Текущая строка.<br />
*'''curCol''' - Текущая колонка.<br />
*'''clickRow''' - Номер последней нажатой строки.<br />
*'''clickCol''' - Номер последнего нажатого столбца.<br />
*'''pCurCol''' - Номер колонки, на которую указывает пивот указателя. До вызова состояний ''flytopointer'' или ''movetopointer'' pCurCol=-1.<br />
*'''pCurRow''' - Номер строки, на которую указывает пивот указателя. До вызова состояний ''flytopointer'' или ''movetopointer'' pCurRow=-1.<br />
*'''pCurIndex''' - Индекс ячейки, на которую указывает пивот указателя. До вызова состояний ''flytopointer'' или ''movetopointer'' pCurIndex=-1.<br />
<br />
== Использование таблицы для анимации ==<br />
<br />
=== Использование состояния flyto ===<br />
<br />
Иногда нужно получить анимацию выезда (или другого движения) некоторого объекта (окна, рисунка и тд) на экран. Это можно сделать с помощью таблицы. Ниже приведен пример для движения вниз (с постепенным пропаданием объекта из видимости). Делаем следующее: создаем таблицу(ее параметры приведены на рисунке) нужного размера(как минимум, чтобы поместился нужный объект). В нее помещаем 2 объекта: пустой рисунок(при движении он заменит собой движущийся объект) и объект-родитель(image размером 0*0 ), в котором находится объект, который будет двигаться.<br />
<br />
'''Важно!''' Для корректного отображения объекта в таблице, нужно:<br />
* Создать таблицу и разместить ее нужным образом,.<br />
* Разместить объект родитель посередине движущегося объекта <br />
* Поместить движущийся объект в родителя<br />
* Поместить родителя в таблицу<br />
<br />
Если нужно подкорректировать положение объекта в таблице, то нужно изменять именно его координаты. Изменение координат родителя не приведет к смещению объекта на экране вьювера.<br />
<br />
Для запуска анимации таблице нужно изменить значение текущей строки (столбца, при горизонтальном движении), после чего передать ей состояние <br />
flyto. Скорость анимации можно настроить изменяя параметр таблицы - скорость листания.<br />
<br />
[[Файл:Tblanimmove.png|250px|Расположение в дереве проекта]] [[Файл:Animmovestate.png|250px|Машина, запускающая анимацию]] [[Файл:Tableanimmove.png|250px|Параметры таблицы]]<br />
<br />
В объекта-родителя можно помещать не только картинки, но и машины(которые могут реализовывать собственное движение, при этом, при попадании за край таблицы, объект постепенно уходит из зоны видимости). Также в родителя можно поместить еще одну анимацию с помощью таблицы.<br />
<br />
<br />
В данном случае нужно движение по вертикали вниз. Для этого таблица имеет следующие параметры: 1 столбец, 2 строки, нелистаемая( тк не нужно взаимодействовать с объектами ). Принцип работы прост ячейка (1,0) заменяется на (0,0).<br />
<br />
<br />
=== Передвижение предмета под границу окна ===<br />
<br />
Такой же эффект можно достичь, если использовать ректангл. Помещаем окно в ректангл и задаем ему параметр отсечение.<br />
Использование ректангла потребляет меньше ресурсов.<br />
<br />
С помощью таблицы можно ограничить зону видимости предмета на экране. При этом, при выходе за эту зону, объект пропадает из видимости постепенно (эффект вылетания). <br />
<br />
Для этого помещаем наше окно в родительский объект(до помещения окна в родителя, родитель должен находится в центре окна). После создаем таблицу по размеру окна, и располагаем ее на сцене нужным образом. Потом помещаем в нее объект-родитель. Теперь таблица является границами видимости окошка и его элементов. Всё, что будет за границами таблицы будет невидимо. После этого, желательно, поместить таблицу в image 0*0.<br />
<br />
[[Файл:Wndtable.png|250px|Расположение в дереве проекта]][[Файл:Parwndtabl.png|250px|Параметры таблицы]]<br />
<br />
В данном случае у таблицы 1 столбец, 1 строка и 1 ячейка, в которой находится наше окошко. Листаться объекты в таблице не должны, но с ними нужно взаимодействовать. Если отключить листание вообще, то объекты не реагируют на воздействие. Для того, чтобы объекты вели себя корректно, делаем следующее: включаем листание 360 градусов (по горизонтали и вертикали) и выставляем большое значение в параметра "старт листание(чтобы клик по окошку таблица не воспринимала как попытку листания)".<br />
<br />
== Перемещение ячеек таблицы ==<br />
Параметры таблицы:<br />
*'''moveCellColFrom''' - указываем номер ячейки (в столбце), которую хотим переместить<br />
<br />
*'''moveCellRowFrom''' - указываем номер ячейки (в строке), которую хотим переместить<br />
<br />
*'''moveCellColTo''' - указываем номер ячейки (в столбце), в которую хотим вставить нужную нам ячейку <br />
<br />
*'''moveCellRowTo''' - указываем номер ячейки (в строке), в которую хотим вставить нужную нам ячейку<br />
<br />
*'''moveCellAnim''' - (0-выкл, 1-вкл), где 0 - быстрое перемещение ячейки без анимации<br />
<br />
*'''moveCellAnimTime''' - время перемещения ячейки при moveCellAnim = 1<br />
<br />
<br />
Состояние '''moveCell''' - запуск перемещения ячейки<br />
<br />
== Пример ==<br />
<br />
[http://fs5.absolutist.com/files/wikisample/Table.rar Download]<br />
<br />
[[Category:Main objects]]</div>Achet