From 2907cc6dd0b0d2d80d44ae292a157651d6e05ee7 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Mon, 26 Aug 2013 05:25:22 +0000 Subject: player: flesh out multi-source in protocol/sourceedit We should be fully-capable of managing any number of options to try sources in. --- Documentation/dtas-player_protocol.txt | 6 ++++-- Documentation/dtas-sourceedit.txt | 17 ++++++++++------- 2 files changed, 14 insertions(+), 9 deletions(-) (limited to 'Documentation') diff --git a/Documentation/dtas-player_protocol.txt b/Documentation/dtas-player_protocol.txt index 360eb84..07d14ec 100644 --- a/Documentation/dtas-player_protocol.txt +++ b/Documentation/dtas-player_protocol.txt @@ -33,6 +33,7 @@ dtas-sinkedit(1), and dtas-enq(1) also implement this protocol. - ENVVALUE - must be a suitable environment variable (setenv(3)) - COMMAND, this may be quoted string passed to sh -c "", variable/argument expansion will be performed by the shell +- SOURCENAME - "sox" or "av", more backends may be supported in the future - FILENAME - an expanded pathname relative to / is recommended since dtas-player and the client may run in different directories @@ -167,14 +168,15 @@ For little-endian machines, $ECAFMT defaults to: -fs32_le,2,44100 + nonblock=BOOLEAN - drop audio data to avoid holding back other sinks + pipe_size=UNSIGNED - set the size of the pipe for the sink (Linux-only) -* source cat - dump the current source command and env in YAML +* source SOURCENAME cat - dump the current source command and env in YAML -* source ed SOURCEARGS - edit the source (decoder) command and environment. +* source ed SOURCENAME SOURCEARGS - edit the source parameters. This changes here will immediately restart the source process. See the code for dtas-sourceedit(1) for an example of using this. + command=COMMAND - change the command-line used to decode audio + env.ENVNAME=ENVVALUE - set ENVNAME to ENVVALUE for the source process + env#ENVNAME - unset ENVNAME in the source process (only) + + tryorder=INTEGER - lower values are tried first * watch - adds the client to the passive watch list for notifications. It is recommended clients issue no further commands and open diff --git a/Documentation/dtas-sourceedit.txt b/Documentation/dtas-sourceedit.txt index 1f5101b..6ef876c 100644 --- a/Documentation/dtas-sourceedit.txt +++ b/Documentation/dtas-sourceedit.txt @@ -3,23 +3,26 @@ # NAME -dtas-sourceedit - edit the command and environment of the decoder +dtas-sourceedit - edit parameters of a source decoder # SYNOPSYS -dtas-sourceedit +dtas-sourceedit {sox | av} # DESCRIPTION -dtas-sourceedit spawns an editor to allow editing of a sink as a YAML file. -See dtas-player_protocol(7) for details on SINKARGS. +dtas-sourceedit spawns an editor to allow editing of a source as a YAML file. +See dtas-player_protocol(7) for details on SOURCEARGS. # EXAMPLES -Invoking dtas-sourceedit will spawn your favorite text editor on a -given SINKNAME: +Invoking dtas-sourceedit will spawn your favorite text editor on "sox": - $ dtas-sourceedit + $ dtas-sourceedit sox + +To change the way dtas-player calls avconv (part of libav): + + $ dtas-sourceedit av # ENVIRONMENT -- cgit v1.2.3-24-ge0c7