来自多媒体文件

多媒体文件流

展开全部页面

库:
音频工具箱/来源
DSP系统工具箱/源代码

描述

的来自多媒体文件块从多媒体文件中读取音频样本、视频帧或两者，并生成具有以下数据类型和幅度范围之一的信号。

输出数据类型	输出幅度范围
`双`	±1
`单`	±1
`int16`	−32768 ~ 32767¹⁵到2¹⁵−1)
`uint8`	0 ~ 255

该块将数据从文件导入到Simulink中金宝app^®模型。

请注意

此块支持为具有文件I/金宝appO可用的主机计算机生成代码。你不能用这个方块金宝appSimulink桌面实时™软件，因为该产品不支持文件I/O。金宝app此块生成的代码依赖于预构建的库文件。详情请参见代码生成．

限制

Lin金宝appux下支持OPUS文件格式^®机器，你一定有libsndfile 1.0.29或已安装的更新版本。在Windows上^®而且Mac，此文件随MATLAB附带^®，可在美元MATLABROOT / bin / <平台>．

港口

接口的输出端口来自多媒体文件块根据多媒体文件的内容进行更改。如果文件只包含视频帧，则图像港口、强度我港口,R，G，B端口,或Y，Cb，Cr端口根据块对话框中的“设置”显示。如果文件只包含音频样本，则音频端口出现在块上。如果文件同时包含音频和视频，您可以选择要发出的数据。本节将更详细地描述这些端口。

输出

全部展开

`图像`-彩色图像或视频帧
数组

彩色图像或视频帧，返回为米——- - - - - -N——- - - - - -P数组中。米而且N是每个图像中的行数和列数。P是每个图像中颜色通道的数量。

依赖关系

开启该端口。

设置文件名称参数设置为包含视频或图像数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数视频只或视频和音频．
设置输出颜色格式参数RGB而且图像信号参数一个多维信号．
该端口被命名为金宝app仿真软件的图像如果输出颜色格式参数设置为RGB和图像信号参数设置为金宝appSimulink图像信号．

数据类型:单|双|int8|int16|int32|uint8|uint16|uint32|金宝app仿真软件。ImageType

`我`-灰度图像或视频帧
矩阵

灰度图像或视频帧，返回为米——- - - - - -N矩阵。米而且N是灰度图像中的行数和列数。

依赖关系

开启该端口。

设置文件名称参数设置为包含视频或图像数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数视频只或视频和音频．
设置输出颜色格式参数强度．

数据类型:单|双|int8|int16|int32|uint8|uint16|uint32

`R`-图像或视频帧的红色组件
矩阵

图像或视频帧的红色组件，返回为米——- - - - - -N矩阵。米而且N是图像中的行数和列数。

从R，G,或B端口尺寸必须相同。

依赖关系

开启该端口。

设置文件名称参数设置为包含视频或图像数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数视频只或视频和音频．
设置输出颜色格式参数RGB而且图像信号参数单独的颜色信号．

数据类型:单|双|int8|int16|int32|uint8|uint16|uint32

`G`-图像或视频帧的绿色成分
矩阵

图像或视频帧的绿色组件，返回为米——- - - - - -N矩阵。米而且N是图像中的行数和列数。

从R，G,或B端口尺寸必须相同。

依赖关系

开启该端口。

设置文件名称参数设置为包含视频或图像数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数视频只或视频和音频．
设置输出颜色格式参数RGB而且图像信号参数单独的颜色信号．

数据类型:单|双|int8|int16|int32|uint8|uint16|uint32

`B`-图像或视频帧的蓝色组件
矩阵

图像或视频帧的蓝色组件，返回为米——- - - - - -N矩阵。米而且N是图像中的行数和列数。

从R，G,或B端口尺寸必须相同。

依赖关系

开启该端口。

设置文件名称参数设置为包含视频或图像数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数视频只或视频和音频．
设置输出颜色格式参数RGB而且图像信号参数单独的颜色信号．

数据类型:单|双|int8|int16|int32|uint8|uint16|uint32

