Utilities

Utilities — Utility functions for Clutter-Gst.

Functions

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

1
2
3
4
5
6
7
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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
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