Полный перевод раздела Command Reference -> 2D-Category -> Sound/Music из стандартного хелпа Blitz.
|
LoadSound (файл$)
Параметры файл$ = имя звукового файла. Поддерживаемые форматы: raw/wav/mp3/ogg Описание Эта команда загружает звук в память. Она возвращает число, если все прошло успешно, или 0, если возникла проблема при загрузке звука. Вы должны присвоить значение, которое возвращает данная команда, переменной (предпочтительно созданной как Global) для дальнейшего воспроизведения (командой PlaySound). См. пример. Пример Код:
; Глобальная переменная для звука |
FreeSound переменная_звука
Параметры переменная_звука = переменная, которой ранее был назначен звук командой LoadSound Описание Если вы больше не используете звуковой эффект, вам следует очистить память, использованную для этого звука и удалить его. Эта команда удалит звук, назначенный переменной, созданной командой LoadSound. Зачем это нужно делать? Вероятно, у вас имеются разные наборы звуков для разных уровней вашей игры. Вероятно, фоновая музыка у вас меняется от уровня к уровню. В таком случае действительно правильным решением будет упорядочивание игровых ресурсов. Даже если вы можете загружать любой звук для всей игры сразу, примите во внимание тех, у кого нет столько памяти на компьютере, сколько есть у вас. Вы же хотите быть уверенным, что ваша игра будет доступна как можно большему количеству людей. Примечание: вы не должны вручную очищать память, когда ваша программа заканчивает свое выполнение, Blitz сделает это сам. Пример Код:
; Загрузить звук в память |
LoopSound переменная_звука
Параметры переменная_звука = переменная, которой ранее был назначен звук командой LoadSound Описание Эта команда устанавливает бесконечное проигрывание звукового файла (.WAV или .MP3), например, для фоновой музыки. Вы должны загрузить звук и назначить его переменной командой LoadSound. Используйте переменную, созданную как Global, чтобы быть уверенным, что ваш звук будет воспроизводиться из любого места программы. Примечание: эта команда в действительности не воспроизводит звук бесконечно, только устанавливает бесконечное проигрывание для конкретного звука. Необходимо использовать команду PlaySound, чтобы воспроизвести сам звук. Пример Код:
; Глобальная переменная для звука |
SoundPitch переменная_звука, частота
Параметры переменная_звука = переменная, которой ранее был назначен звук командой LoadSound частота = допустимая частота проигрывания (до 44000 герц) Описание Изменяет тон («высоту») звука, предварительно загруженного командой LoadSound. Изменяя тон, вы можете многократно использовать один звук в разных целях или сделать для него эффект «понижения»/«повышения» (например, как звук двигателя). Чтобы сделать звук «выше», увеличьте частоту. И наоборот, уменьшение частоты приведет к «понижению» звука. Примечание: эффект зависит от начальной частоты звука Пример Код:
; Загрузить звук (11,000 герц) |
SoundVolume переменная_звука, громкость#
Параметры переменная_звука = переменная, которой ранее был назначен звук командой LoadSound громкость# = дробное значение от 0 (тишина) до 1 (полная громкость) Описание Изменяйте громкость воспроизведения звукового эффекта этой командой. Она использует дробное число от 0 до 1, чтобы контролировать уровень громкости. См. ChannelVolume для большей ясности. Пример Код:
; Загрузить звук |
SoundPan переменная_звука, смещение#
Параметры переменная_звука = переменная, которой ранее был назначен звук командой LoadSound смещение# = дробное число от –1 (лево) до 1 (право), 0 – центр Описание Используйте эту команду, чтобы «сместить» (или «центрировать») звуковой эффект между левой и правой колонками. Она позволит создать эффект крутого стереозвучания в вашей игре. Пример Код:
; Загрузить звуковой файл |
PlaySound (переменная_звука)
Параметры переменная_звука = переменная, которой ранее был назначен звук командой LoadSound Описание Эта команда воспроизводит предварительно загруженный и назначенный переменной с помощью команды LoadSound звук. См. пример. Вам потребуется назначить переменную-указатель канала звуку, когда вы воспроизводите его. Все последующие команды, обращающиеся к звуку, требуют от вас использования переменной КАНАЛА, а не звука. Такими командами являются StopChannel, PauseChannel, ResumeChannel, ChannelPitch, ChannelVolume, ChannelPan и ChannelPlaying. Пример Код:
; Глобальная переменная для звука |
PlayMusic (файл$)
Параметры файл$ = имя музыкального файла. Поддерживаемые форматы: raw/mod/s3m/xm/it/mid/rmi/wav/mp2/mp3/ogg/wma/asf Описание Эта команда загрузит и воспроизведет музыкальный файл. Вы ДОЛЖНЫ использовать переменную канала для того, чтобы остановить или отрегулировать проигрываемую музыку. Можно также использовать StopChannel, PauseChannel, ResumeChannel и др. с этой командой. Нельзя предварительно загрузить мелодию, как звук командой LoadSound. Каждый раз, когда вы используете команду PlayMusic, файл загружается, и музыка сразу же проигрывается. Это значит, что если вы используете эту команду, в то время, как на экране происходит какое-нибудь действие, может появиться небольшая пауза, пока будет происходить поиск необходимого файла на жестком диске. Чтобы избежать этого, можно использовать команды PlaySound/LoopSound вместо PlayMusic. Пример Код:
; Загрузить и проиграть фоновую музыку |
PlayCDTrack (трек,[режим] )
Параметры трек = номер трека для проигрывания режим = 1: проиграть трек один раз; 2: проигрывать бесконечно; 3: проиграть до конца комакт-диска Описание Команда проигрывает трек с компакт-диска и возвращает указатель на канал. Необязательный параметр режим позволяет проигрывать трек разными способами. Запомните, что воспроизведение происходит через кабель внутри компьютера, который соединяет CR-ROM и звуковую карту. На многих компьютерах (по каким-либо причинам) данный кабель не подключен. В этом случае вы НЕ услышите звук с компакт-диска, даже если слышите остальные звуковые эффекты и музыку. Пример Код:
; PlayCDTrack – пример использования |
StopChannel указатель_на_канал
Параметры указатель_на_канал = переменная, назначенная каналу Описание Эта команда заменила StopSound в более поздней версии Blitz Basic. Если воспроизводится звук, и он назначен переменной канала, используйте эту команду, чтобы остановить звук. Она работает со всеми типами звуковых каналов, включая MP3, WAV, MIDI и треки с компакт-диска. Пример Код:
; Примеры с каналами |
PauseChannel указатель_на_канал
Параметры указатель_на_канал = переменная, назначенная каналу Описание При проигрывании звукового канала может наступить момент, когда вам потребуется его приостановить (например, для воспроизведения другого звукового эффекта). Эта команда делает вышесказанное. Воспроизведение канала можно возобновить путем использования ResumeChannel. Используйте StopChannel для полной остановки звука. Работает с любым типом канала (в WAV, MP3, MIDI и др.). Пример Код:
; Примеры с каналами |
ResumeChannel канал
Параметры канал = музыкальный или звуковой канал, предварительно загруженный командами LoadSound, PlayMusic или др. Описание ResumeChannel используется для возобновления воспроизведения звукового или музыкального канала после того, как вы временно его приостановили (PauseChannel). Пример Код:
Graphics 640, 480, 0, 2 |
ChannelPitch указатель_на_канал, частота
Параметры указатель_на_канал = переменная, назначенная каналу частота = значение тона («высоты») канала (попробуйте 8000-44000) Описание Вы можете изменять тон звукового канала, который воспроизводится, приостановлен или просто определен в программе. Я уверен, вы найдете множество применений этой команде! Используйте частоту вашего звука как основу для изменения тона. Если ваш звук имеет начальную частоту 11025 герц, увеличьте частоту до 22050, чтобы удвоить «высоту» звука, 8000 – чтобы ее уменьшить и т.д. Хоть эта команда и похожа на SoundPitch, она позволяет изменять тон каждого отдельно взятого канала, используемого в вашей программе. Пример Код:
; Примеры с каналами |
ChannelVolume указатель_на_канал, громкость#
Параметры указатель_на_канал = переменная, назначенная каналу громкость# = уровень громкости, дробное значение между 0 и 1 Описание Если SoundVolume благополучно изменяет громкость во всей программе, то эта команда позволяет вам изменять громкость для каждого отдельно взятого канала. Очень полезно. Значение громкости дробное, находится в пределах между 0 и 1 (0=тишина, .5=половина громкости, 1=полная громкость). Вы можете также использовать другие крутые примочки, как ChannelPitch и ChannelPan! Пример Код:
; Примеры с каналами |
Часовой пояс GMT +4, время: 16:35. |
vBulletin® Version 3.6.5.
Copyright ©2000 - 2024, Jelsoft Enterprises Ltd.
Перевод: zCarot