/usr/include/gstreamermm-1.0/gstreamermm/context.h is in libgstreamermm-1.0-dev 1.10.0+dfsg-1.
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 171 172 173 174 175 176 177 178 179 180 | // Generated by gmmproc 2.50.1 -- DO NOT MODIFY!
#ifndef _GSTREAMERMM_CONTEXT_H
#define _GSTREAMERMM_CONTEXT_H
#include <glibmm/ustring.h>
#include <sigc++/sigc++.h>
/* gstreamermm - a C++ wrapper for gstreamer
*
* Copyright 2014-2016 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.
*/
#include <gst/gstcontext.h>
#include <gstreamermm/miniobject.h>
namespace Gst
{
class Structure;
/** Lightweight objects to represent element contexts
*
* Gst::Context is a container object used to store contexts like a device
* context, a display server connection and similar concepts that should
* be shared between multiple elements.
*
* Applications can set a context on a complete pipeline by using
* Gst::Element::set_context(), which will then be propagated to all
* child elements. Elements can handle these in Gst::Element::set_context_vfunc()
* and merge them with the context information they already have.
*
* When an element needs a context it will do the following actions in this
* order until one step succeeds:
* 1. Check if the element already has a context
* 2. Query downstream with Gst::QUERY_CONTEXT for the context
* 3. Query upstream with Gst::QUERY_CONTEXT for the context
* 4. Post a Gst::MESSAGE_NEED_CONTEXT message on the bus with the required
* context types and afterwards check if a usable context was set now
* 5. Create a context by itself and post a Gst::MESSAGE_HAVE_CONTEXT message
* on the bus.
*
* Bins will catch Gst::MESSAGE_NEED_CONTEXT messages and will set any previously
* known context on the element that asks for it if possible. Otherwise the
* application should provide one if it can.
*
* Last reviewed on 2016-05-16 (1.8.0)
*
* Since: 1.2
*/
class Context : public MiniObject
{
public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
using CppObjectType = Context;
using BaseObjectType = GstContext;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
/** Increment the reference count for this object.
* You should never need to do this manually - use the object via a RefPtr instead.
*/
void reference() const;
/** Decrement the reference count for this object.
* You should never need to do this manually - use the object via a RefPtr instead.
*/
void unreference() const;
///Provides access to the underlying C instance.
GstContext* gobj();
///Provides access to the underlying C instance.
const GstContext* gobj() const;
///Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
GstContext* gobj_copy() const;
Context() = delete;
// noncopyable
Context(const Context&) = delete;
Context& operator=(const Context&) = delete;
protected:
// Do not derive this. Gst::Context can neither be constructed nor deleted.
void operator delete(void*, std::size_t);
private:
public:
/** Create a new context.
*
* @param context_type Context type.
* @param persistent Persistent context.
* @return The new context.
*/
static Glib::RefPtr<Gst::Context> create(const Glib::ustring& context_type, bool persistent);
/** Creates a copy of the context. Returns a copy of the context.
*
* @return A new copy of @a context.
*
* MT safe.
*/
Glib::RefPtr<Gst::Context> copy() const;
/** Get the type of @a context.
*
* @return The type of the context.
*/
Glib::ustring get_context_type() const;
/** Checks if @a context has @a context_type.
*
* @param context_type Context type to check.
* @return <tt>true</tt> if @a context has @a context_type.
*/
bool has_context_type(const Glib::ustring& context_type) const;
/** Check if @a context is persistent.
*
* @return <tt>true</tt> if the context is persistent.
*/
bool is_persistent() const;
/** Get a writable version of the structure.
*
* @return The structure of the context. The structure is still
* owned by the context, which means that you should not free it and
* that the pointer becomes invalid when you free the context.
* This function checks if @a context is writable.
*/
Gst::Structure writable_structure() const;
};
}
namespace Glib
{
/** A Glib::wrap() method for this object.
*
* @param object The C instance.
* @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
* @result A C++ instance that wraps this C instance.
*
* @relates Gst::Context
*/
Glib::RefPtr<Gst::Context> wrap(GstContext* object, bool take_copy = false);
} // namespace Glib
#endif /* _GSTREAMERMM_CONTEXT_H */
|