2 * This file is part of DisOrder.
3 * Copyright (C) 2004-2008 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 3 of the License, or
8 * (at your option) any later version.
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.
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
21 * Used for the queue, the recently played list and the currently playing
22 * track, both in the server and in clients.
29 /** @brief Possible track states */
31 /** @brief Track failed to play */
36 * Formerly denoted an unplayed scratch. This is now indicated by @p
37 * playing_unplayed and @p origin_scratch.
43 * Formerly meant that no player could be found. Nothing sets this any more.
47 /** @brief Play completed successfully
49 * Currently this actually means it finished decoding - it might still be
50 * buffered in the speaker, RTP player, sound card, etc.
52 * It might also mean that it's a (short!) track that hasn't been played at
53 * all yet but has been fully decoded ahead of time! (This is very confusing
58 /** @brief Track is playing, but paused */
61 /** @brief Track is playing but the server is quitting */
66 * Formerly this meant a track that was picked at random and has not yet been
67 * played. This situation is now indicated by @p playing_unplayed and @p
68 * origin_random (or @p origin_adopted).
72 /** @brief Track was scratched */
75 /** @brief Track is now playing
77 * This refers to the actual playing track, not something being decoded ahead
82 /** @brief Track has not been played yet */
86 extern const char *const playing_states
[];
88 /** @brief Possible track origins
90 * This is a newly introduced field. The aim is ultimately to separate the
91 * concepts of the track origin and its current state. NB that both are
92 * potentially mutable!
95 /** @brief Track was picked at random and then adopted by a user
97 * @c submitter identifies who adopted it.
101 /** @brief Track was picked by a user
103 * @c submitter identifies who picked it
107 /** @brief Track was picked at random
109 * @c submitter will be NULL
113 /** @brief Track was scheduled by a user
115 * @c submitter identifies who picked it
119 /** @brief Track is a scratch
121 * @c submitter identifies who did the scratching
126 extern const char *const track_origins
[];
128 /** @brief One queue/recently played entry
130 * The queue and recently played list form a doubly linked list with the head
131 * and tail referred to from @ref qhead and @ref phead.
134 /** @brief Next entry */
135 struct queue_entry
*next
;
137 /** @brief Previous entry */
138 struct queue_entry
*prev
;
140 /** @brief Path to track (a database key) */
143 /** @brief Submitter or NULL
145 * Adopter, if @c origin is @ref origin_adopted.
147 const char *submitter
;
149 /** @brief When submitted */
152 /** @brief When played */
155 /** @brief Current state
157 * Currently this includes some origin information but this is being phased
159 enum playing_state state
;
161 /** @brief Where track came from */
162 enum track_origin origin
;
164 /** @brief Wait status from player
166 * Only valid in certain states (TODO).
170 /** @brief Who scratched this track or NULL */
171 const char *scratched
;
173 /** @brief Unique ID string */
176 /** @brief Estimated starting time */
179 /** @brief Type word from plugin (playing/buffered tracks only) */
180 unsigned long type
; /* type word from plugin */
182 /** @brief Plugin for this track (playing/buffered tracks only) */
183 const struct plugin
*pl
;
185 /** @brief Player-specific data (playing/buffered tracks only) */
188 /** @brief How much of track has been played so far (seconds) */
191 /** @brief True if track preparation is underway
193 * This is set when a decoder has been started and is expected to connect to
194 * the speaker, but the speaker has not sent as @ref SM_ARRIVED message back
198 /** @brief True if decoder is connected to speaker
200 * This is not a @ref playing_state for a couple of reasons
201 * - it is orthogonal to @ref playing_started and @ref playing_unplayed
202 * - it would have to be hidden to other users of @c queue_entry
204 * For non-raw tracks this should always be zero.
207 /* For DISORDER_PLAYER_PAUSES only: */
209 /** @brief When last paused or 0 */
212 /** @brief When last resumed or 0 */
215 /** @brief How much of track was played up to last pause (seconds) */
218 /** @brief Owning queue (for Disobedience only) */
219 struct queuelike
*ql
;
221 /** @brief Decoder (or player) process ID */
225 void queue_insert_entry(struct queue_entry
*b
, struct queue_entry
*n
);
226 void queue_delete_entry(struct queue_entry
*node
);
228 int queue_unmarshall(struct queue_entry
*q
, const char *s
,
229 void (*error_handler
)(const char *, void *),
231 /* unmarshall UTF-8 string @s@ into @q@ */
233 int queue_unmarshall_vec(struct queue_entry
*q
, int nvec
, char **vec
,
234 void (*error_handler
)(const char *, void *),
236 /* unmarshall pre-split string @vec@ into @q@ */
238 char *queue_marshall(const struct queue_entry
*q
);
239 /* marshall @q@ into a UTF-8 string */