From 7f107e8ce965bd58c8da0631cb1e5cf594b24835 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Sun, 24 Apr 2016 02:37:15 +0000 Subject: player: extra "cue" seeking functionality These commands allow easier jumping within a track marked by embedded CUE sheets. I've found them helpful for tracking out large recordings of multiple tracks (e.g. vinyl transfers or live concert recordings). --- Documentation/dtas-player_protocol.pod | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) (limited to 'Documentation/dtas-player_protocol.pod') diff --git a/Documentation/dtas-player_protocol.pod b/Documentation/dtas-player_protocol.pod index d0dd25e..be9f4ef 100644 --- a/Documentation/dtas-player_protocol.pod +++ b/Documentation/dtas-player_protocol.pod @@ -96,7 +96,7 @@ Commands here should be alphabetized according to `LC_ALL=C sort' PENDING: this may be renamed to "queue clear" or "queue-clear" -=item cue - display the index/offsets of the embedded cue sheet +=item cue - display the index/offsets of the embedded CUE sheet =item cue next - skip to the next cue sheet offset @@ -109,11 +109,26 @@ This may just seek to the beginning if there is no embedded cue sheet or if we are playing the first (embedded) track. -=item cue goto INTEGER - go to the cue index denoted by INTEGER +=item cue goto INTEGER [TIMESTAMP] - go to the cue index denoted by INTEGER 0 is first track as returned by "cue". Negative values of INTEGER allows selecting track relative to the last track (-1 is the last track, -2 is the penultimate, and so on). +The optional TIMESTAMP allows starting the index track at a given +point, negative values allow going to a set point before the given +index. In other words: "cue goto 1 -5" seeks to the last five seconds +of the first track while "cue goto 1 5" seeks to the fifth second of +the second track + +=item cue seek TIMESTAMP - seek within the current cue index + +Like the normal "seek" command, but this confines the seeking +within the currently playing index. As with "seek", +"+" and "-" prefixes allow seeking relative to the currently +playing position + +Using a "=-" prefix allows seeking to the previous track within +the CUE sheet, relative to the currently playing track. =item current - output information about the current track/command in YAML -- cgit v1.2.3-24-ge0c7