Top | ![]() |
![]() |
![]() |
![]() |
An interface which all devices which support interactive learning of controls should implement.
The interface comes with an implementation for caching the learned controls.
The implementor needs to call btic_learn_load_controller_map()
after
construction and btic_learn_store_controller_map()
when a control got added.
The cache files are stored under user-data-dir/buzztrax/controller-maps, e.g.
~/.local/share/buzztrax/controller-maps/.
gboolean
btic_learn_start (const BtIcLearn *self
);
Starts the device if needed and enables the learn function. Starts emission of notify::devide-controlchange signals.
gboolean
btic_learn_stop (const BtIcLearn *self
);
Eventually stops the device and disables the learn function. Stops emission of notify::devide-controlchange signals.
BtIcControl * btic_learn_register_learned_control (const BtIcLearn *self
,const gchar *name
);
Registers the last detected control with name name
.
self |
the device which implements the BtIcLearn interface |
|
name |
the name under which to register the control |
gboolean
btic_learn_load_controller_map (const BtIcLearn *self
);
Create initial set of controls from a stored control map. Interface
implementations should call this from their GObjectClass.constructed()
function.
gboolean
btic_learn_store_controller_map (const BtIcLearn *self
);
Store a map of all controls to disk. Interface implementations should call
this from their btic_learn_register_learned_control()
function after they
registered a new control.
gboolean
(*btic_learn_virtual_start) (gconstpointer self
);
Subclasses will override this methods with a function which enables the learning mode on this device.
gboolean
(*btic_learn_virtual_stop) (gconstpointer self
);
Subclasses will override this methods with a function which disables the learning mode on this device.
BtIcControl * (*btic_learn_virtual_register_learned_control) (gconstpointer self
,const gchar *name
);
Subclasses will override this methods with a function which registers the last control which was detected in learn mode.
“device-controlchange”
property“device-controlchange” gchar *
get the last detected control.
Flags: Read / Write
Default value: NULL