2 * This file is part of DisOrder.
3 * Copyright (C) 2006, 2007 Richard Kettlewell
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
21 #include "disobedience.h"
23 /* Track properties -------------------------------------------------------- */
27 static void kickoff_namepart(struct prefdata *f);
28 static void completed_namepart(struct prefdata *f);
29 static const char *get_edited_namepart(struct prefdata *f);
30 static void set_edited_namepart(struct prefdata *f, const char *value);
31 static void set_namepart(struct prefdata *f, const char *value);
32 static void set_namepart_completed(void *v);
34 static void kickoff_string(struct prefdata *f);
35 static void completed_string(struct prefdata *f);
36 static const char *get_edited_string(struct prefdata *f);
37 static void set_edited_string(struct prefdata *f, const char *value);
38 static void set_string(struct prefdata *f, const char *value);
40 static void kickoff_boolean(struct prefdata *f);
41 static void completed_boolean(struct prefdata *f);
42 static const char *get_edited_boolean(struct prefdata *f);
43 static void set_edited_boolean(struct prefdata *f, const char *value);
44 static void set_boolean(struct prefdata *f, const char *value);
46 static void prefdata_completed(void *v, const char *value);
47 static void prefdata_onerror(struct callbackdata *cbd,
50 static struct callbackdata *make_callbackdata(struct prefdata *f);
51 static void prefdata_completed_common(struct prefdata *f,
54 static void properties_ok(GtkButton *button, gpointer userdata);
55 static void properties_apply(GtkButton *button, gpointer userdata);
56 static void properties_cancel(GtkButton *button, gpointer userdata);
58 /** @brief Data for a single preference */
62 const struct pref *p; /**< @brief kind of preference */
63 const char *value; /**< @brief value from server */
67 /* The type of a preference is the collection of callbacks needed to get,
68 * display and set it */
70 void (*kickoff)(struct prefdata *f);
71 /* Kick off the request to fetch the pref from the server. */
73 void (*completed)(struct prefdata *f);
74 /* Called when the value comes back in; creates the widget. */
76 const char *(*get_edited)(struct prefdata *f);
77 /* Get the edited value from the widget. */
79 /** @brief Update the edited value */
80 void (*set_edited)(struct prefdata *f, const char *value);
82 void (*set)(struct prefdata *f, const char *value);
83 /* Set the new value and (if necessary) arrange for our display to update. */
87 static const struct preftype preftype_namepart = {
96 static const struct preftype preftype_string = {
105 static const struct preftype preftype_boolean = {
113 /* @brief The known prefs for each track */
114 static const struct pref {
115 const char *label; /**< @brief user-level description */
116 const char *part; /**< @brief protocol-level tag */
117 const char *default_value; /**< @brief default value or NULL */
118 const struct preftype *type; /**< @brief underlying data type */
120 { "Artist", "artist", 0, &preftype_namepart },
121 { "Album", "album", 0, &preftype_namepart },
122 { "Title", "title", 0, &preftype_namepart },
123 { "Tags", "tags", "", &preftype_string },
124 { "Random", "pick_at_random", "1", &preftype_boolean },
127 #define NPREFS (int)(sizeof prefs / sizeof *prefs)
129 /* Buttons that appear at the bottom of the window */
130 static const struct button buttons[] = {
134 "Apply all changes and close window"
139 "Apply all changes and keep window open"
144 "Discard all changes and close window"
148 #define NBUTTONS (int)(sizeof buttons / sizeof *buttons)
150 static int prefs_unfilled; /* Prefs remaining to get */
151 static int prefs_total; /* Total prefs */
152 static struct prefdata *prefdatas; /* Current prefdatas */
153 static GtkWidget *properties_window;
154 static GtkWidget *properties_table;
155 static struct progress_window *pw;
157 static void propagate_clicked(GtkButton attribute((unused)) *button,
159 struct prefdata *f = (struct prefdata *)userdata, *g;
161 const char *value = f->p->type->get_edited(f);
163 for(p = 0; p < prefs_total; ++p) {
165 if(f->p == g->p && f != g)
166 g->p->type->set_edited(g, value);
170 void properties(int ntracks, const char **tracks) {
173 GtkWidget *buttonbox, *vbox, *label, *entry, *propagate, *content;
176 /* If no tracks, do nothign */
179 /* If there is a properties window open then just bring it to the
180 * front. It might not have the right values in... */
181 if(properties_window) {
183 gtk_window_present(GTK_WINDOW(properties_window));
186 assert(properties_table == 0);
187 if(ntracks > INT_MAX / NPREFS) {
188 popup_msg(GTK_MESSAGE_ERROR, "Too many tracks selected");
191 /* Create a new properties window */
192 properties_window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
193 gtk_widget_modify_bg(properties_window, GTK_STATE_NORMAL, &tool_bg);
194 g_signal_connect(properties_window, "destroy",
195 G_CALLBACK(gtk_widget_destroyed), &properties_window);
196 /* Most of the action is the table of preferences */
197 properties_table = gtk_table_new((NPREFS + 1) * ntracks, 2 + ntracks > 1,
199 gtk_widget_modify_bg(properties_table, GTK_STATE_NORMAL, &tool_bg);
200 g_signal_connect(properties_table, "destroy",
201 G_CALLBACK(gtk_widget_destroyed), &properties_table);
202 gtk_window_set_title(GTK_WINDOW(properties_window), "Track Properties");
203 /* Create labels for each pref of each track and kick off requests to the
204 * server to fill in the values */
205 prefs_total = NPREFS * ntracks;
206 prefdatas = xcalloc(prefs_total, sizeof *prefdatas);
207 for(n = 0; n < ntracks; ++n) {
208 /* The track itself */
210 label = gtk_label_new("Track");
211 gtk_widget_modify_fg(label, GTK_STATE_NORMAL, &tool_fg);
212 gtk_misc_set_alignment(GTK_MISC(label), 1, 0);
213 gtk_table_attach(GTK_TABLE(properties_table),
216 (NPREFS + 1) * n, (NPREFS + 1) * n + 1,
220 entry = gtk_entry_new();
221 gtk_entry_set_text(GTK_ENTRY(entry), tracks[n]);
222 gtk_editable_set_editable(GTK_EDITABLE(entry), FALSE);
223 gtk_table_attach(GTK_TABLE(properties_table),
226 (NPREFS + 1) * n, (NPREFS + 1) * n + 1,
227 GTK_EXPAND|GTK_FILL, 0,
229 /* Each preference */
230 for(m = 0; m < NPREFS; ++m) {
232 label = gtk_label_new(prefs[m].label);
233 gtk_widget_modify_fg(label, GTK_STATE_NORMAL, &tool_fg);
234 gtk_misc_set_alignment(GTK_MISC(label), 1, 0);
235 gtk_table_attach(GTK_TABLE(properties_table),
238 (NPREFS + 1) * n + 1 + m, (NPREFS + 1) * n + 2 + m,
239 GTK_FILL/*xoptions*/, 0/*yoptions*/,
241 /* Editing the preference is specific */
242 f = &prefdatas[NPREFS * n + m];
243 f->track = tracks[n];
244 f->row = (NPREFS + 1) * n + 1 + m;
246 prefs[m].type->kickoff(f);
248 /* Propagation button */
249 propagate = gtk_button_new();
250 if((pb = find_image("propagate.png")))
251 content = gtk_image_new_from_pixbuf(pb);
253 content = gtk_label_new("propagate.png");
254 gtk_container_add(GTK_CONTAINER(propagate), content);
255 gtk_tooltips_set_tip(tips, propagate, "Copy to other tracks", "");
256 g_signal_connect(G_OBJECT(propagate), "clicked",
257 G_CALLBACK(propagate_clicked), f);
258 gtk_table_attach(GTK_TABLE(properties_table),
260 2/*left*/, 3/*right*/,
261 (NPREFS + 1) * n + 1 + m, (NPREFS + 1) * n + 2 + m,
262 GTK_FILL/*xoptions*/, 0/*yoptions*/,
263 1/*xpadding*/, 1/*ypadding*/);
267 prefs_unfilled = prefs_total;
269 buttonbox = create_buttons(buttons, NBUTTONS);
270 /* Put it all together */
271 vbox = gtk_vbox_new(FALSE, 1);
272 gtk_box_pack_start(GTK_BOX(vbox),
273 scroll_widget(properties_table),
275 gtk_box_pack_start(GTK_BOX(vbox), buttonbox, FALSE, FALSE, 1);
276 gtk_container_add(GTK_CONTAINER(properties_window), vbox);
277 /* The table only really wants to be vertically scrollable */
278 gtk_scrolled_window_set_policy(GTK_SCROLLED_WINDOW(GTK_WIDGET(properties_table)->parent->parent),
280 GTK_POLICY_AUTOMATIC);
281 /* Zot any pre-existing progress window just in case */
283 progress_window_progress(pw, 0, 0);
284 /* Pop up a progress bar while we're waiting */
285 pw = progress_window_new("Fetching Track Properties");
288 /* Everything is filled in now */
289 static void prefdata_alldone(void) {
291 progress_window_progress(pw, 0, 0);
294 /* Default size may be too small */
295 gtk_window_set_default_size(GTK_WINDOW(properties_window), 480, 512);
296 /* TODO: relate default size to required size more closely */
297 gtk_widget_show_all(properties_window);
300 /* Namepart preferences ---------------------------------------------------- */
302 static void kickoff_namepart(struct prefdata *f) {
303 /* We ask for the display name part. This is a bit bizarre if what we really
304 * wanted was the underlying preference, but in fact it should always match
305 * and will supply a sane default without having to know how to parse tracks
306 * names (which implies knowing collection roots). */
307 disorder_eclient_namepart(client, prefdata_completed, f->track, "display", f->p->part,
308 make_callbackdata(f));
311 static void completed_namepart(struct prefdata *f) {
316 f->widget = gtk_entry_new();
319 static const char *get_edited_namepart(struct prefdata *f) {
320 return gtk_entry_get_text(GTK_ENTRY(f->widget));
323 static void set_edited_namepart(struct prefdata *f, const char *value) {
324 gtk_entry_set_text(GTK_ENTRY(f->widget), value);
327 static void set_namepart(struct prefdata *f, const char *value) {
329 struct callbackdata *cbd = xmalloc(sizeof *cbd);
332 byte_xasprintf(&s, "trackname_display_%s", f->p->part);
333 /* We don't know what the default is so can never unset. This is a bug
334 * relative to the original design, which is supposed to only ever allow for
335 * non-trivial namepart preferences. I suppose the server could spot a
336 * default being set and translate it into an unset. */
337 disorder_eclient_set(client, set_namepart_completed, f->track, s, value,
341 /* Called when we've set a namepart */
342 static void set_namepart_completed(void *v) {
343 struct callbackdata *cbd = v;
344 struct prefdata *f = cbd->u.f;
346 namepart_update(f->track, "display", f->p->part);
349 /* String preferences ------------------------------------------------------ */
351 static void kickoff_string(struct prefdata *f) {
352 disorder_eclient_get(client, prefdata_completed, f->track, f->p->part,
353 make_callbackdata(f));
356 static void completed_string(struct prefdata *f) {
358 /* No setting, use the default value instead */
359 f->value = f->p->default_value;
360 f->widget = gtk_entry_new();
363 static const char *get_edited_string(struct prefdata *f) {
364 return gtk_entry_get_text(GTK_ENTRY(f->widget));
367 static void set_edited_string(struct prefdata *f, const char *value) {
368 gtk_entry_set_text(GTK_ENTRY(f->widget), value);
371 static void set_string(struct prefdata *f, const char *value) {
372 if(strcmp(f->p->default_value, value))
373 /* Different from default, set it */
374 disorder_eclient_set(client, 0/*completed*/, f->track, f->p->part,
377 /* Same as default, just unset */
378 disorder_eclient_unset(client, 0/*completed*/, f->track, f->p->part,
382 /* Boolean preferences ----------------------------------------------------- */
384 static void kickoff_boolean(struct prefdata *f) {
385 disorder_eclient_get(client, prefdata_completed, f->track, f->p->part,
386 make_callbackdata(f));
389 static void completed_boolean(struct prefdata *f) {
390 f->widget = gtk_check_button_new();
391 gtk_widget_modify_bg(f->widget, GTK_STATE_NORMAL, &tool_bg);
392 gtk_widget_modify_bg(f->widget, GTK_STATE_PRELIGHT, &tool_active);
394 /* Not set, use the default */
395 f->value = f->p->default_value;
398 static const char *get_edited_boolean(struct prefdata *f) {
399 return (gtk_toggle_button_get_active(GTK_TOGGLE_BUTTON(f->widget))
403 static void set_edited_boolean(struct prefdata *f, const char *value) {
404 gtk_toggle_button_set_active(GTK_TOGGLE_BUTTON(f->widget),
408 static void set_boolean(struct prefdata *f, const char *value) {
411 byte_xasprintf(&s, "trackname_display_%s", f->p->part);
412 if(strcmp(value, f->p->default_value))
413 disorder_eclient_set(client, 0/*completed*/, f->track, f->p->part, value,
416 /* If default value then delete the pref */
417 disorder_eclient_unset(client, 0/*completed*/, f->track, f->p->part,
421 /* Querying preferences ---------------------------------------------------- */
423 /* Make a suitable callbackdata */
424 static struct callbackdata *make_callbackdata(struct prefdata *f) {
425 struct callbackdata *cbd = xmalloc(sizeof *cbd);
427 cbd->onerror = prefdata_onerror;
432 /* No pref was set */
433 static void prefdata_onerror(struct callbackdata *cbd,
434 int attribute((unused)) code,
435 const char attribute((unused)) *msg) {
436 prefdata_completed_common(cbd->u.f, 0);
439 /* Got the value of a pref */
440 static void prefdata_completed(void *v, const char *value) {
441 struct callbackdata *cbd = v;
443 prefdata_completed_common(cbd->u.f, value);
446 static void prefdata_completed_common(struct prefdata *f,
449 f->p->type->completed(f);
450 f->p->type->set_edited(f, f->value);
451 assert(f->value != 0); /* Had better set a default */
452 gtk_table_attach(GTK_TABLE(properties_table), f->widget,
455 GTK_EXPAND|GTK_FILL/*xoptions*/, 0/*yoptions*/,
459 progress_window_progress(pw, prefs_total - prefs_unfilled, prefs_total);
464 /* Button callbacks -------------------------------------------------------- */
466 static void properties_ok(GtkButton *button,
468 properties_apply(button, userdata);
469 properties_cancel(button, userdata);
472 static void properties_apply(GtkButton attribute((unused)) *button,
473 gpointer attribute((unused)) userdata) {
478 /* For each possible property we see if we've changed it and if so tell the
480 for(n = 0; n < prefs_total; ++n) {
482 edited = f->p->type->get_edited(f);
483 if(strcmp(edited, f->value)) {
484 /* The value has changed */
485 f->p->type->set(f, edited);
486 f->value = xstrdup(edited);
491 static void properties_cancel(GtkButton attribute((unused)) *button,
492 gpointer attribute((unused)) userdata) {
493 gtk_widget_destroy(properties_window);
496 /** @brief Called on client reset
498 * Destroys the current properties window.
500 void properties_reset(void) {
501 if(properties_window)
502 gtk_widget_destroy(properties_window);