A Hap player for OpenFrameworks on macOS, Windows and Linux.
Hap is a codec for fast video playback. You can learn more about Hap, and find codecs for encoding, at the main Hap project.
This repo has branches for major OF versions. Use the branch which matches the version of OF you are using. The master branch matches the current OF release.
For example, if you want to use the addon with OpenFrameworks 0.9.x:
$ cd addons/ofxHapPlayer
$ git checkout OpenFrameworks-0.9
This step is only necessary on Linux. On macOS and Windows, the required libraries are bundled with the addon.
On Linux, ofxHapPlayer uses system libraries. For Ubuntu, the following packages are required:
libsnappy-dev, libswresample-dev, libavcodec-dev, libavformat-dev, libtbb-dev
sudo apt-get install libsnappy-dev libswresample-dev libavcodec-dev libavformat-dev libtbb-dev
Pull-requests with instructions for other distributions are welcomed.
ofxHapPlayer will use MSYS2-installed libraries. The following are required (assuming you are using the suggested MINGW64):
mingw-w64-x86_64-snappy, mingw-w64-x86_64-tbb, mingw-w64-x86_64-ffmpeg
pacman -S mingw-w64-x86_64-snappy mingw-w64-x86_64-tbb mingw-w64-x86_64-ffmpeg
Some of these will usually have been installed as dependencies for OpenFrameworks.
Use the OF Project Generator to generate build files for your project, selecting ofxHapPlayer as an addon.
#import "ofxHapPlayer.h"
ofxHapPlayer inherits from ofBaseVideoPlayer
player.loadMovie("movies/MyMovieName.mov");
When you want to draw:
player.draw(20, 20);
Note that there is no direct access to pixels and calls to getPixels() will return NULL.
You can access the texture directly:
ofTexture *texture = player.getTexture();
Note that if you access the texture directly for a Hap Q movie, you will need to use a shader when you draw:
ofShader *shader = player.getShader();
// the result of getShader() will be NULL if the movie is not Hap Q
if (shader)
{
shader->begin();
}
texture.draw(x,y,w,h);
if (shader)
{
shader->end();
}
ofxHapPlayer was written by Tom Butterworth, initially in April 2013, supported by Igloo Vision and James Sheridan. Since then it has been supported by Vidvox. It is released under a FreeBSD License.