src/mpdclient.h

   1 #ifndef MPDCLIENT_H
   2 #define MPDCLIENT_H
   3 #include "libmpdclient.h"
   4
   5 #define MPD_VERSION(c,x,y,z) (c->connection->version[0]*10000+c->connection->version[1]*100+c->connection->version[2] >= \
   6                               x*10000+y*100+z)
   7
   8 /****************************************************************************/
   9 /* Playlist */
  10 /****************************************************************************/
  11
  12 typedef struct
  13 {
  14   /* playlist id */
  15   long long id;
  16   /* list length */
  17   guint length;
  18   /* true if the list is updated */
  19   gboolean updated;
  20   /* the list */
  21   GList *list;
  22
  23 } mpdclient_playlist_t;
  24
  25
  26 typedef struct
  27 {
  28   guint flags;
  29   mpd_InfoEntity *entity;
  30 } filelist_entry_t;
  31
  32 typedef struct
  33 {
  34   /* path */
  35   gchar *path;
  36   /* list length */
  37   guint length;
  38   /* true if the list is updated */
  39   gboolean updated;
  40   /* the list */
  41   GList *list;
  42
  43 } mpdclient_filelist_t;
  44
  45 typedef struct
  46 {
  47   /* playlist */
  48   mpdclient_playlist_t playlist;
  49
  50   /* Callbacks */
  51   GList *error_callbacks;
  52   GList *playlist_callbacks;
  53   GList *browse_callbacks;
  54
  55   mpd_Connection *connection;
  56   mpd_Status     *status;
  57   mpd_Song       *song;
  58
  59   gboolean       need_update;
  60
  61 } mpdclient_t;
  62
  63 /** functions ***************************************************************/
  64 mpdclient_t *mpdclient_new(void);
  65 mpdclient_t *mpdclient_free(mpdclient_t *c);
  66 gint mpdclient_connect(mpdclient_t *c, gchar *host, gint port,
  67                        gfloat timeout, gchar *password);
  68 gint mpdclient_disconnect(mpdclient_t *c);
  69 gint mpdclient_update(mpdclient_t *c);
  70
  71
  72 /*** MPD Commands  **********************************************************/
  73 gint mpdclient_cmd_play(mpdclient_t *c, gint index);
  74 gint mpdclient_cmd_pause(mpdclient_t *c, gint value);
  75 gint mpdclient_cmd_stop(mpdclient_t *c);
  76 gint mpdclient_cmd_next(mpdclient_t *c);
  77 gint mpdclient_cmd_prev(mpdclient_t *c);
  78 gint mpdclient_cmd_seek(mpdclient_t *c, gint id, gint pos);
  79 gint mpdclient_cmd_shuffle(mpdclient_t *c);
  80 gint mpdclient_cmd_clear(mpdclient_t *c);
  81 gint mpdclient_cmd_repeat(mpdclient_t *c, gint value);
  82 gint mpdclient_cmd_random(mpdclient_t *c, gint value);
  83 gint mpdclient_cmd_crossfade(mpdclient_t *c, gint value);
  84 gint mpdclient_cmd_db_update_utf8(mpdclient_t *c, gchar *path);
  85 gint mpdclient_cmd_volume(mpdclient_t *c, gint value);
  86 gint mpdclient_cmd_add_path(mpdclient_t *c, gchar *path);
  87 gint mpdclient_cmd_add_path_utf8(mpdclient_t *c, gchar *path);
  88
  89 gint mpdclient_cmd_add(mpdclient_t *c, mpd_Song *song);
  90 gint mpdclient_cmd_delete(mpdclient_t *c, gint index);
  91 gint mpdclient_cmd_move(mpdclient_t *c, gint old_index, gint new_index);
  92
  93 gint mpdclient_cmd_save_playlist(mpdclient_t *c, gchar *filename);
  94 gint mpdclient_cmd_save_playlist_utf8(mpdclient_t *c, gchar *filename);
  95 gint mpdclient_cmd_load_playlist_utf8(mpdclient_t *c, gchar *filename_utf8);
  96 gint mpdclient_cmd_delete_playlist(mpdclient_t *c, gchar *filename);
  97 gint mpdclient_cmd_delete_playlist_utf8(mpdclient_t *c, gchar *filename_utf8);
  98
  99
 100 /*** error callbacks *****************************************************/
 101
 102 #define IS_ACK_ERROR(n)       (n & MPD_ERROR_ACK)
 103 #define GET_ACK_ERROR_CODE(n) ((n & 0xFF00) >> 8)
 104
 105 typedef void (*mpdc_error_cb_t) (mpdclient_t *c, gint error, gchar *msg);
 106
 107 void mpdclient_install_error_callback(mpdclient_t *c, mpdc_error_cb_t cb);
 108 void mpdclient_remove_error_callback(mpdclient_t *c, mpdc_error_cb_t cb);
 109
 110 /*** playlist functions  **************************************************/
 111
 112 /* free a playlist */
 113 gint mpdclient_playlist_free(mpdclient_playlist_t *playlist);
 114 /* update the complete playlist */
 115 gint mpdclient_playlist_update(mpdclient_t *c);
 116 /* get playlist changes */
 117 gint mpdclient_playlist_update_changes(mpdclient_t *c);
 118
 119 GList *playlist_lookup(mpdclient_t *c, gint id);
 120 mpd_Song *playlist_lookup_song(mpdclient_t *c, gint id);
 121 mpd_Song *playlist_get_song(mpdclient_t *c, gint index);
 122 gint playlist_get_index(mpdclient_t *c, mpd_Song *song);
 123 gint playlist_get_index_from_id(mpdclient_t *c, gint id);
 124 gint playlist_get_index_from_file(mpdclient_t *c, gchar *filename);
 125
 126
 127
 128 /*** mpdclient playlist callbacks *****************************************/
 129
 130 #define PLAYLIST_EVENT_UPDATED     0x01
 131 #define PLAYLIST_EVENT_CLEAR       0x02
 132 #define PLAYLIST_EVENT_DELETE      0x03
 133 #define PLAYLIST_EVENT_ADD         0x04
 134 #define PLAYLIST_EVENT_MOVE        0x05
 135
 136
 137 typedef void (*mpdc_list_cb_t) (mpdclient_t *c, int event, gpointer data);
 138
 139 /* install a playlist callback function */
 140 void mpdclient_install_playlist_callback(mpdclient_t *c, mpdc_list_cb_t cb);
 141
 142 /* remove a playlist callback function */
 143 void mpdclient_remove_playlist_callback(mpdclient_t *c, mpdc_list_cb_t cb);
 144
 145
 146 /* issue a playlist callback */
 147 void mpdclient_playlist_callback(mpdclient_t *c, int event, gpointer data);
 148
 149
 150 /*** filelist functions  ***************************************************/
 151 mpdclient_filelist_t *mpdclient_filelist_free(mpdclient_filelist_t *filelist);
 152 mpdclient_filelist_t *mpdclient_filelist_get(mpdclient_t *c, gchar *path);
 153 mpdclient_filelist_t *mpdclient_filelist_update(mpdclient_t *c,
 154                                                 mpdclient_filelist_t *flist);
 155
 156 #define HIGHLIGHT  (0x01)
 157 void mpdclient_filelist_set_flags(mpdclient_filelist_t *flist,
 158                                   mpd_Song *song,
 159                                   guint flags);
 160
 161 void mpdclient_filelist_clear_flags(mpdclient_filelist_t *flist);
 162 void mpdclient_filelist_clear_flags(mpdclient_filelist_t *flist);
 163 filelist_entry_t *mpdclient_filelist_find_song(mpdclient_filelist_t *flist,
 164                                                mpd_Song *song);
 165
 166 /*** mpdclient browse callbacks ********************************************/
 167
 168 #define BROWSE_DB_UPDATED          0x01
 169 #define BROWSE_PLAYLIST_SAVED      0x02
 170 #define BROWSE_PLAYLIST_DELETED    0x03
 171
 172
 173 /* install a playlist callback function */
 174 void mpdclient_install_browse_callback(mpdclient_t *c, mpdc_list_cb_t cb);
 175
 176 /* remove a playlist callback function */
 177 void mpdclient_remove_browse_callback(mpdclient_t *c, mpdc_list_cb_t cb);
 178
 179
 180 /* issue a playlist callback */
 181 void mpdclient_browse_callback(mpdclient_t *c, int event, gpointer data);
 182
 183
 184 #endif