exponenta event banner

Из мультимедийного файла

Поток из мультимедийного файла

Библиотека

Источники

dspsrcs4

  • From Multimedia File blockFrom Multimedia File block

Описание

Блок From Multimedia File считывает выборки звука, видеокадры или оба из мультимедийного файла и генерирует сигнал с одним из следующих типов данных и диапазонов амплитуд.

Тип выходных данныхДиапазон выходной амплитуды

double

±1

single

±1

int16

от -32768 до 32767 (от -215 до 215 - 1)

uint8

от 0 до 255

Блок импортирует данные из файла в модель Simulink ® .

Примечание

Этот блок поддерживает создание кода для хост-компьютера, на котором доступен файловый ввод-вывод. Этот блок нельзя использовать с программным обеспечением Simulink Desktop Real-Time™, так как этот продукт не поддерживает файловый ввод-вывод.

Созданный для этого блока код основан на предварительно созданных файлах библиотеки. Этот код можно запустить вне среды MATLAB ® или повторно развернуть, но при этом следует учитывать эти дополнительные файлы библиотеки. Функция packNGo создает один zip-файл, содержащий все части, необходимые для выполнения или восстановления этого кода. ПосмотритеpackNGo (Simulink Coder) для получения дополнительной информации.

Чтобы запустить исполняемый файл, созданный из модели, содержащей этот блок, может потребоваться добавить предварительно скомпилированные файлы общей библиотеки к системному пути. Дополнительные сведения см. в разделе Общие сведения о создании кода C в инструментарии системы DSP.

Поддерживаемые платформы и типы файлов

Поддерживаемые форматы файлов зависят от кодеков, установленных в системе.

Поддерживаемые платформы Windows форматы файлов

С необходимыми кодеками Windows ® DirectShow, установленными в вашей системе, блок «Из мультимедийного файла» поддерживает множество форматов видео и аудиофайлов. Этот блок лучше всего работает на платформах с версией 9.0 или более поздней версии ПО DirectX ®.

В следующей таблице перечислены наиболее распространенные форматы файлов.

Типы мультимедиаРасширения имен файлов
Файлы изображений.jpg,.bmp,.png
Видеофайлы.qt, .mov, .avi, .asf, .asx, .wmv, .mpg, .mpeg, .mp2, .mp4, .m4v
Аудиофайлы.wav, .wma, .avi, .aif, .aifc, .aiff, .mp3, .au, .snd, .mp4, .m4a, .flac, .ogg

По умолчанию файлы изображений: .png, для видеофайлов .avi, а для аудиофайлов - .mp3.

Windows 7 и более поздние версии Windows поставляются с ограниченным набором 64-разрядных видео и аудиокодеков. Если блок Из мультимедийного файла не может работать со сжатым мультимедийным файлом, сохраните мультимедийный файл в формате, поддерживаемом блоком.

При использовании Windows используйте проигрыватель Windows Media ® версии 11 или более поздней с этим блоком для получения наилучших результатов .

Форматы файлов, не поддерживаемые платформой Windows

В следующей таблице перечислены наиболее распространенные форматы файлов.

Типы мультимедиаРасширения имен файлов
Видеофайлы.avi, .mj2, .mov, .mp4,.m4v
Аудиофайлы.avi, .mp3, .mp4, .m4a, .wav, .flac, .ogg, .aif, .aifc, .aiff, .au, .snd

По умолчанию видеофайлы: .avi, а для аудиофайлов - .mp3.

Порты

Выходные порты блока Из мультимедийного файла изменяются в соответствии с содержимым мультимедийного файла. Если файл содержит только видеокадры, на блоке появляются порты Image, intensity I или R, G, B. Если файл содержит только образцы звука, на блоке появляется порт Audio. Если файл содержит как аудио, так и видео, можно выбрать данные для передачи. В следующей таблице описаны доступные порты.

ПортОписание
Изображение

Цветовой видеосигнал M-by-N-by-P, где P - количество цветовых плоскостей.

Я

Матрица M-на-N значений интенсивности.

R, G, B

Матрица, представляющая одну плоскость видеопотока RGB. Выходы портов R, G или B должны иметь одинаковые размеры.

Аудио

Вектор аудиоданных.

Y, Cb, Cr

Матрица, представляющая один кадр видеопотока YCbCr. Порты Y, Cb, Cr обеспечивают следующие выходные сигналы:

Y: M x N
Cb: M xN2
Cr: M xN2

Показатели выборки

Частота дискретизации, используемая блоком, зависит от частоты дискретизации аудио и видео. В то время как блок FMMF работает с одной скоростью в Simulink, лежащие в его основе аудио- и видеопотоки могут создавать разные скорости. В некоторых случаях, когда блок выводит как аудио, так и видео, делает небольшую регулировку скорости видео.

Пример расчета времени, используемого для видео- и аудиофайлов

Время выборки = ceil (AudioSampleRateFPS) AudioSampleRate .
Когда время выборки звука AudioSampleRateFPS не интегрировано, уравнение не может быть уменьшено до 1FPS.

В этом случае для предотвращения проблем синхронизации блок сбрасывает соответствующий видеокадр, когда аудиопоток ведет видеопоток более чем на 1FPS.
Таким образом, блок выводит один видеокадр на каждом временном шаге Simulink. Для вычисления количества отсчетов звука, выводимых на каждом временном шаге, блок делит частоту отсчетов звука на частоту кадров видео (fps). Если частота дискретизации звука не делится равномерно на количество видеокадров в секунду, блок округляет количество дискретизированных звуковых сигналов до ближайшего целого числа. При необходимости блок периодически сбрасывает видеокадр для поддержания синхронизации для больших файлов.

