Clutter Gst 3.0.4 Reference Manual: Utilities

Go to page content
Go to main menu
Go to the search field

Utilities

Utilities — Utility functions for Clutter-Gst.

Functions

ClutterInitError	clutter_gst_init ()
ClutterInitError	clutter_gst_init_with_args ()
GstElement *	clutter_gst_create_video_sink ()

Description

The Clutter-Gst library should be initialized with clutter_gst_init() before it can be used. You should pass pointers to the main argc and argv variables so that GStreamer, Clutter and Clutter-Gst gst can process their own command line options, as shown in the following example:

Example 1. Initializing the Clutter-Gst library

int
main (int argc, char *argv[])
{
  // initialize the Clutter-Gst library
  clutter_gst_init (&argc, &argv);
  ...
}

It's allowed to pass two NULL pointers to clutter_gst_init() in case you don't want to pass the command line arguments to GStreamer, Clutter and Clutter-Gst.

You can also use a GOptionEntry array to initialize your own parameters as shown in the next code fragment:

Example 2. Initializing the Clutter-Gst library with additional options

static GOptionEntry options[] =
{
  { "framerate", 'f', 0, G_OPTION_ARG_INT, &opt_framerate,
    "Number of frames per second", NULL },
  { "fourcc", 'o', 0, G_OPTION_ARG_STRING,
     &opt_fourcc, "Fourcc of the wanted YUV format", NULL },
  { NULL }
};

int
main (int argc, char *argv[])
{
   GError           *error = NULL;
   gboolean          result;

   if (!g_thread_supported ())
     g_thread_init (NULL);

   result = clutter_gst_init_with_args (&argc, &argv,
                                        " - Test YUV frames uploading",
                                        options, NULL, &error);

   if (error)
     {
       g_print ("%s\n", error->message);
       g_error_free (error);
       return EXIT_FAILURE;
     }
  ...
}

Functions

clutter_gst_init ()

ClutterInitError
clutter_gst_init (int *argc,
                  char ***argv);

Utility function to initialize both Clutter and GStreamer.

This function should be called before calling any other GLib functions. If this is not an option, your program must initialise the GLib thread system using g_thread_init() before any other GLib functions are called.

Parameters

argc	The number of arguments in `argv` .	[inout]
argv	A pointer to an array.	[array length=argc][inout][allow-none]

Returns

A ClutterInitError.

clutter_gst_init_with_args ()

ClutterInitError
clutter_gst_init_with_args (int *argc,
                            char ***argv,
                            const char *parameter_string,
                            GOptionEntry *entries,
                            const char *translation_domain,
                            GError **error);

This function does the same work as clutter_gst_init(). Additionally, it allows you to add your own command line options, and it automatically generates nicely formatted --help output. Clutter's and GStreamer's GOptionGroups are added to the set of available options.

Your program must initialise the GLib thread system using g_thread_init() before any other GLib functions are called.

Parameters

argc	The number of arguments in `argv` .	[inout]
argv	A pointer to an array.	[array length=argc][inout][allow-none]
parameter_string	a string which is displayed in the first line of `--help` output, after `programname [OPTION...]`
entries	a `NULL`-terminated array of GOptionEntrys describing the options of your program
translation_domain	a translation domain to use for translating the `--help` output for the options in `entries` with `gettext()`, or `NULL`
error	a return location for errors

Returns

CLUTTER_INIT_SUCCESS on success, a negative integer on failure.

Since 1.0

clutter_gst_create_video_sink ()

GstElement *
clutter_gst_create_video_sink (void);

Creates a new ClutterGstVideoSink initialized with Clutter's Cogl context.

Returns

the newly created ClutterGstVideoSink.

[transfer full]

Since 3.0

Types and Values