A: GStreamer uses pkg-config to assist applications with compilationa and linking flags. pkg-config is already used by GTK+, GNOME, SDL, and others; so if you are familiar with using it for any of those, you're set.
If you're not familiar with pkg-config to compile and link a small one-file program, pass the --cflags and --libs arguments to pkg-config. For example:
$ libtool --mode=link gcc `pkg-config --cflags --libs gstreamer-0.10` -o myprog myprog.cwould be sufficient for a gstreamer-only program. If (for example) your app also used GTK+ 2.0, you could use
$ libtool --mode=link gcc `pkg-config --cflags --libs gstreamer-0.10 gtk+-2.0` -o myprog myprog.cThose are back-ticks (on the same key with the tilde on US keyboards), not single quotes.
For bigger projects, you should integrate pkg-config use in your Makefile, or integrate with autoconf using the pkg.m4 macro.
A: It is possible to develop and compile against an uninstalled copy of gstreamer and gst-plugins (for example, against CVS copies). The easiest way to do this is to use a script like this (for bash):
#!/bin/bash -i # # this script is in CVS as gstreamer/docs/faq/gst-uninstalled # # set up environment to use and develop gstreamer and friends uninstalled # # set up PATH, LD_LIBRARY_PATH, PKG_CONFIG_PATH, GST_PLUGIN_PATH, MANPATH, # PYTHONPATH # # prefer uninstalled versions, but also put installed ones on the path # # this script assumes that the relevant modules are checked out one by one # under a given tree specified below in MYGST # # symlink this script in a directory in your path (for example $HOME/bin) # to a name that reflects the version of your checkout # # e.g.: # - mkdir $HOME/gst/head # - ln -sf gst-uninstalled $HOME/bin/gst-head # - checkout copies of gstreamer modules in $HOME/gst/head # - gst-head # this script is run -i so that PS1 doesn't get cleared # change this variable to a different location depending on where you # store your cvs checkouts MYGST=$HOME/gst # extract version from $0 # if this script is called "gst-head" then version will be "head" VERSION=`echo $0 | sed s/.*gst-//g` # base path under which dirs are installed GST=$MYGST/$VERSION if test ! -e $GST; then echo "$GST does not exist !" exit fi # set up a bunch of paths PATH=$GST/gstreamer/tools:$GST/gst-plugins/tools:$GST/gst-player/src:$GST/gst-editor/src:$GST/prefix/bin:$PATH # /some/path: makes the dynamic linker look in . too, so avoid this LD_LIBRARY_PATH=$GST/prefix/lib${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH} for path in audio cdda interfaces netbuffer riff rtp tag video do LD_LIBRARY_PATH=$GST/gst-plugins-base/gst-libs/gst/$path/.libs:$LD_LIBRARY_PATH done for path in base net check controller dataprotocol do LD_LIBRARY_PATH=$GST/gstreamer/libs/gst/$path/.libs:$LD_LIBRARY_PATH done LD_LIBRARY_PATH=$GST/gstreamer/gst/.libs:$LD_LIBRARY_PATH export LD_LIBRARY_PATH export PKG_CONFIG_PATH=$GST/prefix/lib/pkgconfig:$GST/gstreamer/pkgconfig:$GST/gst-plugins/pkgconfig:$GST/gst-plugins-base/pkgconfig:$GST/gst-plugins-good/pkgconfig:$GST/gst-python/pkgconfig:$PKG_CONFIG_PATH export GST_PLUGIN_PATH=$GST/gstreamer:$GST/gst-plugins:$GST/gst-plugins-base:$GST/gst-plugins-good:$GST/gst-plugins-ugly:$GST/gst-plugins-bad:$GST/gst-ffmpeg:$GST/gnonlin:$GST/gst-monkeysaudio:$GST/plugins:$GST_PLUGIN_PATH export GST_PLUGIN_SYSTEM_PATH= export GST_REGISTRY=$GST/gstreamer/registry.xml export MANPATH=$GST/gstreamer/tools:$GST/prefix/share/man:$MANPATH pythonver=`python -c "import sys; print sys.version[:3]"` export PYTHONPATH=$GST/gst-python:$GST/prefix/lib/python$pythonver/site-packages${PYTHONPATH:+:$PYTHONPATH} # if we got a command, run it, else start a shell if test ! -z "$1"; then $@ exit $? fi # set up prompt to help us remember we're in a subshell, cd to # the gstreamer base dir and start $SHELL cd $GST shell=$SHELL if test "x$SHELL" == "x/bin/bash" then # debian/ubuntu resets our PS1. bastards. shell="$SHELL --noprofile" fi PS1="[gst-$VERSION] $PS1" $shellIf you put this script in your path, and symlink it to gst-cvs (if you want to develop against cvs HEAD) or to gst-0.8 (if you want to develop against the 0.8 branch), it will automatically use the uninstalled version from that directory.
This requires you to have put your checkouts of gstreamer and gst-plugins under ~/gst/cvs (for the HEAD version). The program is easily modifiable if this isn't the case.
After running this script, you'll be in an environment where you can use the uninstalled tools, and where gst-register registers the uninstalled plugins by default. Also, pkg-config wil detect the uninstalled copies before any installed copies.
A: For GNOME applications it's a good idea to use GConf to find the default ways of outputting audio and video. You can do this by using the 'gconfaudiosink' and 'gconfvideosink' elements for audio and video output. They will take care of everything GConf-related for you and automatically use the outputs that the user configured.
A: When you link a program against uninstalled GStreamer using libtool, funny shell scripts are made to modify your shared object search path and then run your program. For instance, to debug gst-launch, try
libtool --mode=execute gdb /path/to/gst-launch. If this does not work, you're probably using a broken version of libtool.
A: Our main arena for coordination and discussion is IRC, not email. Join us in #gstreamer on irc.freenode.net For larger picture questions or getting more input from more persons, a mail to gstreamer-devel is never a bad idea.
A: For public releases, GStreamer uses a standard MAJOR.MINOR.MICRO version scheme. If the release consists of mostly bug fixes or incremental changes, the MICRO version is incremented. If the release contains big changes, the MINOR version is incremented. If we're particularly giddy, we might even increase the MAJOR number. Don't hold your breath for that though.
During the development cycle, GStreamer also uses a fourth or NANO number. If this number is 1, then it's a CVS version. Any tarball or package that has a nano number of 1 is made from CVS and thus not supported. Additionally, if you didn't get this package or tarball from the GStreamer team, don't have high hopes on it doing whatever you want it to do.
If the number is 2 or higher, it's an official pre-release in preparation of an actual complete release. Your help in testing these tarballs and packages is very much appreciated.
A: The core is basically coded in K&R with 2-space indenting. Just follow what's already there and you'll be fine. The core could use a code cleanup though at this point.
Individual plugins in gst-plugins or plugins that you want considered for addition to the gst-plugins module should be coded in the same style. It's easier if everything is consistent. Consistency is, of course, the goal.
If you use emacs, try these lines:
(defun gstreamer-c-mode () "C mode with adjusted defaults for use with GStreamer." (interactive) (c-mode) (c-set-style "K&R") (setq c-basic-offset 2)) (setq auto-mode-alist (cons '("gst.*/.*\\.[ch]$" . gstreamer-c-mode) auto-mode-alist))
Or, run your code through
indent -br -bad -cbi0 -cli2 -bls -l100 -ut -cebefore submitting a patch (FIXME: check if these are indeed the proper options).
As for the code itself, the GNOME coding guidelines is a good read. Where possible, we try to adhere to the spirit of GObject and use similar coding idioms.
Patches should be made against CVS or the latest release and should be in 'unified context' format (use diff -u -p). They should be attached to a bug report (or feature request) in bugzilla rather than sent to the mailing list.