Здесь показаны различия между двумя версиями данной страницы.
Both sides previous revision Предыдущая версия | |||
help:sound [2023/01/03 11:43] aleks_versus |
help:sound [2024/10/14 12:27] (текущий) aleks_versus обновление 5.9.0 |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
- | |||
[[help:menu|Назад: Меню]] | [[help:menu|Назад: Меню]] | ||
====== Звук ====== | ====== Звук ====== | ||
- | |||
Quest Soft Player позволяет запускать проигрывание различных звуковых файлов. | Quest Soft Player позволяет запускать проигрывание различных звуковых файлов. | ||
- | Внимательно читайте документацию к конкретному плееру, прежде чем запускать звуковые файлы. Все плееры поддерживают ограниченные наборы форматов. Наиболее распространёнными поддерживаемыми форматами считаются ''.mp3'', ''.wav'' и ''.ogg''. | + | Внимательно читайте документацию к конкретному плееру, прежде чем запускать звуковые файлы. Все плееры поддерживают ограниченные наборы форматов. Наиболее распространёнными поддерживаемыми форматами считаются ''%%.mp3%%'', ''%%.wav%%'' и ''%%.ogg%%''. |
===== Возможности классического плеера QSP ===== | ===== Возможности классического плеера QSP ===== | ||
- | * Одновременное звучание до 32-х композиций. | + | * Одновременное звучание до 32-х композиций. |
- | * Поддерживается множество различных аудиоформатов, в т.ч. ''.mp3'', ''.wav'', ''.mid'', ''.ogg'' и другие. | + | * Поддерживается множество различных аудиоформатов, в т.ч. ''%%.mp3%%'', ''%%.wav%%'', ''%%.mid%%'', ''%%.ogg%%'', ''%%.flac%%'' и другие. |
===== Операторы для управления звуковыми файлами ===== | ===== Операторы для управления звуковыми файлами ===== | ||
- | * ''**PLAY**'' — проигрывание указанного звукового файла с заданной громкостью. Общая запись:<sxh qsp> | + | * ''**PLAY**'' — проигрывание указанного звукового файла с заданной громкостью. Общая запись:<sxh qsp> |
- | PLAY [$путь_к_звуковому_файлу],[#громкость] | + | PLAY [$путь_к_звуковому_файлу],[#громкость] |
- | </sxh> , где ''[$путь_к_звуковому_файлу]'' — путь к звуковому файлу относительно файла игры, ''[#громкость]'' — громкость воспроизведения в процентах от 0 до 100. Параметр ''[#громкость]'' может отсутствовать, при этом громкость принимается равной 100%.\\ Примеры:<sxh qsp> | + | </sxh> , где ''[$путь_к_звуковому_файлу]'' — путь к звуковому файлу относительно файла игры, ''[#громкость]'' — громкость воспроизведения в процентах от 0 до 100. Параметр ''[#громкость]'' может отсутствовать, при этом громкость принимается равной 100%.\\ Примеры:<sxh qsp> |
- | !Громкость 100% | + | !Громкость 100% |
- | play 'sound/music.mp3' | + | play 'sound/music.mp3' |
- | !Громкость 50% | + | !Громкость 50% |
- | play 'sound/music.mp3',50 | + | play 'sound/music.mp3',50 |
- | !Громкость 0% (без звука) | + | !Громкость 0% (без звука) |
- | play 'sound/music.mp3',0 | + | play 'sound/music.mp3',0 |
- | </sxh><sxh qsp> | + | </sxh><sxh qsp> |
- | !Проигрывание файла по адресу из переменной $file | + | !Проигрывание файла по адресу из переменной $file |
- | ! с расширением 'mid' | + | ! с расширением 'mid' |
- | ! и громкостью volume | + | ! и громкостью volume |
- | $file="melody" | + | $file="melody" |
- | play '<<$file>>.mid',volume | + | play '<<$file>>.mid',volume |
- | ! аналогично: | + | ! аналогично: |
- | $file="melody.mid" | + | $file="melody.mid" |
- | play $file,volume | + | play $file,volume |
- | </sxh> Если файл уже проигрывается, то изменяется его громкость звучания без "перезапуска". | + | </sxh> Если файл уже проигрывается, то изменяется его громкость звучания без "перезапуска". |
- | * ''**CLOSE**'' — останавливает проигрывание указанного звукового файла. Общая запись:<sxh qsp> | + | * ''**CLOSE**'' — останавливает проигрывание указанного звукового файла. Общая запись:<sxh qsp> |
- | CLOSE [$путь_к_звуковому_файлу] | + | CLOSE [$путь_к_звуковому_файлу] |
- | </sxh> , где ''[$путь_к_звуковому_файлу]'' — путь к звуковому файлу относительно файла игры. Если параметр ''[$путь_к_звуковому_файлу]'' не указан, происходит остановка воспроизведения всех звуковых файлов.<sxh qsp> | + | </sxh> , где ''[$путь_к_звуковому_файлу]'' — путь к звуковому файлу относительно файла игры. Если параметр ''[$путь_к_звуковому_файлу]'' не указан, происходит остановка воспроизведения всех звуковых файлов.<sxh qsp> |
- | close "sound/music.mp3" | + | close "sound/music.mp3" |
</sxh> | </sxh> | ||
- | * ''**CLOSE ALL**'' — остановка проигрывания всех активных звуковых файлов. Имеет краткую форму ''**CLOSE**''.<sxh qsp> | + | * ''**CLOSE ALL**'' — остановка проигрывания всех активных звуковых файлов. Имеет краткую форму ''**CLOSE**''.<sxh qsp> |
- | ! останавливаем все звуки | + | ! останавливаем все звуки |
- | close all | + | close all |
- | ! или так | + | ! или так |
- | close | + | close |
</sxh> | </sxh> | ||
===== Функции для управления звуковыми файлами ===== | ===== Функции для управления звуковыми файлами ===== | ||
- | * ''**ISPLAY**'' — функция проверяет, проигрывается ли в данный момент файл с указанным названием, и если проигрывается, возвращает **1**. В противном случае функция возвращает **0**. Общая запись:<sxh qsp> | + | * ''%%ISPLAY%%'' — функция проверяет, проигрывается ли в данный момент файл с указанным названием, и если проигрывается, возвращает **1**. В противном случае функция возвращает **0**. Общая запись: <sxh qsp> |
- | ISPLAY([$путь_к_файлу]) | + | ISPLAY([$путь_к_файлу]) |
- | </sxh> , где ''[$путь_к_файлу]'' — путь к звуковому файлу относительно файла игры.\\ Пример:<sxh qsp> | + | </sxh> , где ''%%[$путь_к_файлу]%%'' — путь к звуковому файлу относительно файла игры.\\ |
- | if isplay('music/mountsound.mp3'): | + | Пример: <sxh qsp> |
- | *pl 'Проигрывается музыка.' | + | if isplay('music/mountsound.mp3'): *pl 'Проигрывается музыка.' else: *pl 'Музыка не проигрывается.' end |
- | else: | + | |
- | *pl 'Музыка не проигрывается.' | + | |
- | end | + | |
</sxh> | </sxh> | ||
Строка 63: | Строка 58: | ||
Пути к звуковым файлам указываются относительно файла игры. | Пути к звуковым файлам указываются относительно файла игры. | ||
- | Например, если файл игры лежит в папке "''game''", и в той же папке лежит звуковой файл "''music.mp3''", указываем просто название файла: | + | Например, если файл игры лежит в папке "''%%game%%''", и в той же папке лежит звуковой файл "''%%music.mp3%%''", указываем просто название файла: |
<sxh qsp> | <sxh qsp> | ||
Строка 69: | Строка 64: | ||
if isplay("music.mp3"): | if isplay("music.mp3"): | ||
- | "проигрывается музыка" | + | "проигрывается музыка" |
end | end | ||
</sxh> | </sxh> | ||
- | Если файл игры находится в папке "''game''", и в той же папке лежит папка "''snd''", а в ней находится файл "''mistic.mid''", то путь к этому звуковому файлу будет выглядеть, как "''snd/mistic.mid''": | + | Если файл игры находится в папке "''%%game%%''", и в той же папке лежит папка "''%%snd%%''", а в ней находится файл "''%%mystic.mid%%''", то путь к этому звуковому файлу будет выглядеть, как "''%%snd/mystic.mid%%''": |
<sxh qsp> | <sxh qsp> | ||
- | play "snd/mistic.mid",25 | + | play "snd/mystic.mid",25 |
wait 1000 | wait 1000 | ||
- | if isplay("snd/mistic.mid"): | + | if isplay("snd/mystic.mid"): |
- | "Звук ещё не проигрался." | + | "Звук ещё не проигрался." |
else: | else: | ||
- | "Тишина" | + | "Тишина" |
end | end | ||
</sxh> | </sxh> | ||
- | |||
[[help:graphics|Вперёд: Графика]] | [[help:graphics|Вперёд: Графика]] | ||
- | |||