| gstreamermm 0.10.10 | 
Discoverer - Utility for discovering information on URIs. More...


| Public Member Functions | |
| virtual | ~Discoverer () | 
| GstDiscoverer* | gobj () | 
| Provides access to the underlying C GObject. | |
| const GstDiscoverer* | gobj () const | 
| Provides access to the underlying C GObject. | |
| GstDiscoverer* | gobj_copy () | 
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. | |
| void | start () | 
| Allow asynchronous discovering of URIs to take place. | |
| void | stop () | 
| Stop the discovery of any pending URIs and clears the list of pending URIS (if any). | |
| Glib::RefPtr< DiscovererInfo > | discover_uri (const Glib::ustring& uri) | 
| Synchronously discovers the given uri. | |
| bool | discover_uri_async (const Glib::ustring& uri) | 
| Appends the given uri to the list of URIs to discoverer. | |
| Glib::PropertyProxy< guint64 > | property_timeout () | 
| Timeout. | |
| Glib::PropertyProxy_ReadOnly < guint64 > | property_timeout () const | 
| Timeout. | |
| Glib::SignalProxy2< void, const Glib::RefPtr < DiscovererInfo >&, const Glib::Error& > | signal_discovered () | 
| Glib::SignalProxy0< void > | signal_finished () | 
| Glib::SignalProxy0< void > | signal_starting () | 
| Static Public Member Functions | |
| static Glib::RefPtr< Discoverer > | create (ClockTime timeout) | 
| Creates a new Gst::Discoverer with the provided timeout. | |
| Protected Member Functions | |
| Discoverer (ClockTime timeout) | |
| virtual void | on_discovered (const Glib::RefPtr< DiscovererInfo >& info, const Glib::Error& error) | 
| virtual void | on_finished () | 
| virtual void | on_starting () | 
| Related Functions | |
| (Note that these are not member functions.) | |
| Glib::RefPtr< Gst::Discoverer > | wrap (GstDiscoverer* object, bool take_copy=false) | 
| A Glib::wrap() method for this object. | |
Discoverer - Utility for discovering information on URIs.
The Discoverer is a utility object which allows to get as much information as possible from one or many URIs.
It provides two APIs, allowing usage in blocking or non-blocking mode.
The blocking mode just requires calling discover_uri() with the URI one wishes to discover.
The non-blocking mode requires a running Glib::MainLoop in the default Glib::MainContext, where one connects to the various signals, appends the URIs to be processed (through discover_uri_async()) and then asks for the discovery to begin (through start()).
All the information is returned in a DiscovererInfo structure.
| virtual Gst::Discoverer::~Discoverer | ( | ) |  [virtual] | 
| Gst::Discoverer::Discoverer | ( | ClockTime | timeout | ) |  [explicit, protected] | 
| static Glib::RefPtr<Discoverer> Gst::Discoverer::create | ( | ClockTime | timeout | ) |  [static] | 
Creates a new Gst::Discoverer with the provided timeout.
| timeout | Timeout per file, in nanoseconds. Allowed are values between one second (Gst::SECOND) and one hour (3600 * Gst::SECOND). | 
| err | A pointer to a Error. can be 0. | 
0 will be returned. If err is set, the caller must free it when no longer needed using Glib::error_free(). | Glib::RefPtr<DiscovererInfo> Gst::Discoverer::discover_uri | ( | const Glib::ustring & | uri | ) | 
Synchronously discovers the given uri.
A copy of uri will be made internally, so the caller can safely Glib::free() afterwards.
| uri | The URI to run on. | 
| err | If an error occurred, this field will be filled in. | 
0 if an error occurred. | bool Gst::Discoverer::discover_uri_async | ( | const Glib::ustring & | uri | ) | 
Appends the given uri to the list of URIs to discoverer.
The actual discovery of the uri will only take place if start() has been called.
A copy of uri will be made internally, so the caller can safely Glib::free() afterwards.
| uri | The URI to add. | 
true if the uri was succesfully appended to the list of pending uris, else false. | GstDiscoverer* Gst::Discoverer::gobj | ( | ) |  [inline] | 
Provides access to the underlying C GObject.
Reimplemented from Glib::ObjectBase.
| const GstDiscoverer* Gst::Discoverer::gobj | ( | ) | const  [inline] | 
Provides access to the underlying C GObject.
Reimplemented from Glib::ObjectBase.
| GstDiscoverer* Gst::Discoverer::gobj_copy | ( | ) | 
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
| virtual void Gst::Discoverer::on_discovered | ( | const Glib::RefPtr< DiscovererInfo >& | info, | 
| const Glib::Error & | error | ||
| ) |  [protected, virtual] | 
| virtual void Gst::Discoverer::on_finished | ( | ) |  [protected, virtual] | 
| virtual void Gst::Discoverer::on_starting | ( | ) |  [protected, virtual] | 
| Glib::PropertyProxy<guint64> Gst::Discoverer::property_timeout | ( | ) | 
Timeout.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy_ReadOnly<guint64> Gst::Discoverer::property_timeout | ( | ) | const | 
Timeout.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::SignalProxy2< void,const Glib::RefPtr<DiscovererInfo>&,const Glib::Error& > Gst::Discoverer::signal_discovered | ( | ) | 
void on_my_discovered(const Glib::RefPtr<DiscovererInfo>& info, const Glib::Error& error) | Glib::SignalProxy0< void > Gst::Discoverer::signal_finished | ( | ) | 
void on_my_finished() | Glib::SignalProxy0< void > Gst::Discoverer::signal_starting | ( | ) | 
void on_my_starting() | void Gst::Discoverer::start | ( | ) | 
Allow asynchronous discovering of URIs to take place.
A MainLoop must be available for Gst::Discoverer to properly work in asynchronous mode.
| void Gst::Discoverer::stop | ( | ) | 
Stop the discovery of any pending URIs and clears the list of pending URIS (if any).
| Glib::RefPtr< Gst::Discoverer > wrap | ( | GstDiscoverer * | object, | 
| bool | take_copy = false | ||
| ) |  [related] | 
A Glib::wrap() method for this object.
| object | The C instance. | 
| take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. | 
 1.7.3
 1.7.3