Gst.MiniObject

Gst.MiniObject is a simple structure that can be used to implement refcounted types.

Subclasses will include Gst.MiniObject as the first member in their structure and then call init to initialize the Gst.MiniObject fields.

Gst.ref and Gst.unref increment and decrement the refcount respectively. When the refcount of a mini-object reaches 0, the dispose function is called first and when this returns true, the free function of the miniobject is called.

A copy can be made with Gst.copy.

Gst.is_writable will return true when the refcount of the object is exactly 1, meaning the current caller has the only reference to the object. Gst.make_writable will return a writable version of the object, which might be a new copy when the refcount was not 1.

Opaque data can be associated with a Gst.MiniObject with Gst.set_qdata and Gst.get_qdata. The data is meant to be specific to the particular object and is not automatically copied with Gst.copy or similar methods.

A weak reference can be added and remove with Gst.weak_ref and Gst.weak_unref respectively.

Last reviewed on 2012-06-15 (0.11.93)