愿景。视频FileWriter

将视频帧和音频样本写入视频文件

描述

的VideoFileWriter对象将视频帧和音频样本写入视频文件。视频和音频可以压缩。可用的压缩类型取决于安装在平台上的编码器。

请注意

该块支持为有文件I/O可用的平台生成代码。您不能使用此块与动态仿真模块^®桌面实时™因为该产品不支持文件I/O。

该对象在Windows Media版本11或更高版本的平台上执行效果最好^®播放器软件。该节点只支持Linux上未压缩的RGB24 AVI文件^®而且Mac平台。

此对象生成的代码依赖于预构建的库文件。您可以在MATLAB之外运行此代码^®环境，或重新部署它，但一定要考虑到这些额外的库文件。packNGo函数创建一个单独的zip文件，其中包含运行或重新构建此代码所需的所有部分。看到packNGo(仿真软件编码器)为更多的信息。

要运行从对象生成的可执行文件，可能需要将预编译的共享库文件添加到系统路径中。看到MATLAB编码器而且Simulink共享库依赖获取详细信息。

请注意

从R2016b开始，而不是使用一步方法来执行由System对象™定义的操作，您可以调用带有参数的对象，就像调用函数一样。例如,y =步骤(obj, x)而且y = obj (x)执行相同操作。

创建

语法

videoFWriter =愿景。VideoFileWriter

videoFWriter = vision.VideoFileWriter(文件名)

videoFWriter =愿景。VideoFileWriter (___、名称、值)

描述

例子

videoFWriter =愿景。VideoFileWriter返回一个视频文件写入器系统对象，videoFWriter．它将视频帧写入未压缩的'output.avi的视频文件。每次打给一步方法写入视频帧。

