|
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