# Экран (screen)

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

### Fade

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

```
fade (fadeOut) (hold) (fadeIn) (color)
```

- `fadeOut` — продолжительность затемнения в секундах.   
    По умолчанию 0.5 секунд.
- `hold` — продолжительность паузы после затемнения в секундах.  
    По умолчанию 1 секунда.
- `fadeIn` — продолжительность исчезновения затемнения в секундах.  
    По умолчанию 0.5 секунд.
- `color` — цвет затемнения, может быть ID цвета или его значение.  
    По умолчанию чёрный.

<details id="bkmrk-%D0%94%D0%B5%D0%BC%D0%BE%D0%BD%D1%81%D1%82%D1%80%D0%B0%D1%86%D0%B8%D1%8F-scene-b"><summary>Демонстрация</summary>

```
scene bg akihibara_day
"..."
with fade 1 1 1 red
"..."
```

</details>### Hpunch / Vpunch

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

```
hpunch (duration) (strength) (vibrato) (randomness) (fadeOut)
```

- `duration` — продолжительность тряски в секундах.  
    По умолчанию 1.
- `strength` — сила тряски.  
    По умолчанию 3.
- `vibrato` — сила вибрации.  
    По умолчанию 10.
- `randomness` — значение от 0 до 180, определяет, насколько направление тряски будет случайным.  
    По умолчанию 0.
- `fadeOut` — булевое значение. Если true, то тряска закончится плавно.  
    По умолчанию true.

<details id="bkmrk-hpunch-scene-bg-akih"><summary>hpunch</summary>

```
scene bg akihibara_day
"..."
with hpunch
"..."
```

</details><details id="bkmrk-vpunch-scene-bg-akih"><summary>vpunch</summary>

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

</details>