mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-09-08 13:18:52 +00:00
Original commit message from CVS: 2005-10-10 Andy Wingo <wingo@pobox.com> Merged in popt removal + GOption addition patch from Ronald, bug #169772. * docs/gst/gstreamer-sections.txt: Add STATE_(UN)LOCK_FULL, move GstElement macros around, remove popt-related symbols, add goption stuff. * configure.ac: Remove popt checks, require GLib 2.6 for GOption. * docs/gst/Makefile.am: * docs/libs/Makefile.am: No POPT_CFLAGS. * examples/manual/Makefile.am: * docs/manual/basics-init.xml: Doc updates with an example. * gst/gst.c: (gst_init_get_option_group), (gst_init_check), (gst_init), (parse_one_option), (parse_goption_arg): * gst/gst.h: Removed gst_init_with_popt_table and friends. Took a bit of hand merging and debugging to get the GOption stuff working tho. * tests/Makefile.am: * tools/Makefile.am: * tools/gst-inspect.c: (main): * tools/gst-launch.c: (main): * tools/gst-run.c: (main): * tools/gst-xmlinspect.c: (main): Thanks Ronald!
111 lines
3.7 KiB
XML
111 lines
3.7 KiB
XML
<chapter id="chapter-init">
|
|
<title>Initializing &GStreamer;</title>
|
|
<para>
|
|
When writing a &GStreamer; application, you can simply include
|
|
<filename>gst/gst.h</filename> to get access to the library
|
|
functions. Besides that, you will also need to intialize the
|
|
&GStreamer; library.
|
|
</para>
|
|
|
|
<sect1 id="section-init-c">
|
|
<title>Simple initialization</title>
|
|
<para>
|
|
Before the &GStreamer; libraries can be used,
|
|
<function>gst_init</function> has to be called from the main
|
|
application. This call will perform the necessary initialization
|
|
of the library as well as parse the &GStreamer;-specific command
|
|
line options.
|
|
</para>
|
|
<para>
|
|
A typical program &EXAFOOT; would have code to initialize
|
|
&GStreamer; that looks like this:
|
|
</para>
|
|
<programlisting>
|
|
<!-- example-begin init.c -->
|
|
#include <gst/gst.h>
|
|
|
|
int
|
|
main (int argc,
|
|
char *argv[])
|
|
{
|
|
guint major, minor, micro;
|
|
|
|
gst_init (&argc, &argv);
|
|
|
|
gst_version (&major, &minor, &micro);
|
|
printf ("This program is linked against GStreamer %d.%d.%d\n",
|
|
major, minor, micro);
|
|
|
|
return 0;
|
|
}
|
|
<!-- example-end init.c -->
|
|
</programlisting>
|
|
<para>
|
|
Use the <symbol>GST_VERSION_MAJOR</symbol>,
|
|
<symbol>GST_VERSION_MINOR</symbol> and <symbol>GST_VERSION_MICRO</symbol>
|
|
macros to get the &GStreamer; version you are building against, or
|
|
use the function <function>gst_version</function> to get the version
|
|
your application is linked against. &GStreamer; currently uses a
|
|
scheme where versions with the same major and minor versions are
|
|
API-/ and ABI-compatible.
|
|
</para>
|
|
<para>
|
|
It is also possible to call the <function>gst_init</function> function
|
|
with two <symbol>NULL</symbol> arguments, in which case no command line
|
|
options will be parsed by <application>GStreamer</application>.
|
|
</para>
|
|
</sect1>
|
|
|
|
<sect1>
|
|
<title>The GOption interface</title>
|
|
<para>
|
|
You can also use a GOption table to initialize your own parameters as
|
|
shown in the next example:
|
|
</para>
|
|
<programlisting>
|
|
<!-- example-begin goption.c -->
|
|
#include <gst/gst.h>
|
|
|
|
int
|
|
main (int argc,
|
|
char *argv[])
|
|
{
|
|
gboolean silent = FALSE;
|
|
gchar *savefile = NULL;
|
|
GOptionContext *ctx;
|
|
GError *err = NULL;
|
|
GOptionEntry entries[] = {
|
|
{ "silent", 's', 0, G_OPTION_ARG_NONE, &silent, 0,
|
|
"do not output status information", NULL },
|
|
{ "output", 'o', 0, G_OPTION_ARG_STRING, &savefile, 0,
|
|
"save xml representation of pipeline to FILE and exit", "FILE" },
|
|
{ NULL }
|
|
};
|
|
|
|
ctx = g_option_context_new ("- Your application");
|
|
g_option_context_add_main_entries (ctx, entries, GETTEXT_PACKAGE);
|
|
g_option_context_add_group (ctx, gst_init_get_option_group ());
|
|
if (!g_option_context_parse (ctx, &argc, &argv, &err)) {
|
|
g_print ("Failed to initialize: %s\n", err->message);
|
|
g_error_free (err);
|
|
return 1;
|
|
}
|
|
|
|
printf ("Run me with --help to see the Application options appended.\n");
|
|
|
|
return 0;
|
|
}
|
|
<!-- example-end goption.c -->
|
|
</programlisting>
|
|
<para>
|
|
As shown in this fragment, you can use a <ulink
|
|
url="http://developer.gnome.org/doc/API/2.0/glib/glib-Commandline-option-parser.html"
|
|
type="http">GOption</ulink> table to define your application-specific
|
|
command line options, and pass this table to the GLib initialization
|
|
function along with the option group returned from the
|
|
function <function>gst_init_get_option_group</function>. Your
|
|
application options will be parsed in addition to the standard
|
|
<application>GStreamer</application> options.
|
|
</para>
|
|
</sect1>
|
|
</chapter>
|