diff --git a/src/mpdclient.h b/src/mpdclient.h
index 9f22d268cc046e05b1c8279b0459231590e77a23..1d3b6e0b547d61f292480d6eff9da533230e4a03 100644 (file)
--- a/src/mpdclient.h
+++ b/src/mpdclient.h
#ifndef MPDCLIENT_H
#define MPDCLIENT_H
+#include "config.h"
#include "playlist.h"
+#include "Compiler.h"
#include <mpd/client.h>
struct filelist;
struct mpdclient {
+#ifdef ENABLE_ASYNC_CONNECT
+ /**
+ * These settings are used to connect to MPD asynchronously.
+ */
+ struct mpd_settings *settings;
+
+#ifndef WIN32
+ /**
+ * A second set of settings, just in case #settings did not
+ * work. This is only used if #settings refers to a local
+ * socket path, and this one is supposed to be a fallback to
+ * IP on the default port (6600).
+ */
+ struct mpd_settings *settings2;
+#endif
+
+#else
+ const char *host;
+ unsigned port;
+#endif
+
+ unsigned timeout_ms;
+
+ const char *password;
+
/* playlist */
struct mpdclient_playlist playlist;
+#ifdef ENABLE_ASYNC_CONNECT
+ struct aconnect *async_connect;
+#endif
+
struct mpd_connection *connection;
/**
- * If this object is non-NULL, it tracks idle events. It is
- * automatically called by mpdclient_get_connection() and
- * mpdclient_put_connection(). It is not created by the
- * mpdclient library; the user of this library has to
- * initialize it. However, it is freed when the MPD
- * connection is closed.
+ * Tracks idle events. It is automatically called by
+ * mpdclient_get_connection().
*/
struct mpd_glib_source *source;
+ struct mpd_status *status;
+ const struct mpd_song *song;
+
/**
- * This attribute is true when the connection is currently in
- * "idle" mode, and the #mpd_glib_source waits for an event.
+ * The GLib source id which re-enters MPD idle mode before the
+ * next main loop interation.
*/
- bool idle;
+ unsigned enter_idle_source_id;
- struct mpd_status *status;
- const struct mpd_song *song;
+ /**
+ * This attribute is incremented whenever the connection changes
+ * (i.e. on disconnection and (re-)connection).
+ */
+ unsigned connection_id;
int volume;
- unsigned update_id;
/**
- * A bit mask of idle events occured since the last update.
+ * A bit mask of idle events occurred since the last update.
*/
enum mpd_idle events;
+
+#if defined(ENABLE_ASYNC_CONNECT) && !defined(WIN32)
+ bool connecting2;
+#endif
+
+ /**
+ * This attribute is true when the connection is currently in
+ * "idle" mode, and the #mpd_glib_source waits for an event.
+ */
+ bool idle;
+
+ /**
+ * Is MPD currently playing?
+ */
+ bool playing;
+};
+
+enum {
+ /**
+ * all idle events the version of libmpdclient, ncmpc is compiled
+ * against, supports
+ */
+ MPD_IDLE_ALL = MPD_IDLE_DATABASE
+ | MPD_IDLE_STORED_PLAYLIST
+ | MPD_IDLE_QUEUE
+ | MPD_IDLE_PLAYER
+ | MPD_IDLE_MIXER
+ | MPD_IDLE_OUTPUT
+ | MPD_IDLE_OPTIONS
+ | MPD_IDLE_UPDATE
+ | MPD_IDLE_STICKER
+ | MPD_IDLE_SUBSCRIPTION
+ | MPD_IDLE_MESSAGE
};
/** functions ***************************************************************/
bool
mpdclient_handle_error(struct mpdclient *c);
+static inline bool
+mpdclient_finish_command(struct mpdclient *c)
+{
+ return mpd_response_finish(c->connection)
+ ? true : mpdclient_handle_error(c);
+}
+
struct mpdclient *
-mpdclient_new(void);
+mpdclient_new(const gchar *host, unsigned port,
+ unsigned timeout_ms, const gchar *password);
void mpdclient_free(struct mpdclient *c);
+/**
+ * Determine a human-readable "name" of the settings currently used to
+ * connect to MPD.
+ *
+ * @return an allocated string that needs to be freed (with g_free())
+ * by the caller
+ */
+char *
+mpdclient_settings_name(const struct mpdclient *c);
+
+gcc_pure
static inline bool
mpdclient_is_connected(const struct mpdclient *c)
{
return c->connection != NULL;
}
+/**
+ * Is this object "dead"? i.e. not connected and not currently doing
+ * anything to connect.
+ */
+gcc_pure
+static inline bool
+mpdclient_is_dead(const struct mpdclient *c)
+{
+ return c->connection == NULL
+#ifdef ENABLE_ASYNC_CONNECT
+ && c->async_connect == NULL
+#endif
+ ;
+}
+
+gcc_pure
+static inline bool
+mpdclient_is_playing(const struct mpdclient *c)
+{
+ return c->status != NULL &&
+ (mpd_status_get_state(c->status) == MPD_STATE_PLAY ||
+ mpd_status_get_state(c->status) == MPD_STATE_PAUSE);
+}
+
+gcc_pure
static inline const struct mpd_song *
mpdclient_get_current_song(const struct mpdclient *c)
{
- return c->song != NULL && c->status != NULL &&
- (mpd_status_get_state(c->status) == MPD_STATE_PLAY ||
- mpd_status_get_state(c->status) == MPD_STATE_PAUSE)
+ return c->song != NULL && mpdclient_is_playing(c)
? c->song
: NULL;
}
-bool
-mpdclient_connect(struct mpdclient *c, const gchar *host, gint port,
- gfloat timeout_, const gchar *password);
+void
+mpdclient_connect(struct mpdclient *c);
void
mpdclient_disconnect(struct mpdclient *c);
struct mpd_connection *
mpdclient_get_connection(struct mpdclient *c);
-void
-mpdclient_put_connection(struct mpdclient *c);
-
-/**
- * To be implemented by the application: mpdclient.c calls this to
- * display an error message.
- */
-void
-mpdclient_ui_error(const char *message);
-
/*** MPD Commands **********************************************************/
bool
mpdclient_cmd_delete_range(struct mpdclient *c, unsigned start, unsigned end);
bool
-mpdclient_cmd_move(struct mpdclient *c, gint old_index, gint new_index);
+mpdclient_cmd_move(struct mpdclient *c, unsigned dest, unsigned src);
+
+bool
+mpdclient_cmd_subscribe(struct mpdclient *c, const char *channel);
+
+bool
+mpdclient_cmd_unsubscribe(struct mpdclient *c, const char *channel);
+
+bool
+mpdclient_cmd_send_message(struct mpdclient *c, const char *channel,
+ const char *text);
+
+bool
+mpdclient_send_read_messages(struct mpdclient *c);
+
+struct mpd_message *
+mpdclient_recv_message(struct mpdclient *c);
/*** playlist functions **************************************************/
bool
mpdclient_filelist_add_all(struct mpdclient *c, struct filelist *fl);
-/* sort by list-format */
-gint compare_filelistentry_format(gconstpointer filelist_entry1, gconstpointer filelist_entry2);
-
#endif