Write Binary File

Write binary video data to file

expand all in page

Library:
计算机视觉工具箱/ Sinks

Description

TheWrite Binary Fileblock takes the video data from a Simulink^®model and exports it to a binary file.

This block produces a raw binary file with no header information. It has no encoded information providing the data type, frame rate, or dimensionality. The video data for this block appears in row-major format.

Note

This block supports code generation only for platforms that have file I/O available. The block does not support code generation usingSimulink Desktop Real-Time™orSimulink Real-Time™.

Ports

Input

expand all

`Y'`— Luminance component of input video stream
scalar | vector | matrix

Luminance component of the input video stream, specified as a scalar, vector, or matrix. The label of this port can be changed using theComponent1parameter when theVideo formatparameter is set toCustom.

`Cb`— Blue difference component of the input video stream
scalar | vector | matrix

Blue difference component of the input video stream, specified as a scalar, vector, or matrix. The label of this port can be changed using theComponent2parameter when theVideo formatparameter is set toCustom.

`Cr`— Red difference component of input video stream
scalar | vector | matrix

Red difference component of the input video stream, specified as a scalar, vector, or matrix. The label of this port can be changed using theComponent3parameter when theVideo formatparameter is set toCustom.

`A`— Alpha component of input video stream
scalar | vector | matrix

Alpha component of the input video stream, specified as a scalar, vector, or matrix. The label of this port can be changed using theComponent4parameter when theVideo formatparameter is set toCustom.

Dependencies

To enable this port, use one of these options.

Set theVideo formatparameter toFour character codes, and set theFour character codeparameter toAYUVorIF09.
Set theVideo formatparameter toCustom, and theNumber of inputsparameter to4. In this case, the name of this port isAlpha.

`T`— Transparency component of input video stream
scalar | vector | matrix

Transparency component of the input video stream, specified as a scalar, vector, or matrix.

Dependencies

To enable this port, set theVideo formatparameter toFour character codes, and set theFour character codeparameter toY41TorY42T.

Parameters

expand all

`File name`— Name of the binary file
`output.bin`(default) | file name

Specify the name of the output binary file, with a.binextension, for the video data. ClickSave Asto specify the location for the file.

`Video format`— Format of the video data
`Four character codes`(default) |`Custom`

Specify the format of the video data as one of these options.

Four character codes (FOURCC) — For more information about these codes, seehttps://www.fourcc.org.
Custom — Read the video data from a binary file of a custom format.

`Four character code`— Format of binary file
`I420`(default) |`AYUV`|`CLJR`|`cyuv`|`GREY`|`IF09`|`IMC1`|`IMC2`|`IMC3`|`IMC4`|`IUYV`|`IY41`|`IYU1`|`IYU2`|`IYUV`|`NV12`|`NV21`|`UYNV`|`UYNY`|`V210`|`Y411`|`Y41P`|`Y41T`|`Y422`|`Y42T`|`Y8`|`Y800`|`YUNV`|`YUY2`|`YUYV`|`YV12`|`YV16`|`YVU9`|`YVYU`| ...

选择的四个字符代码所需的代码c for the binary file. The value of this parameter also determines the number of input ports on the block. For information on which four character codes enable which input ports, seeInput Ports for Four Character Codes.

Dependencies

To enable this parameter, set theVideo Formatparameter toFour character codes.

`Line ordering`— Binary file fill direction
`Top line first`(default) |`Bottom line first`

If you selectTop line first, the block begins filling the binary file with the first row of the video frame. It then fills the file with the other rows in increasing order. If you selectBottom line first, the block begins filling the binary file with the last row of the video frame. It then fills the file with the other rows in decreasing order.

`Bit stream format`— Data format of binary file
`Planar`(default) |`Packed`

Specify the data format of the binary file asPlanarorPacked.

Dependencies

To enable this parameter, set theVideo Formatparameter toCustom.

`Number of inputs`— Number of components in input video stream
`3`(default) |`1`|`2`|`4`

Specify the number of components in the input video stream. This parameter sets the number of input ports.

Dependencies

To enable this parameter, set theVideo Formatparameter toCustom.

`Inherit size of components from input data type`— All components have same number of bits
`on`(default) |`off`

Select theInherit size of components from input data typeparameter to indicate that all of the components have the same number of bits as the input data type. If you clear this parameter, you can specify the number of bits for each enabled component using the associatedBitsparameter.

Dependencies

To enable this parameter, set theVideo Formatparameter toCustom.

`Component1`— Name of luminance component input port
`Y'`(default) | component name

Specify the name of the input port for the luminance component of the input video stream.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom, set theNumber of inputsparameter to1or greater .

`Component2`— Name of blue difference component
`Cb`(default) | component name

