From Multimedia File
Поток из мультимедийного файла.
Описание
Блок From Multimedia File считывает отсчеты данных аудиофайлов в формате .wav из мультимедийного файла и генерирует сигнал с одним из следующих типов данных и диапазонов амплитуд.
| Тип выходных данных | Диапазон выходной амплитуды |
|---|---|
|
± |
|
± |
|
от до (от до |
|
от до |
Порты
Выход
#
Audio
—
аудиосигнал
скаляр | матрица
Details
Если вектор не скалярный, то он обязательно является матрицей на , где – количество каналов.
| Типы данных |
|
| Поддержка комплексных чисел |
Нет |
Параметры
Основные
# File name — имя мультимедийного файла
Details
Укажите имя мультимедийного файла для чтения.
Допустимо указание как абсолютного пути до файла (начинается с /user), так и относительного. При этом относительный путь определяется от текущей директории (pwd).
Можно также указать только имя файла. В таком случае Engee будет искать файл с таким именем сначала по относительному пути (то есть в текущей директории), а затем в путях поиска: Редактор пути Engee.
| Значение по умолчанию |
|
| Имя для программного использования |
|
| Настраиваемый |
Нет |
| Вычисляемый |
Да |
#
Inherit sample time from file —
наследование периода дискретизации из файла
Логический тип
Details
Включите этот параметр, чтобы блок наследовал период дискретизации из входного мультимедийного файла.
Снимите флажок с этого параметра, чтобы блок использовал период дискретизации, которое вы указали в параметре {blockLibraryPP_blockTypesPP_FromSS_MultimediaSS_FilePP_BasePP_paramsPP_PP_PP_userDefinedSampleTimePP_label.
| Выберите этот параметр, когда вы не знаете предполагаемую частоту дискретизации мультимедийного файла. |
| Значение по умолчанию |
|
| Имя для программного использования |
|
| Настраиваемый |
Нет |
| Вычисляемый |
Нет |
#
Desired sample time —
период дискретизации
SampleTime (вещественное число / вектор из двух вещественных чисел)
Details
Укажите период дискретизации блока.
Зависимости
Чтобы включить этот параметр, снимите флажок с параметра Inherit sample time from file.
| Значение по умолчанию |
|
| Имя для программного использования |
|
| Настраиваемый |
Нет |
| Вычисляемый |
Да |
#
Number of times to play file —
количество проигрываний мультимедийного файла
Вещественное число
Details
Укажите количество раз для воспроизведения входного мультимедийного файла.
Значение по умолчанию Inf означает, что блок повторяет воспроизведение мультимедийного файла до момента остановки симуляции.
| Значение по умолчанию |
|
| Имя для программного использования |
|
| Настраиваемый |
Нет |
| Вычисляемый |
Да |
#
Read range —
диапазон аудио отсчетов
Массив вещественных чисел
Details
Укажите диапазон отсчетов, из которого будет производиться считывание, в виде двухэлементного вектора строк в форме [StartSample EndSample], где StartSample – это отсчет, с которого начинается считывание файла, а EndSample – отсчет, на котором считывание файла останавливается.
| Значение по умолчанию |
|
| Имя для программного использования |
|
| Настраиваемый |
Нет |
| Вычисляемый |
Да |
#
Samples per audio channel —
отсчеты на аудиоканал
Целое число
Details
Укажите количество отсчетов на аудиоканал.
| Значение по умолчанию |
|
| Имя для программного использования |
|
| Настраиваемый |
Нет |
| Вычисляемый |
Да |
Основные
#
Audio output data type —
тип выходных данных аудио
Float64 | Float32 | Int16 | UInt8
Details
Укажите тип данных для аудио отсчетов, выводимых через порт Audio.
| Значения |
|
| Значение по умолчанию |
|
| Имя для программного использования |
|
| Настраиваемый |
Нет |
| Вычисляемый |
Нет |
Дополнительно
Частоты дискретизации
Частота дискретизации, которую использует этот блок, зависит от частоты дискретизации аудиопотоков.
В то время как блок From Multimedia File работает с одной частотой, базовые аудиопотоки могут иметь разную частоту.
Расчеты периода дискретизации, используемые для аудиофайлов
Период дискретизации, который блок получает на выходном порту, определяется так:
,
где – значение параметра Samples per audio channel, а – частота закодированных в wav файле данных.