https://github.com/postpop/videoreaderffmpeg

MATLAB wrapper for FFMPEG that implements a VideoReader-like interface
https://github.com/postpop/videoreaderffmpeg

ffmpeg matlab matlab-wrapper video

Last synced: about 9 hours ago
JSON representation

MATLAB wrapper for FFMPEG that implements a VideoReader-like interface

• Host: GitHub
• URL: https://github.com/postpop/videoreaderffmpeg
• Owner: postpop
• License: mit
• Created: 2015-04-05T21:01:56.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-06-26T00:47:25.000Z (over 7 years ago)
• Last Synced: 2023-08-03T13:09:25.123Z (over 1 year ago)
• Topics: ffmpeg, matlab, matlab-wrapper, video
• Language: Matlab
• Homepage:
• Size: 81.8 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# VideoReaderFFMPEG

Matlab wrapper for FFMPEG that implements a VideoReader-like interface.

## Documentation

- Constructor: `vr = VideoReaderFFMPEG('test.mp4');`

- Additional arguments (optional): 

    - `tempFolder` - path to save the temporary image files to (optional, defaults to `./`)

    - `FFMPEGpath` - path to the `ffmpeg` and `ffprobe` binaries (optional, defaults to `/usr/local/bin` on osx/unix and `C:\Program Files\ffmpeg\bin` on windows)

    - `imageFormat` - image file format used to temporarily store frames (optional, defauts to `tif`)

- Properties: `Width`, `Height`, `NumberOfFrames`, `FrameRate`, `Channels`

- Methods: 

    - `read()` with single frames or a range of frames `[startFrame endFrame]`, e.g. `vr.read([100 200])` reads frames 100 to 200, returns them as `[WIDTH x HEIGHT x CHANNELS x NFRAMES]` matrix

    - `clean()` deletes all temporary image files (automatically called upon object deletion)

## Usage

```matlab

vr = VideoReaderFFMPEG('test.mp4')  % open video file

frame10 = vr.read(10)               % read frame 10

frames100to200 = vr.read([100 200]) % read frames 100 to 200

vr.clean()                          % delete temporary image files after your done

```

## Internals

- uses `ffprobe` to get meta data

- uses `ffmpeg` to export video frames as images which are loaded using matlab's `imread()`

- tested using `ffmpeg` v2.5 and v2.6