Specify the name of the input port for the blue difference component of the input video stream.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom, set theNumber of inputsparameter to2or greater .

`Component3`— Name of red difference component
`Cr`(default) | component name

Specify the name of the input port for the red difference component of the input video stream.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom, set theNumber of inputsparameter to3or greater .

`Component4`— Name of alpha component
Alpha (default) | component name

Specify the name of the input port for the alpha component of the input video stream.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom, set theNumber of inputsparameter to4.

`Bits1`— Size of luminance component
`8`(default) |`0`|`16`|`24`|`32`

Specify the size of the luminance component in the input video stream. The value of this parameter determines the interpretation of the video stream data as8-bit,16-bit,24-bit, or32-bit.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom, and set theNumber of inputsparameter to1or greater, and select theInherit size of components from input data typeparameter.

`Bits2`— Size of blue difference component
`8`(default) |`0`|`16`|`24`|`32`

Specify the size of the blue difference component in the input video stream. The value of this parameter determines the interpretation of the video stream data as8-bit,16-bit,24-bit, or32-bit.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom, and set theNumber of inputsparameter to2or greater, and select theInherit size of components from input data typeparameter.

`Bits3`— Size of red difference component
`8`(default) |`0`|`16`|`24`|`32`

Specify the size of the red difference component in the input video stream. The value of this parameter determines the interpretation of the video stream data as8-bit,16-bit,24-bit, or32-bit.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom, and set theNumber of inputsparameter to3or greater, and select theInherit size of components from input data typeparameter.

`Bits4`— Size of alpha component
`8`(default) |`0`|`16`|`24`|`32`

Specify the size of the alpha component in the input video stream. The value of this parameter determines the interpretation of the video stream data as8-bit,16-bit,24-bit, or32-bit.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom, and set theNumber of inputsparameter to4, and select theInherit size of components from input data typeparameter.

`Component order in binary file`— Arrangement of components in binary file
[`1 2 3`] (default) | vector of valid component identifiers

Specify the arrangement of the components in the binary file. Identify the components by the assigned numerals, from 1 to 4, in the desired order. You must include all enabled components when setting this parameter.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom.

`Interlaced video`— Read video data as interlaced
`off`(default) |`on`

Select this parameter when the video stream contains interlaced video data.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom.

`Write signed data to output file`— Write signed data to output binary file
`off`(default) |`on`

Select this parameter when the input data is signed.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom.

`Byte order in binary file`— Byte order in output binary file
`Little endian`(default) |`Big endian`

Specify the byte order in the output binary file as either little endian or big endian.

Dependencies

To enable this parameter, set theVideo formatparameter toCustom.

Model Examples

Write Image To Binary File

Write an image data to a binary file in a custom format using theWriteBinaryFileblock.

Open Script

Block Characteristics

Data Types	`integer`
Multidimensional Signals	`no`
Variable-Size Signals	`no`

Input Ports for Four Character Codes

Four Character Code	Input ports
I420	Y'\|Cb\|Cr
AYUV	Y'\|Cb\|Cr\|A
CLJR	Y'\|Cb\|Cr
cyuv	Y'\|Cb\|Cr
GREY	Y'
IF09	Y'\|Cb\|Cr\|A
IMC1	Y'\|Cb\|Cr
IMC2	Y'\|Cb\|Cr
IMC3	Y'\|Cb\|Cr
IMC4	Y'\|Cb\|Cr
IUYV	Y'\|Cb\|Cr
IY41	Y'\|Cb\|Cr
IYU1	Y'\|Cb\|Cr
IYU2	Y'\|Cb\|Cr
IYUV	Y'\|Cb\|Cr
NV12	Y'\|Cb\|Cr
NV21	Y'\|Cb\|Cr
UYNV	Y'\|Cb\|Cr
UYNY	Y'\|Cb\|Cr
V210	Y'\|Cb\|Cr
Y411	Y'\|Cb\|Cr
Y41P	Y'\|Cb\|Cr
Y41T	Y'\|Cb\|Cr\|T
Y422	Y'\|Cb\|Cr
Y42T	Y'\|Cb\|Cr\|T
Y8	Y'
Y800	Y'
YUNV	Y'\|Cb\|Cr
YUY2	Y'\|Cb\|Cr
YUYV	Y'\|Cb\|Cr
YV12	Y'\|Cb\|Cr
YV16	Y'\|Cb\|Cr
YVU9	Y'\|Cb\|Cr
YVYU	Y'\|Cb\|Cr

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced before R2006a

Write Binary File

Description

Ports

Input

Y'— Luminance component of input video streamscalar | vector | matrix

Cb— Blue difference component of the input video streamscalar | vector | matrix

Cr— Red difference component of input video streamscalar | vector | matrix

