/usr/include/gstreamermm-0.10/gstreamermm/init.h is in libgstreamermm-0.10-dev 0.10.11-0ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 | // -*- c++ -*-
/* gstreamermm - a C++ wrapper for gstreamer
*
* Copyright 2008 The gstreamermm Development Team
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#ifndef _GSTREAMERMM_INIT_H
#define _GSTREAMERMM_INIT_H
#include <glibmm/error.h>
#include <glibmm/optiongroup.h>
namespace Gst
{
/** Initializes gstreamermm parsing command line arguments.
*
* Either this function or Gst::init_check() with command line parsing should
* be called to initialize gstreamermm before calling any other GLib functions.
* If this is not an option, your program must initialize the GLib thread
* system using Glib::thread_init() before any other GLib functions are called
* and use either Gst::init(), or Gst::init_check() without the command line
* arguments before calling any gstreamermm functions. GLib thread
* initialization can be done as follows:
*
* @code
* if(!Glib::thread_supported())
* Glib::thread_init();
* ...
* @endcode
*
*
* Note: 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.
*
* @param argc Reference to application's argc.
* @param argv Reference to application's argv.
*/
void init(int& argc, char**& argv);
/** Initializes gstreamermm without parsing command line options.
*
* Either the Gst::init() or Gst::init_check() functions with command line
* parsing should be called to initialize gstreamermm before calling any other
* GLib functions. If this is not an option, your program must initialize the
* GLib thread system using Glib::thread_init() before any other GLib functions
* are called and use either this function or Gst::init_check() without the
* command line arguments before calling any gstreamermm functions. GLib
* thread initialization can be done as follows:
*
* @code
* if(!Glib::thread_supported())
* Glib::thread_init();
* ...
* @endcode
*
* Note: 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.
*/
void init();
/** Initializes gstreamermm gracefully parsing command line arguments.
*
* Either this function or Gst::init() with command line parsing should be
* called to initialize gstreamermm before calling any other GLib functions.
* If this is not an option, your program must initialize the GLib thread
* system using Glib::thread_init() before any other GLib functions are called
* and use either Gst::init() or Gst::init_check() without the command line
* arguments before calling any gstreamermm functions. GLib thread
* initialization can be done as follows:
*
* @code
* if(!Glib::thread_supported())
* Glib::thread_init();
* ...
* @endcode
*
* 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.
*
* @param argc Reference to application's argc.
* @param argv Reference to application's argv.
* @return true if GStreamer could be initialized.
* @throw Glib::Error
*/
bool init_check(int& argc, char**& argv);
/** Initializes gstreamermm gracefully without parsing command line arguments.
*
* Either the Gst::init() or Gst::init_check() functions with command line
* parsing should be called to initialize gstreamermm before calling any other
* GLib functions. If this is not an option, your program must initialize the
* GLib thread system using Glib::thread_init() before any other GLib functions
* are called and use either this function or Gst::init() without the command
* line arguments before calling any gstreamermm functions. GLib thread
* initialization can be done as follows:
*
* @code
* if(!Glib::thread_supported())
* Glib::thread_init();
* ...
* @endcode
*
* 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.
*
* @return true if GStreamer could be initialized.
* @throw Glib::Error
*/
bool init_check();
/** Use this function to check if GStreamer has been initialized.
* @return <tt>true</tt> if initialization has been done, <tt>false</tt>
* otherwise.
*/
bool is_initialized(void);
/** Clean up any resources created by GStreamer upon initialization.
*
* It is normally not needed to call this function in a normal application as
* the resources will automatically be freed when the program terminates.
* This function is therefore mostly used by testsuites and other memory
* profiling tools.
*
* After this call GStreamer (including this method) should not be used
* anymore.
*/
void deinit();
/** Returns a Glib::OptionGroup 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() ).
*
* If you use this function, you should make sure you initialise the GLib
* threading system as one of the very first things in your program.
*
* @return A pointer to GStreamer's option group.
*/
Glib::OptionGroup get_option_group();
}//end namespace Gst
#endif //_GSTREAMERMM_INIT_H
|