MiniObject

Description GstMiniObject is a baseclass like GObject, but has been stripped down of features to be fast and small. It offers sub-classing and ref-counting in the same way as GObject does. It has no properties and no signal-support though. Last reviewed on 2005-11-23 (0.9.5)

class MiniObject {

protected

GstMiniObject* gstMiniObject;

GstMiniObject* getMiniObjectStruct();

void* getStruct();

this(GstMiniObject* gstMiniObject);

this(GType type);

MiniObject copy();

int isWritable();

MiniObject makeWritable();

MiniObject doref();

void unref();

static void replace(MiniObject olddata, MiniObject newdata);

static ParamSpec gstParamSpecMiniObject(string name, string nick, string blurb, GType objectType, GParamFlags flags);

static void gstValueSetMiniObject(Value value, MiniObject miniObject);

static void gstValueTakeMiniObject(Value value, MiniObject miniObject);

static MiniObject gstValueGetMiniObject(Value value);

}

Constructors

this this(GstMiniObject* gstMiniObject): Sets our main struct and passes it to the parent class
this this(GType type): Creates a new mini-object of the desired type. MT safe

Members

Functions

copy MiniObject copy(): Creates a copy of the mini-object. MT safe
doref MiniObject doref(): Increase the reference count of the mini-object. Note that the refcount affects the writeability of mini-object, see gst_mini_object_is_writable(). It is important to note that keeping additional references to GstMiniObject instances can potentially increase the number of memcpy operations in a pipeline, especially if the minibject is a GstBuffer.
getMiniObjectStruct GstMiniObject* getMiniObjectStruct(): Undocumented in source. Be warned that the author may not have intended to support it.
getStruct void* getStruct(): the main Gtk struct as a void*
isWritable int isWritable(): Checks if a mini-object is writable. A mini-object is writable if the reference count is one and the GST_MINI_OBJECT_FLAG_READONLY flag is not set. Modification of a mini-object should only be done after verifying that it is writable. MT safe
makeWritable MiniObject makeWritable(): Checks if a mini-object is writable. If not, a writeable copy is made and returned. This gives away the reference to the original mini object, and returns a reference to the new object. MT safe
unref void unref(): Decreases the reference count of the mini-object, possibly freeing the mini-object.

Static functions

gstParamSpecMiniObject ParamSpec gstParamSpecMiniObject(string name, string nick, string blurb, GType objectType, GParamFlags flags): Creates a new GParamSpec instance that hold GstMiniObject references.
gstValueGetMiniObject MiniObject gstValueGetMiniObject(Value value): Get the contents of a GST_TYPE_MINI_OBJECT derived GValue. Does not increase the refcount of the returned object.
gstValueSetMiniObject void gstValueSetMiniObject(Value value, MiniObject miniObject): Set the contents of a GST_TYPE_MINI_OBJECT derived GValue to mini_object. The caller retains ownership of the reference.
gstValueTakeMiniObject void gstValueTakeMiniObject(Value value, MiniObject miniObject): Set the contents of a GST_TYPE_MINI_OBJECT derived GValue to mini_object. Takes over the ownership of the caller's reference to mini_object; the caller doesn't have to unref it any more.
replace void replace(MiniObject olddata, MiniObject newdata): Modifies a pointer to point to a new mini-object. The modification is done atomically, and the reference counts are updated correctly. Either newdata and the value pointed to by olddata may be NULL.

Variables

gstMiniObject GstMiniObject* gstMiniObject;: the main Gtk struct