Громкость

VolumeUp("Громкость")

Пояснение Увеличивает основную громкость на 5%, если в качестве параметра не указана громкость в процентах. В противоположном случае увеличивает громкость до заданной в процентах величины: 0-100

Примеры ** Увеличение громкости на 5% VolumeUp() ** Установка громкости величиной 70% VolumeUp("70") ** Установка громкости величиной 20% с использованием числовой переменной volume=20 VolumeUp("volume")

Дополнительная информация Основная громкость является общей для всех выходных каналов.

VolumeDown()

Пояснение Уменьшает основную громкость на 5%. Не требует параметров.

Пример ** Уменьшение громкости на 5% VolumeDown()

Дополнительная информация Основная громкость является общей для всех выходных каналов.

Воспроизведение

FMODConfig("Параметры")

Пояснение Отображает диалоговое окно настройки параметров библиотеки FMOD. С помощью этой команды MMB также позволяет задавать настройки FMOD без вызова диалогового окна. Если вы вызовете команду FMODConfig без параметров... FMODConfig("") ...то появится окно настройки параметров FMOD: Как мы уже говорили, настройки FMOD могут быть заданы непосредственно в команде, предотвращая появление диалогового окна. Для этого используются два параметра, разделенные запятой. С помощью первого параметра вы задаете звуковой драйвер, используя одно из следующих чисел: 1 - DirectX 2 - Windows Media Wave Out 3 - Без звука С помощью второго параметра вы задаете состояние точного режима MPEG с переменным битрейтом (MPEG accurate VBR): 0 - точный режим MPEG выключен 1 - точный режим MPEG включен Вместе с параметрами команда выглядит следующим образом: FMODConfig("1,0") В этом примере зеленым цветом выделен параметр, определяющий конфигурацию звукового драйвера. Коричневым цветом выделен параметр состояния точного режима MPEG.

Примеры ** Вызов диалогового окна настройки параметров FMOD FMODConfig("") ** Задает в качестве звукового драйвера Windows Media Wave Out и отключает точный режим MPEG FMODConfig("2,0") ** Задает в качестве звукового драйвера Direct Sound и включает точный режим MPEG FMODConfig("1,1")

Дополнительная информация Диалоговое окно настройки отображается поверх окна приложения, и приложение будет неактивно до тех пор, пока пользователь не закроет диалоговое окно.

PlaySound("Путь")

Пояснение Воспроизводит файл любого из поддерживаемых форматов (OGG, WMA, ASF, WAV, MOD, MIDI), путь к которому указан в качестве параметра. Путь к файлу должен состоять либо а) путь к файлу + имя аудиофайла, либо б) макропуть + имя аудиофайла

Примеры ** Воспроизведение файла MyMusic.ogg из каталога C:\My Project PlaySound("C:\My Project\MyMusic.ogg") ** Воспроизведение системного файла tada.wav PlaySound("<Windows>\Media\tada.wav") ** Воспроизведение файла Autumn.mid из каталога <SrcDir> PlaySound("<SrcDir>\Autumn.mid")

Дополнительная информация Для получения информации об открытом аудиофайле используйте Константы CBK.

StopSound()

Пояснение Останавливает воспроизведение звука. Эта команда не только прекращает воспроизведение всех аудиофайлов, но и выгружает их из памяти. Не требует параметров.

Пример ** Остановка воспроизведения звука StopSound()

Дополнительная информация Эта команда прекращает воспроизведение всех аудиофайлов, включая фоновую музыку (если она используется).

AudioOpen("Путь")

Пояснение Открывает и воспроизводит файл формата OGG, WMA или ASF, путь к которому указан в параметре команды. Параметр должен содержать либо а) путь к файлу + имя аудиофайла, либо б) макропуть + имя аудиофайла

Примеры ** Воспроизведение файла MyMusic.ogg из каталога C:\My Project AudioOpen("C:\My Project\MyMusic.ogg") ** Воспроизведение файла FourSeasons.wma из каталога <SrcDir> AudioOpen("<SrcDir>\FourSeasons.wma")

Дополнительная информация Для получения информации об открытом аудиофайле используйте Константы CBK. Если путь к файлу не был указан, то MMB отобразит диалоговое окно выбора файла. В диалоговом окне доступно выделение нескольких файлов (с помощью клавиш Ctrl и Shift) - первый файл будет воспроизведен, остальные будут сохранены во внутреннем списке MMB, и доступ к ним можно будет получить с помощью константы <List>.

