A new caps query object. More...

#include <gstreamermm/query.h>

Inheritance diagram for Gst::QueryCaps:

Public Member Functions
Glib::RefPtr< Gst::Caps >	parse () const
	Get the filter from the caps query. More...

Glib::RefPtr< Gst::Caps >	parse_caps_result () const
	Get the caps result from query. More...

void	set_caps_result (const Glib::RefPtr< Gst::Caps >& caps)
	Set the caps result in query. More...

Public Member Functions inherited from Gst::Query
void	reference () const
	Increment the reference count for this object. More...

void	unreference () const
	Decrement the reference count for this object. More...

GstQuery*	gobj ()
	Provides access to the underlying C instance. More...

const GstQuery*	gobj () const
	Provides access to the underlying C instance. More...

GstQuery*	gobj_copy () const
	Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...

	Query ()=delete

	Query (const Query&)=delete

Query&	operator= (const Query&)=delete

Glib::RefPtr< Gst::Query >	create_writable ()
	Makes a writable query from the given query. More...

Gst::Structure	get_structure () const
	Get the structure of a query. More...

QueryType	get_query_type () const
	Get the Gst::QueryType of the query. More...

Glib::RefPtr< Gst::Query >	copy ()
	Copies the given query using the copy function of the parent Gst::Structure. More...

Public Member Functions inherited from Gst::MiniObject
void	reference () const
	Increment the reference count for this object. More...

void	unreference () const
	Decrement the reference count for this object. More...

GstMiniObject*	gobj ()
	Provides access to the underlying C instance. More...

const GstMiniObject*	gobj () const
	Provides access to the underlying C instance. More...

GstMiniObject*	gobj_copy () const
	Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...

	MiniObject ()=delete

	MiniObject (const MiniObject&)=delete

MiniObject&	operator= (const MiniObject&)=delete

	~MiniObject ()

guint	get_flags () const

void	set_flags (const guint& value)

gint	get_refcount () const

gint	get_lockstate () const

bool	lock (LockFlags flags)
	Lock the mini-object with the specified access mode in flags. More...

void	unlock (LockFlags flags)
	Unlock the mini-object with the specified access mode in flags. More...

bool	is_writable () const
	If mini_object has the LOCKABLE flag set, check if the current EXCLUSIVE lock on object is the only one, this means that changes to the object will not be visible to any other object. More...

Glib::RefPtr< MiniObject >	create_writable ()
	Checks if a mini-object is writable. More...

void	set_qdata (GQuark quark, QuarkData* data)
	This sets an opaque, named pointer on a miniobject. More...

QuarkData*	get_qdata (GQuark quark) const
	This function gets back user data pointers stored via set_qdata(). More...

QuarkData*	steal_qdata (GQuark quark)
	This function gets back user data pointers stored via set_qdata() and removes the data from object without invoking its destroy() function (if any was set). More...

void	add_finalize_notifier (const SlotFinalizer& slot)
	Adds notifier when mini object is finalized. More...

void	remove_finalize_notifier ()
	Remove finalize notifier. More...

Static Public Member Functions
static Glib::RefPtr< Gst::QueryCaps >	create (const Glib::RefPtr< Gst::Caps >& filter)
	Constructs a new query object for querying the caps. More...

Static Public Member Functions inherited from Gst::Query
static Glib::RefPtr< Gst::Query >	create_buffering (Gst::Format format)
	Constructs a new query object for querying the buffering status of a stream. More...

static Glib::RefPtr< Gst::Query >	create_allocation (Glib::RefPtr< Gst::Caps > caps, bool need_pool)
	Constructs a new query object for querying the allocation properties. More...

static Glib::RefPtr< Gst::Query >	create_uri ()
	Constructs a new query URI query object. More...

static Glib::RefPtr< Gst::Query >	create_scheduling ()
	Constructs a new query object for querying the scheduling properties. More...

static Glib::RefPtr< Gst::Query >	create_drain ()
	Constructs a new query object for querying the drain state. More...

