Commit | Line | Data |
---|---|---|
460b9539 | 1 | /* |
2 | * This file is part of DisOrder. | |
5aff007d | 3 | * Copyright (C) 2004-2008 Richard Kettlewell |
460b9539 | 4 | * |
e7eb3a27 | 5 | * This program is free software: you can redistribute it and/or modify |
460b9539 | 6 | * it under the terms of the GNU General Public License as published by |
e7eb3a27 | 7 | * the Free Software Foundation, either version 3 of the License, or |
460b9539 | 8 | * (at your option) any later version. |
e7eb3a27 RK |
9 | * |
10 | * This program is distributed in the hope that it will be useful, | |
11 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
13 | * GNU General Public License for more details. | |
14 | * | |
460b9539 | 15 | * You should have received a copy of the GNU General Public License |
e7eb3a27 | 16 | * along with this program. If not, see <http://www.gnu.org/licenses/>. |
460b9539 | 17 | */ |
132a5a4a RK |
18 | /** @file lib/queue.h |
19 | * @brief Track queues | |
20 | * | |
21 | * Used for the queue, the recently played list and the currently playing | |
22 | * track, both in the server and in clients. | |
23 | */ | |
460b9539 | 24 | #ifndef QUEUE_H |
25 | #define QUEUE_H | |
26 | ||
05b75f8d RK |
27 | #include <time.h> |
28 | ||
29 | ||
460b9539 | 30 | enum playing_state { |
31 | playing_failed, /* failed to play */ | |
32 | playing_isscratch, /* this is a scratch track */ | |
33 | playing_no_player, /* couldn't find a player */ | |
34 | playing_ok, /* played OK */ | |
35 | playing_paused, /* started but paused */ | |
36 | playing_quitting, /* interrupt because server quit */ | |
37 | playing_random, /* unplayed randomly chosen track */ | |
38 | playing_scratched, /* was scratched */ | |
39 | playing_started, /* started to play */ | |
40 | playing_unplayed /* haven't played this track yet */ | |
41 | }; | |
42 | ||
2dc2f478 RK |
43 | extern const char *const playing_states[]; |
44 | ||
45 | /** @brief Possible track origins | |
46 | * | |
47 | * This is a newly introduced field. The aim is ultimately to separate the | |
48 | * concepts of the track origin and its current state. NB that both are | |
49 | * potentially mutable! | |
50 | */ | |
51 | enum track_origin { | |
52 | /** @brief Track was picked at random and then adopted by a user | |
53 | * | |
54 | * @c submitter identifies who adopted it. This isn't implemented | |
55 | * yet. | |
56 | */ | |
57 | origin_adopted, | |
58 | ||
59 | /** @brief Track was picked by a user | |
60 | * | |
61 | * @c submitter identifies who picked it | |
62 | */ | |
63 | origin_picked, | |
64 | ||
65 | /** @brief Track was picked at random | |
66 | * | |
67 | * @c submitter will be NULL | |
68 | */ | |
69 | origin_random, | |
70 | ||
71 | /** @brief Track was scheduled by a user | |
72 | * | |
73 | * @c submitter identifies who picked it | |
74 | */ | |
75 | origin_scheduled, | |
76 | ||
77 | /** @brief Track is a scratch | |
78 | * | |
79 | * @c submitter identifies who did the scratching | |
80 | */ | |
81 | origin_scratch | |
82 | }; | |
83 | ||
84 | extern const char *const track_origins[]; | |
460b9539 | 85 | |
86 | /* queue entries form a circular doubly-linked list */ | |
87 | struct queue_entry { | |
88 | struct queue_entry *next; /* next entry */ | |
89 | struct queue_entry *prev; /* previous entry */ | |
90 | const char *track; /* path to track */ | |
91 | const char *submitter; /* name of submitter */ | |
92 | time_t when; /* time submitted */ | |
93 | time_t played; /* when played */ | |
94 | enum playing_state state; /* state */ | |
2dc2f478 | 95 | enum track_origin origin; /* where track came from */ |
460b9539 | 96 | long wstat; /* wait status */ |
97 | const char *scratched; /* scratched by */ | |
98 | const char *id; /* queue entry ID */ | |
99 | time_t expected; /* expected started time */ | |
100 | /* for playing or soon-to-be-played tracks only: */ | |
101 | unsigned long type; /* type word from plugin */ | |
102 | const struct plugin *pl; /* plugin that's playing this track */ | |
103 | void *data; /* player data */ | |
104 | long sofar; /* how much played so far */ | |
66bb2e02 | 105 | int prepared; /* true when connected to speaker */ |
460b9539 | 106 | /* For DISORDER_PLAYER_PAUSES only: */ |
107 | time_t lastpaused, lastresumed; /* when last paused/resumed, or 0 */ | |
108 | long uptopause; /* how much played up to last pause */ | |
109 | /* For Disobedience */ | |
110 | struct queuelike *ql; /* owning queue */ | |
111 | }; | |
112 | ||
05b75f8d RK |
113 | void queue_insert_entry(struct queue_entry *b, struct queue_entry *n); |
114 | void queue_delete_entry(struct queue_entry *node); | |
115 | ||
460b9539 | 116 | int queue_unmarshall(struct queue_entry *q, const char *s, |
117 | void (*error_handler)(const char *, void *), | |
118 | void *u); | |
119 | /* unmarshall UTF-8 string @s@ into @q@ */ | |
120 | ||
121 | int queue_unmarshall_vec(struct queue_entry *q, int nvec, char **vec, | |
122 | void (*error_handler)(const char *, void *), | |
123 | void *u); | |
124 | /* unmarshall pre-split string @vec@ into @q@ */ | |
125 | ||
126 | char *queue_marshall(const struct queue_entry *q); | |
127 | /* marshall @q@ into a UTF-8 string */ | |
128 | ||
460b9539 | 129 | #endif /* QUEUE_H */ |
130 | ||
131 | /* | |
132 | Local Variables: | |
133 | c-basic-offset:2 | |
134 | comment-column:40 | |
135 | fill-column:79 | |
136 | End: | |
137 | */ |