Переходы

Синтаксис

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

Фоны (background)

Список переходов, которые можно использовать с командой scene.

Dissolve

dissolve [duration] (useLerp)
Демонстрация
1
scene bg akihibara_day
"..."
window hide
scene bg akihibara_night with dissolve 2
pause hard 2
"..."

2
scene bg akihibara_day
"..."
window hide
scene bg akihibara_night with dissolve 2 true
pause hard 2
"..."

Fade

fade [fadeOut] [hold] [fadeIn] (color)
Демонстрация
1
scene bg akihibara_day
"..."
window hide
scene bg akihibara_night with fade 1 2 1 yellow
pause hard 2
"..."

Pattern

pattern [pattern] (duration)
Демонстрация
1
scene bg akihibara_day
"..."
window hide
scene bg akihibara_night with pattern bottomleft 2
pause hard 2
"..."

SlideIn

slidein [direction] (duration)
Демонстрация
1
scene bg akihibara_day
"..."
window hide
scene bg akihibara_night with slidein left 2
pause hard 2
"..."

SlideOut

slideout [direction] (duration)
Демонстрация
1
scene bg akihibara_day
"..."
window hide
scene bg akihibara_night with slideout left 2
pause hard 2
"..."

Спрайты (character)

Список переходов, которые можно использовать с командой show.

Crossfade

Одновременно меняет прозрачность у активного спрайта и его замены.

crossfade (fadeOut) (fadeIn)
Демонстрация
scene bg akihibara_day
"..."
show hi
"..."
window hide
show hi oldforma with crossfade 1 1
pause hard 2
"..."

TrueDissolve

Выводит новый спрайт позади активного, затем уменьшает прозрачность активного.

truedissolve [duration]
Демонстрация
scene bg akihibara_day
"..."
show hi
"..."
window hide
show hi plate with truedissolve 1
pause hard 2
"..."

Dissolve

Вариативный переход, объединяющий в себе Crossfade и TrueDissolve.

В случае, если у спрайтов совпадают значения CharID и PoseID, будет использован переход TrueDissolve, в противном случае — Crossfade.

dissolve [duration]

Fade

Убирает активный спрайт, затем после определённой паузы выводит новый (если используется в команде hide, то просто убирает).

fade [fadeIn] [hold] [fadeOut]
Демонстрация
scene bg akihibara_day
"..."
show hi
"..."
window hide
show hi plate with fade 0.5 1 0.5
pause hard 2
"..."

Экран (screen)

Список переходов экрана, которые можно использовать с командой with.

Fade

Затемняет экран, затем после определённой паузы убирает затемнение.

fade (fadeOut) (hold) (fadeIn) (color)
Демонстрация
scene bg akihibara_day
"..."
with fade 1 1 1 red
"..."

Hpunch / Vpunch

Горизонтальная / вертикальная встряска экрана.

hpunch (duration) (strength) (vibrato) (randomness) (fadeOut)
hpunch
scene bg akihibara_day
"..."
with hpunch
"..."

vpunch
scene bg akihibara_day
"..."
with vpunch
"..."