From aaec2aba3890e1b2ea8f4dc158d884bc85a59517 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Tue, 27 Oct 2015 20:56:46 +0100
Subject: player: add audio drop/duplicate mode

Not very robust in the moment.
---
 DOCS/man/options.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

(limited to 'DOCS')

diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index c2b8ad118a..94beae933a 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -3463,6 +3463,11 @@ Miscellaneous
     :display-vdrop:     Drop or repeat video frames to compensate desyncing
                         video. (Although it should have the same effects as
                         ``audio``, the implementation is very different.)
+    :display-adrop:     Drop or repeat audio data to compensate desyncing
+                        video. See ``--video-sync-adrop-size``. This mode will
+                        cause severe audio artifacts if the real monitor
+                        refresh rate is too different from the reported or
+                        forced rate.
     :display-desync:    Sync video to display, and let audio play on its own.
     :desync:            Sync video according to system clock, and let audio play
                         on its own.
@@ -3494,6 +3499,13 @@ Miscellaneous
     frame dropping due to the audio "overshooting" and skipping multiple video
     frames before the sync logic can react.
 
+``--video-sync-adrop-size=<value``
+    For the ``--video-sync=display-adrop`` mode. This mode duplicates/drops
+    audio data to keep audio in sync with video. To avoid audio artifacts on
+    jitter (which would add/remove samples all the time), this is done in
+    relatively large, fixed units, controlled by this option. The unit is
+    seconds.
+
 ``--mf-fps=<value>``
     Framerate used when decoding from multiple PNG or JPEG files with ``mf://``
     (default: 1).
-- 
cgit v1.2.3