Skip to main content

Синтаксис

Переходы прописываются у определённых команд после ключевого параметра 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