blackboard
[Device proxies]

Collaboration diagram for blackboard:


Detailed Description

The blackboard proxy provides an interface to a simple data-store in a similar fashion to a hash-map.

Data is set and retrieved by using a label. Any player message structure can be stored in the blackboard. At this time it is up to the user to pack and unpack the entry data. The xdr functions can be used to do this.


Classes

struct  playerc_blackboard
 BlackBoard proxy. More...

Defines

#define PLAYERC_BLACKBOARD_DATA_TYPE_NONE   0
#define PLAYERC_BLACKBOARD_DATA_TYPE_SIMPLE   1
#define PLAYERC_BLACKBOARD_DATA_TYPE_COMPLEX   2
#define PLAYERC_BLACKBOARD_DATA_SUBTYPE_NONE   0
#define PLAYERC_BLACKBOARD_DATA_SUBTYPE_STRING   1
#define PLAYERC_BLACKBOARD_DATA_SUBTYPE_INT   2
#define PLAYERC_BLACKBOARD_DATA_SUBTYPE_DOUBLE   3

Typedefs

typedef playerc_blackboard playerc_blackboard_t
 BlackBoard proxy.

Functions

playerc_blackboard_tplayerc_blackboard_create (playerc_client_t *client, int index)
 Create a blackboard proxy.
void playerc_blackboard_destroy (playerc_blackboard_t *device)
 Destroy a blackboard proxy.
int playerc_blackboard_subscribe (playerc_blackboard_t *device, int access)
 Subscribe to the blackboard device.
int playerc_blackboard_unsubscribe (playerc_blackboard_t *device)
 Un-subscribe from the blackboard device.
int playerc_blackboard_subscribe_to_key (playerc_blackboard_t *device, const char *key, const char *group, player_blackboard_entry_t **entry)
 Subscribe to a key.
int playerc_blackboard_get_entry (playerc_blackboard_t *device, const char *key, const char *group, player_blackboard_entry_t **entry)
 Get the current value of a key, without subscribing.
int playerc_blackboard_unsubscribe_from_key (playerc_blackboard_t *device, const char *key, const char *group)
 Unsubscribe from a key.
int playerc_blackboard_subscribe_to_group (playerc_blackboard_t *device, const char *group)
 Subscribe to a group.
int playerc_blackboard_unsubscribe_from_group (playerc_blackboard_t *device, const char *group)
 Unsubscribe from a group.
int playerc_blackboard_set_entry (playerc_blackboard_t *device, player_blackboard_entry_t *entry)
 Set an entry value.
int playerc_blackboard_set_string (playerc_blackboard_t *device, const char *key, const char *group, const char *value)
int playerc_blackboard_set_int (playerc_blackboard_t *device, const char *key, const char *group, const int value)
int playerc_blackboard_set_double (playerc_blackboard_t *device, const char *key, const char *group, const double value)

Function Documentation

int playerc_blackboard_get_entry ( playerc_blackboard_t device,
const char *  key,
const char *  group,
player_blackboard_entry_t **  entry 
)

Get the current value of a key, without subscribing.

If entry is none null it will be filled in with the response. The caller is responsible for freeing it.

int playerc_blackboard_subscribe_to_group ( playerc_blackboard_t device,
const char *  group 
)

Subscribe to a group.

The current entries are sent as data messages.

int playerc_blackboard_subscribe_to_key ( playerc_blackboard_t device,
const char *  key,
const char *  group,
player_blackboard_entry_t **  entry 
)

Subscribe to a key.

If entry is none null it will be filled in with the response. The caller is responsible for freeing it.


Last updated 12 September 2005 21:38:45