<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>Developing applications with GStreamer</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Building GStreamer from CVS"
HREF="chapter-cvs.html"></HEAD
><BODY
CLASS="sect1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
></TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="chapter-cvs.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
> </TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="chapter-developing"
>8. Developing applications with GStreamer</A
></H1
><DIV
CLASS="qandaset"
><DL
><DT
>8.1. <A
HREF="chapter-developing.html#developing-compile-programs"
>How do I compile programs that use GStreamer ?</A
></DT
><DT
>8.2. <A
HREF="chapter-developing.html#developing-uninstalled-gstreamer"
>How do I develop against an uninstalled GStreamer copy ?</A
></DT
><DT
>8.3. <A
HREF="chapter-developing.html#developing-gconf"
>How can I use GConf to get the system-wide defaults ?</A
></DT
><DT
>8.4. <A
HREF="chapter-developing.html#developing-libtool-scripts"
> How do I debug these funny shell scripts that libtool makes ?
</A
></DT
><DT
>8.5. <A
HREF="chapter-developing.html#developing-mail-gstreamer-devel"
>Why is mail traffic so low on gstreamer-devel ?</A
></DT
><DT
>8.6. <A
HREF="chapter-developing.html#developing-versioning"
>What kind of versioning scheme does GStreamer use ?</A
></DT
><DT
>8.7. <A
HREF="chapter-developing.html#developing-coding-style"
>What is the coding style for GStreamer core ?</A
></DT
></DL
><DIV
CLASS="qandaentry"
><DIV
CLASS="question"
><P
><A
NAME="developing-compile-programs"
></A
><B
>8.1. </B
>How do I compile programs that use GStreamer ?</P
></DIV
><DIV
CLASS="answer"
><P
><B
> </B
>
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.
</P
><P
> 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:
<PRE
CLASS="programlisting"
> $ gcc `pkg-config --cflags --libs gstreamer-0.7` -o myprog myprog.c
</PRE
>
would be sufficient for a gstreamer-only program.
If (for example) your app also used GTK+ 2.0, you could use
<PRE
CLASS="programlisting"
> $ gcc `pkg-config --cflags --libs gstreamer-0.7 gtk+-2.0` -o myprog myprog.c
</PRE
>
Those are back-ticks (on the same key with the tilde on US keyboards),
not single quotes.
</P
><P
> For bigger projects, you should integrate pkg-config use in your Makefile,
or integrate with autoconf using the pkg.m4 macro.
</P
></DIV
></DIV
><DIV
CLASS="qandaentry"
><DIV
CLASS="question"
><P
><A
NAME="developing-uninstalled-gstreamer"
></A
><B
>8.2. </B
>How do I develop against an uninstalled GStreamer copy ?</P
></DIV
><DIV
CLASS="answer"
><P
><B
> </B
>
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):
<PRE
CLASS="programlisting"
> #!/bin/bash -i
# set up environment to use and develop gstreamer from uninstalled
# this is run -i so that PS1 doesn't get cleared
# extract version from $0
# gst-cvs -> cvs
VERSION=`echo $0 | sed s/.*gst-//g`
echo $VERSION
# base path under which dirs are installed
GST=~/gst/$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:$PATH
export PKG_CONFIG_PATH=$GST/gstreamer/pkgconfig:$GST/gst-plugins/pkgconfig
export GST_PLUGIN_PATH=$GST/gstreamer:$GST/gst-plugins
# set up prompt to help us remember we're in a subshell and start bash
PS1="[gst-$VERSION] $PS1" bash
</PRE
>
If 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.6 (if you want to develop against the
0.6 branch), it will automatically use the uninstalled version from that
directory.
</P
><P
> 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.
</P
><P
> 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.
</P
></DIV
></DIV
><DIV
CLASS="qandaentry"
><DIV
CLASS="question"
><P
><A
NAME="developing-gconf"
></A
><B
>8.3. </B
>How can I use GConf to get the system-wide defaults ?</P
></DIV
><DIV
CLASS="answer"
><P
><B
> </B
>
It's a good idea to use GConf to use default ways of outputting audio and
video. Since GStreamer's GConf keys can be more than
just one element, but a whole pipeline, it would be a good idea
to use the gstgconf library. It provides functions to parse the GConf key
to a usable pipeline.
</P
><P
> To link against gstgconf, use pkg-config to query the gstreamer-libs-0.7.pc file
for link flags, and add -lgstgconf to the link flags.
This fragment of configure.ac shows how to use pkg-config to get the LIBS:
</P
><PRE
CLASS="programlisting"
> dnl check for GStreamer helper libs
PKG_CHECK_MODULES(GST_HELPLIBS, gstreamer-libs-0.7 >= $GSTREAMER_REQ,,exit)
AC_SUBST(GST_HELPLIBS_LIBS)
AC_SUBST(GST_HELPLIBS_CFLAGS)
</PRE
><P
> This fragment of a Makefile.am file shows how to make your application link
to it:
</P
><PRE
CLASS="programlisting"
> bin_PROGRAMS = application
application_LDADD = $(GST_LIBS) $(GST_HELPLIBS_LIBS) -lgstgconf
application_CFLAGS = $(GST_CFLAGS) $(GST_HELPLIBS_CFLAGS)
</PRE
></DIV
></DIV
><DIV
CLASS="qandaentry"
><DIV
CLASS="question"
><P
><A
NAME="developing-libtool-scripts"
></A
><B
>8.4. </B
>
How do I debug these funny shell scripts that libtool makes ?
</P
></DIV
><DIV
CLASS="answer"
><P
><B
> </B
>
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
<PRE
CLASS="programlisting"
> libtool gdb /path/to/gstreamer-launch
</PRE
>.
If this does not work, you're probably using a broken version of libtool.
</P
></DIV
></DIV
><DIV
CLASS="qandaentry"
><DIV
CLASS="question"
><P
><A
NAME="developing-mail-gstreamer-devel"
></A
><B
>8.5. </B
>Why is mail traffic so low on gstreamer-devel ?</P
></DIV
><DIV
CLASS="answer"
><P
><B
> </B
>
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.
However, we do archive our IRC discussions, which you may find in the
gstreamer-daily mailing list archives.
</P
></DIV
></DIV
><DIV
CLASS="qandaentry"
><DIV
CLASS="question"
><P
><A
NAME="developing-versioning"
></A
><B
>8.6. </B
>What kind of versioning scheme does GStreamer use ?</P
></DIV
><DIV
CLASS="answer"
><P
><B
> </B
>
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.
</P
><P
> 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.
</P
><P
> 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.
</P
></DIV
></DIV
><DIV
CLASS="qandaentry"
><DIV
CLASS="question"
><P
><A
NAME="developing-coding-style"
></A
><B
>8.7. </B
>What is the coding style for GStreamer core ?</P
></DIV
><DIV
CLASS="answer"
><P
><B
> </B
>
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.
</P
><P
> 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.
</P
><P
> If you use emacs, try these lines:
<PRE
CLASS="programlisting"
> (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))
</PRE
>
</P
><P
> Or, run your code through
<PRE
CLASS="programlisting"
> indent -br -bad -cbi0 -cli2 -bls -l100 -ut -ce
</PRE
>
before submitting a patch (FIXME: check if these are indeed the proper options).
</P
><P
> As for the code itself, the
<A
HREF="http://developer.gnome.org/doc/guides/programming-guidelines/book1.html"
TARGET="_top"
>GNOME coding guidelines</A
> is a good read.
Where possible, we try to adhere to the spirit of GObject and use similar
coding idioms.
</P
></DIV
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="chapter-cvs.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
> </TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Building GStreamer from CVS</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
> </TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
> </TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
