Grabs, decodes and returns the next video frame

frame = cap.read()
frame = cap.read('OptionName',optionValue, ...)

Output

• frame output image

Options

• FlipChannels in case the output is color image, flips the color order from OpenCV's BGR to MATLAB's RGB order. default true

The method combines cv.VideoCapture.grab and cv.VideoCapture.retrieve in one call. This is the most convenient method for reading video files or capturing data from decode and return the just grabbed frame. If no frames has been grabbed (camera has been disconnected, or there are no more frames in video file), the function return an empty matrix.