videoFWriter =愿景。VideoFileWriter (文件名）返回一个视频文件写入器对象，videoFWriter把视频写入文件，文件名．文件类型为.avi，.mj2，mp4,.m4v指定的FileFormat财产。

videoFWriter =愿景。VideoFileWriter (___，名称,值）配置视频文件写入器属性，指定为一个或多个名值对参数。未指定的属性有默认值。

的名字属性名和价值对应的值。的名字必须出现在单引号内(”)．可以以任意顺序指定多个名值对参数Name1, Value1,…,的家．

例子:videoFWriter = vision.VideoFileWriter (myFile.avi,帧速率,…videoFReader.info.VideoFrameRate);

属性

全部展开

`文件名`- - - - - -视频输出文件名
`output.avi`(默认)|特征向量

视频输出文件名，指定为字符向量。您指定的文件扩展名文件名必须匹配FileFormat．

`FileFormat`- - - - - -输出文件格式
`“AVI”`(默认)|`“MJ2000”`|`MPEG4的`

输出文件格式，指定为表中所示的支持的文件格式之一。

文件格式	描述	文件扩展名	支持的平台
`“AVI”`	视听传播的交错文件	`.avi`	所有平台
`“MJ2000”`	运动JPEG 2000文件	`.mj2`	所有平台
`MPEG4的`	mpeg - 4 / h .视频	`mp4`，`.m4v`	窗户^®而且Mac

`AudioInputPort`- - - - - -写音频数据
`假`(默认)|`真正的`

写入音频数据，指定为假或真正的．使用此属性可控制对象是否将音频样本写入视频文件。将此值设置为真正的写音频数据。要将音频和视频写入文件，必须使用。avi格式。

`帧速率`- - - - - -视频帧率
`30.`(默认)|积极的数字标量

视频帧率(每秒帧数)，指定为正数值标量。对于同时包含音频数据的视频，音频数据的速率将被确定为视频的速率乘以传入的音频样本的数量。例如，如果你使用帧速率30.，并传递1470个音频样本，对象将音频样本设置为44100, (1470 x 30 = 44100)．

`AudioCompressor`- - - - - -音频压缩编码器
`没有(压缩)`(默认)|系统的压缩机

指定音频数据要实现的压缩算法类型。这种压缩减少了视频文件的大小。选择没有(压缩)将未压缩的音频数据保存到视频文件中。其他选项反映系统上安装的可用音频压缩算法。此属性仅适用于写入时AVIWindows平台上的文件。

`VideoCompressor`- - - - - -视频压缩编码器
`没有(压缩)`(默认)|系统的压缩机

指定用于压缩视频数据的压缩算法类型。这种压缩减少了视频文件的大小。选择没有(压缩)将未压缩的视频数据保存到视频文件中。的VideoCompressor属性也可以设置为系统上可用的一个压缩器。要获得可用视频压缩器的列表，可以使用选项卡补全。遵循以下步骤:

实例化对象:
```
y =愿景。视频FileWriter
```
要启动选项卡完成功能，请在开引号后面键入以下内容。
y.VideoCompressor = '
键后，将出现系统上可用的压缩器列表选项卡关键。例如:

此属性仅适用于写入时AVIWindows平台上的文件。

`AudioDataType`- - - - - -未压缩音频数据类型
`WAV`(默认)

指定压缩输出音频数据类型。此属性仅适用于未压缩的写入WAV文件。

`FileColorSpace`- - - - - -输出文件的颜色空间
`RGB`(默认)|`YCbCr 4:2:2`

输出AVI文件的颜色空间，指定为RGB或YCbCr 4:2:2．属性时应用此属性FileFormat财产AVI而且仅适用于Windows平台。

`质量`- - - - - -控制输出视频文件的大小
`75`(默认)|整数

控制输出视频文件的大小，指定为范围[0，One hundred.］．增加该值可获得更高的视频质量。但是，这样做会增加文件的大小。减小该值可降低视频质量，减小文件大小。

的质量属性仅适用于写入MPEG4视频文件时(在Windows或Mac)或在Mac或Linux上编写MJPEG-AVI视频文件时。

`CompressionFactor`- - - - - -输入图像和压缩图像中字节数的目标比率
`10`(默认)|整数

输入图像和压缩图像中字节数之间的目标比率，指定为大于1．的CompressionFactor指示输入图像与压缩图像的字节数之间的目标比率。数据被尽可能地压缩，直到指定的目标。此属性仅适用于编写Lossy MJ2000文件时。

使用

语法

文件名= videoFWriter (videoFrame)

文件名= videoFWriter (videoFrame、音频)

文件名= videoFWriter (videoFrame Y Cb、Cr、音频)

描述

例子

文件名= videoFWriter (videoFrame）写一帧视频，videoFrame，到输出文件。输入视频可以是米——- - - - - -N-3真彩RGB视频帧，或米——- - - - - -N灰度视频帧。

文件名= videoFWriter (videoFrame，音频）写入输入视频的一帧，videoFrame，以及一帧音频样本，音频，到输出文件。当您设置AudioInputPort财产真正的．

文件名= videoFWriter (videoFrame，Y，Cb，Cr，音频）写一帧YCbCr 4:2:2视频和一帧音频样本，音频，到输出文件。当您设置AudioInputPort来真正的和FileColorSpace财产的YCbCr 4:2:2”。Cb和Cr色件的宽度必须是Y宽度的一半。

输入参数

全部展开

`videoFrame`- - - - - -视频帧
真彩|二维灰度图像

视频帧，作为真彩色或二维灰度图像返回。

`Y、Cb、铬`- - - - - -YCbCr颜色格式
`“YCbCr 4:2:2”`

的YCbCr颜色格式返回YCbCr 4:2:2格式。

`音频`- - - - - -一帧音频样本
`. wav`|`mp3`|`mp3`|`mp4`|`. ogg`|`.flac`|`.au`|`.aiff`|`aif`|`.aifc`

一帧音频样本，以下列格式之一返回。

平台	支持的文件扩展名
所有平台	AVI (`.avi`）
窗户	图像： `jpg`，`bmp格式`
	视频： MPEG(。`mpeg`） mpeg - 2(。`mp2`） mpeg - 1`.mpg` MPEG-4，包括H.264编码视频(。`mp4`， .`m4v`）运动JPEG 2000(。`mj2`） windowsmediavideo (`.wmv`，`.asf`，`.asx`.asx) 以及Microsoft DirectShow®9.0或更高版本支持的任何格式。
	音频：波(`. wav`） Windows Media音频文件(`.wma`）音频交换文件格式(`aif`，`.aiff`）压缩音频交换文件格式(`.aifc`)， MP3 (`mp3`）太阳音频(`.au`）苹果（`爱恋`）
麦金塔电脑	视频： `.avi` 运动JPEG 2000(。`mj2`） MPEG-4，包括H.264编码视频(。`mp4`， .`m4v`）苹果QuickTime电影(.mov) 以及QuickTime支持的任何格式，请参见http://support.apple.com/kb/HT3775。
麦金塔电脑	音频：未压缩的`.avi`
Linux	运动JPEG 2000(。`mj2`）为GStreamer 0.1或更高版本安装的插件支持的任何格式，如http://gstreamer.freedesktop.org/documentation/plugins.html上列出的，包括Ogg Theora (. Ogg)。

Windows XP而且Windows 7X64平台附带一套有限的64位视频和音频编解码器。如果压缩的多媒体文件无法播放，请尝试将多媒体文件保存为上表中列出的支持的文件格式。

如果您使用Windows，请使用Windows Media player版本11或更高版本。

请注意

使用VideoReader而且VideoWriter对于更高的钻头深度。

输出参数

全部展开

`文件名`—视频输出文件名
`“.avi”`(默认)|`“.mj2”`|`“mp4”`|`“.m4v”`

视频输出文件名，指定为“.avi”，“.mj2”，“mp4”,“.m4v”．您指定的文件扩展名文件名必须匹配FileFormat．

对象的功能

要使用对象函数，请将System对象指定为第一个输入参数。例如，释放名为obj，使用以下语法:

发行版(obj)

全部展开

特定的视觉。VideoFileWriter

`信息`	指定视频文件信息
`结束`	文件尾状态(逻辑)

通用于所有系统对象

`一步`	运行系统对象算法
`释放`	释放资源并允许更改系统对象属性值和输入特征
`重置`	的内部状态重置系统对象

例子

全部折叠

将视频写入AVI文件

打开生活的脚本

加载一个视频文件，并将该文件写入写入器对象。

vidReader = VideoReader (“viplanedeparture.mp4”）;videoFWriter =愿景。VideoFileWriter (“myFile.avi”，.．.的帧速率, vidReader.FrameRate);

将原始文件中的前50帧写入新创建的文件中myFile.avi文件。

为i=1:50 videoFrame = readFrame(vidReader);videoFWriter (videoFrame);结束

关闭输入和输出文件。

释放(videoFWriter);

扩展功能

C / c++代码生成
使用MATLAB®Coder™生成C和c++代码。

使用注意事项和限制:

为该函数生成的代码使用预编译的特定于平台的共享库。
看到MATLAB代码生成中的系统对象(MATLAB编码器)．

版本历史

介绍了R2012a

另请参阅

VideoWriter|VideoReader|愿景。视频Player

愿景。视频FileWriter

描述

创建

语法

描述

属性

文件名- - - - - -视频输出文件名output.avi(默认)|特征向量

FileFormat- - - - - -输出文件格式“AVI”(默认)|“MJ2000”|MPEG4的

AudioInputPort- - - - - -写音频数据假(默认)|真正的

帧速率- - - - - -视频帧率30.(默认)|积极的数字标量

AudioCompressor- - - - - -音频压缩编码器没有(压缩)(默认)|系统的压缩机

VideoCompressor- - - - - -视频压缩编码器没有(压缩)(默认)|系统的压缩机

AudioDataType- - - - - -未压缩音频数据类型WAV(默认)

FileColorSpace- - - - - -输出文件的颜色空间RGB(默认)|YCbCr 4:2:2

质量- - - - - -控制输出视频文件的大小75(默认)|整数

CompressionFactor- - - - - -输入图像和压缩图像中字节数的目标比率10(默认)|整数

使用

语法

描述

输入参数

videoFrame- - - - - -视频帧真彩|二维灰度图像

Y、Cb、铬- - - - - -YCbCr颜色格式“YCbCr 4:2:2”

音频- - - - - -一帧音频样本. wav|mp3|mp3|mp4|. ogg|.flac|.au|.aiff|aif|.aifc

输出参数

文件名—视频输出文件名“.avi”(默认)|“.mj2”|“mp4”|“.m4v”

对象的功能

特定的视觉。VideoFileWriter

通用于所有系统对象

例子

将视频写入AVI文件

扩展功能

C / c++代码生成使用MATLAB®Coder™生成C和c++代码。

版本历史

另请参阅

`文件名`- - - - - -视频输出文件名
`output.avi`(默认)|特征向量

`FileFormat`- - - - - -输出文件格式
`“AVI”`(默认)|`“MJ2000”`|`MPEG4的`

`AudioInputPort`- - - - - -写音频数据
`假`(默认)|`真正的`

`帧速率`- - - - - -视频帧率
`30.`(默认)|积极的数字标量

`AudioCompressor`- - - - - -音频压缩编码器
`没有(压缩)`(默认)|系统的压缩机

`VideoCompressor`- - - - - -视频压缩编码器
`没有(压缩)`(默认)|系统的压缩机

`AudioDataType`- - - - - -未压缩音频数据类型
`WAV`(默认)

`FileColorSpace`- - - - - -输出文件的颜色空间
`RGB`(默认)|`YCbCr 4:2:2`

`质量`- - - - - -控制输出视频文件的大小
`75`(默认)|整数

`CompressionFactor`- - - - - -输入图像和压缩图像中字节数的目标比率
`10`(默认)|整数

`videoFrame`- - - - - -视频帧
真彩|二维灰度图像

`Y、Cb、铬`- - - - - -YCbCr颜色格式
`“YCbCr 4:2:2”`

`音频`- - - - - -一帧音频样本
`. wav`|`mp3`|`mp3`|`mp4`|`. ogg`|`.flac`|`.au`|`.aiff`|`aif`|`.aifc`

`文件名`—视频输出文件名
`“.avi”`(默认)|`“.mj2”`|`“mp4”`|`“.m4v”`

C / c++代码生成
使用MATLAB®Coder™生成C和c++代码。