FireURQ:Особенности реализации URQL: различия между версиями
Содержимое удалено Содержимое добавлено
Евг (обсуждение | вклад) мНет описания правки |
Евг (обсуждение | вклад) мНет описания правки |
||
Строка 24:
btn mylabel(2+2, "четыре"), Кнопка с параметрами
При нажатии на эту кнопку переменная ''mylabel_1'' примет числовое значение '''4''', а переменная '''mylabel_2''' — строковое значение '''"четыре"'''.
==Музыка и звук==
'''FireURQ''' поддерживает множество форматов музыки и звука. Командой '''play''' можно воспроизводить звуки. Музыка воспроизводится командой '''music'''.
===Звуки===
'''play [loop|stop] [<имя файла>[, <громкость>]]'''
имя файла – это имя файла формата WAV/AIFF/MP3/MP2/MP1/OGG
громкость – может принимать значения от '''0''' до '''255'''
Если указать параметр '''loop''', то воспроизведение звука будет зациклено (полезно, если нужно реализовать фоновый эмбиентный звук). Если указан параметр '''stop''', то конкретный звук (все его «ипостаси», если воспроизведение конкретного звука было запущено несколько раз) будет остановлен. Если указать stop и не указать имя файла, то будут остановлены все звуки.
===Музыка===
'''music <имя файла>|stop[, <время в миллисекундах>]'''
имя файла – это имя файла формата WAV/AIFF/MP3/MP2/MP1/OGG, плюс форматы трекерной музыки: XM, IT, S3M, MOD, MTM, UMX. Кроме того, воспроизводится и MIDI-музыка (файлы MID). Также поддерживается формат MO3 (трекерная музыка с OGG-упакованными семплами). Конвертер для превращения любого трекерного формата в MO3 можно скачать с сайта http://un4seen.com/. Если требуется остановить воспроизведение, то вместо имени файла указывается '''stop'''.
время в миллисекундах – время, в течении которого громкость музыки будет нарастать (или угасать – в зависимости от того, включаем мы воспроизведение, или выключаем). Если музыка уже звучит и мы запускаем новый трек с указанием времени нарастания громкости, то будет исполнен эффект crossfade – старый трек будет угасать, а новый – нарастать по громкости.
Для регулировки громкости музыки используется переменная '''music_volume''', которая может принимать значения от '''0''' до '''255'''.
Возможно плавное изменение громкости музыки командой '''fademusic''':
'''fademusic <громкость>, <время в миллисекундах>'''
громкость – целевая громкость музыки.
время в миллисекундах – время, в течении которого громкость достигнет целевого значения.
Кроме того, для музыки поддерживается переменная '''music_looped''', которая принимает два значения: '''1''' и '''0'''. Эта переменная указывает, будет ли воспроизводимая музыка зациклена или проиграет один раз и остановится. По умолчанию равна '''1''' (музыка зацикливается).
Важное замечание: некоторые файлы трекерной музыки зациклены сами по себе, с помощью внутренних команд формата. Такие файлы будут играть по кругу вне зависимости от переменной '''music_looped'''.
===Озвучка локаций===
''' voice <имя файла>
voice stop'''
С помощью команды '''voice''' можно удобно озвучивать локации в квестах. Действие этой команды аналогично действию команды '''play''' – проигрывается звук, указанный в качестве параметра, за несколькими исключениями:
* Озвучка может быть только одна в любой момент времени. Каждая следующая команда voice останавливает предыдущую;
* Переход по кнопке ('''btn''') также останавливает озвучку.
* Громкость озвучки регулируется с помощью переменной '''voice_volume''', а не указывается напрямую в команде.
[[Категория:Документация FireURQ]]
| |||