diff options
author | wm4 <wm4@nowhere> | 2012-11-15 18:49:17 +0100 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2012-11-16 21:21:15 +0100 |
commit | 51503a05778290edc0bb77276b67d33ca0e10783 (patch) | |
tree | 4745d8d476e788fe0a36c1151dd28118cac0a911 /DOCS/man/en | |
parent | b4b86e9286ba175ba0da4d19e165660bed7002e4 (diff) |
options: rename -ss and -endpos, allow relative times
Rename the -ss option to -start, and -endpos to -length. Add a -end
option. The -end option always specifies an absolute end time, as
opposed to -endpos/-length.
All these options (--start, --end, --length) now accept relative times.
Percent positions (e.g. "--start=30%") are interpreted as fractions of
the file duration. Negative times (e.g. "--start=-1:00) are interpreted
relative to the end of the file. Chapters (e.g. "--start=#3") yield the
chapter's time position.
The chapter support might be able to replace --chapter completely, but
for now I am not sure how well this works out with e.g. DVDs and BDs,
and a separate --chapter option is useful interface-wise.
Diffstat (limited to 'DOCS/man/en')
-rw-r--r-- | DOCS/man/en/changes.rst | 2 | ||||
-rw-r--r-- | DOCS/man/en/options.rst | 43 |
2 files changed, 26 insertions, 19 deletions
diff --git a/DOCS/man/en/changes.rst b/DOCS/man/en/changes.rst index 71d788a044..53d9179e6d 100644 --- a/DOCS/man/en/changes.rst +++ b/DOCS/man/en/changes.rst @@ -105,6 +105,8 @@ Command line switches -ni --avi-ni -benchmark --untimed (no stats) -xineramascreen --screen (different values) + -ss --start + -endpos --length =================================== =================================== input.conf and slave commands diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst index 6b8041c192..7cc309de02 100644 --- a/DOCS/man/en/options.rst +++ b/DOCS/man/en/options.rst @@ -336,7 +336,7 @@ --chapter=<start[-end]> Specify which chapter to start playing at. Optionally specify which - chapter to end playing at (default: 1). + chapter to end playing at. Also see ``--start``. --chapter-merge-threshold=<number> Threshold for merging almost consecutive ordered chapter parts in @@ -518,20 +518,9 @@ enabled). These fonts can be used for SSA/ASS subtitle rendering (``--ass`` option). ---endpos=<[[hh:]mm:]ss[.ms]> - Stop at given time. - - *NOTE*: When used in conjunction with ``--ss`` option, ``--endpos`` time - will shift forward by seconds specified with ``--ss``. - - *EXAMPLE*: - - ``--endpos=56`` - Stop at 56 seconds. - ``--endpos=01:10:00`` - Stop at 1 hour 10 minutes. - ``--ss=10 --endpos=56`` - Stop at 1 minute 6 seconds. +--end=<relative time> + Stop at given absolute time. See ``--start`` for valid option values and + examples. --no-extbased, --extbased ``--no-extbased`` disables extension-based demuxer selection. By default, when the file type @@ -1057,6 +1046,10 @@ Encryption key the demuxer should use. This is the raw binary data of the key converted to a hexadecimal string. +--length=<relative time> + Stop after a given time relative to the start time. + See ``--start`` for valid option values and examples. + --lirc, --no-lirc Enable/disable LIRC support. Enabled by default. @@ -1515,7 +1508,7 @@ --sb=<n> Seek to byte position. Useful for playback from CD-ROM images or VOB files - with junk at the beginning. See also ``--ss``. + with junk at the beginning. See also ``--start``. --screenshot-format=<type> Set the image file type used for saving screenshots. @@ -1685,15 +1678,27 @@ inserted into the audio filter layer to compensate for the difference. The type of resampling can be controlled by the ``--af-adv`` option. ---ss=<time> +--start=<relative time> Seek to given time position. + The general format for absolute times is ``[[hh:]mm:]ss[.ms]``. If the time + is negated with ``-``, the seek is relative from the end of the file. + + It's also possible to seek to a percent position with ``pp%``. + *EXAMPLE*: - ``--ss=56`` + ``--start=56`` Seeks to 56 seconds. - ``--ss=01:10:00`` + ``--start=01:10:00`` Seeks to 1 hour 10 min. + ``--start=50%`` + Seeks to the middle of the file. + ``--start=30 --end=40`` + Seeks to 30 seconds, plays 10 seconds, and exits. + ``--start=-3:20 --length=10`` + Seeks to 3 minutes and 20 seconds before the end of the file, plays + 10 seconds, and exits. --ssf=<mode> Specifies software scaler parameters. |