A— Alpha component of input video streamscalar | vector | matrix

Dependencies

T— Transparency component of input video streamscalar | vector | matrix

Dependencies

Parameters

File name— Name of the binary fileoutput.bin(default) | file name

Video format— Format of the video dataFour character codes(default) |Custom

Four character code— Format of binary fileI420(default) |AYUV|CLJR|cyuv|GREY|IF09|IMC1|IMC2|IMC3|IMC4|IUYV|IY41|IYU1|IYU2|IYUV|NV12|NV21|UYNV|UYNY|V210|Y411|Y41P|Y41T|Y422|Y42T|Y8|Y800|YUNV|YUY2|YUYV|YV12|YV16|YVU9|YVYU| ...

Dependencies

Line ordering— Binary file fill directionTop line first(default) |Bottom line first

Bit stream format— Data format of binary filePlanar(default) |Packed

Dependencies

Number of inputs— Number of components in input video stream3(default) |1|2|4

Dependencies

Inherit size of components from input data type— All components have same number of bitson(default) |off

Dependencies

Component1— Name of luminance component input portY'(default) | component name

Dependencies

Component2— Name of blue difference componentCb(default) | component name

Dependencies

Component3— Name of red difference componentCr(default) | component name

Dependencies

Component4— Name of alpha componentAlpha (default) | component name

Dependencies

Bits1— Size of luminance component8(default) |0|16|24|32

Dependencies

Bits2— Size of blue difference component8(default) |0|16|24|32

Dependencies

Bits3— Size of red difference component8(default) |0|16|24|32

Dependencies

Bits4— Size of alpha component8(default) |0|16|24|32

Dependencies

Component order in binary file— Arrangement of components in binary file[1 2 3] (default) | vector of valid component identifiers

Dependencies

Interlaced video— Read video data as interlacedoff(default) |on

Dependencies

Write signed data to output file— Write signed data to output binary fileoff(default) |on

Dependencies

Byte order in binary file— Byte order in output binary fileLittle endian(default) |Big endian

Dependencies

Model Examples

Write Image To Binary File

Block Characteristics

Input Ports for Four Character Codes

Extended Capabilities

C/C++ Code GenerationGenerate C and C++ code using Simulink® Coder™.

Version History

See Also

Blocks

`Y'`— Luminance component of input video stream
scalar | vector | matrix

`Cb`— Blue difference component of the input video stream
scalar | vector | matrix

`Cr`— Red difference component of input video stream
scalar | vector | matrix

`A`— Alpha component of input video stream
scalar | vector | matrix

`T`— Transparency component of input video stream
scalar | vector | matrix

`File name`— Name of the binary file
`output.bin`(default) | file name

`Video format`— Format of the video data
`Four character codes`(default) |`Custom`

`Four character code`— Format of binary file
`I420`(default) |`AYUV`|`CLJR`|`cyuv`|`GREY`|`IF09`|`IMC1`|`IMC2`|`IMC3`|`IMC4`|`IUYV`|`IY41`|`IYU1`|`IYU2`|`IYUV`|`NV12`|`NV21`|`UYNV`|`UYNY`|`V210`|`Y411`|`Y41P`|`Y41T`|`Y422`|`Y42T`|`Y8`|`Y800`|`YUNV`|`YUY2`|`YUYV`|`YV12`|`YV16`|`YVU9`|`YVYU`| ...

`Line ordering`— Binary file fill direction
`Top line first`(default) |`Bottom line first`

`Bit stream format`— Data format of binary file
`Planar`(default) |`Packed`

`Number of inputs`— Number of components in input video stream
`3`(default) |`1`|`2`|`4`

`Inherit size of components from input data type`— All components have same number of bits
`on`(default) |`off`

`Component1`— Name of luminance component input port
`Y'`(default) | component name

`Component2`— Name of blue difference component
`Cb`(default) | component name

`Component3`— Name of red difference component
`Cr`(default) | component name

`Component4`— Name of alpha component
Alpha (default) | component name

`Bits1`— Size of luminance component
`8`(default) |`0`|`16`|`24`|`32`

`Bits2`— Size of blue difference component
`8`(default) |`0`|`16`|`24`|`32`

`Bits3`— Size of red difference component
`8`(default) |`0`|`16`|`24`|`32`

`Bits4`— Size of alpha component
`8`(default) |`0`|`16`|`24`|`32`

`Component order in binary file`— Arrangement of components in binary file
[`1 2 3`] (default) | vector of valid component identifiers

`Interlaced video`— Read video data as interlaced
`off`(default) |`on`

`Write signed data to output file`— Write signed data to output binary file
`off`(default) |`on`

`Byte order in binary file`— Byte order in output binary file
`Little endian`(default) |`Big endian`

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.