![]() | ![]() | ![]() | GStreamer 0.10 Core Reference Manual | ![]() |
---|
GstGst — |
#include <gst/gst.h> void gst_init (int *argc, char **argv[]); gboolean gst_init_check (int *argc, char **argv[], GError **err); GOptionGroup* gst_init_get_option_group (void); void gst_deinit (void); void gst_version (guint *major, guint *minor, guint *micro, guint *nano); gchar* gst_version_string (void);
void gst_init (int *argc, char **argv[]);
Initializes the GStreamer library, setting up internal path lists, registering built-in elements, and loading standard plugins.
This function will terminate your program if it was unable to initialize
GStreamer for some reason. If you want your program to fall back,
use gst_init_check()
instead.
WARNING: This function does not work in the same way as corresponding
functions in other glib-style libraries, such as gtk_init()
. In
particular, unknown command line options cause this function to
abort program execution.
argc : | pointer to application's argc |
argv : | pointer to application's argv |
gboolean gst_init_check (int *argc, char **argv[], GError **err);
Initializes the GStreamer library, setting up internal path lists, registering built-in elements, and loading standard plugins.
This function will return FALSE
if GStreamer could not be initialized
for some reason. If you want your program to fail fatally,
use gst_init()
instead.
argc : | pointer to application's argc |
argv : | pointer to application's argv |
err : | pointer to a GError to which a message will be posted on error |
Returns : | TRUE if GStreamer could be initialized.
|
GOptionGroup* gst_init_get_option_group (void);
Returns a GOptionGroup with GStreamer's argument specifications. The group is set up to use standard GOption callbacks, so when using this group in combination with GOption parsing methods, all argument parsing and initialization is automated.
This function is useful if you want to integrate GStreamer with other
libraries that use GOption (see g_option_context_add_group()
).
Returns : | a pointer to GStreamer's option group. Should be dereferenced after use. |
void gst_deinit (void);
Clean up. Call only once, before exiting. After this call GStreamer should not be used anymore.
void gst_version (guint *major, guint *minor, guint *micro, guint *nano);
Gets the version number of the GStreamer library.
major : | pointer to a guint to store the major version number |
minor : | pointer to a guint to store the minor version number |
micro : | pointer to a guint to store the micro version number |
nano : | pointer to a guint to store the nano version number |
gchar* gst_version_string (void);
This function returns a string that is useful for describing this version of GStreamer to the outside world: user agent strings, logging, ...
Returns : | a newly allocated string describing this version of GStreamer. |
<< GStreamer Core Library | GstBin >> |