Documentation Center

  • Trial Software
  • Product Updates

step

System object: vision.VideoFileReader
Package: vision

Output video frame

Syntax

I = step(H)
[Y,Cb,Cr] = step(H)
[I,AUDIO] = step(H)
[Y,Cb,Cr,AUDIO] = step(H)
[..., EOF] = step(H)

Description

Use the step method with the video file reader object and any optional properties to output the next video frame.

I = step(H) outputs next video frame.

[Y,Cb,Cr] = step(H) outputs next frame of YCbCr 4:2:2 video in the color components Y, Cb, and Cr. This syntax requires that you set the ImageColorSpace property to 'YCbCr 4:2:2'.

[I,AUDIO] = step(H) outputs next video frame, I, and one frame of audio samples, AUDIO. This syntax requires that you set the AudioOutputPort property to true.

[Y,Cb,Cr,AUDIO] = step(H) outputs next frame of YCbCr 4:2:2 video in the color components Y, Cb, and Cr, and one frame of audio samples in AUDIO. This syntax requires that you set the AudioOutputPort property to true, and the ImageColorSpace property to 'YCbCr 4:2:2'.

[..., EOF] = step(H) returns the end-of-file indicator, EOF. The object sets EOF to true each time the output contains the last audio sample and/or video frame.

    Note:   The object performs an initialization the first time the step method is executed. This initialization locks nontunable properties and input specifications, such as dimensions, complexity, and data type of the input data. If you change a nontunable property or an input specification, the System object™ issues an error. To change nontunable properties or inputs, you must first call the release method to unlock the object.

Was this topic helpful?