ofxGStreamer is an special addon that allows to use the openFrameworks GStreamer elements, ofGstVideoPlayer and ofGstUtils under windows and osx
This addon has no code and instead uses the addon_config.mk file included here to add the required files from the core + the flags needed to compile programs using GStreamer. Please see ofxGSTRTP for examples and implimentation of the toolkit.
The instructions below will only work with the latest version of the project generator on github. More information about getting OF setup is documented here. Use the project generater to create template projects after you have installed the GStreamer libraries according to the instructions below.
##Installing gstreamer
This addon depends on the gstreamer SDK. We are using version 1.0 currently. To install it:
###For OSX (Tested with XCode 5, 10.6,7,8,9,10)
First you need to download gstreamer v1.0. To install it under osx install each of the packages described below from the gstreamer install packages for osx
-
gstreamer-1.0-1.14.2-x86_64.pkg installs the necesary libraries for applications to run
-
gstreamer-1.0-devel-1.14.2-x86_64.pkg installs the development files needed to compile gst applications
-
gstreamer-1.0-1.14.2-x86_64-packages.dmg contains some additional packages that are needed to encode some formats like h264, some of these packages have GPL license or use patented formats. Download the dmg and install the following packages from that collection:
This package is needed to do colorspace conversion:
* gstreamer-1.0-libav-1.14.2-x86_64.pkg
And these packages will provide h264 encoding and some network utilities to stream h264 and other data formats:
* gstreamer-1.0-codecs-restricted-1.14.2-x86_64.pkg
* gstreamer-1.0-net-restricted-1.14.2-x86_64.pkg
If you only want to run an osx app, the development package is not needed but for our applications we needed to the additional packages.
Note: on the systems we have tested it seems it's necesary to remove or rename /Library/Frameworks/GStreamer.framework/Headers/assert.h
or it'll clash with the assert.h in the system and some projects won't compile. In our testing we renamed the file to keep a copy instead of deleting it. Open a terminal window and paste this in:
sudo mv /Library/Frameworks/GStreamer.framework/Headers/assert.h /Library/Frameworks/GStreamer.framework/Headers/assertCOPY.h
###For Windows (Tested in visual studio 2012, on Windows 7 & 8)
You need to download GStreamer v1.0. To install it under windows use the 1.2.2 packages located http://gstreamer.freedesktop.org/data/pkg/windows/1.2.2/ any later version from http://gstreamer.freedesktop.org/data/pkg/windows should work but haven't been tested yet. It is important to install the complete version when the installer asks, or it won't install some plugins like h264 encoder and decoder, audio input... in general everything in gstreamer bad and ugly won't be installed with the tipical installation mode.
-
gstreamer-1.0-x86-1.2.2.msi installs the necesary libraries for applications to run.
-
gstreamer-1.0-devel-x86-1.2.2.msi installs the development files needed to compile gst applications.
After installing those 2 packages, you need to add the path to the bin directory of the installation to the PATH environment variable. In windows 8 open the control panel and search for environment variable. In windows 7 type "environment variable" into the run window. Edit the system PATH variable and at the end by adding a ; and the bin folder in the path where you installed gstreamer. The default path should be:
;C:\gstreamer\1.0\x86\bin
That will allow you to run the gstreamer tools like gst-launch from the command line in any folder and will let the applications know where to find the runtime dll's.
Changes 2018-08-04 updated osx download links for libraries