Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


CinderHap enables the Hap codec on Cinder.

Hap is an open source video codec for fast decompression on modern graphics hardware. Usually when a movie is being played, the CPU has to decompress every frame before passing them to the graphics card (GPU). Hap passes the compressed frames to the GPU, who does all the decompression, saving your precious CPU from this work.

Hap was developed by Tom Butterworth and commissioned by Vidvox.

For general information about Hap, read the the Hap announcement.

For technical information about Hap, see the Hap project.

The Hap codec is developed for Mac OSX only, but a Windows version is in the works.

How it works

Cinder-Hap has a new class called qtime::MovieGlHap that acts just like qtime::MovieGl. When a movie encoded with Hap is loaded, it will pass compressed frames to Hap. If the movie is not encoded with Hap, everything works like qtime::MovieGl.

Movies encoded with Hap are much larger than common codecs used for playback, like Photo-JPEG and H.264. So, to benefit from Hap, you will need an SSD drive to read your movies from.

To encode your movies with Hap, see this tutorial.

How to add Cinder-Hap to your existing project

  1. Install the Hap QuickTime codec.

  2. Download or Fork this project to your $CINDER_PATH/blocks folder.

  3. Add all but the samples sources files to your existing Cinder Xcode project.

  4. Add the shaders to your target's Build Bundle Resources:

  5. Replace all your qtime::MovieGl classes by qtime::MovieGlHap.

  6. Load a Hap encoded movie and enjoy extra playback smoothness.

There's a sample project called sampleHap you can use for reference.


qtime::MovieGlHap has some extra functionalities...

  • bool isHap()

    Return true if the movie is using a Hap codec.

  • void setAsRect(bool b=true)

    Hap textures are natively stored as GL_TEXTURE_2D, so when you call getTexture(), that's what you receive to maximize performance. To keep compatibility with qtime::MovieGl, which returns GL_TEXTURE_RECTANGLE_ARB textures, call setAsRect() once after you create your movie.

    Internally, Cinder-Hap draws the original 2D texture to an Rect FBO and returns it's texture. So it will consume a little bit more of your CPU/GPU than working with 2D textures.

    HapQ also uses this FBO (2D or Rect, as you wish), because it has to be rendered with the provided shader.

  • std::string & getCodecName()

    Returns a string containing the Hap version being used by the movie (Hap, HapA or HapQ). If not Hap, returns the FourCC code of the codec.

  • float getPlaybackFramerate()

    Returns the actual playback framerate of the movie.


This code is released under the Modified BSD License, same as Cinder.

This project was originally written by Roger Sodré, 2013.


CinderHap enables the Hap codec on Cinder.






No releases published


No packages published