Синтаксис
Переходы прописываются у определённых команд после ключевого параметра with
.
В качестве значения может быть указано название перехода и его параметры, или сокращенное имя из заранее определённого списка (также существует встроенный в игру список).
Параметры перехода указываются после его названия в том порядке, в котором они прописаны в документации. Если у каких-то параметров есть значение по умолчанию, их можно не указывать — но только в том случае, если параметры, стоящие после, тоже не планируется использовать.
В противном же случае можно явно указать название параметров и их значения, при этом порядок неважен, и часть параметров (если у них есть значения по умолчанию) можно пропустить.
Это делается при помощи символа :
(двоеточие), которое разделяет название параметра и его значение:
with [название перехода] параметр:значение параметр2:значение
Рассмотрим на примере перехода crossfade
спрайтов: у данного перехода есть два параметра — fadeOut
и fadeIn
, которые отвечают за продолжительность исчезновения активного спрайта и появление нового соответственно. У обоих параметров есть значения по умолчанию, поэтому указывать их необязательно.
Попробуем указать значение параметра fadeIn
, не указывая при этом fadeOut
:
# выводим спрайт Химицу
show hi with dissolve
"..."
# применяем переход crossfade, указав нужный параметр
show hi at right with crossfade fadein:3
Таким образом активный спрайт Химицу исчезнет через 0.5 секунд — именно такое значение по умолчанию у fadeOut
— а новый спрайт появится справа через 3 секунды.
Демонстрация
При использовании такого синтаксиса должны быть указаны явно названия всех параметров, значения которых планируется изменить.
Если бы мы использовали короткий синтаксис, пришлось бы дополнительно указывать значение для fadeOut
:
# выводим спрайт Химицу
show hi with dissolve
"..."
# применяем переход crossfade; делает то же самое, что и в предыдущем примере
show hi at right with crossfade 0.5 3