https://github.com/bangnoise/ofxhapplayer
A Hap player for OpenFrameworks
https://github.com/bangnoise/ofxhapplayer
hap openframeworks
Last synced: 10 months ago
JSON representation
A Hap player for OpenFrameworks
- Host: GitHub
- URL: https://github.com/bangnoise/ofxhapplayer
- Owner: bangnoise
- License: other
- Created: 2013-04-24T13:42:37.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2025-03-12T00:37:36.000Z (11 months ago)
- Last Synced: 2025-04-10T06:39:23.463Z (10 months ago)
- Topics: hap, openframeworks
- Language: C
- Homepage:
- Size: 14.7 MB
- Stars: 151
- Watchers: 12
- Forks: 46
- Open Issues: 29
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
ofxHapPlayer
============
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](https://github.com/Vidvox/hap).
Installation
------------
This repo has branches for major OF versions. Use the branch which matches the version of OF you are using. The [master](https://github.com/bangnoise/ofxHapPlayer/tree/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
Linux Requirements
------------------
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.
MSYS2 Requirements
------------------
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.
Usage
-----
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.
Advanced Usage
--------------
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();
}
Credits and License
-------------------
ofxHapPlayer was written by [Tom Butterworth](https://6a64.xyz), initially in April 2013, supported by [Igloo Vision](http://www.igloovision.com/) and James Sheridan. Since then it has been supported by [Vidvox](http://vidvox.net/). It is released under a [FreeBSD License](http://github.com/bangnoise/ofxHapPlayer/blob/master/LICENSE).