Различия

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

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

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

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

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

Различия

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

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