return -E_UNSUPPORTED_AUDIO_FORMAT;
}
+static int get_matching_audio_format_nums(const char *re)
+{
+ int i, ret;
+ regex_t preg;
+
+ ret = para_regcomp(&preg, re, REG_EXTENDED | REG_NOSUB);
+ if (ret < 0)
+ return ret;
+ ret = 0;
+ FOR_EACH_AUDIO_FORMAT(i)
+ if (regexec(&preg, audio_formats[i], 0, NULL, 0) != REG_NOMATCH)
+ ret |= (1 << i);
+ regfree(&preg);
+ return ret;
+}
+
/**
* Compute the play time based on information of the given slot.
*
static int parse_stream_command(const char *txt, char **cmd)
{
- char *p = strchr(txt, ':');
- int i;
+ int ret, len;
+ char *re, *p = strchr(txt, ':');
if (!p)
return -E_MISSING_COLON;
- p++;
- FOR_EACH_AUDIO_FORMAT(i) {
- if (strncmp(txt, audio_formats[i], strlen(audio_formats[i])))
- continue;
- *cmd = p;
- return i;
- }
- return -E_UNSUPPORTED_AUDIO_FORMAT;
+ *cmd = p + 1;
+ len = p - txt;
+ re = malloc(len + 1);
+ strncpy(re, txt, len);
+ re[len] = '\0';
+ ret = get_matching_audio_format_nums(re);
+ free(re);
+ return ret;
}
static int add_filter(int format, char *cmdline)
{
struct audio_format_info *a = &afi[format];
int filter_num, nf = a->num_filters;
+ void *cfg;
- filter_num = check_filter_arg(cmdline, &a->filter_conf[nf]);
+ filter_num = check_filter_arg(cmdline, &cfg);
if (filter_num < 0)
return filter_num;
+ a->filter_conf = para_realloc(a->filter_conf,
+ (nf + 1) * sizeof(void *));
+ a->filter_nums = para_realloc(a->filter_nums,
+ (nf + 1) * sizeof(unsigned));
a->filter_nums[nf] = filter_num;
+ a->filter_conf[nf] = cfg;
a->num_filters++;
PARA_INFO_LOG("%s filter %d: %s\n", audio_formats[format], nf,
filters[filter_num].name);
static int parse_writer_args(void)
{
- int i, ret, nw;
+ int i, ret;
char *cmd;
struct audio_format_info *a;
- nw = PARA_MAX(1U, conf.writer_given);
- PARA_INFO_LOG("maximal number of writers: %d\n", nw);
- FOR_EACH_AUDIO_FORMAT(i) {
- a = &afi[i];
- a->writer_conf = para_malloc(nw * sizeof(void *));
- a->writer_nums = para_malloc(nw * sizeof(int));
- a->num_writers = 0;
- }
for (i = 0; i < conf.writer_given; i++) {
void *wconf;
- int writer_num;
+ int j, nw, writer_num, af_mask;
+
ret = parse_stream_command(conf.writer_arg[i], &cmd);
if (ret < 0)
goto out;
- a = &afi[ret];
- nw = a->num_writers;
- wconf = check_writer_arg(cmd, &writer_num);
- if (!wconf) {
- ret = writer_num;
- goto out;
+ af_mask = ret;
+ FOR_EACH_AUDIO_FORMAT(j) {
+ a = afi + j;
+ if ((af_mask & (1 << j)) == 0) /* no match */
+ continue;
+ ret = -E_WRITE_COMMON_SYNTAX;
+ wconf = check_writer_arg(cmd, &writer_num);
+ if (!wconf)
+ goto out;
+ nw = a->num_writers;
+ a->writer_nums = para_realloc(a->writer_nums, (nw + 1) * sizeof(int));
+ a->writer_conf = para_realloc(a->writer_conf, (nw + 1) * sizeof(void *));
+ a->writer_nums[nw] = writer_num;
+ a->writer_conf[nw] = wconf;
+ PARA_INFO_LOG("%s writer #%d: %s\n", audio_formats[writer_num],
+ nw, writer_names[writer_num]);
+ a->num_writers++;
}
- a->writer_nums[nw] = writer_num;
- a->writer_conf[nw] = wconf;
- PARA_INFO_LOG("%s writer #%d: %s\n", audio_formats[ret],
- nw, writer_names[writer_num]);
- a->num_writers++;
}
ret = 1;
out:
struct audio_format_info *a;
for (i = conf.receiver_given - 1; i >= 0; i--) {
- char *arg = conf.receiver_arg[i];
- char *recv_arg = strchr(arg, ':');
- ret = -E_MISSING_COLON;
- if (!recv_arg)
- goto out;
- *recv_arg = '\0';
- recv_arg++;
- ret = get_audio_format_num(arg);
+ char *arg;
+ int j, af_mask;
+
+ ret = parse_stream_command(conf.receiver_arg[i], &arg);
if (ret < 0)
goto out;
- /*
- * If multiple receivers are given for this audio format, the
- * last one wins and we have to free the previous receiver
- * config here. Since we are iterating backwards, the winning
- * receiver arg is in fact the first one given.
- */
- if (afi[ret].receiver_conf)
- afi[ret].receiver->free_config(afi[ret].receiver_conf);
- afi[ret].receiver_conf = check_receiver_arg(recv_arg, &receiver_num);
- if (!afi[ret].receiver_conf) {
+ af_mask = ret;
+ FOR_EACH_AUDIO_FORMAT(j) {
+ a = afi + j;
+ if ((af_mask & (1 << j)) == 0) /* no match */
+ continue;
+ /*
+ * If multiple receivers are given for this audio format, the
+ * last one wins and we have to free the previous receiver
+ * config here. Since we are iterating backwards, the winning
+ * receiver arg is in fact the first one given.
+ */
+ if (a->receiver_conf)
+ a->receiver->free_config(a->receiver_conf);
+ a->receiver_conf = check_receiver_arg(arg, &receiver_num);
ret = -E_RECV_SYNTAX;
- goto out;
+ if (!a->receiver_conf)
+ goto out;
+ a->receiver = receivers + receiver_num;
}
- afi[ret].receiver = &receivers[receiver_num];
}
/*
* Use the first available receiver with no arguments for those audio
return -E_RECV_SYNTAX;
a->receiver = &receivers[receiver_num];
}
+ FOR_EACH_AUDIO_FORMAT(i) {
+ a = afi + i;
+ PARA_INFO_LOG("receiving %s streams via %s receiver\n",
+ audio_formats[i], a->receiver->name);
+ }
ret = 1;
out:
free(cmd);
if (a->num_filters)
continue; /* no default -- nothing to to */
/*
- * If udp is used to receive this audiod format, add fecdec as
- * the first filter.
+ * udp and dccp streams are fec-encoded, so add fecdec as the
+ * first filter.
*/
if (strcmp(afi[i].receiver->name, "udp") == 0 ||
strcmp(afi[i].receiver->name, "dccp") == 0) {
static int parse_filter_args(void)
{
- int i, ret, nf;
+ int i, j, ret, af_mask;
- nf = PARA_MAX(2U, conf.filter_given);
- PARA_INFO_LOG("maximal number of filters: %d\n", nf);
- FOR_EACH_AUDIO_FORMAT(i) {
- afi[i].filter_conf = para_malloc(nf * sizeof(void *));
- afi[i].filter_nums = para_malloc(nf * sizeof(unsigned));
- }
if (!conf.no_default_filters_given)
return init_default_filters();
for (i = 0; i < conf.filter_given; i++) {
- char *arg = conf.filter_arg[i];
- char *filter_name = strchr(arg, ':');
- ret = -E_MISSING_COLON;
- if (!filter_name)
- goto out;
- *filter_name = '\0';
- filter_name++;
- ret = get_audio_format_num(arg);
- if (ret < 0)
- goto out;
- ret = add_filter(ret, filter_name);
+ char *arg;
+ ret = parse_stream_command(conf.filter_arg[i], &arg);
if (ret < 0)
goto out;
+ af_mask = ret;
+ FOR_EACH_AUDIO_FORMAT(j) {
+ if ((af_mask & (1 << j)) == 0) /* no match */
+ continue;
+ ret = add_filter(j, arg);
+ if (ret < 0)
+ goto out;
+ }
}
ret = init_default_filters(); /* use default values for the rest */
out:
optional
multiple
details="
- This option may be given multiple times, once for each
- supported audio format. The \"receiver_spec\" consists of
- an audio format and the receiver name, separated by a colon,
- and any options for that receiver, seperated by whitespace.
- If any receiver options are present, the whole receiver
- argument must be quoted.
+ This option may be given multiple times, for each audio format
+ separately. If multiple definitions for an audio format are
+ given, the first one is selected.
+
+ The \"receiver_spec\" consists of an audio format specifier
+ and one or more receiver arguments, separated by a colon.
- Example:
+ The audio format specifier is a regular expression which
+ specifies the set of audio formats for which this option
+ should apply.
+
+ If any receiver options are present, the whole receiver
+ argument must be quoted:
-r 'mp3:http -i my.host.org -p 8009'
+
+ Since a single dot '.' matches the name of any audio format,
+ specifying '.' instead of 'mp3' above activates the http
+ receiver for all audio formats.
+
"
option "no_default_filters" D
dependon="no_default_filters"
details="
This option may be given multiple times. The \"filter_spec\"
- consists of an audio format, the name of the filter, and any
- options for that filter. Note that order matters.
+ consists of an audio format specifier (see above), the name
+ of the filter, and any options for that filter. Note that
+ order matters.
Examples:
--filter 'mp3:mp3dec'
- --filter 'mp3:compress --inertia 5 --damp 2'
+ --filter 'mp3|aac:compress --inertia 5 --damp 2'
+
+ --filter '.:fecdec'
"
audio format. Default value is \"alsa\" for all supported
audio formats. Example:
- --writer 'aac:osx'
+ --writer 'aac|wma:oss'
"
We will also have to tell para_audiod that it should receive the
-audio stream from server_host:
+audio stream from server_host via http:
- para_audiod -l info -r 'mp3:http -i server_host'
+ para_audiod -l info -r '.:http -i server_host'
You should now be able to listen to the audio stream once para_server
starts streaming. To activate streaming, execute
-> Create a minimal config for para_audiod for HTTP streams:
c=$HOME/.paraslash/audiod.conf.min; s=server.foo.com
- formats="mp3 ogg aac wma" # remove what you do not have
- for f in $formats; do echo receiver \"$f:http -i $s\"; done > $c
+ echo receiver \".:http -i $s\" > $c
para_audiod --config $c
-------
para_filter -f 'mp3dec --ignore-crc' -f 'compress --damp 1'
For para_audiod, each audio format has its own set of filters. The
-name of the audio format for which the filter should be applied is
-used as the prefix for the filter option. Example:
+name of the audio format for which the filter should be applied can
+be used as the prefix for the filter option. Example:
para_audiod -f 'mp3:prebuffer --duration 300'
+The "mp3" prefix above is actually interpreted as a POSIX extended
+regular expression. Therefore
+
+ para_audiod -f '.:prebuffer --duration 300'
+
+activates the prebuffer filter for all supported audio formats (because
+"." matches all audio formats) while
+
+ para_audiod -f 'wma|ogg:prebuffer --duration 300'
+
+activates it only for wma and ogg streams.
+
Decoders
~~~~~~~~