Video player for openFrameworks using Windows Media Foundation API and hardware acceleration capabilities
C C++ Objective-C

README.md

ofxWMFVideoPlayer

This addon is an accelerated video player using the Windows Media Foundation API. It was developed by Philippe Laulheret for Second Story and is released under MIT licensing. See license.md for more details. For a more comprehensive/technical description of the work, please refer to the file TechnicalDescription.md

This addons is meant to work with openFrameworks 0.8 and superior, on windows Vista and following. Previous version of oF should work as well but won't be maintained.

Prerequisites

This addons uses the WGL_NV_DX_interop extension, in order to use it you need to upgrade the GLEW library of your openFrameworks folder : Prior to compiling this example you need to replace the GLEW headers and libraries from your of\libs foler by the one present in the lib folder of this repository.

On top of that this addon is built against the Direct X SDK of June 2010. You'll need to install it to have the headers required for compiling the example. At the time of writing, you can download it on the Microsoft website

Using the example

Make sure you have updated the GLEW library, your graphic driver are up to date. Copy (and rename) a mp4 file as "test.mp4" into the data folder and run the example.

Compatibility

The texture sharing we are using is based upon an NVIDIA extension but AMD/ATI cards claims they support it was well, even though sometimes it gets more finicky. Feedback on working/not working cards and drivers are more than welcomed.

Troubleshooting

In some instance we have noticed that the video appears "washed out". If you are noticing this it is due to a NVIDIA card setting that sets colors to a limited range of 16-235. You can fix this by doing the following:

  • Open the nVidia Control Panel
  • Adjust Video Color Settings
  • Make Color Adjustments
  • With nVidia Settings
  • Select Advanced Tab
  • Set Dynamic Range to: Full (0-255)