`Y`-图像或视频帧的Luma组件
矩阵

亮度组件的图像或视频帧，返回作为米——- - - - - -N矩阵。米而且N是图像中的行数和列数。

依赖关系

开启该端口。

设置文件名称参数设置为包含视频或图像数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数视频只或视频和音频．
设置输出颜色格式参数YCbCr 4:2:2．

数据类型:单|双|int8|int16|int32|uint8|uint16|uint32

`Cb`-图像或视频帧的蓝差色度分量
矩阵

图像或视频帧的蓝差色度分量，返回为米——- - - - - -N/ 2的矩阵。米而且N是输入图像中的行数和列数。

依赖关系

开启该端口。

设置文件名称参数设置为包含视频或图像数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数视频只或视频和音频．
设置输出颜色格式参数YCbCr 4:2:2．

数据类型:单|双|int8|int16|int32|uint8|uint16|uint32

`Cr`-图像或视频帧的红差色度分量
矩阵

图像或视频帧的红差色度分量，返回为米——- - - - - -N/ 2的矩阵。米而且N是每个输入图像中的行数和列数。

依赖关系

开启该端口。

设置文件名称参数设置为包含视频或图像数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数视频只或视频和音频．
设置输出颜色格式参数YCbCr 4:2:2．

数据类型:单|双|int8|int16|int32|uint8|uint16|uint32

`音频`-音频信号
向量|矩阵

音频信号，返回为米-element vector或an米——- - - - - -N矩阵。米每个通道的样本数量和N是通道数。

依赖关系

若要启用此端口，请设置文件名称参数设置为包含音频数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数音频只有或视频和音频．

数据类型:单|双|int16|uint8

`EOF`—文件结束指示器
标量

文件结束指示器，作为每个视频帧或音频样本的逻辑标量返回。文件结束指示符为1当块从文件中输出最后的视频帧或音频样本时，为0否则。

依赖关系

要启用此端口，请选择输出文件结束指示器参数。

数据类型:布尔

参数

全部展开

主要选项卡

`文件名称`—多媒体文件名称
`speech_dft.mp3`(默认)|字符向量

指定要读取的块的多媒体文件的名称。该块确定文件的类型(音频和视频，仅音频或仅视频)并提供相关参数。

如果文件的位置没有出现在MATLAB路径上，请使用浏览按钮指定完整路径。如果文件的位置出现在MATLAB路径上，则只输入文件名。

在Windows平台上，此参数支持指向MMS (Microsoft Med金宝appia Server)流的url。

`从文件继承样例时间`-从文件中继承采样时间
On(默认)| off

指定该块是从多媒体文件继承采样时间还是使用指定的采样时间。当选择此参数时，该块将从输入的多媒体文件中继承采样时间。方法中指定的采样时间期望采样时间参数。

提示

当不知道多媒体文件的采样率时，请选择此参数。

`期望采样时间`-分段采样时间
`1/30`(默认)|实正标量

指定块采样时间。

依赖关系

若要启用此参数，请清除从文件继承样例时间参数。

`播放文件的次数`—多媒体文件播放次数
`正`(默认值)|正整数

指定播放输入多媒体文件的次数。的默认值正指定块重复播放多媒体文件，直到模拟停止时间。

`阅读范围`-音频采样范围
`(1正)`(默认)|二元向量

指定样本范围，以[的形式将其读取为两元素行向量。StartSampleEndSample),StartSample样本是从哪个文件读取开始的EndSample是文件读取停止的示例。

依赖关系

若要启用此参数，请设置文件名称参数设置为包含音频数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数音频只有．

`输出文件结束指示器`—文件结束指示器
Off(默认)| on

使用此参数确定输出是否为多媒体文件中的最后一帧视频或音频样本。当选择该参数时，a布尔输出端口标记EOF出现在块上。的输出。EOF当最后一个视频帧或音频样本从块输出时，端口默认为1。的输出EOF端口默认为0。

`多媒体输出`-媒体类型
`音频只有`(默认)|`视频和音频`|`视频只`

