SwamiControlProp

typedef struct _SwamiControlProp SwamiControlProp;

swami_get_control_prop ()

SwamiControl *      swami_get_control_prop              (GObject *object,
                                                         GParamSpec *pspec);

Gets the SwamiControlProp object associated with an object's GObject property by pspec. If a control for the given object and pspec does not yet exist, then it is created and returned. Passing NULL for object and/or pspec create's a wildcard control which receives property change events for a specific property of all items (object is NULL), any property of a specifc item (pspec is NULL) or all item property changes (both are NULL). Note that wildcard property controls only work for IpatchItem derived objects currently.

swami_get_control_prop_by_name ()

SwamiControl *      swami_get_control_prop_by_name      (GObject *object,
                                                         const char *name);

Like swami_get_control_prop() but takes a property name instead. It is also therefore not possible to specify a wildcard object (NULL).

swami_control_prop_connect_objects ()

void                swami_control_prop_connect_objects  (GObject *src,
                                                         const char *propname1,
                                                         GObject *dest,
                                                         const char *propname2,
                                                         guint flags);

Connect the properties of two objects together using SwamiControlProp controls.

swami_control_prop_connect_to_control ()

void                swami_control_prop_connect_to_control
                                                        (GObject *src,
                                                         const char *propname,
                                                         SwamiControl *dest,
                                                         guint flags);

A convenience function to connect an object property as the source control to another SwamiControl.

swami_control_prop_connect_from_control ()

void                swami_control_prop_connect_from_control
                                                        (SwamiControl *src,
                                                         GObject *dest,
                                                         const char *propname,
                                                         guint flags);

A convenience function to connect a SwamiControl to an object property as the destination control.

swami_control_prop_new ()

SwamiControlProp *  swami_control_prop_new              (GObject *object,
                                                         GParamSpec *pspec);

Create a new GObject property control. Note that swami_get_control_prop() is likely more desireable to use, since it will return an existing control if one already exists for the given object and pspec.

If one of object or pspec is NULL then it acts as a wildcard and the control will send only (transmit changes for matching properties). If both are NULL however, the control has no active property to control (use swami_get_control_prop() if a IpatchItem entirely wildcard callback is desired). If object and/or pspec is wildcard then the control will use SwamiEventPropChange events instead of just the property value.

swami_control_prop_assign ()

void                swami_control_prop_assign           (SwamiControlProp *ctrlprop,
                                                         GObject *object,
                                                         GParamSpec *pspec,
                                                         gboolean send_events);

Assign the object property to control for a SwamiControlProp object. If a property is already set for the control the new object property must honor existing input/output connections by being writable/readable respectively and have the same value type.

If one of object or pspec is NULL then it acts as a wildcard and the control will send only (transmit changes for matching properties). If both are NULL however, the control has no active property to control.

swami_control_prop_assign_by_name ()

void                swami_control_prop_assign_by_name   (SwamiControlProp *ctrlprop,
                                                         GObject *object,
                                                         const char *prop_name);

Like swami_control_prop_assign() but accepts a name of a property instead of the param spec. Note also that object may not be wildcard, contrary to the other function.