Audacious
$Id:Doxyfile42802007-03-2104:39:00Znenolod$
|
00001 /* 00002 * Audacious: A cross-platform multimedia player 00003 * Copyright (c) 2007 Ben Tucker 00004 * 00005 * This program is free software; you can redistribute it and/or modify 00006 * it under the terms of the GNU General Public License as published by 00007 * the Free Software Foundation; under version 3 of the License. 00008 * 00009 * This program is distributed in the hope that it will be useful, 00010 * but WITHOUT ANY WARRANTY; without even the implied warranty of 00011 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 00012 * GNU General Public License for more details. 00013 * 00014 * You should have received a copy of the GNU General Public License 00015 * along with this program. If not, see <http://www.gnu.org/licenses>. 00016 * 00017 * The Audacious team does not consider modular code linking to 00018 * Audacious or using our public API to be a derived work. 00019 */ 00020 00021 #ifndef AUDACIOUS_DBUS_SERVICE_H 00022 #define AUDACIOUS_DBUS_SERVICE_H 00023 00024 #include <glib.h> 00025 00026 #define DBUS_API_SUBJECT_TO_CHANGE 00027 #include <dbus/dbus-glib.h> 00028 00029 typedef struct { 00030 GObject parent; 00031 DBusGProxy *proxy; 00032 } RemoteObject, MprisRoot, MprisPlayer, MprisTrackList; 00033 00034 typedef struct { 00035 GObjectClass parent_class; 00036 } RemoteObjectClass, MprisRootClass, MprisPlayerClass, MprisTrackListClass; 00037 00038 void init_dbus(); 00039 void free_dbus(); 00040 DBusGProxy *audacious_get_dbus_proxy(); 00041 00042 /* MPRIS API */ 00043 // Capabilities 00044 enum { 00045 MPRIS_CAPS_NONE = 0, 00046 MPRIS_CAPS_CAN_GO_NEXT = 1 << 0, 00047 MPRIS_CAPS_CAN_GO_PREV = 1 << 1, 00048 MPRIS_CAPS_CAN_PAUSE = 1 << 2, 00049 MPRIS_CAPS_CAN_PLAY = 1 << 3, 00050 MPRIS_CAPS_CAN_SEEK = 1 << 4, 00051 MPRIS_CAPS_CAN_PROVIDE_METADATA = 1 << 5, 00052 MPRIS_CAPS_PROVIDES_TIMING = 1 << 6, 00053 }; 00054 00055 // Status 00056 typedef enum { 00057 MPRIS_STATUS_PLAY = 0, 00058 MPRIS_STATUS_PAUSE, 00059 MPRIS_STATUS_STOP 00060 } PlaybackStatus; 00061 00062 // MPRIS / 00063 gboolean mpris_root_identity(MprisRoot *obj, gchar **identity, 00064 GError **error); 00065 gboolean mpris_root_quit(MprisPlayer *obj, GError **error); 00066 00067 // MPRIS /Player 00068 gboolean mpris_player_next(MprisPlayer *obj, GError **error); 00069 gboolean mpris_player_prev(MprisPlayer *obj, GError **error); 00070 gboolean mpris_player_pause(MprisPlayer *obj, GError **error); 00071 gboolean mpris_player_stop(MprisPlayer *obj, GError **error); 00072 gboolean mpris_player_play(MprisPlayer *obj, GError **error); 00073 gboolean mpris_player_repeat(MprisPlayer *obj, gboolean rpt, GError **error); 00074 gboolean mpris_player_get_status(MprisPlayer *obj, GValueArray **status, 00075 GError **error); 00076 gboolean mpris_player_get_metadata(MprisPlayer *obj, GHashTable **metadata, 00077 GError **error); 00078 gboolean mpris_player_get_caps(MprisPlayer *obj, gint *capabilities, 00079 GError **error); 00080 gboolean mpris_player_volume_set(MprisPlayer *obj, gint vol, GError **error); 00081 gboolean mpris_player_volume_get(MprisPlayer *obj, gint *vol, 00082 GError **error); 00083 gboolean mpris_player_position_set(MprisPlayer *obj, gint pos, GError **error); 00084 gboolean mpris_player_position_get(MprisPlayer *obj, gint *pos, 00085 GError **error); 00086 enum { 00087 TRACK_CHANGE_SIG, 00088 STATUS_CHANGE_SIG, 00089 CAPS_CHANGE_SIG, 00090 LAST_SIG 00091 }; 00092 00093 enum { 00094 TRACKLIST_CHANGE_SIG, 00095 LAST_TRACKLIST_SIG 00096 }; 00097 00098 gboolean mpris_emit_track_change(MprisPlayer *obj); 00099 gboolean mpris_emit_status_change(MprisPlayer *obj, PlaybackStatus status); 00100 gboolean mpris_emit_caps_change(MprisPlayer *obj); 00101 gboolean mpris_emit_tracklist_change(MprisTrackList *obj, gint playlist); 00102 00103 // MPRIS /TrackList 00104 gboolean mpris_tracklist_get_metadata(MprisTrackList *obj, gint pos, 00105 GHashTable **metadata, GError **error); 00106 gboolean mpris_tracklist_get_current_track(MprisTrackList *obj, gint *pos, 00107 GError **error); 00108 gboolean mpris_tracklist_get_length(MprisTrackList *obj, gint *length, 00109 GError **error); 00110 gboolean mpris_tracklist_add_track(MprisTrackList *obj, gchar *uri, 00111 gboolean play, GError **error); 00112 gboolean mpris_tracklist_del_track(MprisTrackList *obj, gint pos, 00113 GError **error); 00114 gboolean mpris_tracklist_loop(MprisTrackList *obj, gboolean loop, 00115 GError **error); 00116 gboolean mpris_tracklist_random(MprisTrackList *obj, gboolean random, 00117 GError **error); 00118 00119 /* Legacy API */ 00120 // Audacious General Information 00121 gboolean audacious_rc_version(RemoteObject *obj, gchar **version, GError **error); 00122 gboolean audacious_rc_quit(RemoteObject *obj, GError **error); 00123 gboolean audacious_rc_eject(RemoteObject *obj, GError **error); 00124 gboolean audacious_rc_main_win_visible(RemoteObject *obj, 00125 gboolean *is_main_win, GError **error); 00126 gboolean audacious_rc_show_main_win(RemoteObject *obj, gboolean show, 00127 GError **error); 00128 gboolean audacious_rc_equalizer_visible(RemoteObject *obj, gboolean *is_eq_win, 00129 GError **error); 00130 gboolean audacious_rc_show_equalizer(RemoteObject *obj, gboolean show, 00131 GError **error); 00132 gboolean audacious_rc_playlist_visible(RemoteObject *obj, 00133 gboolean *is_pl_win, 00134 GError **error); 00135 gboolean audacious_rc_show_playlist(RemoteObject *obj, gboolean show, 00136 GError **error); 00137 gboolean audacious_rc_get_tuple_fields(RemoteObject *obj, gchar ***fields, 00138 GError **error); 00139 00140 // Playback Information/Manipulation 00141 gboolean audacious_rc_play(RemoteObject *obj, GError **error); 00142 gboolean audacious_rc_pause(RemoteObject *obj, GError **error); 00143 gboolean audacious_rc_stop(RemoteObject *obj, GError **error); 00144 gboolean audacious_rc_playing(RemoteObject *obj, gboolean *is_playing, 00145 GError **error); 00146 gboolean audacious_rc_paused(RemoteObject *obj, gboolean *is_paused, 00147 GError **error); 00148 gboolean audacious_rc_stopped(RemoteObject *obj, gboolean *is_stopped, 00149 GError **error); 00150 gboolean audacious_rc_status(RemoteObject *obj, gchar **status, 00151 GError **error); 00152 gboolean audacious_rc_info(RemoteObject *obj, gint *rate, gint *freq, 00153 gint *nch, GError **error); 00154 gboolean audacious_rc_time(RemoteObject *obj, gint *time, GError **error); 00155 gboolean audacious_rc_seek(RemoteObject *obj, guint pos, GError **error); 00156 gboolean audacious_rc_volume(RemoteObject *obj, gint *vl, gint *vr, 00157 GError **error); 00158 gboolean audacious_rc_set_volume(RemoteObject *obj, gint vl, gint vr, 00159 GError **error); 00160 gboolean audacious_rc_balance(RemoteObject *obj, gint *balance, 00161 GError **error); 00162 00163 // Playlist Information/Manipulation 00164 gboolean audacious_rc_position(RemoteObject *obj, int *pos, GError **error); 00165 gboolean audacious_rc_advance(RemoteObject *obj, GError **error); 00166 gboolean audacious_rc_reverse(RemoteObject *obj, GError **error); 00167 gboolean audacious_rc_length(RemoteObject *obj, int *length, 00168 GError **error); 00169 gboolean audacious_rc_song_title(RemoteObject *obj, guint pos, 00170 gchar **title, GError **error); 00171 gboolean audacious_rc_song_filename(RemoteObject *obj, guint pos, 00172 gchar **filename, GError **error); 00173 gboolean audacious_rc_song_length(RemoteObject *obj, guint pos, int *length, 00174 GError **error); 00175 gboolean audacious_rc_song_frames(RemoteObject *obj, guint pos, int *length, 00176 GError **error); 00177 gboolean audacious_rc_song_tuple(RemoteObject *obj, guint pos, gchar *tuple, 00178 GValue *value, GError **error); 00179 gboolean audacious_rc_jump(RemoteObject *obj, guint pos, GError **error); 00180 gboolean audacious_rc_add(RemoteObject *obj, gchar *file, GError **error); 00181 gboolean audacious_rc_add_url(RemoteObject *obj, gchar *url, 00182 GError **error); 00183 gboolean audacious_rc_add_list (RemoteObject * obj, gchar * * filenames, 00184 GError * * error); 00185 gboolean audacious_rc_open_list (RemoteObject * obj, gchar * * filenames, 00186 GError * * error); 00187 gboolean audacious_rc_open_list_to_temp (RemoteObject * obj, gchar * * 00188 filenames, GError * * error); 00189 gboolean audacious_rc_delete(RemoteObject *obj, guint pos, GError **error); 00190 gboolean audacious_rc_clear(RemoteObject *obj, GError **error); 00191 gboolean audacious_rc_auto_advance(RemoteObject *obj, gboolean *is_advance, 00192 GError **error); 00193 gboolean audacious_rc_toggle_auto_advance(RemoteObject *obj, GError **error); 00194 gboolean audacious_rc_repeat(RemoteObject *obj, gboolean *is_repeat, 00195 GError **error); 00196 gboolean audacious_rc_toggle_repeat(RemoteObject *obj, GError **error); 00197 gboolean audacious_rc_shuffle(RemoteObject *obj, gboolean *is_shuffle, 00198 GError **error); 00199 gboolean audacious_rc_toggle_shuffle(RemoteObject *obj, GError **error); 00200 00201 /* new */ 00202 gboolean audacious_rc_show_prefs_box(RemoteObject *obj, gboolean show, GError **error); 00203 gboolean audacious_rc_show_about_box(RemoteObject *obj, gboolean show, GError **error); 00204 gboolean audacious_rc_show_jtf_box(RemoteObject *obj, gboolean show, GError **error); 00205 gboolean audacious_rc_show_filebrowser(RemoteObject *obj, gboolean show, GError **error); //new Nov 8 00206 gboolean audacious_rc_play_pause(RemoteObject *obj, GError **error); 00207 gboolean audacious_rc_activate(RemoteObject *obj, GError **error); 00208 gboolean audacious_rc_queue_get_list_pos(RemoteObject *obj, gint qpos, gint *pos, GError **error); 00209 gboolean audacious_rc_queue_get_queue_pos(RemoteObject *obj, gint pos, gint *qpos, GError **error); 00210 gboolean audacious_rc_get_info(RemoteObject *obj, gint *rate, gint *freq, gint *nch, GError **error); 00211 gboolean audacious_rc_toggle_aot(RemoteObject *obj, gboolean ontop, GError **error); 00212 gboolean audacious_rc_get_playqueue_length(RemoteObject *obj, gint *length, GError **error); 00213 gboolean audacious_rc_playqueue_add(RemoteObject *obj, gint pos, GError **error); 00214 gboolean audacious_rc_playqueue_remove(RemoteObject *obj, gint pos, GError **error); 00215 gboolean audacious_rc_playqueue_clear(RemoteObject *obj, GError **error); 00216 gboolean audacious_rc_playqueue_is_queued(RemoteObject *obj, gint pos, gboolean *is_queued, GError **error); 00217 gboolean audacious_rc_playlist_ins_url_string(RemoteObject *obj, gchar *url, gint pos, GError **error); 00218 gboolean audacious_rc_playlist_enqueue_to_temp(RemoteObject *obj, gchar *url, GError **error); 00219 gboolean audacious_rc_playlist_add(RemoteObject *obj, gpointer list, GError **error); 00220 00221 /* new on nov 7 */ 00222 gboolean audacious_rc_get_eq(RemoteObject *obj, gdouble *preamp, GArray **bands, GError **error); 00223 gboolean audacious_rc_get_eq_preamp(RemoteObject *obj, gdouble *preamp, GError **error); 00224 gboolean audacious_rc_get_eq_band(RemoteObject *obj, gint band, gdouble *value, GError **error); 00225 gboolean audacious_rc_set_eq(RemoteObject *obj, gdouble preamp, GArray *bands, GError **error); 00226 gboolean audacious_rc_set_eq_preamp(RemoteObject *obj, gdouble preamp, GError **error); 00227 gboolean audacious_rc_set_eq_band(RemoteObject *obj, gint band, gdouble value, GError **error); 00228 gboolean audacious_rc_equalizer_activate(RemoteObject *obj, gboolean active, GError **error); 00229 00230 /* new in 2.4 */ 00231 gboolean audacious_rc_get_active_playlist_name(RemoteObject *obj, gchar **title, GError **error); 00232 00233 #endif /* AUDACIOUS_DBUS_SERVICE_H */