1 /* GStreamer base utils library
2 * Copyright (C) 2006 Tim-Philipp Müller <tim centricular net>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
22 * @short_description: General Application and Plugin Utility Library
26 * libgstpbutils is a general utility library for plugins and applications,
27 * available since gst-plugins-base 0.10.12. It currently provides the
33 * human-readable description strings of codecs, elements, sources, decoders,
34 * encoders, or sinks from decoder/encoder caps, element names, or protocol
40 * support for applications to initiate installation of missing plugins (if
41 * this is supported by the distribution or operating system used)
46 * API for GStreamer elements to create missing-plugin messages in order to
47 * communicate to the application that a certain type of plugin is missing
48 * (decoder, encoder, URI protocol source, URI protocol sink, named element)
53 * API for applications to recognise and handle missing-plugin messages
57 * <title>Linking to this library</title>
59 * You should obtain the required CFLAGS and LIBS using pkg-config on the
60 * gstreamer-plugins-base-0.10 module. You will then also need to add
61 * '-lgstpbutils-0.10' manually to your LIBS line.
63 * <title>Library initialisation</title>
65 * Before using any of its functions, applications and plugins must call
66 * gst_pb_utils_init() to initialise the library.
77 #include "gst/gst-i18n-plugin.h"
82 * Initialises the base utils support library. This function is not
83 * thread-safe. Applications should call it after calling gst_init(),
84 * plugins should call it from their plugin_init function.
86 * This function may be called multiple times. It will do nothing if the
87 * library has already been initialised.
92 gst_pb_utils_init (void)
94 static gboolean inited; /* FALSE */
97 GST_LOG ("already initialised");
101 GST_DEBUG ("binding text domain %s to locale dir %s", GETTEXT_PACKAGE,
103 bindtextdomain (GETTEXT_PACKAGE, LOCALEDIR);
104 bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8");