指定要从包含视频和音频数据的文件中读取的媒体类型。

依赖关系

若要启用此参数，请设置文件名称参数设置为同时包含音频和视频数据的多媒体文件的名称。

`每个音频通道的样本`-每个音频通道的样本
`1024`(默认值)|正整数

指定每个音频通道的采样数。此参数对于包含音频的文件可用。

依赖关系

`输出颜色格式`-彩色视频格式
`RGB`(默认)|`强度`|`YCbCr 4:2:2`

指定输入视频数据的输出颜色格式。该块支持金宝appRGB，强度,YCbCr 4:2:2颜色格式。

如果您选择RGB，使用图像信号参数指定如何输出颜色信号。

依赖关系

若要启用此参数，请设置文件名称参数设置为包含视频数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数视频只或视频和音频．

`图像信号`—RGB视频输出端口配置
`一个多维信号`(默认)|`单独的颜色信号`|`金宝appSimulink图像信号`

指定块如何输出RGB彩色视频。如果您选择:

一个多维信号——该块输出一个米——- - - - - -N——- - - - - -P彩色视频信号通过图像港口,P是彩色平面的数量。
单独的颜色信号——该块输出视频数据使用三个单独的颜色通道，横跨R，G,B港口。每个端口输出一个米——- - - - - -N平面的RGB视频流。
金宝appSimulink图像信号——该块输出一个视频金宝app仿真软件。ImageType数据类型。

依赖关系

启用该参数。

设置文件名称参数设置为包含视频数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数视频只或视频和音频．
设置输出颜色格式参数RGB．

数据类型选项卡

`音频输出数据类型`—音频输出数据类型
`双`(默认)|`单`|`int16`|`uint8`

处输出的音频样本指定数据类型音频端口。

依赖关系

若要启用此参数，请设置文件名称参数设置为包含音频数据的多媒体文件的名称。如果指定的文件同时包含音频和视频数据，请设置多媒体输出参数音频只有或视频和音频．

`视频输出数据类型`—视频输出数据类型
`单`(默认)|`双`|`int8`|`uint8`|`int16`|`uint16`|`int32`|`uint32`|`从文件继承`

属性处输出的视频帧的数据类型R，G，B,或图像港口. .

依赖关系

模型的例子

减少短货

检查Simulink®模型中的音频设备写入器块，确定欠压，并减少欠压。金宝app

打开脚本

模拟声学环境

在Simulink®模型中检查混响器块和调谐参数。金宝app该模型中的混响参数模拟了一个有硬墙的大房间，如体育馆。

应用频率加权

检查Simulink®模型中的权重过滤器(音频工具箱)块并调优参数。金宝app

块特征

数据类型	`双`\|`整数^一个`\|`单`
直接引线	`没有`
多维信号	`没有`
适应信号	`没有`
讨论二阶导数过零检测	`没有`
^一个金宝app支持16位和32位有符号整数和8位无符号整数。

更多关于

全部展开

金宝app支持的平台和文件类型

支持的文金宝app件格式取决于系统上安装的编解码器。

窗户平台支持的文件格式金宝app

在您的系统上安装了必要的Windows DirectShow编解码器后来自多媒体文件Block支金宝app持多种视频和音频文件格式。此块在DirectX 9.0或更高版本的平台上性能最好^®软件

下表列出了最常见的文件格式。

多媒体类型	文件扩展名
图像文件	`jpg`，`bmp格式`，`. png`
视频文件	`.qt`，`。mov`，`.avi`，`.asf`，`.asx`，`.wmv`，`.mpg`，`.mpeg`，`mp2`，`mp4`，`.m4v`
音频文件	`. wav`，`.wma`，`.avi`，`aif`，`.aifc`，`.aiff`，`mp3`，`.au`，`爱恋`，`mp4`，`.m4a`，`.flac`，`. ogg`，`.opus`

映像文件的默认值是. png，用于视频文件.avi，而对于音频文件则是mp3．