AudioPlay()

Пояснение Воспроизводит файл формата OGG, WMA или ASF, открытый с помощью команды AudioOpen.

Пример ** Воспроизведение открытого файла AudioPlay()

Дополнительная информация Для получения информации об открытом аудиофайле используйте Константы CBK.

AudioStop()

Пояснение Останавливает воспроизведение файла, запущенного с помощью команды AudioOpen или AudioPlay. Не требует параметров.

Пример ** Остановка воспроизведения звука AudioStop()

AudioPause()

Пояснение Приостанавливает воспроизведение файла, запущенного с помощью команды AudioOpen или AudioPlay. Не требует параметров.

Пример ** Приостановка воспроизведения звука AudioPause()

AudioRewind("Секунды","Параметры")

Пояснение Прокручивает аудиофайл, открытый и воспроизводимый с помощью команд AudioOpen или AudioPlay, до заданной позиции (в секундах). Первый параметр задает число секунд для прокрутки. Второй параметр необязательный, используемый для относительной прокрутки. Чтобы воспользоваться им, укажите: RELATIVE ...в качестве второго параметра команды.

Примеры ** Прокрутка аудиофайла до 125 секунды AudioRewind("125","") ** Прокрутка аудиофайла на 20 секунд вперед AudioRewind("20","RELATIVE")

Дополнительная информация Для создания полосы прокрутки изучите Матрицы изображений.

BackgroundPlay("Путь","Параметры")

Пояснение Открывает и воспроизводит в качестве фоновой музыки файл любого из поддерживаемых форматов, путь к которому указан в первом параметре команды. Первый параметр должен содержать либо а) путь к файлу + имя аудиофайла, либо б) макропуть + имя аудиофайла Второй параметр необязательный и с его помощью вы можете зациклить воспроизведение заданного файла. Параметр выглядит так: LOOP

Примеры ** Воспроизведение файла MyMysic.ogg из каталога <SrcDir> в качестве фоновой музыки BackgroundPlay("<SrcDir>\MyMusic.ogg","") ** Зацикленное воспроизведение файла Beat.wav из каталога <CD> BackgroundPlay("<CD>\Beat.wav","LOOP")

Дополнительная информация Для получения информации об открытом аудиофайле используйте Константы CBK.

BackgroundPause()

Пояснение Приостанавливает воспроизведение фоновой музыки, запущенной с помощью команды BackgroundPlay. Не требует параметров.

Пример ** Приостановка воспроизведения фоновой музыки BackgroundPause()

BackgroundStop()

Пояснение Останавливает воспроизведение фоновой музыки, запущенной с помощью команды BackgroundPlay. Не требует параметров.

Пример ** Остановка воспроизведения фоновой музыки BackgroundStop()

WavePlay("Путь","Параметры")

Пояснение Открывает и воспроизводит файл формата WAVE, путь к которому указан в первом параметре команды. Первый параметр должен содержать либо а) путь к файлу + имя аудиофайла, либо б) макропуть + имя аудиофайла Второй параметр необязательный и с его помощью вы можете зациклить воспроизведение заданного файла. Параметр выглядит так: LOOP

Примеры ** Воспроизведение файла MyMysic.wav из каталога C:\My Project WavePlay("C:\My Project\MyMusic.wav","") ** Зацикленное воспроизведение файла FourSeasons.wav из каталога <SrcDir> WavePlay("<SrcDir>\FourSeasons.wav","LOOP") ** В том случае, если файл вложенный, то не используйте полный путь.. просто укажите имя, которое задано в окне Вложенный звук WavePlay("FourSeasons","")

Дополнительная информация Для получения информации об открытом аудиофайле используйте Константы CBK. Если путь к файлу не был указан, то MMB отобразит диалоговое окно выбора файла. В диалоговом окне доступно выделение нескольких файлов (с помощью клавиш Ctrl и Shift) - первый файл будет воспроизведен, остальные будут сохранены во внутреннем списке MMB, и доступ к ним можно будет получить с помощью константы <List>.

WaveStop()

Пояснение Останавливает воспроизведение файла, запущенного с помощью команды WavePlay. Не требует параметров.

Пример ** Остановка воспроизведения wav-файла WaveStop()

MidiPlay("Путь","Параметры")

