Skip to content
OpenMax accelerated video player for openFrameworks on the Raspberry Pi
C++ C Other
Find file
Latest commit 46a99c7 @jvcleave Update readme.md

readme.md

STATUS: PERPETUAL DEVELOPMENT
Use Releases unless you are contributing or looking for bleeding edge (requires blood). Releases contain tested versions that work for specific versions of openFrameworks.

CURRENT KNOWN MAJOR ISSUES:
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/

USAGE:
(NEW) 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:

  • Audio can be played back through HDMI or headphone jack
  • May be disabled to save resources
  • initialVolume can be passed

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-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-restartMovie:
restart a movie by pressing "r" + ENTER in ssh session (or "r" on attached keyboard)

example-shader:
Use of shaders, fbos and video

example-multiple-players:

  • Multiple players
  • Usage of a display area to play non-textured video non-fullscreen

There may be other examples in Master branch but the above are most likely to remain

COMPRESSION RECOMMENDATIONS:

CREDITS:
Majority of the code is based off of https://github.com/popcornmix/omxplayer

with some modifications by xbmc: https://github.com/xbmc/xbmc

See addons/ofxOMXPlayer/libs/omxplayer/COPYING for license details inherited from omxplayer/xbmc

Thanks to OtherCrashOverride for helping me figure out the linking issue to enable callbacks https://github.com/OtherCrashOverride

Thanks to @bendenoz for help with the looping https://github.com/bendenoz

Test video files from: http://www.bigbuckbunny.org/index.php/download/

Something went wrong with that request. Please try again.