static Glib::RefPtr< Gst::Query >	create_custom (Gst::QueryType type, const Gst::Structure& structure)
	Constructs a new custom query object. More...

static Glib::RefPtr< Gst::Query >	create_convert (Gst::Format format, gint64 value, Gst::Format dest_format)
	Constructs a new convert query object. More...

static Glib::RefPtr< Gst::Query >	create_position (Gst::Format format)
	Constructs a new query stream position query object. More...

static Glib::RefPtr< Gst::Query >	create_duration (Gst::Format format)
	Constructs a new stream duration query object to query in the given format. More...

static Glib::RefPtr< Gst::Query >	create_latency ()
	Constructs a new latency query object. More...

static Glib::RefPtr< Gst::Query >	create_seeking (Gst::Format format)
	Constructs a new query object for querying seeking properties of the stream. More...

static Glib::RefPtr< Gst::Query >	create_formats ()
	Constructs a new query object for querying formats of the stream. More...

static Glib::RefPtr< Gst::Query >	create_segment (Gst::Format format)
	Constructs a new segment query object. More...

static Glib::RefPtr< Gst::Query >	create_caps (Glib::RefPtr< Gst::Caps > filter)
	Constructs a new query object for querying the caps. More...

static Glib::RefPtr< Gst::Query >	create_accept_caps (Glib::RefPtr< Gst::Caps > filter)
	Constructs a new query object for querying if filter are accepted. More...

Additional Inherited Members
Public Types inherited from Gst::MiniObject
typedef sigc::slot< void >	SlotFinalizer

Protected Member Functions inherited from Gst::Query
void	operator delete (void*, std::size_t)

Protected Member Functions inherited from Gst::MiniObject
void	operator delete (void*, std::size_t)

Static Protected Member Functions inherited from Gst::Query
template<class QueryType >
static Glib::RefPtr< QueryType >	wrap (GstQuery* query, bool take_copy=false)

Related Functions inherited from Gst::Query
Glib::RefPtr< Gst::Query >	wrap (GstQuery* object, bool take_copy=false)
	A Glib::wrap() method for this object. More...

Related Functions inherited from Gst::MiniObject
Glib::RefPtr< Gst::MiniObject >	wrap (GstMiniObject* object, bool take_copy=false)
	A Glib::wrap() method for this object. More...

Detailed Description

A new caps query object.

See create() for more details.

Member Function Documentation

◆ create()

static Glib::RefPtr<Gst::QueryCaps> Gst::QueryCaps::create ( const Glib::RefPtr< Gst::Caps >& filter )

static

Constructs a new query object for querying the caps.

The CAPS query should return the allowable caps for a pad in the context of the element's state, its link to other elements, and the devices or files it has opened. These caps must be a subset of the pad template caps. In the NULL state with no links, the CAPS query should ideally return the same caps as the pad template. In rare circumstances, an object property can affect the caps returned by the CAPS query, but this is discouraged. For most filters, the caps returned by CAPS query is directly affected by the allowed caps on other pads. For demuxers and decoders, the caps returned by the srcpad's getcaps function is directly related to the stream data. Again, the CAPS query should return the most specific caps it reasonably can, since this helps with autoplugging.

The filter is used to restrict the result caps, only the caps matching filter should be returned from the CAPS query. Specifying a filter might greatly reduce the amount of processing an element needs to do.

Parameters

filter a filter.

Returns: The new Gst::QureyCaps.

◆ parse()

Glib::RefPtr<Gst::Caps> Gst::QueryCaps::parse ( ) const

Get the filter from the caps query.

The caps remains valid as long as query remains valid.

Returns: caps filter.

◆ parse_caps_result()

Glib::RefPtr<Gst::Caps> Gst::QueryCaps::parse_caps_result ( ) const

Get the caps result from query.

The caps remains valid as long as query remains valid.

Returns: a pointer to the caps.

◆ set_caps_result()

void Gst::QueryCaps::set_caps_result ( const Glib::RefPtr< Gst::Caps >& caps )

Set the caps result in query.