Пояснение Открывает и воспроизводит файл формата MIDI, путь к которому указан в первом параметре команды. Первый параметр должен содержать либо а) путь к файлу + имя аудиофайла, либо б) макропуть + имя аудиофайла Второй параметр необязательный и с его помощью вы можете зациклить воспроизведение заданного файла. Параметр выглядит так: LOOP

Примеры ** Воспроизведение файла MyMysic.mid из каталога C:\My Project MidiPlay("C:\My Project\MyMusic.mid","") ** Зацикленное воспроизведение файла FourSeasons.mid из каталога <SrcDir> MidiPlay("<SrcDir>\FourSeasons.mid","LOOP")

Дополнительная информация Для получения информации об открытом аудиофайле используйте Константы CBK. Если путь к файлу не был указан, то MMB отобразит диалоговое окно выбора файла. В диалоговом окне доступно выделение нескольких файлов (с помощью клавиш Ctrl и Shift) - первый файл будет воспроизведен, остальные будут сохранены во внутреннем списке MMB, и доступ к ним можно будет получить с помощью константы <List>.

MidiStop()

Пояснение Останавливает воспроизведение файла, запущенного с помощью команды MidiPlay. Не требует параметров.

Пример ** Остановка воспроизведения mid-файла MidiStop()

ModOpen("Путь")

Пояснение Открывает файл формата MOD, путь к которому указан в параметре команды. Параметр должен содержать либо а) путь к файлу + имя аудиофайла, либо б) макропуть + имя аудиофайла

Примеры ** Открытие файла MyMysic.mod из каталога C:\My Project ModOpen("C:\My Project\MyMusic.mod") ** Открытие файла FourSeasons.mod из каталога <SrcDir> ModOpen("<SrcDir>\FourSeasons.mod")

Дополнительная информация Для получения информации об открытом аудиофайле используйте Константы CBK. Если путь к файлу не был указан, то MMB отобразит диалоговое окно выбора файла. В диалоговом окне доступно выделение нескольких файлов (с помощью клавиш Ctrl и Shift) - первый файл будет воспроизведен, остальные будут сохранены во внутреннем списке MMB, и доступ к ним можно будет получить с помощью константы <List>.

ModPlay()

Пояснение Воспроизводит файл формата MOD, открытый с помощью команды ModOpen. Не требует параметров.

Пример ** Воспроизведение mod-файла ModPlay("")

ModStop()

Пояснение Останавливает воспроизведение файла, открытого и воспроизводимого с помощью команд ModOpen и ModPlay. Не требует параметров.

Пример ** Остановка воспроизведения mod-файла ModStop()

Воспроизведение аудио CD

CDPlay()

Пояснение Начинает воспроизведение аудио CD с первого трека.

Пример ** Воспроизведение аудио CD с первого трека CDPlay()

Дополнительная информация Для получения информации о компакт-диске используйте Константы CBK.

CDStop()

Пояснение Останавливает воспроизведение аудио CD.

Пример ** Остановка воспроизведения аудио CD CDStop()

CDPause()

Пояснение Приостанавливает воспроизведение аудио CD.

Пример ** Приостановка воспроизведения аудио CD CDStop()

CDTrack("НомерТрека")

Пояснение Воспроизводит указанный трек. Параметр задает номер трека, например: 4 В этом случае команда начнет воспроизведение четвертого трека.

Пример ** Воспроизведение шестого трека CDTrack("6")

Дополнительная информация Диски стандарта Mixed-mode CD используют первый трек для размещения данных, поэтому первым аудиотреком на таком диске будет трек номер 2.

CDForward()

Пояснение Воспроизводит следующий аудиотрек.

Пример ** Воспроизведение следующего трека CDForward()

CDBackward()

Пояснение Воспроизводит предыдущий аудиотрек.

Пример ** Воспроизведение предыдущего трека CDBackward()

CDPlayPause()

Пояснение Пауза или продолжение воспроизведения аудио CD. Если воспроизведение было приостановлено/прервано, то с помощью этой команды оно будет продолжено. В противоположном случае оно будет приостановлено. Это полезно при создании кнопки, одновременно выполняющей функцию воспроизведения и паузы.

Пример ** Продолжение воспроизведения или приостановка аудио CD CDPlayPause()

CDSkipForward()

Пояснение Устанавливает позицию текущего аудиотрека на 10 секунд вперед.

Пример ** Прокрутка текущего трека на 10 секунд вперед CDSkipForward()

