SIVP Toolbox
Last update : April, 2006

avireadframe - Grabs and returns a frame from a opened video file or camera (experimental)

### Calling Sequence

  `im = avireadframe(n)`

### Parameters

- `n`: The opened video file/camera index.
- `im`: The returned frame/image. If no frame, return 0.

### Description

`avireadframe` grabs and returns a frame from an opened video file or camera. It can only get the current frame and move to the pointer to the next frame.

Video support for SIVP is only available when SIVP is compiled with OpenCV which support video I/O.

### Examples

        n = aviopen(SCI+'/contrib/sivp/images/video.avi');
        im = avireadframe(n); //get a frame
        imshow(im);

        avilistopened()
        aviclose(n);

### Bugs and Shortcomings

`avireadframe` can only get the current frame now.

### Authors

  Shiqi Yu <shiqi.yu[at]gmail.com>

### Availability

The latest version of SIVP can be found at

http://sivp.sourceforge.net

### See Also

`aviinfo`, `aviopen`, `camopen`, `avifile`, `addframe`, `aviclose`, `avicloseall`, `avilistopened`,