Диалоговое окно

Главная вкладка

Имя файла

Укажите имя мультимедийного файла для чтения. Блок определяет тип файла (аудио и видео, только аудио или только видео) и предоставляет соответствующие параметры.

Если расположение файла не указано в пути MATLAB, используйте кнопку «Обзор» для указания полного пути. В противном случае, если местоположение этого файла указано в пути MATLAB, введите только имя файла. На платформах Windows этот параметр поддерживает URL-адреса, указывающие на потоки MMS (Microsoft Media Server).

Наследование времени образца из файла

Установите флажок Наследовать время выборки из файла (Inherit sample time from file), если требуется, чтобы время выборки блока совпадало с временем для мультимедийного файла. Если этот флажок снят, введите время блочной выборки в поле Требуемый параметр времени выборки. Файл, на который ссылается блок «Из мультимедийного файла», определяет время выборки блока по умолчанию. Можно также вручную задать время выборки для этого блока. Если вы не знаете предполагаемую частоту дискретизации видео, пусть блок наследует частоту дискретизации из мультимедийного файла.

Требуемое время выборки

Укажите время выборки блока. Этот параметр становится доступным, если снять флажок Наследовать время образца из файла (Inherit sample time from file).

Количество воспроизведений файла

Введите положительное целое число или inf для представления количества воспроизведений файла.

Диапазон считывания

Укажите диапазон выборки, из которого будет считываться двухэлементный вектор строки в виде [StartSample EndSample], где StartSample - образец, с которого начинается чтение файла, а EndSample - образец, с которого прекращается чтение файла.

По умолчанию используется значение [1 Inf].

Выходной индикатор конца файла

Этот флажок используется для определения того, является ли вывод последним видеокадром или образцом звука в мультимедийном файле. Если этот флажок установлен, на блоке появляется логический выходной порт с меткой EOF. Выходной сигнал порта EOF по умолчанию равен 1, когда последний видеокадр или звуковой образец выводится из блока. В противном случае выходные данные порта EOF по умолчанию равны 0.

Мультимедийные выходы

Определить Video and audio, Video only, или Audio only тип выходного файла. Этот параметр становится доступным только тогда, когда видеосигнал имеет как аудио, так и видео.

Выборки на аудиоканал

Укажите количество выборок на аудиоканал. Этот параметр становится доступным для файлов, содержащих звук.

Формат выходного цвета

Укажите, следует ли выводить блок RGB, Intensity, или YCbCr 4:2:2 видеокадры. Этот параметр становится доступным только для сигнала, содержащего видео. При выборе RGBиспользуйте параметр Сигнал изображения (Image signal), чтобы указать способ вывода цветового сигнала.

Сигнал изображения

Укажите способ вывода цветного видеосигнала. При выборе One multidimensional signalблок выводит цветной видеосигнал M-by-N-by-P, где P - количество цветовых плоскостей, на одном порту. При выборе Separate color signalsв блоке появляются дополнительные порты. Каждый порт выводит одну плоскость M-на-N видеопотока RGB. Этот параметр становится доступным, только если для параметра Формат выходного цвета (Output color format) задано значение RGB и сигнал содержит видео.

Вкладка «Типы данных»

Тип данных аудиовыхода

Установите тип данных аудиоотсчетов, выводимых в аудиопорте. Этот параметр становится доступным только в том случае, если мультимедийный файл содержит звук. Вы можете выбрать double, single, int16, или uint8 типы.

Тип данных вывода видео

Установите тип данных видеокадров, выводимых в портах R, G, B или Image. Этот параметр становится доступным только в том случае, если мультимедийный файл содержит видео. Вы можете выбрать double, single, int8, uint8, int16, uint16, int32, uint32, или Inherit from file типы.

Поиск неисправностей

Запуск исполняемого файла вне MATLAB

Чтобы запустить созданное автономное исполняемое приложение в Shell, необходимо установить следующую среду:

ПлатформаКоманда
Mac

setenv DYLD_LIBRARY_PATH "${DYLD_LIBRARY_PATH}:$MATLABROOT/bin/maci64" (csh/tcsh)

export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:$MATLABROOT/bin/maci64 (Bash)

Дополнительные сведения см. в разделе Добавление пути к библиотеке к «DYLD_LIBRARY_PATH» в MAC.

Linux

setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:$MATLABROOT/bin/glnxa64 (csh/tcsh)

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$MATLABROOT/bin/glnxa64 (Bash)

Windows

set PATH=%PATH%;%MATLABROOT%\bin\win64

Поддерживаемые типы данных

Для правильного отображения видеоданных исходными блоками значения пикселей с плавающей запятой с двойной и одинарной точностью должны быть между 0 и 1. Для других типов данных значения пикселов должны быть между минимальным и максимальным значениями, поддерживаемыми их типом данных.

ПортПоддерживаемые типы данныхПоддерживает комплексные значения?

Изображение

  • Плавающая точка с двойной точностью

  • Плавающая точка с одинарной точностью

  • 8-, 16- и 32-разрядные целые числа со знаком

  • 8-, 16- и 32-разрядные целые числа без знака

Нет

R, G, B

Совпадает с портом образа

Нет

Аудио

  • Плавающая точка с двойной точностью

  • Плавающая точка с одинарной точностью

  • 16-битные целые числа со знаком

  • 8-битные беззнаковые целые числа

Нет

Y, Cb, Cr

Совпадает с портом образа

Нет

Расширенные возможности

.
Представлен до R2006a