CDSkipBackward()

Пояснение Устанавливает позицию текущего аудиотрека на 10 секунд назад.

Пример ** Прокрутка текущего трека на 10 секунд назад CDSkipBackward()

WhichCDTrack("Переменная")

Пояснение Определяет номер текущего аудиотрека и помещает результат в числовую переменную, имя которой указано в качестве параметра. Параметр задает имя переменной, которая будет содержать номер воспроизводимого трека. Например: TrackNumber В полном виде команда выглядит так: WhichCDTrack("TrackNumber") После выполнения этой строки кода, числовая переменная TrackNumber будет содержать номер текущего трека. Теперь вы можете, к примеру, отобразить его: Message("Текущий аудиотрек:","TrackNumber")

Пример ** Определение номера текущего трека и отображение значения в текстовом объекте AudioTrack WhichCDTrack("TrackNumber") DisplayValue("AudioTrack","TrackNumber")

Дополнительная информация Диски стандарта Mixed-mode CD используют первый трек для размещения данных, поэтому первым аудиотреком на таком диске будет трек номер 2.

Аудиовизуализация

AudioVisualizationType("ИмяОбъекта","Тип")

Пояснение Задает тип аудиовизуализации. Использует два параметра - первый параметр задает имя объекта аудиовизуализации, для которого вы хотите изменить тип. Например, AudioVis Второй параметр задает тип аудиовизуализации: ANALYZER OSCILLOSCOPE

Примеры ** Задает для объекта AudioVis тип визуализации "Эквалайзер" AudioVisualizationType("AudioVis","ANALYZER") ** Задает для объекта AudioVis тип визуализации "Осциллограф" AudioVisualizationType("AudioVis","OSCILLOSCOPE")

Дополнительная информация Аудиовизуализация поддерживается форматами OGG, WAV, XM, S3M, IT и MOD.

AudioVisualizationColor("ИмяОбъекта","Параметры")

Пояснение Задает цвет элементов аудиовизуализации. Первый параметр задает имя объекта аудиовизуализации, для которого вы хотите изменить цвет. Например, AudioVis Второй параметр задает цвет визуализации. Настройка цвета осуществляется с помощью системы RGB, состоящей из 3 компонентов: Красный (Red), Зеленый (Green), Синий (Blue). Каждый из компонентов может быть задан одним из 256 уровней. Чем больше значение уровня, тем больше интенсивность соответствующего компонента. Если вы укажете значение 0, то данный компонент использоваться не будет. Значение 255 указывает на максимальную интенсивность цвета. Параметр цвета для аудиовизуализации является строковым массивом из трех разделенных запятыми элементов, представляющих цвета RGB в диапазоне значений 0 - 255. R,G,B Результат 128,5,64   R,G,B Результат 0,255,255   Оба типа визуализации имеют фоновый цвет который может быть изменен с помощью следующего параметра: BACKGROUND=R,G,B Подставляя конкретные числовые значения RGB: BACKGROUND=150,79,205 Визуализация типа Эквалайзер использует два цвета: Сначала вы задаете значения RGB для основания: 255,0,0 И после запятой добавляете значения RGB для вершины: 0,0,255 В полном виде второй параметр для эквалайзера выглядит так: 255,0,0,0,0,255 Визуализация типа Осциллограф использует только один цвет (цвет линии): Пример значений RGB для цвета линии осциллографа: 255,0,0

Примеры ** Задает цвет фона для объекта аудиовизуализации AudioVis AudioVisualizationColor("AudioVis","BACKGROUND=150,79,205") ** Задает цвет основания и вершин эквалайзера для объекта аудиовизуализации AudioVis AudioVisualizationColor("AudioVis","255,0,0,0,0,255") ** Задает цвет линии осциллографа для объекта аудиовизуализации AudioVis AudioVisualizationColor("AudioVis","255,0,0") ** Более сложный пример с использованием команды ColorPicker() BGColor$='' ColorPicker() BGColor$=CBK_SelColor If (BGColor$>'') Then   AudioVisualizationColor("AudioVis","BACKGROUND=BGColor$") End Этот скрипт открывает диалоговое окно выбора цвета и позволяет вам выбрать цвет, затем заменяет текущий цвет фона выбранным.

Дополнительная информация Аудиовизуализация поддерживается форматами OGG, WAV, XM, S3M, IT и MOD.