Windows 7以及后续版本的Windows附带一套有限的64位视频和音频编解码器。如果来自多媒体文件块不能作用于压缩的多媒体文件，请将多媒体文件保存为该块支持的文件格式。金宝app

如果您使用Windows，请使用Windows媒体^®球员版本11或更高版本使用此块以获得最佳结果。

非窗户平台支持的文件格式金宝app

下表列出了最常见的文件格式。

多媒体类型	文件扩展名
视频文件	`.avi`，`.mj2`，`。mov`，`mp4`，`.m4v`
音频文件	`.avi`，`mp3`，`mp4`，`.m4a`，`. wav`，`.flac`，`. ogg`，`aif`，`.aifc`，`.aiff`，`.au`，`.opus`，`爱恋`

视频文件的默认值为.avi而对于音频文件是mp3．

样本率

该块使用的采样率取决于音频和视频的采样率。而来自多媒体文件block在Simulink中以单一速率运行，底层音频和视频流可以产生金宝app不同的速率。在某些情况下，当块同时输出音频和视频时，它会对视频速率做一个小的调整。

用于视频和音频文件的时间计算示例

采样时间=

\frac{c e 我 l （ \frac{一个 u d 我 o 年代 一个 米 p l e R 一个 t e}{F P 年代} ）}{一个 u d 我 o 年代 一个 米 p l e R 一个 t e}

．
当音频采样时间

\frac{一个 u d 我 o 年代 一个 米 p l e R 一个 t e}{F P 年代}

是不是整数，方程不能约为

\frac{1}{F P 年代}

．

在这种情况下，为了防止同步问题，当音频流领先视频流超过时，块将丢弃相应的视频帧

\frac{1}{F P 年代}

．
总之，该块在每个Simulink时间步输出一个视频帧。金宝app为了计算每个时间步输出的音频样本数量，该块将音频样本速率除以视频帧率(fps)。如果音频采样率没有平均除以每秒的视频帧数，该块将音频采样数舍入到最接近的整数。如果有必要，块会定期丢弃一个视频帧以保持大文件的同步。

在外部运行可执行文件MATLAB

要在Shell中运行生成的独立可执行应用程序，您需要将环境设置为以下格式:

平台命令

Mac

平台	命令
Mac	`setenv DYLD_LIBRARY_PATH "${DYLD_LIBRARY_PATH}:$MATLABROOT/bin/maci64" (csh/tcsh)` `导出DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:$MATLABROOT/bin/maci64` 有关更多信息，请参见在MAC中添加库路径到“DYLD_LIBRARY_PATH”．
Linux	`setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:$MATLABROOT/bin/glnxa64 (csh/tcsh)` `export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$MATLABROOT/bin/glnxa64 (Bash)`
窗户	`设置路径= % %路径;% MATLABROOT % \ bin \ win64`

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

导出DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:$MATLABROOT/bin/maci64

有关更多信息，请参见在MAC中添加库路径到“DYLD_LIBRARY_PATH”．

Linux

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

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

窗户

设置路径= % %路径;% MATLABROOT % \ bin \ win64

扩展功能

C/ c++代码生成
使用Simulink®Coder™生成C和c++代码。金宝app

使用注意事项和限制:

仅限主机。不包括Simuli金宝appnk桌面实时代码生成。
此块生成的可执行文件依赖于预构建的动态库文件(. dll文件)包含MATLAB。使用packNGo函数将此块生成的代码和所有相关文件打包到压缩的ZIP文件中。使用这个ZIP文件，您可以在另一个没有安装MATLAB的开发环境中重新定位、解包和重新构建项目。详情请参见如何在MATLAB之外运行生成的可执行文件．

版本历史

R2006a之前介绍

全部展开

R2022b:金宝app支持OPUS音频文件格式

