General Description
This is an egg that provides a (fairly brain-dead) interface to
libxmmsclient, for xmms2. See
http://doxygen.xmms2.xmms.se/clientlib/stable/xmmsclient/modules.html
and
http://doxygen.xmms2.xmms.se/clientlib/stable/xmmsclient/xmmsclient_8c.html
for details of the actual functions, since this egg mostly just
exports the C functions with the same names.
The libxmmsclient tutorials, in Scheme form, are bundled with
this egg; look at them for examples.
This egg is basically xmmsclient.h and xmmsc_coll.h, as of 0.2
DrJekyll, with bits grabbed from other includes.
Differences/Changes
- All enums have been turned into const int declarations
- uint32_t has been turned into unsigned int
- int32_t has been turned into int
- These two:
- XMMS_CALLBACK_SET(conn,meth,callback,udata)
- XMMS_CALLBACK_SET_FULL(conn,meth,callback,udata,free_func)
have been converted from macros to functions.
Not Supported
- xmmsc_result_t *xmmsc_medialib_select (xmmsc_connection_t *conn,
const char *query) XMMS_DEPRECATED;
Local Additions
- char *xmmsc_userconfdir_get_with_leak();
-
- Convenience function around xmmsc_userconfdir_get; mallocs its
own PATH_MAX sized buffer, and makes no attempt to free it.
- (xmms-wait call error-func)
- Wait on a libxmmsclient result, and also return that result. If
an error occurs, the actual text of the error is passed to
error-func (which should be a function of one argument).
- (xmms-result->string result error-func)
- Takes an xmms2 result that contains a string and returns the
string. error-func is passed to xmms-wait, so you don't need to call
xmms-wait yourself.
- (xmms-result->int result error-func)
- Takes an xmms2 result that contains an int and returns the int.
error-func is passed to xmms-wait, so you don't need to call
xmms-wait yourself.
- (xmms-result->int-list result error-func)
- Takes an xmms2 result that contains a list of ints and returns
them as a list. error-func is passed to xmms-wait, so you don't
need to call xmms-wait yourself.
- (xmms-result->string-list result)
- ; Takes an xmms2 result that contains a list of strings and
returns them as a list of strings. error-func is passed to
xmms-wait, so you don't need to call xmms-wait yourself.