STATUS
Most code replaced 9/29/2018 (see bottom)
Use Releases unless you are contributing or looking for bleeding edge.
Releases contain tested versions that work for specific versions of openFrameworks.
CURRENT KNOWN MAJOR ISSUES:
Requires openFrameworks 10, Raspberry Pi 1-3
Videos with and audio track (even silent) work best and allow more accurate looping/frame tracking
DESCRIPTION:
This is an openFrameworks video player addon for the Raspberry Pi. The video player is hardware accelerated and can provide textures to openFrameworks to be used for shaders, etc.
REQUIREMENTS:
- GPU split set to 128 (may need to be higher for larger videos)
- openFrameworks version 0.8 or higher http://www.openframeworks.cc/setup/raspberrypi/
- run install_depends.sh for necessary libav dependencies
USAGE:
Clone into openFrameworks/addons
There 2 modes of Playback, Direct (aka Non-textured) or Textured.
Direct:
- Renders directly to the screen, no texture access or pixels. This is most similar to what you will see in omxplayer
- By default is played fullscreen video
- OF is still able to run other processes in the background.
- 1080p video playback is typically good
Textured:
Allows the use of
- shaders
- pixel access
- drawing overlays
- 720p video works best here
Audio:
- Yes
Headphone jack may require this tweak:
https://gist.github.com/jvcleave/4972661
To use HDMI Audio you may need to add the below line to /boot/config.txt and reboot. See http://elinux.org/RPiconfig for more details
hdmi_drive=2
EXAMPLES:
example-basic:
Playback of video in texture mode (default)
example-texture-mode:
Playback of video in texture mode (default)
example-direct-mode:
Playback of video in direct mode (no textures/pixel access)
example-multiple-players:
Simultaneous playback 2 videos in non-texture mode
example-playlist:
Playback of a folder of videos in texture mode
example-pixels:
Example of pixel access that is needed for OpenCv operations/Saving images, etc
example-http-stream:
plays network streamed video
example-shader:
Use of shaders
example-playback-controls:
tried to keep these close to omxplayer
example-wrapper:
ofRPIVideoPlayer extends ofVideoPlayer in hopes to be a drop in replacement for ofVideoPlayer,
There may be other examples in Master branch but the above are most likely to remain
COMPRESSION RECOMMENDATIONS:
- Use MPEGStreamclip (http://www.squared5.com/)
- H.264
- Quality 50%
- PCM Audio (more compatible with HDMI)
CREDITS:
Majority of the code is based off of
https://github.com/popcornmix/omxplayer
See COPYING for license details inherited from omxplayer/xbmc
Test video files from:
http://www.bigbuckbunny.org/index.php/download/
REHAUL NOTES:
I have basically rewritten the underlying engine in order to keep as close to omxplayer as possible.
It seems to be about the same performance-wise. Noticeable changes are better looping and audio. This addon should play most files the same way as omxplayer. ofxOMXPlayerEngine is basically omxplayer.cpp with additions to support the openFrameworks model and textures.
This addon no longer has static/custom compiled versions of libav.
I closed all the previous issues as I won't be doing anything to the old code.
TODO:
I still need to port back some of the direct mode display options and some stuff around the filters. There is also some functionality missing around switching the audio settings at runtime.