的来自多媒体文件block支金宝app持OPUS文件格式的音频文件(.opus）.

来自多媒体文件

描述

限制

港口

输出

图像-彩色图像或视频帧数组

依赖关系

我-灰度图像或视频帧矩阵

依赖关系

R-图像或视频帧的红色组件矩阵

依赖关系

G-图像或视频帧的绿色成分矩阵

依赖关系

B-图像或视频帧的蓝色组件矩阵

依赖关系

Y-图像或视频帧的Luma组件矩阵

依赖关系

Cb-图像或视频帧的蓝差色度分量矩阵

依赖关系

Cr-图像或视频帧的红差色度分量矩阵

依赖关系

音频-音频信号向量|矩阵

依赖关系

EOF—文件结束指示器标量

依赖关系

参数

主要选项卡

文件名称—多媒体文件名称speech_dft.mp3(默认)|字符向量

从文件继承样例时间-从文件中继承采样时间On(默认)| off

期望采样时间-分段采样时间1/30(默认)|实正标量

依赖关系

播放文件的次数—多媒体文件播放次数正(默认值)|正整数

阅读范围-音频采样范围(1正)(默认)|二元向量

依赖关系

输出文件结束指示器—文件结束指示器Off(默认)| on

多媒体输出-媒体类型音频只有(默认)|视频和音频|视频只

依赖关系

每个音频通道的样本-每个音频通道的样本1024(默认值)|正整数

依赖关系

输出颜色格式-彩色视频格式RGB(默认)|强度|YCbCr 4:2:2

依赖关系

图像信号—RGB视频输出端口配置一个多维信号(默认)|单独的颜色信号|金宝appSimulink图像信号

依赖关系

数据类型选项卡

音频输出数据类型—音频输出数据类型双(默认)|单|int16|uint8

依赖关系

视频输出数据类型—视频输出数据类型单(默认)|双|int8|uint8|int16|uint16|int32|uint32|从文件继承

依赖关系

模型的例子

减少短货

模拟声学环境

应用频率加权

块特征

更多关于

金宝app支持的平台和文件类型

样本率

用于视频和音频文件的时间计算示例

在外部运行可执行文件MATLAB

扩展功能

C/ c++代码生成使用Simulink®Coder™生成C和c++代码。金宝app

版本历史

R2022b:金宝app支持OPUS音频文件格式

另请参阅

块

主题

`图像`-彩色图像或视频帧
数组

`我`-灰度图像或视频帧
矩阵

`R`-图像或视频帧的红色组件
矩阵

`G`-图像或视频帧的绿色成分
矩阵

`B`-图像或视频帧的蓝色组件
矩阵

`Y`-图像或视频帧的Luma组件
矩阵

`Cb`-图像或视频帧的蓝差色度分量
矩阵

`Cr`-图像或视频帧的红差色度分量
矩阵

`音频`-音频信号
向量|矩阵

`EOF`—文件结束指示器
标量

`文件名称`—多媒体文件名称
`speech_dft.mp3`(默认)|字符向量

`从文件继承样例时间`-从文件中继承采样时间
On(默认)| off

`期望采样时间`-分段采样时间
`1/30`(默认)|实正标量

`播放文件的次数`—多媒体文件播放次数
`正`(默认值)|正整数

`阅读范围`-音频采样范围
`(1正)`(默认)|二元向量

`输出文件结束指示器`—文件结束指示器
Off(默认)| on

`多媒体输出`-媒体类型
`音频只有`(默认)|`视频和音频`|`视频只`

`每个音频通道的样本`-每个音频通道的样本
`1024`(默认值)|正整数

`输出颜色格式`-彩色视频格式
`RGB`(默认)|`强度`|`YCbCr 4:2:2`

`图像信号`—RGB视频输出端口配置
`一个多维信号`(默认)|`单独的颜色信号`|`金宝appSimulink图像信号`

`音频输出数据类型`—音频输出数据类型
`双`(默认)|`单`|`int16`|`uint8`

`视频输出数据类型`—视频输出数据类型
`单`(默认)|`双`|`int8`|`uint8`|`int16`|`uint16`|`int32`|`uint32`|`从文件继承`

C/ c++代码生成
使用Simulink®Coder™生成C和c++代码。金宝app