Различия

Здесь показаны различия между двумя версиями данной страницы.

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

Документация QSPСайтФорум

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы

Документация QSP
Сайт Форум